Cross Reference: /opengrok/OpenGrok

	OpenGrok revision 91a4a0519a6171d9f52be4c514959c0d65c82812
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#!/bin/sh
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock# OpenGrok Wrapper (initial setup and cron job updating)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock# Supported Operating Systems:
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - Solaris 11  (SunOS 5.11)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - Solaris 12  (SunOS 5.12)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - Debian      (Linux)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock# Supported Deployment Engines:
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - Tomcat 8
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - Tomcat 7
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - Tomcat 6
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - Glassfish
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock# Supported Environment Variables:
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_NON_INTERACTIVE    Suppress Progress and Warnings Messages (*)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_STANDARD_ENV       Run Time Shell Environment (Shell Script)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_CONFIGURATION      User Configuration (Shell Script)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock# Supported Environment Variables for configuring the default setup:
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor#   - OPENGROK_DISTRIBUTION_BASE  Base Directory of the OpenGrok Distribution
4263d13f00c9691fa14620eff82abef795be0693George Wilson#   - OPENGROK_INSTANCE_BASE      Base Directory of the OpenGrok User Data Area
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - EXUBERANT_CTAGS             Full Path to Exuberant CTags
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_CTAGS_OPTIONS_FILE Full path to file with extra command line
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 options for CTags program (for its --options
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 switch), default is DATA_ROOT/etc/ctags.config
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - JAVA_HOME                   Full Path to Java Installation Root
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - JAVA                        Full Path to java binary (to enable 64bit JDK)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - JAVA_OPTS                   Java options (e.g. for JVM memory increase
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 or enabling server JDK)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 JAVA_OPTS=-Xmx2048m is the default!
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_APP_SERVER         Application Server ("Tomcat", "Glassfish" or "Resin")
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_WAR_TARGET_TOMCAT  Tomcat Specific WAR Target Directory
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_WAR_TARGET_GLASSFISH Glassfish Specific WAR Target Directory
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_WAR_TARGET_RESIN   Resin Specific WAR Target Directory
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_WAR_TARGET         Fallback WAR Target Directory
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_TOMCAT_BASE        Base Directory for Tomcat (contains webapps)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_GLASSFISH_BASE     Base Directory for Glassfish
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 (contains domains)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_GLASSFISH_DOMAIN   Preferred Glassfish Domain Name
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_RESIN_BASE         Base Directory for Resin (contains webapps)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_VERBOSE            Enable Verbose Mode in opengrok.jar (*)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_PROGRESS           Shows progress in %(percentage) of working
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 through project, it's good to have Verbose
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 Mode enabled too, cost of this is one more
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 traversal of the project before indexing it(*)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_GENERATE_HISTORY   Influence history cache generation
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 Following values are recognized:
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                   on      - enabled (default)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                   off     - disabled for indexing and UI
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                   dirbased    - indexing enabled only for repos
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                                 which can fetch history for
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                                 directory
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                   local   - for local repos only
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                   uionly  - enabled for UI only
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_ENABLE_PROJECTS    Enable projects (set it to true or false)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 Every directory in SRC_ROOT is
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                   considered a separate project
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_SCAN_REPOS         Disable Scan for repositories (*)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_SCAN_DEPTH         how deep should scanning for repos go
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 (by default 3 directories from SRC_ROOT)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_WEBAPP_CFGADDR     Web app address to send configuration to
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 (use "none" to avoid sending it to web app)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_WEBAPP_CONTEXT     Context URL of the OpenGrok webapp
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 (by default /source)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 - FULL reindex is needed once this is used
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 (old already indexed files won't be refreshed)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_WPREFIX            Disable wildcard prefix search query
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 support (*)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_DERBY              if set, then indexer tries to use derby as
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 historycache (see derby command of this
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor#                                 script)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_DERBY_URL          Use specific URL to JavaDB, e.g.
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 "jdbc:derby://localhost:1528/cachedb;create=true"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 (default port is 1527)
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor#   - OPENGROK_TAG                Enable parsing of revision tags into the History
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 view
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor#   - READ_XML_CONFIGURATION      file with read only configuration
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 - temporary workaround for bug # 327
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_FLUSH_RAM_BUFFER_SIZE="-m 16" - set RAM buffer size for flushing,
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 default is 16MB per thread, you might try to
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 increase it to 256MB, but do increase JVM to
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 4/8/16GB ! Lucene defaults to 8 threads.
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 Increase JVM memory as noted using JAVA_OPTS
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_LOGGER_CONFIG_PATH Set path to custom logging.properties file.
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_SUBVERSION_USERNAME name of the user that should be used for
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 fetching the history from subversion
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   - OPENGROK_SUBVERSION_PASSWORD password of the user that should be used for
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#                                 fetching the history from subversion
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock# Notes:
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#   (*) Any Non-Empty String will enable these options
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor#
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor#
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor# Copyright (c) 2008, 2016, Oracle and/or its affiliates. All rights reserved.
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor#
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor#
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor# Print usage to stdout and exit.
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor#
3c112a2b34403220c06c3e2fcac403358cfba168Eric TaylorUsage()
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor{
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    progname=`basename $0`
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    exec >&2
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    echo ""
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    echo "Usage: ${progname} <deploy|derby|update|updateQuietly|usage|help>"
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    echo "       ${progname} index [<directory>]"
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    echo "       ${progname} indexpart <src_root> <directory1> [..]"
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    echo "       ${progname} clearHistory <src_root> <repository_name>"
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    echo ""
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    echo "  Optional environment variables:"
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    echo "    OPENGROK_CONFIGURATION - location of your configuration"
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    echo "      e.g. $ OPENGROK_CONFIGURATION=/var/opengrok/myog.conf ${0} ... "
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    echo ""
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    echo "    See the code for more information on configuration options /" \
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor        "variables"
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    echo ""
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    exit 1
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor}
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor#
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor# Runtime Configuration
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor#
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylorif [ -x "/bin/uname" ]; then
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    OS_NAME="`/bin/uname -s`"
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    OS_VERSION="`/bin/uname -r`"
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylorelif [ -x "/usr/bin/uname" ]; then
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    OS_NAME="`/usr/bin/uname -s`"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    OS_VERSION="`/usr/bin/uname -r`"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrockelse
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    echo "Cannot determine operating system version"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    exit 1
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrockfi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock# TODO: Handle symlinks correctly (especially in ${0})
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrockSCRIPT_DIRECTORY=`dirname "${0}"`
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrockSCRIPT_DIRECTORY=`cd "${SCRIPT_DIRECTORY}"; pwd`
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock# Default Instance Configuration
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrockDefaultInstanceConfiguration()
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock{
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # Use the built-in defaults. This section can be copied to its own
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # file and tailored to your local requirements. Then simply set
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # OPENGROK_CONFIGURATION=/path/to/your/configuration, before using
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # this wrapper. It will save you hand editing in your settings
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # on each new release. A sample cron(1M) entry might look like:
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # 15 0 * * * OPENGROK_CONFIGURATION=/pkgs/etc/OpenGrok.sh /pkgs/sbin/OpenGrok updateQuietly
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
bf82a41b568b2bd31bf9814587eb25ee2e7b05ffeschrock    # Note: It is not really possible to ever provided defaults for
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # these values which will run in every UNIX-like environment.
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # So I have provided a set which are functional for a given
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # environment on which you can based you own configuration.
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # This has been updated to support more environment variables and
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # operating systems, if you have any reasonably generic
bf82a41b568b2bd31bf9814587eb25ee2e7b05ffeschrock    # improvements please feel free to submit a patch.
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    OPENGROK_INSTANCE_BASE="${OPENGROK_INSTANCE_BASE:-/var/opengrok}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    LOGGER_CONFIG_FILE="logging.properties"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -z "${OPENGROK_DISTRIBUTION_BASE}" ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        if [ -d "${SCRIPT_DIRECTORY}/dist" -a \
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock             -f "${SCRIPT_DIRECTORY}/dist/opengrok.jar" -a \
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock             -f "${SCRIPT_DIRECTORY}/dist/source.war" \
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock           ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            # Handle Developer Build Environments
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            OPENGROK_DISTRIBUTION_BASE="${SCRIPT_DIRECTORY}/dist"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            LOGGER_CONF_SOURCE="${SCRIPT_DIRECTORY}/${LOGGER_CONFIG_FILE}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        else
bf82a41b568b2bd31bf9814587eb25ee2e7b05ffeschrock            # Handle Binary Distributions
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            OPENGROK_DISTRIBUTION_BASE="${SCRIPT_DIRECTORY}/../lib"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            LOGGER_CONF_SOURCE="${OPENGROK_DISTRIBUTION_BASE}/../doc/"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            LOGGER_CONF_SOURCE="${LOGGER_CONF_SOURCE}${LOGGER_CONFIG_FILE}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # REQUIRED: Source Code/Repository Root
990b4856d0eaada6f8140335733a1b1771ed2746lling    #           (your source code or the root of all repositories)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    SRC_ROOT="${OPENGROK_INSTANCE_BASE}/src"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # REQUIRED: OpenGrok Generate Data Root
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #           (for Lucene index and hypertext cross-references)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #           This area is rebuilt by "update" / "updateQuietly"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    DATA_ROOT="${OPENGROK_INSTANCE_BASE}/data"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # OPTIONAL: User Provided Source Path to Description Mapping
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #       (Tab Separated Value)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #           (The user maintained source of the generated EftarFile file)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    PATH_DESC="${OPENGROK_INSTANCE_BASE}/etc/paths.tsv"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # REQUIRED: XML Configuration
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #           (the configuration used by Web/GUI interfaces)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    XML_CONFIGURATION="${OPENGROK_INSTANCE_BASE}/etc/configuration.xml"
c5904d138f3bdf0762dbf452a43d5a5c387ea6a8eschrock
c5904d138f3bdf0762dbf452a43d5a5c387ea6a8eschrock    # OPTIONAL: read only XML config, if it exists, it will be read
c5904d138f3bdf0762dbf452a43d5a5c387ea6a8eschrock    READ_XML_CONFIGURATION="${READ_XML_CONFIGURATION:-}"
c5904d138f3bdf0762dbf452a43d5a5c387ea6a8eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -f "${READ_XML_CONFIGURATION}" ] ; then
c5904d138f3bdf0762dbf452a43d5a5c387ea6a8eschrock        READ_XML_CONF="-R ${READ_XML_CONFIGURATION}"
c5904d138f3bdf0762dbf452a43d5a5c387ea6a8eschrock    fi
c5904d138f3bdf0762dbf452a43d5a5c387ea6a8eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # REQUIRED: Logger Configuration
c5904d138f3bdf0762dbf452a43d5a5c387ea6a8eschrock    if [ -n "${OPENGROK_LOGGER_CONFIG_PATH}" ]; then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        if [ ! -f "${OPENGROK_LOGGER_CONFIG_PATH}" ]; then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        echo "File ${OPENGROK_LOGGER_CONFIG_PATH} does not exist"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        exit 1
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        LOGGER_CONFIG_PATH=${OPENGROK_LOGGER_CONFIG_PATH}
c5904d138f3bdf0762dbf452a43d5a5c387ea6a8eschrock    else
c5904d138f3bdf0762dbf452a43d5a5c387ea6a8eschrock        LOGGER_CONFIG_PATH="${OPENGROK_INSTANCE_BASE}/${LOGGER_CONFIG_FILE}"
c5904d138f3bdf0762dbf452a43d5a5c387ea6a8eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    LOGGER_PROPERTIES="-Djava.util.logging.config.file=${LOGGER_CONFIG_PATH}"
c5904d138f3bdf0762dbf452a43d5a5c387ea6a8eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # REQUIRED: Java Archive of OpenGrok (Installation Location)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    OPENGROK_JAR="${OPENGROK_DISTRIBUTION_BASE}/opengrok.jar"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # REQUIRED(deploy): Web Archive of OpenGrok (Distribution Location)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #           (user building from source code will find this and other key
bf82a41b568b2bd31bf9814587eb25ee2e7b05ffeschrock    #            files in the "dist" directory after the build is completed)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    OPENGROK_DIST_WAR="${OPENGROK_DISTRIBUTION_BASE}/source.war"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # REQUIRED: Exuberant CTags (http://ctags.sf.net)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    EXUBERANT_CTAGS="${EXUBERANT_CTAGS:-`FindExuberantCTags`}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # OPTIONAL: supply extra command line options to CTags program
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -n "${OPENGROK_CTAGS_OPTIONS_FILE}" ]; then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        CTAGS_OPTIONS_FILE="${OPENGROK_CTAGS_OPTIONS_FILE}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    elif [ -r "${OPENGROK_INSTANCE_BASE}/etc/ctags.config" ]; then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        CTAGS_OPTIONS_FILE="${OPENGROK_INSTANCE_BASE}/etc/ctags.config"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
bf82a41b568b2bd31bf9814587eb25ee2e7b05ffeschrock
bf82a41b568b2bd31bf9814587eb25ee2e7b05ffeschrock    # REQUIRED: Java Home
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    JAVA_HOME="${JAVA_HOME:-`FindJavaHome`}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    export JAVA_HOME
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # REQUIRED: Java Virtual Machine
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    JAVA="${JAVA:-$JAVA_HOME/bin/java}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # DEVELOPMENT: Debug option, if enabled current indexer will listen on the
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # port 8010 until a debugger connects
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #JAVA_DEBUG="-agentlib:jdwp=transport=dt_socket"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #JAVA_DEBUG="$JAVA_DEBUG,server=y,address=8010,suspend=y"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # OPTIONAL: Ignore these patterns as names of files or directories
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #IGNORE_PATTERNS="-i dummy"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # To ignore skipping just the history cache creation for a particular
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # directory and all of it's subdirectories, touch an empty
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # .opengrok_skip_history file at the root of that directory
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # OPTIONAL: Enable Projects
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #           (Every directory in SRC_ROOT is considered a separate project)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    OPENGROK_ENABLE_PROJECTS="${OPENGROK_ENABLE_PROJECTS:-true}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    case $OPENGROK_ENABLE_PROJECTS in
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        true) ENABLE_PROJECTS="-P" ;;
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        false) ENABLE_PROJECTS="" ;;
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        *) ENABLE_PROJECTS="-P" ;;
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    esac
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # OPTIONAL: Scanning Options (for Mercurial repositories)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    SCAN_FOR_REPOSITORY="-S"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -n "${OPENGROK_SCAN_REPOS}" ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        SCAN_FOR_REPOSITORY=""
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # OPTIONAL: Disable remote repository support (CVS or SVN) [on by default]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    GENERATE_HISTORY="-r on"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -n "${OPENGROK_GENERATE_HISTORY}" ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    then
b01c3b58f7eb7fb570f606f96f130fb9b2018b49eschrock        GENERATE_HISTORY="-r ${OPENGROK_GENERATE_HISTORY}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ "$OPENGROK_GENERATE_HISTORY" != "off" ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        GENERATE_HISTORY="${GENERATE_HISTORY} -H"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # OPTIONAL: override depth of scanning for repositories
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -n "${OPENGROK_SCAN_DEPTH}" ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        SCAN_DEPTH="-z${OPENGROK_SCAN_DEPTH}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # OPTIONAL: Allow Leading Wildcard Searches
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #           (default: on)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    LEADING_WILDCARD="-a on"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -n "${OPENGROK_WPREFIX}" ]
b01c3b58f7eb7fb570f606f96f130fb9b2018b49eschrock    then
b01c3b58f7eb7fb570f606f96f130fb9b2018b49eschrock        LEADING_WILDCARD=""
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # OPTIONAL: Web Site Look & Feel
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #           (Options: default, offwhite and polished.
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #            Note the quoting requirements)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #SKIN='-L default'
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # OPTIONAL: Configuration Address (host:port)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #           (conf/web.xml default is localhost:2424)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    WEBAPP_CONFIG=""
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -n "${OPENGROK_WEBAPP_CFGADDR}" ]; then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        WEBAPP_CONFIG_ADDRESS=${OPENGROK_WEBAPP_CFGADDR}
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ "${OPENGROK_WEBAPP_CFGADDR}" = "none" ]; then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        WEBAPP_CONFIG_ADDRESS=""
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    else
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        WEBAPP_CONFIG_ADDRESS="localhost:2424"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -n "${WEBAPP_CONFIG_ADDRESS}" ]; then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        WEBAPP_CONFIG="-U ${WEBAPP_CONFIG_ADDRESS}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    # OPTIONAL: Context URL of the OpenGrok webapp
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    #           (default is /source)
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    WEBAPP_CONTEXT=""
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    if [ -n "${OPENGROK_WEBAPP_CONTEXT}" ]; then
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor        WEBAPP_CONTEXT="-w ${OPENGROK_WEBAPP_CONTEXT}"
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    fi
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    # OPTIONAL: JVM Options
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    JAVA_OPTS="${JAVA_OPTS:--Xmx2048m}"
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # OPTIONAL: Full Path to History Utilities
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    HG="`Which hg`"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    CVS="`Which cvs`"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    SVN="`Which svn`"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    SCCS="`Which sccs`"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    CLEARCASE="`Which cleartool`"
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    GIT="`Which git`"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    P4="`Which p4`"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    MTN="`Which mtn`"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    BZR="`Which bzr`"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # OPTIONAL: Override Built-in Properties
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # Assumption: We should not set properties to the empty string
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    PROPERTIES="\
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock${HG:+-Dorg.opensolaris.opengrok.history.Mercurial=$HG} \
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock${CVS:+-Dorg.opensolaris.opengrok.history.cvs=$CVS} \
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock${SVN:+-Dorg.opensolaris.opengrok.history.Subversion=$SVN} \
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor${SCCS:+-Dorg.opensolaris.opengrok.history.SCCS=$SCCS} \
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor${CLEARCASE:+-Dorg.opensolaris.opengrok.history.ClearCase=$CLEARCASE} \
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor${GIT:+-Dorg.opensolaris.opengrok.history.git=$GIT} \
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor${P4:+-Dorg.opensolaris.opengrok.history.Perforce=$P4} \
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor${MTN:+-Dorg.opensolaris.opengrok.history.Monotone=$MTN} \
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor${BZR:+-Dorg.opensolaris.opengrok.history.Bazaar=$BZR} \
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor"
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor    # OPTIONAL: Store The History Cache in Java DB (derby),
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor    #           instead of file system (in gzipped xml files).
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor    #
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor    # Requirements:
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor    #   - derbyclient.jar      - See README.txt for more details
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    #   - Running Derby Server - Defaults to localhost:1527
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    #
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -n "${OPENGROK_DERBY}" ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        DERBY_OPTIONS="-D"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -n "${OPENGROK_DERBY_URL}" ]; then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        DERBY_OPTIONS="${DERBY_OPTIONS} -u ${OPENGROK_DERBY_URL}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # OPTIONAL: Show revision tags in History view.
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #       Turn this off if you want to increase indexing performance a bit
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #           (default: off)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -n "${OPENGROK_TAG}" ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        HISTORY_TAGS="-G"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # DELIVERED: An update program for EftarFile
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # Usage: <class> inputFile [inputFile ...] outputFile
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # EftarFile == An Extremely Fast Tagged Attribute Read-only File System
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    EFTAR_UPDATE="org.opensolaris.opengrok.web.EftarFile"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # HARDCODED: Generated EftarFile (See web/*.jsp)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    EFTAR_OUTPUT_FILE="${DATA_ROOT}/index/dtags.eftar"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # Be Quiet? (set indirectly by command line arguments in the main program)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #QUIET=""
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # or alternatively, Be Verbose!
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #VERBOSE="-v"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -n "${OPENGROK_VERBOSE}" ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        VERBOSE="-v"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        QUIET=""
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -n "${OPENGROK_PROGRESS}" ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        PROGRESS="-C"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock}
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock# Helper Functions - Logging
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock# In general, non-interactive use like cron jobs and automated
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock# installation environments should not generate unnecessary
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock# progress information or warnings, as usage and configuration
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock# will have generally been debugged prior to automation.
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrockProgress()
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock{
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -z "${OPENGROK_NON_INTERACTIVE}" ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        echo "${@}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock}
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrockWarning()
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock{
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -z "${OPENGROK_NON_INTERACTIVE}" ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        echo "WARNING: ${@}" 1>&2
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock}
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrockError()
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock{
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    echo "ERROR: ${@}" 1>&2
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock}
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrockFatalError()
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock{
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    exec >&2
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    echo ""
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    echo "FATAL ERROR: ${@} - Aborting!"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    echo ""
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    ${DO} exit 2
25085d90140a7be7bb8524085d401fac7ca23cfbEric Taylor}
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock# Helper Functions - Autodetection of Runtime Environment
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock#
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrockWhich()
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock{
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    path="`which ${1} 2>/dev/null`"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -x "${path}" ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        echo "${path}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock}
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrockLocateBinary() {
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    for f in $@
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    do
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    file=`which "$f" 2>/dev/null | grep -v '^no '`
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if test -n "$file" -a -x "$file"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        echo $file
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        return 0
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    done
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    echo ""
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    return 1
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock}
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrockFindExuberantCTags()
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock{
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # Search for Exuberant ctags intelligently, skipping
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # over other ctags implementations.
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    #
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    binary=""
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    found=0
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    for program in ctags-exuberant exctags ctags; do
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    for path in `echo $PATH | tr ':' '\n'`; do
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        if [ -x "$path/$program" ]; then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            binary="$path/$program"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            # Verify that this really is Exuberant Ctags.
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            $binary --version 2>&1 | grep "Exuberant Ctags" > /dev/null
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            if [ $? -eq 0 ]; then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock                found=1
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock                break
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    done
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ $found -eq 1 ]; then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        break;
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    done
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ $found -ne 1 ]; then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        Error "Unable to determine Exuberant CTags command name" \
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            "for ${OS_NAME} ${OS_VERSION}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        return
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    echo ${binary}
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock}
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrockFindJavaHome()
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock{
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    javaHome=""
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    case "${OS_NAME}:${OS_VERSION}" in
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    SunOS:5.10) javaHome="/usr/jdk/instances/jdk1.7.0" ;;
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    SunOS:5.11) javaHome="/usr/jdk/latest"             ;;
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    SunOS:5.12) javaHome="/usr/jdk/latest"             ;;
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    Darwin:*)    javaHome=`/usr/libexec/java_home`     ;;
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    Linux:*)
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            if [ -f /etc/alternatives/java ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock               javaHome=`ls -l /etc/alternatives/java | cut -f 2 -d \> `
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock               javaHome=`dirname $javaHome`
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock               javaHome=`dirname $javaHome`
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            ;;
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    esac
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -z "${javaHome}" ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        Error "Unable to determine Java 7 Home" \
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock              "for ${OS_NAME} ${OS_VERSION}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        return
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    if [ ! -d "${javaHome}" ]
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    then
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor        Error "Missing Java Home ${javaHome}"
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor        return
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    fi
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    echo "${javaHome}"
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor}
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor
b98131cff90a91303826565dacf89c46a422e6c5Eric TaylorFindApplicationServerType()
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor{
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    # Use this function to determine which environment the deploy the
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    # web application function into. Some users (especially
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    # developers) will have many deployment environments or will wish
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    # to specify directly the application server to deploy to.
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    # Either use the environment variable OPENGROK_APP_SERVER or
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    # reimplement this function in your configuration file (as
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    # specified by OPENGROK_CONFIGURATION)
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    if [ -n "${OPENGROK_APP_SERVER}" ]
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    then
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor        echo "${OPENGROK_APP_SERVER}"
4263d13f00c9691fa14620eff82abef795be0693George Wilson        return
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    fi
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor
4263d13f00c9691fa14620eff82abef795be0693George Wilson    # This implementation favours Tomcat, but needs a lot of work,
4263d13f00c9691fa14620eff82abef795be0693George Wilson    # especially if Glassfish is perferrerd or it is under the control
4263d13f00c9691fa14620eff82abef795be0693George Wilson    # of SMF (Service Management Facility)
4263d13f00c9691fa14620eff82abef795be0693George Wilson
4263d13f00c9691fa14620eff82abef795be0693George Wilson    # Maybe a better implementation would be to call Application
4263d13f00c9691fa14620eff82abef795be0693George Wilson    # Server specific WAR Directory and see if they exist.
4263d13f00c9691fa14620eff82abef795be0693George Wilson
4263d13f00c9691fa14620eff82abef795be0693George Wilson    if [    -d "/var/tomcat8/webapps"        \
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor         -o -d "/var/lib/tomcat8/webapps"    \
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor       ]
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    then
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor        echo "Tomcat"
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor        return
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    fi
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    if [ -x "/etc/init.d/appserv" -a -d "/var/appserver/domains" ]
25085d90140a7be7bb8524085d401fac7ca23cfbEric Taylor    then
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor        echo "Glassfish"
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor        return
25085d90140a7be7bb8524085d401fac7ca23cfbEric Taylor    fi
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    if [ -d "/etc/resin" -o -d "/usr/local/share/resin" ]
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    then
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor        echo "Resin"
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor        return
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    fi
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    # Assume Tomcat
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    echo "Tomcat"
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor}
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor
b98131cff90a91303826565dacf89c46a422e6c5Eric TaylorDetermineWarDirectoryTomcat()
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor{
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    if [ -n "${OPENGROK_WAR_TARGET_TOMCAT}" ]
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    then
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor        echo "${OPENGROK_WAR_TARGET_TOMCAT}"
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor        return
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    elif [ -n "${OPENGROK_WAR_TARGET}" ]
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    then
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor        echo "${OPENGROK_WAR_TARGET}"
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor        return
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    fi
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    for prefix in               \
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor        ${OPENGROK_TOMCAT_BASE} \
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor        /var/lib/tomcat8    \
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor        /var/tomcat8
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    do
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor        if [ -d "${prefix}/webapps" ]
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor        then
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor            echo "${prefix}/webapps"
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor            return
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    done
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock}
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrockDetermineWarDirectoryGlassfish()
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock{
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -n "${OPENGROK_WAR_TARGET_GLASSFISH}" ]
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        echo "${OPENGROK_WAR_TARGET_GLASSFISH}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        return
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    elif [ -n "${OPENGROK_WAR_TARGET}" ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        echo "${OPENGROK_WAR_TARGET}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        return
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    for prefix in                       \
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        ${OPENGROK_GLASSFISH_BASE}      \
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        /var/appserver
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    do
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        if [ -d "${prefix}/domains" ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            if [ -z "${domainDirectory}" ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock                domainDirectory="${prefix}/domains"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    done
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -z "${domainDirectory}" ]
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    then
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor        return
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # User Specified Domain
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -n "${OPENGROK_GLASSFISH_DOMAIN}" ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        directory="${domainDirectory}/${OPENGROK_GLASSFISH_DOMAIN}/autodeploy"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        if [ ! -d "${directory}" ]
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor        then
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor            FatalError "Missing Specified Glassfish Domain " \
b98131cff90a91303826565dacf89c46a422e6c5Eric Taylor            "${OPENGROK_GLASSFISH_DOMAIN}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        echo "${directory}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        return
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    # Arbitrary Domain Selection
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    firstDomain=`ls -1 ${domainDirectory} | head -1`
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor    if [ -z "${firstDomain}" ]
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor    then
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor        FatalError "Failed to dynamically determine Glassfish Domain from " \
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor        "${domainDirectory}"
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor    fi
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor    echo "${domainDirectory}/${firstDomain}/autodeploy"
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor}
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric TaylorDetermineWarDirectoryResin()
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor{
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    if [ -n "${OPENGROK_WAR_TARGET_RESIN}" ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        echo "${OPENGROK_WAR_TARGET_RESIN}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        return
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    elif [ -n "${OPENGROK_WAR_TARGET}" ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        echo "${OPENGROK_WAR_TARGET}"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        return
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    fi
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor    for prefix in               \
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor        ${OPENGROK_RESIN_BASE} \
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor        /var/resin  \
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor        /opt/resin
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    do
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor        if [ -d "${prefix}/webapps" ]
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor        then
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            echo "${prefix}/webapps"
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock            return
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock        fi
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    done
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock}
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor#
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor# Implementation
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor#
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor# The variable "DO" can usefully be set to "echo" to aid in script debugging
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor#
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor
3c112a2b34403220c06c3e2fcac403358cfba168Eric TaylorLoadStandardEnvironment()
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor{
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    # Setup a standard execution environment (if required)
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor    cronexec="/pkgs/sbin/CronExecutionEnvironment.sh"
37e3a0d8ec40beeef3861086ca78f757dd47eabdEric Taylor    OPENGROK_STANDARD_ENV="${OPENGROK_STANDARD_ENV:-$cronexec}"
3c112a2b34403220c06c3e2fcac403358cfba168Eric Taylor
25085d90140a7be7bb8524085d401fac7ca23cfbEric Taylor    if [ -f "${OPENGROK_STANDARD_ENV}" ]
3d7072f8bd27709dba14f6fe336f149d25d9e207eschrock    then
        Progress "Loading ${OPENGROK_STANDARD_ENV} ..."
        . "${OPENGROK_STANDARD_ENV}"
    fi
}

#
# Load custom configuration and then fill remaining stuff with defaults.
#
LoadInstanceConfiguration()
{
    #
    # Note: As all functions have been defined by the time this routine
    # is called, your configuration can, if desired, override functions
    # in addition to setting the variables mentioned in the function
    # DefaultInstanceConfiguration(), this maybe useful to override
    # functionality used to determine the default deployment environment
    # find dependencies or validate the configuration, for example.
    #
    if [ -n "${OPENGROK_CONFIGURATION}" -a -f "${OPENGROK_CONFIGURATION}" ]
    then
        # Load the Local OpenGrok Configuration Environment
        Progress "Loading ${OPENGROK_CONFIGURATION} ..."
        . "${OPENGROK_CONFIGURATION}"
    fi
    Progress "Loading the default instance configuration ..."
    DefaultInstanceConfiguration
}

ValidateConfiguration()
{
    if [ ! -x "${EXUBERANT_CTAGS}" ]
    then
        FatalError "Missing Dependent Application - Exuberant CTags"
    fi

    if [ ! -d "${SRC_ROOT}" ]
    then
        FatalError "OpenGrok Source Path ${SRC_ROOT} doesn't exist"
    fi

    if [ -n "${QUIET}" -a -n "${VERBOSE}" ]
    then
        Warning "Both Quiet and Verbose Mode Enabled - Choosing Verbose"
        QUIET=""
        VERBOSE="-v"
    fi

    if [ -n "${OPENGROK_DERBY}" ]
    then
        if [ "`uname -s`" = "SunOS" -a -d /opt/SUNWjavadb -a -d /usr/opengrok ];
    then
        if [ -d "/var/tomcat8" -a \
            ! -r "/var/tomcat8/webapps/source/WEB-INF/lib/derbyclient.jar" ];
        then
            FatalError "JavaDB on but no derbyclient.jar under" \
            "/var/tomcat8/webapps/source/WEB-INF/lib"
        fi
        if [ ! -r "/usr/opengrok/lib/derbyclient.jar" ]; then
            FatalError "JavaDB on but no derbyclient.jar under" \
            "/usr/opengrok/lib"
        fi
    else
            Warning "CHECK: derbyclient.jar needs to be in where the rest of " \
            "opengrok used jars are and in unpacked source.war in " \
        "WEB-INF/lib !"
    fi
    fi
}

CreateRuntimeRequirements()
{
    if [ ! -d "${DATA_ROOT}" ]
    then
        Warning  "OpenGrok generated data path ${DATA_ROOT} doesn't exist"
        Progress "  Attempting to create generated data directory ... "
        ${DO} mkdir -p "${DATA_ROOT}"
    fi
    if [ ! -d "${DATA_ROOT}" ]
    then
        FatalError "OpenGrok data path ${DATA_ROOT} doesn't exist"
    fi

    if [ ! -d "${OPENGROK_INSTANCE_BASE}/etc" ]
    then
        Warning  "OpenGrok generated etc path ${OPENGROK_INSTANCE_BASE}/etc " \
        "doesn't exist"
        Progress "  Attempting to create generated etc directory ... "
        ${DO} mkdir -p "${OPENGROK_INSTANCE_BASE}/etc"
    fi
    if [ ! -d "${OPENGROK_INSTANCE_BASE}/etc" ]
    then
        FatalError "OpenGrok etc path ${OPENGROK_INSTANCE_BASE}/etc " \
        "doesn't exist"
    fi

    if [ -n "${LOGGER_CONFIG_PATH}" -a ! -f "${LOGGER_CONFIG_PATH}" ]
    then
        Progress "  Creating default ${LOGGER_CONFIG_PATH} ... "
        if [ ! -f "${LOGGER_CONF_SOURCE}" ]
        then
            Warning "Can't find distribution logging configuration"   \
                      "(${LOGGER_CONF_SOURCE}) to install as default" \
                      "logging configuration (${LOGGER_CONFIG_PATH})"
        else
            filename="opengrok%g.%u.log"
            fullpath="${OPENGROK_INSTANCE_BASE}/log/opengrok%g.%u.log"
            ${DO} grep -v java.util.logging.FileHandler.pattern \
             "${LOGGER_CONF_SOURCE}" > "${LOGGER_CONFIG_PATH}"
            ${DO} grep java.util.logging.FileHandler.pattern \
             "${LOGGER_CONF_SOURCE}" | \
         sed "s|$filename|$fullpath|g" >> "${LOGGER_CONFIG_PATH}"
        if [ ! -d ${OPENGROK_INSTANCE_BASE}/log ]
            then
                 ${DO} mkdir ${OPENGROK_INSTANCE_BASE}/log
            fi
        fi
    fi

    if [ -n "${OPENGROK_DERBY}" ]
    then
        if [ ! -d "${OPENGROK_INSTANCE_BASE}/derby" ]
        then
            Warning "OpenGrok generated derby path " \
            "${OPENGROK_INSTANCE_BASE}/derby doesn't exist"
            Progress "  Attempting to create generated derby directory ... "
            ${DO} mkdir -p ${OPENGROK_INSTANCE_BASE}/derby
        fi
    fi
}

MinimalInvocation()
{
    ${DO} ${JAVA} ${JAVA_OPTS} ${PROPERTIES}                        \
        ${JAVA_DEBUG}                                               \
        ${LOGGER_PROPERTIES}                                        \
        -jar "${OPENGROK_JAR}"                                      \
        ${VERBOSE} ${QUIET}                                         \
        "${@}"
}

CommonInvocation()
{
    MinimalInvocation                           \
        ${IGNORE_PATTERNS}                                  \
        ${DERBY_OPTIONS}                        \
        ${HISTORY_TAGS}                         \
        ${GENERATE_HISTORY}                             \
        ${SCAN_DEPTH}                                               \
        ${PROGRESS}                                                 \
        ${EXUBERANT_CTAGS:+-c} ${EXUBERANT_CTAGS}                   \
        ${CTAGS_OPTIONS_FILE:+-o} ${CTAGS_OPTIONS_FILE}             \
        ${OPENGROK_FLUSH_RAM_BUFFER_SIZE} ${SKIN} ${LEADING_WILDCARD}   \
        ${READ_XML_CONF}                                            \
        "${@}"
}

StdInvocation()
{
    CommonInvocation        \
        -W ${XML_CONFIGURATION} \
    ${SCAN_FOR_REPOSITORY}  \
    ${ENABLE_PROJECTS}  \
        ${WEBAPP_CONFIG}    \
        ${WEBAPP_CONTEXT}   \
        -s "${SRC_ROOT}"    \
    -d "${DATA_ROOT}"   \
    "${@}"
}

UpdateGeneratedData()
{
    StdInvocation
}

UpdateDataPartial()
{
    extra_args=""
    for arg in "$@"; do
        if [ -n "$extra_args" ]; then
            extra_args="$extra_args -h $arg"
    else
        extra_args="-h $arg"
    fi
    done
    CommonInvocation $extra_args "$@"
}

UpdateDescriptionCache()
{
    # OPTIONAL : Update the EftarFile data

    if [ -n "${PATH_DESC}" -a -s "${PATH_DESC}" ]
    then
        ${DO} ${JAVA} -classpath "${OPENGROK_JAR}"      \
            ${EFTAR_UPDATE} "${PATH_DESC}" "${EFTAR_OUTPUT_FILE}"
    fi
}

OpenGrokUsage()
{
    echo "Options for opengrok.jar:" 1>&2
    ${DO} ${JAVA} ${JAVA_OPTS} -jar "${OPENGROK_JAR}" '-?'
}

DeployWar()
{
    applicationServer="`FindApplicationServerType`"

    case "${applicationServer}" in

        Tomcat)    warTarget="`DetermineWarDirectoryTomcat`"    ;;
        Glassfish) warTarget="`DetermineWarDirectoryGlassfish`" ;;
        Resin)     warTarget="`DetermineWarDirectoryResin`" ;;

        *) FatalError "Unsupported Application Server ${applicationServer}" ;;

    esac

    if [ -z "${warTarget}" ]
    then
        FatalError "Unable to determine Deployment Directory for " \
        "${applicationServer}"
    fi

    if [ ! -f "${OPENGROK_DIST_WAR}" ]
    then
        FatalError "Missing Web Application Archive ${OPENGROK_DIST_WAR}"
    fi

    if [ ! -d "${warTarget}" ]
    then
        FatalError "Missing Deployment Directory ${warTarget}"
    fi

    Progress "Installing ${OPENGROK_DIST_WAR} to ${warTarget} ..."
    ${DO} cp -p "${OPENGROK_DIST_WAR}" "${warTarget}/"
    if [ $? != 0 ]
    then
        FatalError "Web Application Installation FAILED"
    fi

    # Fix for opengrok issue https://github.com/OpenGrok/OpenGrok/issues/863
    # If user does not use default OPENGROK_INSTANCE_BASE or default
    # WEBAPP_CONFIG_ADDRESS, then attempt to extract WEB-INF/web.xml from
    # source.war using jar or zip utility, update the hardcoded values and
    # then update source.war with the new WEB-INF/web.xml

    if [ "${OPENGROK_INSTANCE_BASE}" != '/var/opengrok' ] || [ "${WEBAPP_CONFIG_ADDRESS}" != 'localhost:2424' ]
    then
        EXTRACT_COMMAND=""
        COMPRESS_COMMAND=""
        if [ -n "`Which jar`" ]
        then
            EXTRACT_COMMAND="jar -xf"
            COMPRESS_COMMAND="jar -uf"
        elif [ -n "`Which zip`" ] && [ -n "`Which unzip`" ]
        then
            EXTRACT_COMMAND="unzip"
            COMPRESS_COMMAND="zip -rf"
        fi

        if [ -n "${EXTRACT_COMMAND}" ]
        then
            cd "${warTarget}"
            eval "${EXTRACT_COMMAND} ${warTarget}/source.war WEB-INF/web.xml"
            if [ "${OPENGROK_INSTANCE_BASE}" != '/var/opengrok' ]
            then
                sed -i -e 's:/var/opengrok/etc/configuration.xml:'"$XML_CONFIGURATION"':g' "${warTarget}/WEB-INF/web.xml"
            fi
            if [ "${WEBAPP_CONFIG_ADDRESS}" != 'localhost:2424' ]
            then
                sed -i -e 's/localhost:2424/'"$WEBAPP_CONFIG_ADDRESS"'/g' "${warTarget}/WEB-INF/web.xml"
            fi
            eval "${COMPRESS_COMMAND} ${warTarget}/source.war WEB-INF/web.xml"
            rm -rf "${warTarget}/WEB-INF"
        fi
    fi

    Progress
    Progress "Start your application server (${applicationServer}), " \
        "if it is not already"
    Progress "running, or wait until it loads the just installed web " \
        "application."
    Progress
    Progress "OpenGrok should be available on <HOST>:<PORT>/source"
    Progress "  where HOST and PORT are configured in ${applicationServer}."
    Progress
}

