JBoss Communications Platform Installation Guide


Download JBoss Communications Platform 1.0.0.GA


Requirements

  • JDK 1.5 32-bit

  • 200 MB of available disk space

  • Gnome or KDE for Linux systems

Installing and Configuring 32-bit Sun JDK 5.0 on Linux


Download the Sun JDK 5.0 (Java 2 Development Kit) from Sun's website:
Make sure you choose the appropriate file for your platform. http://java.sun.com/javase/downloads/index_jdk5.jsp.

Choose "JDK 5.0 Update <x>" (where x is the latest update number) for download and then select "RPM in self-extracting" file for Linux1. Read the instructions on Sun's website for installing the JDK.

  • If you don't want to use SysV service scripts you can install the "self-extracting file" for Linux instead of choosing the "RPM in self-extracting" file. In that case you can skip the next step mentioned here. But it is recommended to use the SysV service scripts for production servers.

  • Download and install the appropriate -compat RPM from JPackage here [ftp://jpackage.hmdc.harvard.edu/JPackage/1.7/generic/RPMS.non-free/]. Please ensure you choose a matching version of the -compat package to the JDK you installed.

  • Create an environment variable that points to the JDK installation directory and call it JAVA_HOME. Add $JAVA_HOME/bin to the system path to be able to run java from the command line. You can do this by adding the following lines to the .bashrc file in your home directory.

    #In this example /usr/java/jdk1.5.0_11 is the JDK installation directory.
    export JAVA_HOME=/usr/java/jdk1.5.0_11
    export PATH=$PATH:$JAVA_HOME/bin

    Set this variable for the user account doing the installation and also for the user account that will run the server.

  • If you have more than one version of JVM installed in your machine, make sure you are using the JDK1.5 installation as the default java and javac. You can do this using the alternatives system. The alternatives system allows different versions of Java, from different sources to co-exist on your system. You can always override this step by setting the JAVA_HOME environment variable.

  • Make sure that the java executable is in your path and that you are using an appropriate
    version. To verify your Java environment, type java -version at the shell prompt and you
    should see something like this:

[root@vsr ~]$ java -version
java version "1.5.0_11"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_11-b03)
Java HotSpot(TM) Client VM (build 1.5.0_11-b03, mixed mode, sharing)


Installing and Configuring 32-bit Sun JDK 5.0 on Microsoft Windows

  • Download the Sun JDK 5.0 (Java 2 Development Kit) from Sun's website:
    http://java.sun.com/javase/downloads/index_jdk5.jsp. Choose "JDK 5.0 Update <x>" (where x is the latest update number) for download and then select your Windows Platform options to perform the installation.

  • Create an environment variable called JAVA_HOME that points to the JDK installation directory, Configuring Your Java Environment 5 for example: C:\Program Files\Java\jdk1.5.0_11\. In order to run java from the command line add the jre\bin directory to your path, for example: C:\Program Files\Java\jdk1.5.0_11\jre\bin. To do this, open the Control Panel from the Start Menu, switch to Classic View if necessary, open the System Control Panel applet, select the Advanced Tab, and click on the Environment Variables button.

Installation

On both Windows and Linux (Gnome or KDE) you can run the installer with the following command:

java -jar jbcp-installer-<release>.jar

On Windows you should be able to simply double click on the jar file and it will run, but if it doesn't work, use the command line method.

  • Welcome screen. Click Next.

  • Read the release notes and click Next.

  • Read the licence agreement and click Next.


  • Select installation path and click Next.

  • You can specify which packages to be installed. It is recommended to install all packages. Click Next.


  • Here you can configure a datasource for the Application Server. Click Next.


  • You can read a summary of what will be installed. To proceed with the installation click Next.


  • Wait for the installation to complete and click Next.


  • In this screen you can specify what start menu and desktop shortcuts to be created (this feature works only on Windows and Linux). Click Next.

 

  • This is the final screen. Click Done to leave the installer.

  • Once installed, You should see a new program group. You can start the server with Start Mobicents Server. On some rare Linux systems the program group doesn't appear immediately after installation, you should logout and log in again.