Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Install ActiveMQ

  1. Download the activemq web archive file from https://cgsrv1.arrc.csiro.au/swrepo/activemq/activemq-web-console-5.14.1.war
  2. Stop tomcat
  3. Copy activemq-web-console-5.14.1.war to %TOMCAT_HOME%/webapps
  4. Start tomcat, a new activemq-web-console-5.14.1 web app will be created

Install the NVCLDataServices web app

...

Oracle example

Code Block
languagetext
jdbc.dbType=oracle
jdbc.driverClassName= oracle.jdbc.driver.OracleDriver
jdbc.url= jdbc:oracle:thin:@nvcldb.csiro.au:1521/nvcl.nvcldb.csiro.au
jdbc.username= WEBSERVICE
jdbc.password= password1
...
jdbc.validationQuery=SELECT 1 FROM DUAL

SQL Server Example

Code Block
languagetext
jdbc.dbType=sqlserver
jdbc.driverClassName=com.microsoft.sqlserver.jdbc.SQLServerDriver
jdbc.url= jdbc:sqlserver://nvcldb.csiro.au:1433;database=NVCL;
jdbc.username= WEBSERVICE
jdbc.password= password1
...
jdbc.validationQuery=SELECT 1

...

The NVCL DataServices can be installed as a standalone service or as a web application within a tomcat instance.  We recommend using the standalone package as it provides greater isolation from other services and makes management easier.  However, if you have tomcat running on your server then you can use it if its more convenient.

If you have an existing NVCLDataServices package

  1. Stop tomcat
  2. Copy jdbc.properties and config.properties from NVCLDataServices/WEB-INF/classes/ folder into a backup location for reference later
  3. Delete the NVCLDataServices folder and all its contents

Option 1. Install the NVCLDataServices as a standalone service

Windows Users
  1. Download the Windows installer
  2. Windows users run the windows installer, once it completes the configuration file should be displayed for editing.  If not edit C:\Program Files\NVCLDataServices\application.properties
  3. Copy the values for the properties from your saved jdbc and config.properties files or follow the instructions within the file
  4. Start the NVCLDataServices from windows services

Linux Users

  1. Download the universal WAR
  2. Make a folder named NVCLDataServices and save the WAR file into it
  3. Download the template configuration file and save it in the NVCLDataServices folder
  4. Create a user to run the service e.g.

    Code Block
    languagetext
    sudo useradd -r nvcldsuser


  5. Change ownership of the NVCLDataServices folder and its contents to the user created above e.g.

    Code Block
    languagetext
    sudo chown -R nvcldsuser:nvcldsuser NVCLDataServices


  6. If you system supports systemd create a file name NVCLDataServices.service in the /etc/systemd/system/ folder with the following content (NOTE: you will likely need to modify ExecStart path):

    Code Block
    languagetext
    [Unit]
    Description=NVCL Data Services package
    After=syslog.target
    
    [Service]
    User=nvcldsuser
    ExecStart=/var/NVCLDataServices/NVCLDataServices-2.1.0.war
    SuccessExitStatus=143
    
    [Install]
    WantedBy=multi-user.target


  7. To make the NVCLDataServices start automatically run:

    Code Block
    languagetext
    sudo systemctl enable NVCLDataServices.service


  8. Edit NVCLDataServices\application.properties
  9. Copy the values for the properties from your saved jdbc and config.properties files or follow the instructions within the file
  10. NOTE: if you're running tomcat on port 8080 you will need to change the port the NVCLDataServices run on (something in the 808x range is recommended)
  11. Create a script file called runtsg.sh to run tsg with the following content:

    Code Block
    languagetext
    #!/bin/bash
    xvfb-run -a wine tsgeol8.exe $1
    exit


  12. Start the NVCLDataServices with systemctl:

    Code Block
    languagetext
    sudo systemctl start NVCLDataServices.service

Option 2. Install the NVCLDataServices as a web application in tomcat

  1. Download the universal WAR
  2. Create a new folder named NVCLDataServices in your %TOMCAT_HOME%/webapps folder

  3. Extract NVCLDataServices-2.1.0.war into the new folder (rename it to NVCLDataServices.zip if you unzip app doesn't recognize it)
  4. Edit NVCLDataServices\WEB-INF\classes\application.properties
  5. Copy the values for the properties from your saved jdbc and config.properties files or follow the instructions within the file
  6. For Linux create a script file called runtsg.sh to run tsg with the following content:

    Code Block
    languagetext
    #!/bin/bash
    xvfb-run -a wine tsgeol8.exe $1
    exit


After Install

  1. If you are using Apache HTTP Server as a reverse proxy to your tomcat instance add the following in the proxy settings of your http Server configuration file:

    Code Block
    languagetext
    ProxyPass /NVCLDataServices ajphttp://localhost:%TOMCAT_AJPHTTP_PORT_NUMBER%/NVCLDataServices
    ProxyPass /NVCLDownloadServices ajphttp://localhost:%TOMCAT_AJPHTTP_PORT_NUMBER%/NVCLDataServices
    ProxyPass /NVCLPreparedDownloads ajphttp://localhost:%TOMCAT_AJPHTTP_PORT_NUMBER%/NVCLPreparedDownloads

    For Linux create a script file called runtsg.sh to run tsg with the following content:

    Code Block
    languagetext
    #!/bin/bash
    xvfb-run -a wine C:\\Program\ Files\\The\ Spectral\ Geologist\\tsgeol8.exe $1
    exit


  2. Replace %download.rootpath% with the same directory you entered for download.rootpath in the config.properties file above and insert the following 'context' element inside the 'host' element of the file %TOMCAT_HOME%/conf/server.xml:

    Code Block
    languagetext
    <Context path="/NVCLPreparedDownloads" docBase="%download.rootpath%" crossContext="false" reloadable="false" />

  3. Start Tomcat

...