DerbyServer()
{
    case "${OS_NAME}:${OS_VERSION}" in
        SunOS:5.10) Error "unsupported OS" ;;
        SunOS:5.11)
                    /sbin/svcadm enable javadb
                     ;;
        SunOS:5.12)
                    echo "Below might need your socket permission setup"
                    echo "see JDK1.7_51 release notes"
                    set -x
                    mkdir -p $DATA_ROOT/derby
                    java -Dderby.system.home=$DATA_ROOT/derby \
                -jar /usr/jdk/instances/jdk1.7.0/db/lib/derbynet.jar start
                     ;;
        Linux:*)
                    mkdir -p $DATA_ROOT/derby
                    java -Dderby.system.home=$DATA_ROOT/derby \
                -jar /usr/lib/jvm/java-6-sun/db/lib/derbynet.jar start
                     ;;
        *)          Error "unsupported OS" ;;
    esac
}

#
# Clear history index for given project.
#
ClearHistory()
{
    Progress "Removing history index data for repository ${1}"
    MinimalInvocation -s "${SRC_ROOT}" -d "${DATA_ROOT}" -k "${1}"
}

#
# Main Program
#

if [ $# -eq 0 ]
then
    Usage
fi

LoadStandardEnvironment

LoadInstanceConfiguration

case "${1}" in
    deploy)
        DeployWar
        ;;

    derby)
        ValidateConfiguration
        CreateRuntimeRequirements
        DerbyServer
        ;;

    update)
        ValidateConfiguration
        CreateRuntimeRequirements
        UpdateGeneratedData
        UpdateDescriptionCache
        ;;

    updateQuietly)
        ValidateConfiguration
        CreateRuntimeRequirements
        QUIET="-q"
        VERBOSE=""
        UpdateGeneratedData
        UpdateDescriptionCache
        ;;

    index)
    if [ $# -gt 2 ]
    then
        Usage
    fi
        if [ -n "${2}" ]
        then
            SRC_ROOT="${2}"
        fi
        ValidateConfiguration
        CreateRuntimeRequirements
        UpdateGeneratedData
        UpdateDescriptionCache
        ;;

    indexpart)
        if [ $# -ne 3 ]
        then
            Usage
        fi
        SRC_ROOT="${2}"
        shift 2
        ValidateConfiguration
        CreateRuntimeRequirements
        UpdateDataPartial $@
        ;;

    clearHistory)
        if [ $# -ne 3 ]
        then
            Usage
        fi
        SRC_ROOT="${2}"
        shift 2
    if [ -z "${1}" ]; then
        Usage
    fi
    ClearHistory "${1}"
    ;;

    usage|help)
        OpenGrokUsage
        Usage
        ;;
    *)
        Usage
        ;;
esac