OpenGrok revision 857
787N/A# OpenGrok Wrapper (initial setup and cron job updating) 789N/A# Supported Operating Systems: 789N/A# - Solaris 10 (SunOS 5.10) 789N/A# - OpenSolaris (SunOS 5.11) 873N/A# Supported Deployment Engines 294N/A# Supported Environment Variables : 873N/A# - OPENGROK_NON_INTERACTIVE Suppress Progress and Warnings Messages 873N/A# - OPENGROK_STANDARD_ENV Run Time Shell Environment (Shell Script) 789N/A# - OPENGROK_CONFIGURATION User Configuration (Shell Script) 789N/A# Supported Environment Variables for configuring the default setup 873N/A# - OPENGROK_DISTRIBUTION_BASE Base Directory of the OpenGrok Distribution 789N/A# - OPENGROK_INSTANCE_BASE Base Directory of the OpenGrok User Data Area 789N/A# - EXUBERANT_CTAGS Full Path to Exuberant CTags 789N/A# - JAVA_HOME Full Path to Java Installation Root 789N/A# - OPENGROK_APP_SERVER Application Server ("Tomcat" or "Glassfish") 789N/A# - OPENGROK_WAR_TARGET_TOMCAT Tomcat Specific WAR Target Directory 789N/A# - OPENGROK_WAR_TARGET_GLASSFISH Glassfish Specific WAR Target Directory 789N/A# - OPENGROK_WAR_TARGET Fallback WAR Target Directory 789N/A# - OPENGROK_TOMCAT_BASE Base Directory for Tomcat (contains webapps) 789N/A# - OPENGROK_GLASSFISH_BASE Base Directory for Glassfish (contains domains) 789N/A# - OPENGROK_GLASSFISH_DOMAIN Preferred Glassfish Domain Name 873N/A echo "Usage: ${0} <deploy|update|updateQuietly|updateConfiguration|usage>" 1>&2 787N/A echo " Optional environment variables:" 1>&2 294N/A echo " OPENGROK_CONFIGURATION - location of your configuartion" 1>&2 294N/A echo " See the code for more information on configuration options" 1>&2 294N/A# Default Instance Configuration 294N/A # Use the built-in defaults. This section can be copied to its own 787N/A # file and tailored to your local requirements. Then simply set 789N/A # this wrapper. It will save you hand editing in your settings 787N/A # on each new release. A sample cron(1M) entry might look like: 869N/A # Note: It is not really possible to ever provided defaults for 869N/A # these values which will run in every UNIX-like environment. 789N/A # So I have provided a set which are functional for a given 789N/A # environment on which you can based you own configuration. 789N/A # This has been updated to support more environment variables and 789N/A # operating systems, if you have any reasonably generic 789N/A # improvements please feel free to submit a patch. 294N/A if [ -z "${OPENGROK_DISTRIBUTION_BASE}" ] 294N/A # Handle Developer Build Environments 294N/A # Handle Binary Distributions 789N/A # (your source code or the root of all repositories) 868N/A # REQUIRED: OpenGrok Generate Data Root 789N/A # (for Lucene index and hypertext cross-references) 789N/A # This area is rebuilt by "update" / "updateQuietly" 869N/A # OPTIONAL: User Provided Source Path to Description Mapping (Tab Separated Value) 869N/A # (The user maintained source of the generated EftarFile file) 869N/A # REQUIRED: XML Configuration 979N/A # REQUIRED: Java Archive of OpenGrok (Installation Location) 787N/A # REQUIRED(deploy): Web Archive of OpenGrok (Distribution Location) 787N/A # (user building from source code will find this and other key 294N/A # files in the "dist" directory after the build is completed) 294N/A # REQUIRED: Java Virtual Machine 789N/A # OPTIONAL: Scanning Options (for Mercurial repositories) 789N/A # OPTIONAL: Full Path to History Utilities 911N/A # OPTIONAL: Override Built-in Properties 911N/A # Assumption: We should not set properties to the empty string 789N/A # OPTIONAL: JVM Options 789N/A #JAVA_OPTS="-server -Xmx1024m" 789N/A # DELIVERED: An update program for EftarFile 294N/A # Usage: <class> inputFile [inputFile ...] outputFile 294N/A # EftarFile == An Extremely Fast Tagged Attribute Read-only File System 294N/A # HARDCODED: Generated EftarFile (See web/*.jsp) 294N/A # Be Quiet? (set indirectly by command line arguments in the main program) 294N/A # or alternatively, Be Verbose! 869N/A# Helper Functions - Logging 869N/A# In general, non-interactive use like cron jobs and automated 869N/A# installation environments should not generate unnecessary 869N/A# progress information or warnings, as usage and configuration 868N/A# will have generally been debugged prior to automation. 941N/A if [ -z "${OPENGROK_NON_INTERACTIVE}" ] 941N/A if [ -z "${OPENGROK_NON_INTERACTIVE}" ] 869N/A echo "WARNING: ${@}" 1>&2 994N/A echo "ERROR: ${@}" 1>&2 869N/A echo "FATAL ERROR: ${@} - Aborting!" 1>&2 870N/A# Helper Functions - Autodetection of Runtime Environment 789N/A case "${OS_NAME}:${OS_VERSION}" in 877N/A if [ -z "${commandName}" ] 294N/A Error "Unable to determine Exuberant CTags command name" \ 789N/A "for ${OS_NAME} ${OS_VERSION}" 877N/A case "${OS_NAME}:${OS_VERSION}" in 869N/A if [ -z "${javaHome}" ] 869N/A "for ${OS_NAME} ${OS_VERSION}" 294N/A if [ ! -d "${javaHome}" ] 869N/A # Use this function to determine which environment the deploy the 873N/A # web application function into. Some users (especially 873N/A # developers) will have many deployment environments or will wish 872N/A # to specify directly the application server to deploy to. 873N/A # Either use the environment variable OPENGROK_APP_SERVER or 872N/A # reimplement this function in your configuration file (as 789N/A # specified by OPENGROK_CONFIGURATION) 789N/A if [ -n "${OPENGROK_APP_SERVER}" ] 789N/A echo "${OPENGROK_APP_SERVER}" 789N/A # This implementation favours Tomcat, but needs a lot of work, 789N/A # especially if Glassfish is perferrerd or it is under the control 789N/A # of SMF (Service Management Facility) 789N/A # Maybe a better implementation would be to call Application 789N/A # Server specific WAR Directory and see if they exist. 789N/A if [ -n "${OPENGROK_WAR_TARGET_TOMCAT}" ] 789N/A echo "${OPENGROK_WAR_TARGET_TOMCAT}" 789N/A elif [ -n "${OPENGROK_WAR_TARGET}" ] 789N/A echo "${OPENGROK_WAR_TARGET}" 789N/A if [ -d "${prefix}/webapps" ] 294N/A echo "${prefix}/webapps" 789N/A if [ -n "${OPENGROK_WAR_TARGET_GLASSFISH}" ] 789N/A echo "${OPENGROK_WAR_TARGET_GLASSFISH}" 789N/A elif [ -n "${OPENGROK_WAR_TARGET}" ] 789N/A echo "${OPENGROK_WAR_TARGET}" 789N/A if [ -d "${prefix}/domains" ] 789N/A if [ -z "${domainDirectory}" ] 789N/A if [ -z "${domainDirectory}" ] 789N/A # User Specified Domain 789N/A if [ -n "${OPENGROK_GLASSFISH_DOMAIN}" ] 789N/A directory="${domainDirectory}/${OPENGROK_GLASSFISH_DOMAIN}/autodeploy" 789N/A if [ ! -d "${directory}" ] 789N/A FatalError "Missing Specified Glassfish Domain ${OPENGROK_GLASSFISH_DOMAIN}" 789N/A # Arbitrary Domain Selection 787N/A if [ -z "${firstDomain}" ] 789N/A FatalError "Failed to dynamically determine Glassfish Domain from ${domainDirectory}" 789N/A echo "${domainDirectory}/${firstDomain}/autodeploy" 789N/A# The variable "DO" can usefully be set to "echo" to aid in script debugging 877N/A # Setup a standard execution environment (if required) 789N/A if [ -f "${OPENGROK_STANDARD_ENV}" ] 789N/A . "${OPENGROK_STANDARD_ENV}" 789N/A # Note: As all functions have been defined by the time this routine 789N/A # is called, your configuration can, if desired, override functions 789N/A # in addition to setting the variables mentioned in the function 789N/A # DefaultInstanceConfiguration(), this maybe useful to override 789N/A # functionality used to determine the default deployment environment 789N/A # find dependencies or validate the configuration, for example. 789N/A if [ -n "${OPENGROK_CONFIGURATION}" -a -f "${OPENGROK_CONFIGURATION}" ] 789N/A # Load the Local OpenGrok Configuration Environment 789N/A . "${OPENGROK_CONFIGURATION}" 877N/A if [ ! -x "${EXUBERANT_CTAGS}" ] 789N/A if [ ! -d "${SRC_ROOT}" ] 789N/A if [ ! -d "${DATA_ROOT}" ] 789N/A Warning "OpenGrok Generated Data Path ${DATA_ROOT} doesn't exist" 789N/A if [ ! -d "${DATA_ROOT}" ] 789N/A if [ ! -d "${OPENGROK_INSTANCE_BASE}/etc" ] 789N/A Warning "OpenGrok Generated Etc Path ${OPENGROK_INSTANCE_BASE}/etc doesn't exist" 789N/A if [ ! -d "${OPENGROK_INSTANCE_BASE}/etc" ] 789N/A FatalError "OpenGrok Etc Path ${OPENGROK_INSTANCE_BASE}/etc doesn't exist" 789N/A # OPTIONAL : Update the EftarFile data 789N/A if [ -n "${PATH_DESC}" -o -s "${PATH_DESC}" ] 789N/A if [ -z "${warTarget}" ] 789N/A FatalError "Unable to determine Deployment Directory for ${applicationServer}" 789N/A if [ ! -f "${OPENGROK_DIST_WAR}" ] 789N/A if [ ! -d "${warTarget}" ] 789N/A ${DO} cp "${OPENGROK_DIST_WAR}" "${warTarget}/" 789N/A Progress "Start your application server (${applicationServer}), if it is not already" 789N/A Progress "running, or wait until it loads the just installed web application." 789N/A Progress "OpenGrok should be available on <HOST>:<PORT>/source" 789N/A Progress " where HOST and PORT are configured in ${applicationServer}."