Preparing IBM WebSphere
To deploy AM in IBM WebSphere, perform the following steps:
To prepare AM to run in WebSphere, change the AM
war file to ensure that the AM upgrade process is able to find the AM configuration files. Be sure to make this change whenever you deploy a new
war file as part of an AM upgrade.
Change the AM
war file as follows:
If installing on Windows, the specified paths should have slashes / and not backslashes \.
Create a temporary directory and expand the
AM-7.1.0.warfile. For example:
mkdir /tmp/openam ; cd /tmp/openam$
jar xvf ~/Downloads/AM-7.1.0.war
bootstrap.propertiesfile in the
WEB-INF/classesdirectory of the expanded
# configuration.dir=line in the
bootstrap.propertiesfile to specify a path with read and write permissions. For example:
# This property should also be used when the system user that # is running the web/application server process does not have # a home directory. i.e. System.getProperty("user.home") returns # null. configuration.dir=/my/readwrite/config/dir
(Optional) If you are using an IBM JDK, replace the default
WEB-INF/template /keystore/keystore.jcekskeystore file with one generated using the IBM JDK, by performing the following steps:
Generate a new, empty
keystore.jcekskeystore file in IBM JDK format:
keytool -genkey -storetype jceks -keystore keystore.jceks -storepass changeit -keypass changeit
Copy the new
keystore.jcekskeystore file into the expanded WAR file, overwriting the existing
cp keystore.jceks /tmp/openam/WEB-INF/template/keystore/keystore.jceks
jar cvf ../AM-7.1.0.war *
In addition to preparing the AM WAR file, perform the following steps to configure WebSphere for AM after you deploy AM into WebSphere:
Load classes from AM bundled libraries before loading classes from libraries delivered with WebSphere:
In the WebSphere administration console, navigate to Application > Application Type > WebSphere enterprise applications > AM Name > Class loading and update detection.
Set Class loader order > Classes loaded with local class loader first (parent last).
Ensure that the value of the WAR class loader policy property is set to the default value:
Class loader for each WAR file in application.
Save your work.
(Optional) If your environment uses SOAP, perform the following steps to add SOAP-related properties to the JVM:
In the WebSphere administration console, select Servers.
Expand Server Type, and select WebSphere application servers.
Select your WebSphere server name.
Expand Java and Process Management, and select Process Definition.
Under the Additional Properties section, select Java Virtual Machine.
Locate the Generic JVM argument box and add the following properties:
-Djavax.xml.soap.MessageFactory=com.sun.xml.internal.messaging.saaj.soap.ver1_1.SOAPMessageFactory1_1Impl -Djavax.xml.soap.SOAPFactory=com.sun.xml.internal.messaging.saaj.soap.ver1_1.SOAPFactory1_1Impl -Djavax.xml.soap.SOAPConnectionFactory=com.sun.xml.internal.messaging.saaj.client.p2p.HttpSOAPConnectionFactory -Djavax.xml.soap.MetaFactory=com.sun.xml.internal.messaging.saaj.soap.SAAJMetaFactoryImpl -Dcom.ibm.websphere.webservices.DisableIBMJAXWSEngine=true
Save your work.