Configure Apache Tomcat for Application Center manually

To configure Apache Tomcat for Application Center manually, copy JAR and WAR files to Tomcat, add database drivers, edit the server.xml file, and then start Tomcat.

1. Add the database drivers to the Tomcat lib directory. See the instructions for the appropriate DBMS in Manual installation of Application Center.

2. Edit tomcat_install_dir/conf/server.xml.

   1. Uncomment the following element, which is initially commented out: <Valve className="org.apache.catalina.authenticator.SingleSignOn" />.

   2. Declare the Application Center console and services applications and a user registry:

      <!-- Declare the IBM Application Center Console application. -->
      <Context path="/appcenterconsole" docBase="appcenterconsole">
        <!-- Define the AppCenter services endpoint in order for the AppCenter
             console to be able to invoke the REST service.
             You need to enable this property if the server is behind a reverse
             proxy or if the context root of the Application Center Services        application is different from '/applicationcenter'. -->
        <!-- <Environment name="ibm.appcenter.services.endpoint"
                          value="http://proxy-host:proxy-port/applicationcenter"
                          type="java.lang.String" override="false"/>
        -->
      </Context>
      <!-- Declare the IBM Application Center Services application. -->
      <Context path="/applicationcenter" docBase="applicationcenter">
        <!-- The directory with binaries of the 'aapt' program, from        the Android SDK's platform-tools package. -->
        <Environment name="android.aapt.dir"
                     value="MF_HOME/ApplicationCenter/tools/android-sdk"
                     type="java.lang.String" override="false"/>
        <!-- The protocol of the application resources URI.
             This property is optional. It is only needed if the protocol
             of the external and internal URI are different. -->
        <!-- <Environment name="ibm.appcenter.proxy.protocol"
                          value="http" type="java.lang.String" override="false"/>
        -->
        <!-- The hostname of the application resources URI. -->
        <!-- <Environment name="ibm.appcenter.proxy.host"
                          value="proxy-host"
                          type="java.lang.String" override="false"/>
        -->
        <!-- The port of the application resources URI.
             This property is optional. -->
        <!-- <Environment name="ibm.appcenter.proxy.port"
                          value="proxy-port"
                          type="java.lang.Integer" override="false"/> -->
        <!-- Declare the IBM Application Center Services database. -->
        <!-- <Resource name="jdbc/AppCenterDS" type="javax.sql.DataSource" ... -->
      </Context>
      <!-- Declare the user registry for the IBM Application Center.
           The MemoryRealm recognizes the users defined in conf/tomcat-users.xml.
           For other choices, see Apache Tomcat's "Realm Configuration HOW-TO"
           http://tomcat.apache.org/tomcat-7.0-doc/realm-howto.html . -->
      <Realm className="org.apache.catalina.realm.MemoryRealm"/>

      where you fill in the <Resource> element as described in one of the sections:

      • Configure Apache Tomcat for DB2 manually for Application Center

      • Configure Apache Tomcat for Derby manually for Application Center

      • Configure Apache Tomcat for MySQL manually for Application Center

      • Configure Apache Tomcat for Oracle manually for Application Center

3. Copy the Application Center WAR files to Tomcat.

   • On UNIX and Linux systems: cp MF_HOME/ApplicationCenter/console/*.war TOMCAT_HOME/webapps

   • On Windows systems:

     copy /B MF_HOME\ApplicationCenter\console\appcenterconsole.war tomcat_install_dir\webapps\appcenterconsole.war
     copy /B MF_HOME\ApplicationCenter\console\applicationcenter.war tomcat_install_dir\webapps\applicationcenter.war

4. Start Tomcat.

What to do next

For more steps to configure the Application Center, see Configure Apache Tomcat.

Parent topic: Deploy Application Center WAR files manually