Configuring the Liberty profile for Application Center manually

To configure WebSphere® Application Server Liberty profile manually for Application Center, you must modify the server.xml file.

1. Ensure that the <featureManager> element contains at least the following <feature> elements:

   <feature>jdbc-4.0</feature>
   <feature>appSecurity-2.0</feature>
   <feature>servlet-3.0</feature>
   <feature>usr:MFPDecoderFeature-1.0</feature>

2. Add the following declarations for Application Center:

   <!-- The directory with binaries of the 'aapt' program, from the Android SDK's
        platform-tools package. -->
   <jndiEntry jndiName="android.aapt.dir" value="product_install_dir/ApplicationCenter/tools/android-sdk"/>
   <!-- Declare the Application Center Console application. -->
   <application id="appcenterconsole"
                name="appcenterconsole"
                location="appcenterconsole.war"
                type="war">
     <application-bnd>
       <security-role name="appcenteradmin">
         <group name="appcentergroup"/>
       </security-role>
     </application-bnd>
     <classloader delegation="parentLast">
     </classloader>
   </application>
   
   <!-- Declare the IBM Application Center Services application. -->
   <application id="applicationcenter" 
                name="applicationcenter"
                location="applicationcenter.war" 
                type="war"> 
     <application-bnd>
       <security-role name="appcenteradmin">
         <group name="appcentergroup"/>
       </security-role>
     </application-bnd>
     <classloader delegation="parentLast">           
     </classloader>
   </application>
   
   <!-- Declare the user registry for the IBM Application Center. -->
   <basicRegistry id="applicationcenter-registry"
                  realm="ApplicationCenter">
     <!-- The users defined here are members of group "appcentergroup",
          thus have role "appcenteradmin", and can therefore perform
          administrative tasks through the Application Center Console. -->
     <user name="appcenteradmin" password="admin"/>
     <user name="demo" password="demo"/>
     <group name="appcentergroup">
       <member name="appcenteradmin"/>
       <member name="demo"/>
     </group>
   </basicRegistry>

   The groups and users that are defined in the basicRegistry are example logins that you can use to test Application Center. Similarly, the groups that are defined in the <security-role name="appcenteradmin"> for the Application Center console and the Application Center service are examples. For more information about how to modify these groups, see Configuring the Java EE security roles on WebSphere Application Server Liberty profile.

3. If the database is Oracle, add the commonLibraryRef attribute to the class loader of the Application Center service application.

   ...
   <classloader delegation="parentLast"  commonLibraryRef="OracleLib">
   ...

   The name of the library reference (OracleLib in this example) must be the ID of the library that contains the JDBC JAR file. This ID is declared in the procedure that is documented in Configuring Liberty profile for Oracle manually for Application Center.
4. Copy the Application Center WAR files to your Liberty server.
   • On UNIX and Linux systems:

     mkdir -p LIBERTY_HOME/wlp/usr/servers/server_name/apps
     cp product_install_dir/ApplicationCenter/console/*.war LIBERTY_HOME/wlp/usr/servers/server_name/apps/

   • On Windows systems:

     mmkdir LIBERTY_HOME\wlp\usr\servers\server_name\apps
     copy /B product_install_dir\ApplicationCenter\console\appcenterconsole.war 
     LIBERTY_HOME\wlp\usr\servers\server_name\apps\appcenterconsole.war
     copy /B product_install_dir\ApplicationCenter\console\applicationcenter.war 
     LIBERTY_HOME\wlp\usr\servers\server_name\apps\applicationcenter.war

5. Copy the password decoder user feature.
   • On UNIX and Linux systems:

     mkdir -p LIBERTY_HOME/wlp/usr/extension/lib/features
     cp product_install_dir/features/com.ibm.websphere.crypto_1.0.0.jar LIBERTY_HOME/wlp/usr/extension/lib/
     cp product_install_dir/features/MFPDecoderFeature-1.0.mf LIBERTY_HOME/wlp/usr/extension/lib/features/

   • On Windows systems:

     mkdir LIBERTY_HOME\wlp\usr\extension\lib
     copy /B product_install_dir\features\com.ibm.websphere.crypto_1.0.0.jar  
     LIBERTY_HOME\wlp\usr\extension\lib\com.ibm.websphere.crypto_1.0.0.jar
     mkdir LIBERTY_HOME\wlp\usr\extension\lib\features
     copy /B product_install_dir\features\MFPDecoderFeature-1.0.mf  
     LIBERTY_HOME\wlp\usr\extension\lib\features\MFPDecoderFeature-1.0.mf

6. Start the Liberty server.