+

Search Tips | Advanced Search

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


Configure Apache Tomcat for Application Center manually

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


Procedure

  1. Add the database drivers to the Tomcat lib directory. See the instructions for the appropriate DBMS in Manually installing 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.
               We 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="product_install_dir/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 host name 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:

  3. Copy the Application Center WAR files to Tomcat.

    • On UNIX and Linux systems:

        cp product_install_dir/ApplicationCenter/console/*.war TOMCAT_HOME/webapps/

    • On Windows systems:

        copy /B product_install_dir\ApplicationCenter\console\appcenterconsole.war tomcat_install_dir\webapps\appcenterconsole.war
        copy /B product_install_dir\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 the Java EE security roles on Apache Tomcat.

Parent topic: Deploy the Application Center WAR files and configuring the application server manually