Product SiteDocumentation Site

2.2.4. Installing

Once the requirements and prerequisites have been met and you have downloaded the binary distribution zip file, you are ready to install MSS for Tomcat. Follow the instructions below for your platform, whether Linux or Windows.

Use Version Numbers Relevant to Your Installation!

For clarity, the command line instructions presented in this chapter use specific version numbers and directory names. Remember to replace them with version numbers and file names relevant to those you are actually working with.
Procedure 2.12. Installing the MSS for Tomcat Binary Distribution on Linux
  1. For this example, we'll assume you're currently in your home directory, which is where you downloaded the zip file to. First, create a subdirectory to hold the unzipped MSS for Tomcat files. It is good practice to include the version number in this directory name; if you do so, remember to correctly match it with the version of the MSS for Tomcat distribution you downloaded. 
    ~]$ cd downloads
  2. In downloads, create a subdirectory to hold the unzipped MSS for Tomcat files. It is good practice to include the version number in this directory name; if you do so, remember to correctly match it with the version of the MSS for Tomcat binary distribution you downloaded. 
    ~]$ mkdir "mss-tomcat-<version>"
  3. Move the downloaded zip file into the directory you have just created: 
    ~]$ mv "mss-0.7.2-apache-tomcat-6.0.14-0901261255.zip" "mss-tomcat-<version>"
  4. Move into that directory: 
    ~]$ cd "mss-tomcat-<version>"
  5. Finally, use Java's jar -xvf command to extract the contents of the zip file into the current directory, thus completing the install: 
    mss-tomcat-<version>]$ jar -xvf "mss-0.7.2-apache-tomcat-6.0.14-0901261255.zip"
    • Alternatively, if Linux's unzip utility is present on your system or is installable, you can use it in lieu of Java's jar -xvf command: 
      mss-tomcat-<version>]$ unzip "mss-0.7.2-apache-tomcat-6.0.14-0901261255.zip"

      Note

      You can also use unzip's -d<unzip_to_location> option to extract the zip file's contents to a location other than the current directory.
  6. To free disk space, you may want to delete the zip file once you've extracted its contents: 
    mss-tomcat-<version>]$ rm "mss-0.7.2-apache-tomcat-6.0.14-0901261255.zip"
Procedure 2.13. Installing the MSS for Tomcat Binary Distribution on Windows
  1. For this example, we'll assume that you downloaded the binary distribution zip file to the My Downloads folder. First, using Windows Explorer, create a subfolder in My Downloads to extract the zip file's contents into. When you name this folder, it is good practice to include the version number; if you do so, remember to correctly match it with the version of the MSS for Tomcat binary distribution you downloaded. In these instructions, we will refer to this folder as mss-tomcat-<version>.
  2. Double-click the downloaded zip file, selecting as the destination folder the one you just created to hold the zip file's contents.
    • Alternatively, it is also possible to use Java's jar -xvf command to extract the binary distribution files from the zip archive. To use this method instead, first move the downloaded zip file from My Downloads to the folder that you just created to hold the SIP Servlets Server files.
    • Then, open the Windows Command Prompt and navigate to the folder holding the archive using the cd command.

      Opening the Command Prompt from Windows Explorer

      If you are using Windows Vista®, you can open the Command Prompt directly from Explorer. Hold down the Shift key and right-click on either a folder, the desktop, or inside a folder. This will cause an Open Command Window Here context menu item to appear, which can be used to open the Command Prompt with the current working directory set to either the folder you opened, or opened it from.
    • Finally, use the jar -xvf command to extract the archive contents into the current folder. 
      C:\Users\Me\My Downloads\mss-tomcat-<version>>jar -xvf "mss-0.7.2-apache-tomcat-6.0.14-0901261255.zip"
  3. At this point, you may want to move the folder holding the MSS for Tomcat binary files (in this example, the folder named mss-tomcat-<version>) to another location. This step is not strictly necessary, but it is probably a good idea to move the installation folder from My Downloads to a user-defined location for storing runnable programs. Any location will suffice, however.
  4. You may want to delete the zip file after extracting its contents in order to free disk space: 
    C:\Users\Me\My Downloads\mss-tomcat-<version>>delete "mss-0.7.2-apache-tomcat-6.0.14-0901261255.zip"