Guidelines for deploying Marketing Platform on WebSphere
You must follow a set of guidelines when you deploy Marketing Platform on Websphere.
Make sure that the version of WebSphere® meets the requirements that are described in the IBM® Enterprise Products Recommended Software Environments and Minimum System Requirements document, including any necessary fix packs. Use the following guidelines when you deploy Marketing Platform on WebSphere:
- Specify the following custom property in the server:
- Name:
com.ibm.ws.webcontainer.invokefilterscompatibility
- Value: true
- Name:
- See http://www-01.ibm.com/support/docview.wss?uid=swg21284395 for instructions on setting a custom property in WebSphere.
- Deploy the HCL EAR file or unica.war file as
an enterprise application. When you deploy the EAR file or the unica.war file, ensure that the JDK source level of the
JSP compiler is set to Java™ 16
or 17, and that JSP pages are precompiled according to the following
information:
- In the form where you browse to and select the WAR file, select Show me all installation options and parameters so the Select Installation Options wizard runs.
- In step 1 of the Select Installation Options wizard, select Precompile JavaServer Pages files.
- In step 3 of the Select Installation Options wizard, ensure that the JDK Source Level is
set to 16 or 17.
If you deployed an EAR, set the JDK Source Level for each WAR file.
- In step 8 of the Select Installation Options wizard, select UnicaPlatformDS as the matching Target Resource.
- In the
- Select the Override session management check
box under Session Management.
If you deployed separate WAR files for your HCL EMM products, in the WebSphere console, in the section of the server, specify a unique session cookie name.
If you deployed EAR files for your HCL EMM products, in the WebSphere console, in the section of the server, specify a unique session cookie name.
- If your installation must support non-ASCII characters, for example
for Portuguese or for locales that require multi-byte characters,
add the following arguments to Generic JVM Arguments at the server level:
-Dfile.encoding=UTF-8
-Dclient.encoding.override=UTF-8
Navigation tip: Select
. See the WebSphere documentation for additional details.
section of the server,
enable cookies. Specify a different session cookie name for each application
that is deployed. Use one of the following procedures to specify a
cookie name: - Select the Override session management check
box under Session Management.
- In the Class loading and update
detection and specify the following properties.
- If you are deploying a WAR file:
- For Class loader order, select Classes loaded with local class loader first (parent last).
- For WAR class loader policy, select Single class loader for application.
- If you are deploying an EAR file:
- For Class loader order, select Classes loaded with local class loader first (parent last).
- For WAR class loader policy, select Class loader for each WAR file in application.
section of the server, select the EAR file or WAR file
that you deployed, then select - If you are deploying a WAR file:
- Start your deployment. If your instance of WebSphere is configured to use a JVM version
1.6 or newer, complete the following steps to work around an issue
with the time zone database.
- Stop WebSphere.
- Download the IBM Time Zone Update Utility for Java (JTZU) from the IBM web site:
- Follow the steps provided by the IBM (JTZU) to update the time zone data in your JVM.
- Restart WebSphere.
- The following additional setting is required for WAS 8.5:
In Websphere Enterprise Applications, select
. - The recommended minimum heap size for the basic functioning of
the application is 512, and the recommended maximum heap size is 1024.Complete the following tasks to specify the heap size:
- In WebSphere Enterprise Applications, select .
- Set the initial heap size to 512.
- Set the maximum heap size to 1024