Linux

• Create a login account on the Linux server. Lets call it dbcam.

  Note : This account does not need any special privileges. If you have an existing account that you want to use for installing DB CAM, you are free to do so.

• Log into dbcam account, and create a directory where we will be installing the software.

  You can call it 'dbcam'. We will refer to it as DBCAM_HOME.

• Download DB CAM software if you have not done already. 

  Transfer the file to the Linux server.

• Uncompress the file.

   

     $ cd DBCAM_HOME
     $ tar -zxf <download directory>/dbcam-ee-<version>.<build number>-linux64.tgz

   

• You should see a directory structure similar to the following:

     [dbcam@perfprd-01 dbcam]$ ls -ltr
     drwxr-xr-x  3 dbcam dbcam 4096 Feb 22 22:56 doc
     drwxr-xr-x  2 dbcam dbcam 4096 Feb 22 22:56 conf
     drwxr-xr-x  2 dbcam dbcam 4096 Feb 22 22:56 bin
     drwxr-xr-x 17 dbcam dbcam 4096 Feb 22 22:56 app
     drwxr-xr-x  9 dbcam dbcam 4096 Feb 22 22:56 server
     drwxr-xr-x  2 dbcam dbcam 4096 Feb 22 22:56 index
     drwxr-xr-x  3 dbcam dbcam 4096 Feb 22 22:56 files

• Change to the bin directory and start the DB CAM application server.

     [dbcam@perfprd-01 dbcam]$ cd bin
     [dbcam@perfprd-01 bin]$ ./start-dbcam.sh
  
     Jetty home =  /apps/dbcam/server/jetty
  
     To run DBCAM in the foreground, start the server with start-dbcam.sh -fg
     executing as current user
     Using CATALINA_BASE:   /apps/dbcam/server/ui
     Using CATALINA_HOME:   /apps/dbcam/server/ui
     Using CATALINA_TMPDIR: /apps/dbcam/server/ui/temp
     Using JRE_HOME:        ../../jre
     Using CLASSPATH:       /apps/dbcam/server/ui/bin/bootstrap.jar:/apps/dbcam/server/ui/bin/tomcat-juli.jar
     Using CATALINA_PID:    ../logs/id.pid
     Tomcat started.

  This should start the Tomcat application server on port 7070.

  Note : If you would like to start it on a different port, open DBCAM_HOME/conf/server.xml file, search for 7070 and replace it with the desired port number.

• Go to the URL : http://<Linux server name>:7070

  
  

  

  As the database objects have not yet been created, DB CAM is started in 'Setup Mode', as indicated by the message under by Login dialog box.

• Log in as setup/setup. You should see the installer screen which will guide you through the process of setting up the repository.

• On the first Installer screen, please read and accept the DB CAM End User License Agreement, before you can proceed with the installation.

  
  

  

• The next screen briefly describes the pre-requisite steps that need to be carried out on the repository database before proceeding to the next step.

  
  

  

• Once the repository user(s) have been created, enter the connection details to the repository database. Click on the 'Test' button to test database connectivity.

  
  

  

• If the connection test result is 'Success', click on the 'Save' button to save the connection information into dbcam.properties file.

  
  

  

• The next screen displays the objects to be created. Click on 'Create Repository' at the bottom of the page.

• Once the repository objects are create, you need to restart DB CAM Tomcat server.

     $ cd <DBCAM_HOME>/bin;
  
     $ sh ./stop-dbcam.sh
     $ sh ./start-dbcam.sh

  Note : Before issuing the start command, it is a good idea to use the unix 'ps -ef |grep java' command to make sure that the shutdown command executed successfully, and that there is no tomcat java processes running. If it did not get cleaned up, use the unix kill command to terminate the process.

• If you are going to use features that use the Scheduler, you need to start it using the following command :

•    $ cd <DBCAM_HOME>/bin;
  
     $ sh ./start-scheduler.sh
  
  
  
  # To stop the scheduler process, run
  
     $ sh ./stop-scheduler.sh