You are here: SwitchKit® Development Environment - Installation and Maintenance Guide > 2 Installation > Installing SwitchKit on UNIX/LINUX

Installing SwitchKit on UNIX/LINUX

This procedure describes the installation of SwitchKit on a UNIX system.

Before you begin

If you are installing SwitchKit in a directory other than the default, replace all path names in this procedure with the appropriate path. All file names are case-sensitive and should be in lower case in UNIX. All linkable libraries in SwitchKit are in ELF format.

Important! Be sure to log in as root to do the instsallation.

Installing SwitchKit on UNIX

Follow this procedure to install SwitchKit on UNIX systems. Be

1 Log on to the target machine:

login:<user name>

password:<your password>

2 Insert the SwitchKit installation CD.

3 Create the SwitchKit installation directory by typing:

mkdir /opt/cantata/switchkit

Note: For Release 8.3.1 the directory is /usr/local/switchkit

4 Copy the SwitchKit installation script and zip file reside on the CD in the directory /SwKit/<UNIX Operating System>. The name of the SwitchKit installation zip file is as follows:

Solaris: solsparc.bin.gz
Linux: linux.bin.gz
HP/UX: hpux.bin.gz

Copy the appropriate SwitchKit installation file and zip file to the installation directory:
cp /SwKit/<UNIX Operating System>/*.bin.gz
cp /SwKit/<UNIX Operating System>/install.sh
chmod +x install.sh

5 Type the following exactly:
./install.sh

6 Follow the instructions on the screen to complete the installation.

7 This step is optional. Create a directory under
/opt/cantata/switchkit called "log" by typing:

mkdir /opt/cantata/switchkit/log

Log files by default are stored in the same directory that LLC and SwitchManager are run from.

8 This step is optional. Create a directory under
/opt/cantata/switchkit called "cfg" by typing:

mkdir /opt/cantata/switchkit/cfg

You can store config files in any directory that SwitchManager can access. If the configuration file is in a separate directory that SwitchManager cannot access, the config file will need to specify the path (absolute or relative to where SwitchManager is).

9 Add entries to the /etc/profile file

This allows the system to automatically set the SwitchKit environment variables every time you log in. To do this, add the following lines to the /etc/profile file (somewhere near the top).

SK_LIB_DIR=/opt/cantata/switchkit

SK_LOG_DIR=/opt/cantata/switchkit/log

export SK_LIB_DIR SK_LOG_DIR

Directory Summary

The directories listed in the following table are required for operation. They are either created automatically during installation or must be created by the user, as noted.

Directory | Contents and Use | Created
--- | --- | ---
/opt/cantata/switchkit/bin | SwitchKit executable files | Automatically
/opt/cantata/switchkit/lib | SwitchKit development libraries | Automatically
/opt/cantata/switchkit/include | SwitchKit development header files | Automatically
/opt/cantata/switchkit/samples | Contains sample configuration files | Automatically
/opt/cantata/switchkit/log | Stores log files | By User
/opt/cantata/switchkit/cfg | Stores configuration files | By User