##
## Licensed to the Apache Software Foundation (ASF) under one
## or more contributor license agreements.  See the NOTICE file
## distributed with this work for additional information
## regarding copyright ownership.  The ASF licenses this file
## to you under the Apache License, Version 2.0 (the
## "License"); you may not use this file except in compliance
## with the License.  You may obtain a copy of the License at
##
##   http://www.apache.org/licenses/LICENSE-2.0
##
## Unless required by applicable law or agreed to in writing,
## software distributed under the License is distributed on an
## "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
## KIND, either express or implied.  See the License for the
## specific language governing permissions and limitations
## under the License.
##

Lokahi is an effort undergoing incubation at the Apache Software Foundation (ASF),
sponsored by the Incubator PMC. Incubation is required of all newly accepted projects
until a further review indicates that the infrastructure, communications, and decision
making process have stabilized in a manner consistent with other successful ASF projects.
While incubation status is not necessarily a reflection of the completeness or stability
of the code, it does indicate that the project has yet to be fully endorsed by the ASF.



   Requirements:  Tomcat 5.5.x is installed, and you know how to configure it
                  Oracle 9i database is available to you
                  JDK 1.5
                  ant 1.6.5 or later

   Build instructions:

   SECTION I: Download Source Code

   1. Untar the tarball, or take the latest src from svn @
      https://svn.apache.org/repos/asf/incubator/lokahi/lokahi/trunk/
   2. Change directory (cd) to the home directory of lokahi.

   SECTION II: Build Software

      1. Change directory (cd) to the home directory of lokahi.
      2. Edit the following properties in the build.properties file:

      ----
      tomcat.home=<YOUR_TOMCAT_HOME>
      app.name=lokahi
      app.virtuahost.name=
      app.authenticationmodule=org.apache.lokahi.core.common.authentication.NoAuthentication
      console.log.location=
      agent.log.location=
      database.uri=jdbc:oracle:thin:@<DATABASE_SERVER>:<PORT>:<DB_NAME>
      database.user=<SCHEMA>
      database.password=<PASSWORD>
      database.driver=oracle.jdbc.driver.OracleDriver
      inital.instance.name=
      inital.user.name=
      install.location=${tomcat.home}/webapps/
      agent.install.location=
      ----

      3. Download external libraries to lib/ directory:
         a. classes12.jar   -- from the oracle website
         b. jdom.jar        -- Jdom version 1.0 from http://www.jdom.org/
         c. activation.jar  -- from http://java.sun.com/products/javabeans/glasgow/jaf.html
         d. mail.jar        -- from http://java.sun.com/products/javamail/
      4. Verify that JAVA_HOME is properly set to jdk1.5 in your shell.
      5. Run ant to build the package.



   SECTION III: Database Setup (Oracle)

   1. Change directory to build/lokahi/database/ directory.
   2. Database Administrator task: Create the lokahi schema <SCHEMA> in your Oracle database with default tablespace
      and enough quota on that tablespace (100 MB is sufficient for install).
   3. Database Administrator task: Run schema_priv.sql as DBA to grant system privileges to <SCHEMA>:
      > @schema_priv.sql <SCH>

   4. Login from sqlplus as <SCHEMA> and run:
      > @install.sql

      Install.sql will call recompile.sql to recompile any invalid object and report
      install status at the end. Make sure there is no invalid object and no error
      message in install.log and recompile.log

   5. Create the superuser. Login from sqlplus as <SCHEMA> and run:
      > @tmc_user_data.sql

      You will be prompted to enter a username, password, first name, last name, and
      email address.  These will be used to create the superuser account.

      Then run:
      > @tmc_rel_function_user_data.sql

   6. Create the initial instance.
      > @tmc_instance_data.sql

      You can add more instances later via
      Administration -> Manage TMC -> Manage Instances -> Select Action -> Add



   SECTION IV: Agent Install

   1.	copy the files in $LOKAHI_SOURCE/build/$APP_NAME/agent to a directory on each server.
   2.	start the agent by running:
      > $JAVA_HOME/bin/java -classpath  $JAVA_HOME/lib/tools.jar:$AGENT_HOME/axis.jar:$AGENT_HOME/commons-dbcp-1.2.1.jar:$AGENT_HOME/commons-discovery-0.2.jar:$AGENT_HOME/commons-logging.jar:$AGENT_HOME/commons-pool-1.2.jar:$AGENT_HOME/derby.jar:$AGENT_HOME/derbyclient.jar:$AGENT_HOME/jaxrpc.jar:$AGENT_HOME/jdom.jar:$AGENT_HOME/log4j-1.2.13.jar:$AGENT_HOME/lokahi.jar:$AGENT_HOME/saaj.jar:$AGENT_HOME/wsdl4j-1.5.1.jar org.apache.lokahi.core.agent.TMCAgent start


   SECTION V: Console Install
   1.  Modify the web.xml in the <install.location> and set the JvmHttp parameter to the HTTP port of the jvm.
   1.  define the context in tomcat's server.xml file and start tomcat.