Installing DTS on Linux

The following is an install guide for DTS which references commands for the Ubuntu version of Linux.  For the RedHat equivalent commands see:

https://help.ubuntu.com/community/SwitchingToUbuntu/FromLinux/RedHatEnterpriseLinuxAndFedora.

Installation of the CM1 daemon requires gawk and sysv-rc-conf, which are not always included with Ubuntu. 

Ubuntu installs the gawk package at the location, /usr/bin/gawk. Since the ./StartServer.sh script references the path, /bin/gawk, you must create a symbolic link to the newly-installed gawk executable. To install gawk and sysv-rc-conf,

run the following commands:

Install gawk and create a symbolic link:
sudo apt-get install gawk
sudo ln -s /usr/bin/gawk /bin/gawk

Install sysv-rc-conf:
sudo apt-get install sysv-rc-conf

If you attempt to install without gawk and sysv-rc-conf, installation will fail with an error that these commands are required.

For 64 Bit machines: If you do not have IA32 Java libraries installed prior to trying to install, the installer does not load and the temp.lax says the following:

lax.nl.message.vm.not.loaded=The installer either could not find a Java VM, or the Java VM on this system is too old. The installer requires Java 1.1.5 or later. It can be downloaded from: http://docs.oracle.com/javase/7/docs/webnotes/install/linux/linux-jre.html

Before installing to Linux: you should create a user to install and run Percussion DTS.  

To install DTS:
1.    Download the Linux installation package.
2.    Untar the installation file to a convenient location on the machine where you want to install Percussion CM1. The unzipped file should include the following contents:

  • resource (directory)
  • setup (directory)
  • readme.html (html file)

3.    Change to the directory /CM1/setup, where CM1 is the location where you copied the CM1 installation directory.
4.    Run the installer ./SetupDTSConsole.sh.  (chmod +x if the file is not executable) 
The system extracts and starts the installation wizard.
5.    The first section of the installation is the introduction. Read the introduction and press the < Enter > key to continue.
6.    The installation wizard displays the  license agreement. Read the License Agreement before responding to the installation wizard request:
DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT?
Enter "Y" (Note: case-insensitive; it can be either upper-case or lower-case) to accept the license agreement.
7.    The following section asks whether you are performing a new installation or an upgrade. If you have not installed Percussion CM1 or Percussion DTS on the machine before, the option defaults to new installation (1). If you have installed CM1 or DTS on the machine previously, the option defaults to upgrade (2). If the option defaults to (2), you can either select a new installation directory or upgrade an existing server.

To install a new DTS server:

  1. Enter "1".
  2. The next section asks you to define the installation directory. The installation directory defaults to /home/< username >/Percussion. You can change this to any other directory. Press the < Enter > key to continue. If the directory does not exist, the installation wizard asks if you want to create it. To create the directory, enter "yes" (Note: case-insensitive; it can be either upper-case or lower-case) and press the < Enter > key.

8.    The installation wizard displays the Installation summary. Press the <Enter> key to continue the installation.

10.    If an error occurs during installation, the installation wizard displays a message informing you of the error and the location of a detailed log file. Look at the log file to determine the error.


See Starting the Percussion CM1 Server for details about starting the Percussion CM1 server after you complete the installation.  See Configuring Publishing and Publishing a Site for details on setting up your web servers and configuring a publishing site.