Oracle® Identity Manager Installation Guide for WebSphere Release 9.0.3.1 Part Number B32462-02 |
|
|
View PDF |
This chapter explains how to set up WebSphere before and after installing Oracle Identity Manager.
This chapter discusses the following topics:
Preparing to Install Oracle Identity Manager as a Non-Root User on UNIX or Linux
Starting WebSphere Before Installing Oracle Identity Manager
Note:
Refer to "Deploying in a Clustered WebSphere Configuration" if you are using WebSphere in an application server cluster.The following are high-level pre- and post-installation tasks. You must perform all of these tasks.
Task overview: WebSphere installation and configuration:
Install the WebSphere Application Server.
See "Installing the WebSphere Application Server" on page 3-2 for more information.
Install WebSphere Application Client.
See "Installing the WebSphere Application Client" on page 3-2 for more information.
Enable SOAP Communication to WebSphere.
See "Enabling SOAP Communication with WebSphere" on page 3-3 for more information.
Upgrade WebSphere server and client software.
See "Upgrading the WebSphere Server and Client" on page 3-4 for more information.
Prepare the environment.
See "Setting Environment Variables" on page 3-4 for more information.
Increase the memory setting for the Java Virtual Machine.
See "Setting the Memory Size" on page 3-5 for more information.
Obtain the cell and node name of the WebSphere instance where you plan to install Oracle Identity Manager.
See "Obtaining the WebSphere Cell and Node Name" on page 3-5 for more information.
Install Oracle Identity Manager.
See "Starting WebSphere Before Installing Oracle Identity Manager" on page 3-6 for more information.
Install WebSphere using the full (default) installation option.If you select instead a custom installation of WebSphere, pay attention to the following:
Make sure that the path you specify for the application server location ends with AppServer
. For example on Windows, a valid path might be the following:
C:\IBM\WebSphere\AppServer
Make sure that the following WebSphere components are installed during the WebSphere installation:
Admin scripting
Ant utilities
Assembly and deployment tools
Embedded Messaging Server and client
By default, the WebSphere installation uses the application server named server1.
You can use any server name for your Oracle Identity Manager installation. See "Configuring WebSphere on a Nondefault Server" for detailed information on configuring WebSphere to use a nondefault server name.
The WebSphere Application Client is required to run the Oracle Identity Manager Design Console. Install the WebSphere Application Client 5.1 with the typical (default) installation. Consult your WebSphere documentation for detailed installation procedures.
The Oracle Identity Manager installer communicates with WebSphere as a SOAP client using JACL commands to create data sources, set up message queues, and perform other operations.
To enable SOAP communication with WebSphere:
Open the following file in a text editor:
<WEBSPHERE_HOME>\properties\soap.client.props
Edit the property lines as follows:
com.ibm.SOAP.securityEnabled=true com.ibm.SOAP.loginUserid=xelsysadm com.ibm.SOAP.loginPassword=xelsysadm
Note:
If you used a user ID or password other than xelsysadm for WebSphere, enter those here.Save and close the file.
During WebSphere Application Client installation, you are prompted for the WebSphere Server hostname and port. The port is the WebSphere bootstrap port. You must also provide this port number during Design Console installation. Obtain the bootstrap port number using the WebSphere administrative console.
Note:
The WebSphere application server must be running to obtain the bootstrap port number.To view the bootstrap port number on a non-clustered (singleton) installation:
Log in to the WebSphere administrative console.
Select Servers, then select Application Servers, then select <SERVER_NAME>, then select End Points, and then select Bootstrap Address.
The bootstrap port is displayed.
To view the bootstrap port number on a clustered installation:
Log in to the WebSphere administrative console.
Select Servers, then select Application Servers, then select <Model_Node_Server_Name>, then select End Points, and then select Bootstrap Address.
The bootstrap port is displayed.
Note:
If you are using a clustered WebSphere environment, manually edit the Oracle Identity Manager Design Console configuration file and provide a list of all the bootstrap ports in the cluster. See "Installing Oracle Identity Manager Cluster using a Shared Directory" for more information.Both the WebSphere server and the client must be updated with the latest fix packs from IBM.
Perform these upgrades in the following order:
Upgrade your WebSphere server as follows:
from 5.1 to 5.1.1
from 5.1.1 to 5.1.1.5
from 5.1.1.5 to 5.1.1.12
Upgrade your WebSphere client as follows:
from 5.1 to 5.1.1
from 5.1.1 to 5.1.1.5
from 5.1.1.5 to 5.1.1.12
Setting environment variables involves the following:
Ensure that the JAVA_HOME
system variable is set to the appropriate JDK. On Microsoft Windows, Solaris, and Linux, set JAVA_HOME
to Sun JDK. On AIX, set JAVA_HOME
to the IBM JDK (bundled with IBM WebSphere).
See Also:
Oracle Identity Manager Release Notes for Release 9.0.3.1 for information about certified JDK versionsRemove the ANT_HOME
system variable if it is defined.
For Microsoft Windows, Solaris, and Linux, ensure that the Sun JDK is being used when a Java command is run. To do this, include the /java/jre/bin/
directory of the Sun JDK installation in the PATH
ahead of all other path entries. For example:
Microsoft Windows
set PATH=<SUN_JDK_HOME>\jre\bin;%PATH%
Solaris or Linux
export PATH=<SUN_JDK_HOME>/jre/bin:$PATH
For AIX, ensure that the IBM JDK (bundled with IBM WebSphere) is being used when a Java command is run. To do this, include the /java/jre/bin/
directory of IBM JDK installation in the PATH ahead of all other path entries. For example:
export PATH=<IBM_JDK_HOME>/jre/bin:$PATH
Use the following steps to set the memory size. The WebSphere application server must be running to set the memory size.
To set the memory size:
Connect to the WebSphere administrative console using the following URL:
http://<WebSphere Host>:<WebSphere Admin Port>/admin
Select Servers, then Application Servers.
Select the server name.
On the Configuration tab, scroll to the Additional Properties section.
Select Process Definition.
On the Configuration tab, scroll to the Additional Properties section.
Click Java Virtual Machine.
In the General Properties list, change the value for Maximum Heap Size to 1024 MB.
Select OK.
Select Save to commit the setting.
After installing and initially configuring WebSphere, use the following procedure to obtain the cell and node name of the WebSphere instance where you plan to install Oracle Identity Manager. The Oracle Identity Manager installer will prompt you for this information during installation.
To obtain the cell and node name:
Connect to the WebSphere administrative console using the following URL:
http://<WebSphere Host>:<WebSphere Admin Port>/admin
Click Servers on the left section.
Click Application Servers under Servers.
Click the server instance (server1, default) on the right section.
Click the Runtime tab.
Note the values for Cell Name and Node Name.
Note:
If the value of State is notStarted
, then restart the server instance.Installing Oracle Identity Manager as a non-root user on a WebSphere application server running on UNIX or Linux requires certain permissions. Before attempting to install Oracle Identity Manager as a non-root user on a WebSphere application server running on UNIX or Linux, verify the operating system user account installing Oracle Identity Manager has write and execute permissions on the directories where WebSphere will be installed, including <WEBSPHERE_HOME> and <NDM_HOME>.
The Oracle Identity Manager installer needs to communicate with your WebSphere server during installation, therefore you must verify that the application server is running before you start installation.To start WebSphere on Windows, use the Windows Start Menu, or the <WEBSPHERE_HOME>\bin\startServer.bat script. For example, run:
<WEBSPHERE_HOME>\bin\startServer.bat <server name>
To start WebSphere on UNIX or Linux, use the <WEBSPHERE_HOME>/bin/startServer.sh script. For example, run:
<WEBSPHERE_HOME>/bin/startServer.sh <server name>
To install Oracle Identity Manager, follow the installation instructions in the chapter specific to your operating system. See "Installing Oracle Identity Manager Server on Windows" or "Installing Oracle Identity Manager Server on UNIX or Linux" for more information.