Installing OrecX Web (Optional)

Run the commands in the following steps to install OrkWeb on your system:

  1. Install MySQL if it is not already installed. Replace platform-and-version-specific-package-name.rpm with the name of the package:
    sudo yum install platform-and-version-specific-package-name.rpm
  2. Start the MySQL service if it is not already running:
    sudo systemctl start mysqld 
  3. Run the following command to make sure MySQL restarts automatically after a system reboot:
    sudo chkconfig mysqld on 
  4. Extract the OrkWeb installer provided by OrecX:
    tar -xvf ./orkwebapps-2.90-11509-x64-rhel8-installer.sh.tar
  5. Run the OrkWeb installer:
    ./orkwebapps-2.90-11509-x64-rhel8-installer.sh
  6. The OrkWeb installer will prompt for the MySQL directory, hostname, database, username and password.
    Verifying MySQL database installation... Found package mysql-server-5.1.73-5.el6_6.x86_64 Click enter to accept defaults... Path to mysql (default: /usr/bin/mysql): MySQL hostname (default: localhost): MySQL database (default: oreka): MySQL user name: MySQL password:

    Hit Enter to accept the defaults. If you set a MySQL password, type it in when prompted. Otherwise, copy the temporary password generated in the /var/log/mysqld.log log file and hit Enter.

  7. The installer will prompt for the installation of Java:
    Do you want to install Java? (y/n) Enter desired path to install java - the JRE will be installed in a subdirectory named jre1.7.0_04 (default: /opt/java):

    Enter y and accept the default directory to complete the Java installation.

  8. The installer will prompt for the installation of Tomcat:
    Do you want to install Tomcat? (y/n) Installing Tomcat Enter the path for tomcat installation (default: /opt). A subdirectory called tomcat7 will be created under the directory you enter (e.g.: /opt/tomcat7):

    Enter y and accept the default directory to complete the Tomcat installation.

  9. The installer will prompt to install Tomcat as a service:
    Tomcat has been successfully installed in: /opt/tomcat7 Do you want to install Tomcat as a service? (y/n)

    Enter y to complete the installation of OrkWeb under Tomcat.

  10. The Installer will prompt to set the OrkWeb admin password:
    Enter the OrkWeb admin password (important to note it down): OrkWeb admin password: OrkWeb admin password confirm:

    The OrkWeb installation is complete when you set and confirm the password.

  11. The installer automatically configures the Tomcat service to start after a reboot; however, the service will need to be started manually at the end of the installation:
    sudo systemctl start tomcat 
  12. Open any standard web browser and navigate to http://localhost:8080/orkweb/. The page contains a login screen where you can enter the credentials specified during the installation process. A valid OrecX license will be requested after logging in. Copy and paste the contents of the license text file issued by OrecX into the field.
    Note: If you are accessing from a location other than the server where OrkWeb was installed, replace localhost with the hostname or IP address of the OrkWeb server.
Tip:

You can update an OrkWeb license using the OrecX REST API as an alternative option. The following command uses the curl utility to execute an HTTP PUT request:

curl -i -s -S -X PUT -H "Content-type:multipart/form-data" \
                     -F "file=@licensefile.txt" \
                     -H"Authorization:$accessTokenAdmin" \
                     http://localhost:8080/orktrack/rest/licenseinfo?force=true