To configure WebSphere® Application Server for Application Center manually,
you must configure variables, custom properties, and class loading
policies.
Before you begin
Make sure that a
WebSphere Application Server profile
exists.
Procedure
- Log on to the WebSphere Application Server administration
console for your IBM MobileFirst™ Platform Server.
- Enable application security.
- Click .
- Ensure that Enable administrative security is
selected. Application security can be enabled only if
administrative security is enabled.
- Ensure that Enable application security is
selected.
- Click OK.
- Save the changes.
For more information, see Enabling security.
- Create the Application Center JDBC
data source and provider.
See the appropriate section
in Manually installing Application Center.
- Install the Application Center console
WAR file.
- Depending on your version of WebSphere Application Server,
click one of the following options:
- Navigate to the MobileFirst Server installation
directory mfserver_install_dir/ApplicationCenter/console.
- Select appcenterconsole.war and
click Next.
- On the How do you want to install the application? page,
click Detailed, and then click Next.
- On the Application Security Warnings page,
click Continue.
- Click Next until you reach the "Map
context roots for web modules" page.
- In the Context Root field, type /appcenterconsole.
- Click Next until you reach the "Map
security roles to users or groups" page.
- Select all roles, click Map Special Subjects and
select All Authenticated in Application's Realm.
- Click Next until you reach the Summary page.
- Click Finish and save the configuration.
- Configure the
class loader policies and then start the application:
- Click .
- From the list of applications, click appcenterconsole_war.
- In the Detail Properties section,
click the Class loading and update detection link.
- In the Class loader order pane,
click Classes loaded with local class loader first (parent
last).
- Click OK.
- In the Modules section, click Manage
Modules.
- From the list of modules, click ApplicationCenterConsole.
- In the Class loader order pane,
click Classes loaded with local class loader first (parent
last).
- Click OK twice.
- Click Save.
- Select appcenterconsole_war and
click Start.
- Install the WAR file for Application Center services.
- Depending on your version of WebSphere Application Server,
click one of the following options:
- Navigate to the MobileFirst Server installation
directory mfserver_install_dir/ApplicationCenter/console.
- Select applicationcenter.war and
click Next.
- On the How do you want to install the application? page,
click Detailed, and then click Next.
- On the Application Security Warnings page,
click Continue.
- Click Next until you reach the "Map
resource references to resources" page.
- Click Browser and select the
data source with the jdbc/AppCenterDS JNDI name.
- Click Apply.
- In the Context Root field, type /applicationcenter.
- Click Next until you reach the "Map
security roles to users or groups" page.
- Select all roles, click Map Special Subjects,
and select All Authenticated in Application's Realm.
- Click Next until you reach the Summary page.
- Click Finish and save the configuration.
- Repeat step 5.
- Select applicationcenter.war from
the list of applications in substeps b and k.
- Select ApplicationCenterServices in
substep g.
- Review the server class loader policy: Depending on your
version of WebSphere Application Server,
click or and then select the server.
- If the class loader policy is set to Multiple,
do nothing.
- If the class loader policy is set to Single and Class
loading mode is set to Classes loaded with
local class loader first (parent last), do nothing.
- If Classloader policy is set to Single and Class
loading mode is set to Classes loaded with
parent class loader first, set Classloader
policy to Multiple and set the
classloader policy of all applications other than MobileFirst applications
to Classes loaded with parent class loader first.
- Save the configuration.
- Configure a JNDI environment entry
to indicate the directory with binary files of the aapt program,
from the Android SDK platform-tools package.
- Determine a suitable directory for the aapt binary
files in the WebSphere Application Server installation
directory.
- For a stand-alone server, you can use a directory such as WAS_INSTALL_DIR/optionalLibraries/IBM/mobilefirst/android-sdk.
- For deployment to a WebSphere Application Server Network
Deployment cell, use WAS_INSTALL_DIR/profiles/profile-name/config/cells/cell-name/mobilefirst/android-sdk.
- For deployment to a WebSphere Application Server Network
Deployment cluster, use WAS_INSTALL_DIR/profiles/profile-name/config/cells/cell-name/clusters/cluster-name/mobilefirst/android-sdk.
- For deployment to a WebSphere Application Server Network
Deployment node, use WAS_INSTALL_DIR/profiles/profile-name/config/cells/cell-name/nodes/node-name/mobilefirst/android-sdk.
- For deployment to a WebSphere Application Server Network
Deployment server, use WAS_INSTALL_DIR/profiles/profile-name/config/cells/cell-name/nodes/node-name/servers/server-name/mobilefirst/android-sdk.
- Copy the product_install_dir/ApplicationCenter/tools/android-sdk directory
to the directory that you determined in Substep
a.
- For WebSphere Application Server Network
Deployment, click , select the nodes, and
click Full Synchronize.
- Configure the environment entry (JNDI property) android.aapt.dir,
and set as its value the directory that you determined in Substep
a. The WAS_INSTALL_DIR/profiles/profile-name profile
is replaced with the WebSphere Application Server variable
reference ${USER_INSTALL_ROOT}.
Results
You can now access the Application Center at http://<server>:<port>/appcenterconsole,
where server is the host name of your server and port is
the port number (by default 9080).