Product SiteDocumentation Site

1.2.3. Installing

Once the requirements and prerequisites have been met and you have downloaded the binary distribution zip file, you are ready to install the JBoss Communications Platform. Follow the instructions below for your operating system 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 1.3. Installing the JBoss Communications Platform Binary Distribution on Linux
  1. Assuming that you downloaded the binary distribution zip file to your home folder, you want to create a subdirectory to which to unzip the JBoss Communications Platform 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 binary distribution you downloaded. 
    ~]$ mkdir "jbcp-<version>"
  2. Move the downloaded zip file into the directory you just created: 
    ~]$ mv "JBCP-1.2.0.GA-jboss-eap-4.3.zip" "jbcp-<version>"
  3. Move into that directory: 
    ~]$ cd "jbcp-<version>"
  4. Finally, use Java's jar -xvf command to extract the contents of the zip file into the current directory, thus completing the install: 
    jbcp-<version>]$ jar -xvf "JBCP-1.2.0.GA-jboss-eap-4.3.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: 
      jbcp-<version>]$ unzip "JBCP-1.2.0.GA-jboss-eap-4.3.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.
  5. To free disk space, you may want to delete the zip file once you've extracted its contents: 
    jbcp-<version>]$ rm "JBCP-1.2.0.GA-jboss-eap-4.3.zip"
Procedure 1.4. Installing the JBoss Communications Platform 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 JBoss Communications Platform binary distribution you downloaded. In these instructions, we will refer to this folder as jbcp-<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 JBoss Communications Platform 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. 
      C:\Users\Me>cd "My Downloads\jbcp-<version>"
    • Finally, use the jar -xvf command to extract the archive contents into the current folder. 
      C:\Users\Me\My Downloads\jbcp-<version>>jar -xvf "JBCP-1.2.0.GA-jboss-eap-4.3.zip"
  3. At this point, you may want to move the folder holding the JBoss Communications Platform binary files (in this example, the folder named jbcp-<version>) to another location. This step is not strictly necessary, but it is probably a good idea to move the folder from My Downloads to a user-defined location for storing runnable programs. Any location will suffice, however.
  4. You may also want to delete the zip file after extracting its contents in order to free disk space: 
    C:\Users\Me\My Downloads\jbcp-<version>>delete "JBCP-1.2.0.GA-jboss-eap-4.3.zip"