For up-to-date product documentation, see the IBM MobileFirst Foundation Developer Center.

Connecting MobileFirst Server installed on Apache Tomcat to the Rational License Key Server

You must install the Rational® Common Licensing native and Java™ libraries on the Apache Tomcat application server before you connect MobileFirst Server to the Rational License Key Server.

Before you begin

Parent topic: Installing and configuring for token licensing

Installing Rational Common Licensing libraries


  1. Choose the Rational Common Licensing native library. Depending on your operating system and the bit version of the Java Runtime Environment (JRE) on which your Apache Tomcat is running, we must choose the correct native library in product_install_dir/MobileFirstServer/tokenLibs/bin/your_corresponding_platform/the_native_library_file. For example, for Linux x86 with a 64-bit JRE, the library can be found in product_install_dir/MobileFirstServer/tokensLibs/bin/Linux_x86_64/
  2. Copy the native library to the computer that runs MobileFirst Server administration service. The directory might be ${CATALINA_HOME}/bin.

    Note: ${CATALINA_HOME} is the installation directory of your Apache Tomcat.

  3. Copy rcl_ibmratl.jar file to ${CATALINA_HOME}/lib. The rcl_ibmratl.jar file is a Rational Common Licensing Java library that can be found in product_install_dir/MobileFirstServer/tokenLibs directory. The library uses the native library that is copied in Step 2, and can be loaded only once by Apache Tomcat. This file must be placed in the ${CATALINA_HOME}/lib directory or any directory in the path of Apache Tomcat common class loader.

    Important: The Java virtual machine (JVM) of Apache Tomcat needs read and execute privileges on the copied native and Java libraries. Both copied files must also be readable and executable at least for the application server process in your operating system.

  4. Configure the access to the Rational Common Licensing library by the JVM of your application server. For any operating systems, configure the ${CATALINA_HOME}/bin/setenv.bat file (or file on UNIX) by adding the following line:

    set CATALINA_OPTS=%CATALINA_OPTS% -Djava.library.path=absolute_path_to_the_previous_bin_directory
    CATALINA_OPTS="$CATALINA_OPTS -Djava.library.path=absolute_path_to_the_previous_bin_directory"

    Note: If you move the configuration folder of the server on which the administration service is running, we must update the java.library.path with the new absolute path.

  5. Configure MobileFirst Server to access Rational License Key Server. In ${CATALINA_HOME}/conf/server.xml file, look for the <Context> element of the administration service application, and add in these JNDI configuration lines.

    <Environment name="" value="rlks_hostname" type="java.lang.String" override="false"/> <Environment name="mfp.admin.license.key.server.port" value="rlks_port" type="java.lang.String" override="false"/>

    • rlks_hostname is the host name of the Rational License Key Server.
    • rlks_port is the port of the Rational License Key Server. By default, the value is 27000.
    For more information about the JNDI properties, see JNDI properties for Administration Services: licensing.

Installing on Apache Tomcat server farm


For configuring the connection of MobileFirst Server on Apache Tomcat server farm, we must follow all the steps that are described in Installing Rational Common Licensing libraries for each node of your server farm where the MobileFirst Server administration service is running. For more information about server farm, see Server farm topology and Installing a server farm.