Fix Readme
Abstract
IBM OpenPages GRC Platform 7.0 Fix Pack 1 Readme
Content
About this Patch Installer
This patch installer updates the IBM® OpenPages® GRC Platform environment from version 7.0.0.0 to version 7.0.0.1 for Windows/IBM WebSphere Application Server, Windows/Oracle WebLogic Server, AIX/IBM WebSphere Application Server, RHEL/IBM WebSphere Application Server installation. It is a cumulative update.
Depending on your environment and preferences, you can update the database server by manually running SQL scripts. Database scripts can be executed directly on the database server or from the application server.
Important! You must use the patch installer program to update the IBM OpenPages application, workflow, and reporting servers. The patch installer must be run on all application and reporting servers.
Bug Fixes and Known Issues
- Bug Fixes
- Using a shared database instance for IBM OpenPages GRC Platform on Linux, Windows and when using a hypervisor (VM) could encounter memory conflicts and errors during OpenPages Modules installations and FastMap data loads
TechNote: http://www.ibm.com/support/docview.wss?uid=swg21665959
- Using Microsoft Internet Explorer 8 or earlier may cause Browser script errors when loading large amounts of data
TechNote: http://www.ibm.com/support/docview.wss?uid=swg21666009
- Unable to launch Cognos Analysis Studio, Cognos Query Studio or Cognos Report Studio from OpenPages application
TechNote: http://www.ibm.com/support/docview.wss?uid=swg21661656
- The OpenPages application server host name not added to the valid domains or hosts in IBM Cognos Configuration
TechNote: http://www.ibm.com/support/docview.wss?uid=swg21661659
- OpenPages Modules installation completed with errors in DB2 environment
TechNote: http://www.ibm.com/support/docview.wss?uid=swg21664626
- Upgrade from OpenPages 6.2.1 to 7.0 in Linux/WAS/DB2 with Modules failed in step - Upgrading Real Time Reporting Schema
TechNote: http://www.ibm.com/support/docview.wss?uid=swg21662889
- Unable to install OpenPages 7.0 and CommandCenter in mixed operating systems using OpenPages Administrative Console
Technote: http://www.ibm.com/support/docview.wss?uid=swg21662906
- If you have performed any changes to application.xml (for example, removed "openpages" from the app URL), then you will need to follow the steps below to preserve the settings.
- Before applying the patch, navigate to OpenPages\applications\op-apps\META-INF\application.xml
- Copy the file to a temporary location.
- Apply the patch.
- Stop all services (if running).
- Return to OpenPages\applications\op-apps\META-INF\application.xml
- Restore your old settings back from the file you backed up before.
- Restart the services.
- Before applying the patch, navigate to /opt/OpenPages/profiles/OpenPagesDmgr/config/cells/OpenPagesCell/applications/op-apps.ear/deployments/op-apps/META-INF/application.xml
- Copy the file to a temporary location.
- Apply the patch.
- Stop all services (if running)
- Return to /opt/OpenPages/profiles/OpenPagesDmgr/config/
cells/OpenPagesCell/applications/op-apps.ear/deployments/
op-apps/META-INF/application.xml - Open the file in a text editor and compare it to the previously backed up file.
- Restore previously customized settings.
- This above steps 5, 6 & 7 needs to be done for all nodes in the cluster. Each node will have a version of application.xml in a path similar to:
opt/OpenPages/profiles/<Node Name>1/installedApps/OpenPagesCell/op-apps.ear/META-INF/application.xml
If you have performed any changes to web.xml (for example, changed session time-outs), then you will need to follow the steps below to preserve the settings
- Session Timeout Settings
- Please refer to page 430 of the Administrator’s Guide, "Setting a Session Inactive Timeout Values in Oracle Weblogic Environment”.
- Please note down the current "Session Timeout"
For Example:
<!-- Set the default session timeout (in minutes) -->
<session-config>
<session-timeout>90</session-timeout>
</session-config>
- Apply the fix pack and then stop services.
- Again refer to page 430 of the Administrator’s Guide to restore the original value.
- Please refer page 431 of the Administrator’s Guide, "Setting a Session Inactivity Timeout Values in IBM WebSphere Environment"
- Please note down the current Timeout Value.
- Apply the fix pack
- Again refer page 431 of the Administrator’s Guide to restore the original value.
- For more information, please see the IBM OpenPages 7.0.0 fp1 release page:
http://www.ibm.com/support/docview.wss?uid=swg27040490#tab_70FP1
Known Issues
- Oracle WebLogic
IBM WebSphere
Oracle WebLogic
Prerequisite Software
- Prior to installing the IBM® OpenPages® GRC Platform 7.0.0.1, you should have OpenPages 7.0.0.0 installed
Information You Need
- For the OpenPages application update:
- The existing installation path of the OpenPages application server and the administrative server port number
- The existing installation path of the Interstage BPM workflow server, application server port number and the administrative server port number
- The existing installation path of the Oracle WebLogic or IBM WebSphere server with the corresponding admin server user name and password
- The number of cluster members configured on the machine
- The user name and password of the OpenPages application super administrator.
- The status of WebSphere Global Security for the IBM WebSphere Application Server
- For the Oracle database update:
- The existing location of the Oracle Client folder
- The Oracle database alias name
- The OpenPages database user name and password
- The Interstage BPM workflow database user name and password
- For the DB2 database update:
- The existing location of the DB2 Client folder
- The OpenPages database user name and password
- The Interstage BPM workflow database user name and password
- For the CommandCenter update:
- The existing installation path of the Cognos server
- The existing installation path of the CommandCenter folder
- The dispatcher URL for the CommandCenter
The 7.0.0.1 patch requires the following information.
Before you start the patch update process, perform the following tasks.
Task 1: Backing Up the Entire OpenPages Environment
- These tasks are required.
Use the OPBackup utility to back up the necessary OpenPages files and database content on the server where it is run.
Run the OpenPages and CommandCenter Backup Utilities
Run the OpenPages backup (OPBackup) and CommandCenter backup (OPCCBackup) utilities to completely back up your OpenPages database and application, and CommandCenter Content Store and files.
Note: If this is the first time you are using the CommandCenter backup utility (OPCCBackup), make sure you configure the Oracle ‘datapump’ storage directory before running this utility.
For details on using the OpenPages and CommandCenter backup utilities and configuring the Oracle Data Pump directory for first-time use, see the “Using Utilities” chapter in the IBM® OpenPages® GRC Platform Administrator’s Guide.
Task 2: Backing up Directories and Files needed for Manual Rollback
- This task is recommended and applies to Windows and Unix environments.
- Log on to the admin server as a user with administrative privileges and full access to the local server drives. For AIX or Linux, use non-root user, such as the user you created for the IBM OpenPages GRC Platform installation, for example opuser.
- Stop all OpenPages services, including the following, on each server in your environment:
- OpenPages application and workflow services
- IBM Cognos service
- OpenPages Framework Model Generator service
Note: For details on stopping services, see the “Starting and Stopping Servers” chapter in the IBM® OpenPages® GRC Platform Administrator’s Guide. - Create the following backup directories in a location that is different from the installation location. For example:
- Copy the following directories and file from the <OP_Home> installation directory to the backup directory location OpenPages7000Backup\OpenPages\:
<OP_Home>\applications
<OP_Home>\aurora
<OP_Home>\bin
<OP_Home>\OpenPagesDomain (for Oracle WebLogic Application Server)
<OP_Home>\profiles (for IBM WebSphere Application Server)
<OP_Home>\openpagesregistry.xml
- Copy the entire <Workflow_Home> installation directory to the backup directory location OpenPages7000Backup\Fujitsu\InterstageBPM.
- Copy the following directories from the <Cognos_Home> installation directory to the backup directory location OpenPages7000Backup\Cognos\cognos\c10_64.
<Cognos_Home>\webapps\p2pd\WEB-INF\lib
<Cognos_Home>\ configuration - Copy the following directories and file from the <CC_Home> installation directory to the backup directory location OpenPages7000Backup\CommandCenter.
<CC_Home>\apache-tomcat
<CC_Home>\tools\bin
<CC_Home>\openpagesregistry.xml
- Start all services including the following:
- OpenPages application and workflow services
- IBM Cognos service
- OpenPages Framework Model Generator service
In the event it is necessary to uninstall the IBM OpenPages GRC Platform 7.0.0.1 patch and revert to the previous version/patch, this section identifies the directories and files that will be required for the uninstall and rollback process.
For specific details of which files to back up, see Creating Back Up Directories in the Event of a Rollback.
Steps:
Operating System | Example backup directory path |
Windows | C:\OpenPages7000Backup\OpenPages C:\OpenPages7000Backup\Fujitsu\InterstageBPM C:\OpenPages7000Backup\Cognos\cognos\c10_64 C:\OpenPages7000Backup\CommandCenter |
AIX or Linux | /opt/OpenPages7000Backup/OpenPages /opt/OpenPages7000Backup/Fujitsu/InterstageBPM /opt/OpenPages7000Backup/Cognos/cognos/c10_64 /opt/OpenPages7000Backup/CommandCenter |
Note: For details on starting services, see the “Starting and Stopping Servers” chapter in the IBM® OpenPages® GRC Platform Administrator’s Guide.
Selecting the Type of Installation
Before you update your system, use the following scenarios to help you decide where to run the patch installer in your particular environment:
- Scenario 1: The application and reporting servers are on separate machines
- Scenario 2: The application and reporting servers are on the same machine
Note: In any of these scenarios, you need to manually upgrade the database server first, using SQL scripts.
Scenario 1: The Application, Database, and Reporting Servers Are on Separate Machines
If the application and reporting servers are each running on different machines (for example, the application server is on Machine-1 and the reporting server is on Machine-2), run the patch installer program as follows:
To update… | Run the patch installer on this machine… | And select this… |
An application server | Application server | Application |
A reporting server | Reporting server | Reporting |
Scenario 2: The Application, Database, and Reporting Servers Are on the Same Machine
If the application and reporting servers are all running on the same machine (for example, Machine-1), use the following method.
Run the patch installer program to automatically update the application, database, and reporting servers as follows.
To update… | Run the patch installer on this machine… | And select this… |
The application and reporting on one system | The application/reporting server | Application and Reporting |
To install the IBM OpenPages GRC Platform 7.0.0.1 patch, perform the following tasks.
Important! Before installing the 7.0.0.1 patch, make sure you have all the required backup folders and files including those described Backing Up the Existing IBM OpenPages GRC Platform Environment.
Task 1: Verify That Servers Are Running
All servers need to be running during installation of the IBM OpenPages GRC Platform 7.0.0.1 patch. If any administrative or managed servers are stopped, start these servers. This is required so the patch installer program can validate user input.
- Verify that all administrative and managed servers are running, including database and reporting servers (both CommandCenter and Framework Manager).
- If this is a horizontal clustered environment then verify all managed servers are running on all non-administrative servers.
- Once the 7.0.0.1 patch installer has finished updating the application and reporting, restart the OpenPages application and reporting servers, including the administrative server.
Note: For details on starting and stopping servers, see the “Starting and Stopping Servers” chapter in the IBM® OpenPages® GRC Platform Administrator’s Guide.
Task 2: Use SQL Scripts to Update the Database Server
Manually update the database server by running SQL scripts included in the media kit.
Important! Manually run SQL scripts to update the database server, you must run the SQL scripts BEFORE using the 7.0.0.1 patch installer.
To update the database server using SQL scripts, follow the instructions in this section.
For Oracle database,
- Steps:
- Log on as an administrative user to a machine with SQL*Plus and access to the database server.
- From the IBM OpenPages GRC Platform Patch Installer 7.0.0.1 media kit, copy the entire OP_7.0.0.1_Database directory to a local directory.
- Open a Command Prompt window (using the Run as Administrator option) or Unix shell and navigate to OP_7.0.0.1_Database directory you just copied.
- Run each SQL script listed in the following table in the order specified.
Script Sequence | Script Name |
1. | OP-7-0-0-1-wfx-schema-upgrade.sql |
2. | OP-7-0-0-1-wfx-core-data-upgrade.sql |
3. | OP-7-0-0-1-wfx-app-data-upgrade.sql |
4. | OP-7-0-0-1-opx-schema-upgrade.sql |
5. | OP-7-0-0-1-opx-procedure-upgrade.sql |
6. | OP-7-0-0-1-opx-core-data-upgrade.sql |
7. | OP-7-0-0-1-opx-app-data-upgrade.sql |
<openpages username> is the user name for accessing the OpenPages database. By default, this is: openpages
<openpages password> is the password for the OpenPages database account
<alias name> is the Oracle Alias name (for example, OP or OP11G)
sqlplus <openpages username>/<openpages password>@<alias name> @sql-wrapper OP-7-0-0-1-wfx-schema-upgrade.sql OP-7-0-0-1-wfx-schema-upgrade.log
sqlplus <openpages username>/<openpages password>@<alias name> @sql-wrapper OP-7-0-0-1-wfx-core-data-upgrade.sql OP-7-0-0-1-wfx-core-data-upgrade.log
sqlplus <openpages username>/<openpages password>@<alias name> @sql-wrapper OP-7-0-0-1-wfx-app-data-upgrade.sql OP-7-0-0-1-wfx-app-data-upgrade.log
sqlplus <openpages username>/<openpages password>@<alias name> @sql-wrapper OP-7-0-0-1-opx-schema-upgrade.sql OP-7-0-0-1-opx-schema-upgrade.log
sqlplus <openpages username>/<openpages password>@<alias name> @sql-wrapper OP-7-0-0-1-opx-procedure-upgrade.sql OP-7-0-0-1-opx-procedure-upgrade.log
sqlplus <openpages username>/<openpages password>@<alias name> @sql-wrapper OP-7-0-0-1-opx-core-data-upgrade.sql OP-7-0-0-1-opx-core-data-upgrade.log
sqlplus <openpages username>/<openpages password>@<alias name> @sql-wrapper OP-7-0-0-1-opx-app-data-upgrade.sql OP-7-0-0-1-opx-app-data-upgrade.log
5. When finished, close the Command Prompt window.
For DB2 database,
- Steps:
- Log on as an administrative user to a machine with CLPPlus and access to the database server.
- From the IBM OpenPages GRC Platform Patch Installer 7.0.0.1 media kit, copy the entire OP_7.0.0.1_Database directory to a local directory.
- Open a Command Prompt window (using the Run as Administrator option) or Unix shell and navigate to OP_7.0.0.1_Database directory you just copied.
- Run db2cmd command to launch CLP Window
- Run each SQL script listed in the following table in the order specified.
Script Sequence | Script Name |
1. | OP-7-0-0-1-wfx-schema-upgrade.sql |
2. | OP-7-0-0-1-wfx-core-data-upgrade.sql |
3. | OP-7-0-0-1-wfx-app-data-upgrade.sql |
4. | OP-7-0-0-1-opx-schema-upgrade.sql |
5. | OP-7-0-0-1-opx-procedure-upgrade.bat|.sh |
6. | revalidate.sql |
7. | OP-7-0-0-1-opx-core-data-upgrade.sql |
8. | OP-7-0-0-1-opx-app-data-upgrade.sql |
<openpages username> is the user name for accessing the OpenPages database. By default, this is: openpages
<openpages password> is the password for the OpenPages database account
<host name> is the database machine name
<instance port> is the instance port (for example, 50000)
<database name> is the instance name (for example, OPX)
clpplus -nw <openpages username>/<openpages password>@<HOST NAME>:<instance port>/<database name> @sql-wrapper OP-7-0-0-1-wfx-schema-upgrade.sql OP-7-0-0-1-wfx-schema-upgrade.log
clpplus -nw <openpages username>/<openpages password>@<HOST NAME>:<instance port>/<database name> @sql-wrapper OP-7-0-0-1-wfx-core-data-upgrade.sql OP-7-0-0-1-wfx-core-data-upgrade.log
clpplus -nw <openpages username>/<openpages password>@<HOST NAME>:<instance port>/<database name> @sql-wrapper OP-7-0-0-1-wfx-app-data-upgrade.sql OP-7-0-0-1-wfx-app-data-upgrade.log
clpplus -nw <openpages username>/<openpages password>@<HOST NAME>:<instance port>/<database name> @sql-wrapper OP-7-0-0-1-opx-schema-upgrade.sql OP-7-0-0-1-opx-schema-upgrade.log
OP-7-0-0-1-opx-procedure-upgrade.bat|.sh <database name> <openpages username> <openpages password>
clpplus -nw <openpages username>/<openpages password>@<HOST NAME>:<instance port>/<database name> @sql-wrapper revalidate.sql revalidate.log <openpages username>
db2rbind <database name> -l oprbind.log -u <openpages username> -p <openpages password> -r any
clpplus -nw <openpages username>/<openpages password>@<HOST NAME>:<instance port>/<database name> @sql-wrapper OP-7-0-0-1-opx-core-data-upgrade.sql OP-7-0-0-1-opx-core-data-upgrade.log
clpplus -nw <openpages username>/<openpages password>@<HOST NAME>:<instance port>/<database name> @sql-wrapper OP-7-0-0-1-opx-app-data-upgrade.sql OP-7-0-0-1-opx-app-data-upgrade.log
6. When finished, close the Command Prompt window.
Launch the OpenPagesPatchSetup installer program to launch the patch installation.
Notes
- If this is a horizontal clustered environment, the patch installer must be installed on the administrative server first, and then on all non-administrative servers.
- You must use the patch installer program to update the OpenPages application, workflow, and reporting servers. To update the database server, manually run scripts and needs to be executed before using the patch installer program.
- Navigate to the <OpenPages Installation Folder>/bin directory and verify that the following two properties in the ObjectManager.properties files are set to false configuration.manager.force.update.object.strings=false
Steps:
- Log on to the server where you will perform the upgrade as a user with administrative privileges and full access to the local server drives.
Note: For Unix installs, log in as a non-root user, such as the user you created for the reporting server installation, for example: opuser. - From the IBM OpenPages GRC Platform Patch Installer 7.0.0.1 installation kit, copy the entire OP_7.0.0.1_Installer\IBM OpenPages GRC Platform Patch Installer directory to the application server.
- Open a Command Prompt window (using the Run as Administrator option) or Unix shell, and do the following:
- Navigate to the IBM OpenPages GRC Platform Patch Installer directory you just copied. Navigate to the patch installer in the IBM OpenPages GRC Platform Patch Installer directory:
Disk1\InstData\[Linux, AIX64 or WIN64]\NoVM - Launch the IBM OpenPages GRC Platform patch installer program as follows:
- On the Introduction screen, click next.
Windows | OpenPagesPatchSetup.exe |
AIX/Linux | OpenPagesPatchSetup.bin |
Task 4: Choose the Type of Installation
These instructions assume that you have read the section “About Selecting the Type of Installation” and know which installation options you want to choose.
Steps:
- On the Installation Type screen, do the following.
- Depending on your requirements, select from the following options to automatically update your environment:
- When finished, click Next to continue.
For this server… | Select this option… | Perform these Tasks… |
Admin Application server | Application | Task 5; Task 6; Task 8; Task 9 |
Non-Admin Application server | Application | Task 5; Task 8; Task 9 |
Reporting server | Reporting | Task 7; Task 8; Task 9 |
Application/ Reporting server | Application AND Reporting | Task 5; Task 6; Task 7; Task 8; Task 9 |
Task 5: Enter OpenPages Application Information
These screens will appear when upgrading an OpenPages application server.
Use the following instructions to update the OpenPages application server using the patch installer program.
Steps:
- On the Installation Directory screen, do the following.
- Enter information for the following fields:
- When finished, click Next.
- On the OpenPages Application Server Information screen, do the following.
- Enter information for the following fields:
- When finished, click Next.
In this field… | Enter this… |
OpenPages GRC Platform Installation directory | The installation location of the existing OpenPages application. Example: Windows c:\OpenPages AIX or Linux /opt/OpenPages |
Workflow(Interstage BPM) Installation Folder | The installation location of the existing Fujitsu Interstage BPM workflow server. Example: Windows c:\Fujitsu\InterstageBPM AIX or Linux /opt/Fujitsu/InterstageBPM |
WebLogic Installation Folder Windows/Oracle WebLogic Only | The installation location of the existing Oracle WebLogic server. Example: Windows c:\Oracle\Middleware\wlserver_10.3 |
In this field… | Enter this… |
OpenPages Admin Server Port Number Windows/Oracle WebLogic Only | The administrative server port number used by the Oracle WebLogic Server for the OpenPages application. Windows Default: 7001 |
Interstage BPM Admin Server Port Number Windows/Oracle WebLogic Only | The administrative server port number used by Oracle WebLogic Server for the workflow server. Windows Default: 49901 |
Admin Server User Name Windows/Oracle WebLogic Only | The user name for accessing the Oracle WebLogic Server Administration Console. Windows Default: weblogic |
Admin Server User Password Windows/Oracle WebLogic Only | The password for the Oracle WebLogic or IBM WebSphere admin account. |
Confirm Password Windows/Oracle WebLogic Only | Re-enter the above password for confirmation. |
How many cluster members do you have configured on this machine? | The number of cluster members on the current machine. |
Is Security Enabled? IBM WebSphere Application Server Only | Select one of the following: · No – if WebSphere Global Security is not enabled. · Yes – if WebSphere Global Security is enabled, and then proceed to the following fields: o Admin Server User Name - enter the user name for accessing the IBM WebSphere Integrated Solutions Console. o Admin Server User Password - enter the password for the IBM WAS admin account. o Confirm Password - re-enter the above password for confirmation. |
Task 6: Enter OpenPages Administrator Information
This screen will appear when upgrading an OpenPages admin server.
Use the following instructions to update the admin server using the patch installer program.
- On the OpenPages Application User Information screen, do the following.
- Enter information for the following fields:
- Click Next.
In this field… | Enter this… |
OpenPages Application User | The administrative user name for accessing the OpenPages application. By default, this is: OpenPagesAdministrator |
OpenPages Application Password | The password for the OpenPages administrator account. |
Confirm Password | Re-enter the above password. |
Task 7: Enter Reporting Server Information
This screen will appear when upgrading a CommandCenter reporting server.
Use the following instructions to update the reporting server using the patch installer program.
Steps:
- On the OpenPages Reporting Server Information screen, enter information for the following fields:
- When finished, click Next.
In this field… | Enter this… |
Cognos Installation Directory | The installation location of the Cognos application. Example: Windows C:\OpenPages\Cognos\cognos\c10_64 AIX or Linux /opt/OpenPages/Cognos/cognos/c10_64 |
OpenPages CommandCenter Directory | The location of the OpenPages CommandCenter folder. Example: Windows C:\OpenPages\CommandCenter AIX or Linux /opt/OpenPages/CommandCenter |
CommandCenter Dispatcher URL | The Dispatcher URL for the OpenPages CommandCenter Example: http://<servername>:9300/p2pd/servlet/dispatch |
This screen will appear when upgrading an OpenPages database server.
Use the following instructions to update the database using the patch installer program.
Steps:
For Oracle Database:
- 1. On the OpenPages Database Information screen, do the following:
- Enter information for the following fields:
- When finished, click Next.
In this field… | Enter this… |
Oracle Client Directory | The location on the OpenPages application server where the Oracle Client software is installed. This should be the same as the ORACLE_HOME value. Example In this example, the database and application servers are on different machines: Windows C:\openpages_data\repository\ client112_ac_x64\software AIX or Linux /opt/oracle/openpages_data/repository/ client112_ac_x64/software |
Database Alias Name | The TNS name of the OpenPages database instance. |
OpenPages User Name | The user name for accessing the OpenPages database. By default, this is: openpages |
OpenPages Password | The password for the OpenPages database account. |
Confirm Password | Re-enter the above password for confirmation. |
- 1. On the OpenPages Database Information screen, do the following:
- Enter information for the following fields:
- When finished, click Next.
In this field… | Enter this… |
DB2 Client Directory | The location on the OpenPages application server where the DB2 Client software is installed. This should be the same as the DB2_HOME value. Example In this example, the database and application servers are on different machines: Windows C:\db2inst1\sqllib AIX or Linux /home/db2inst1/sqllib |
OpenPages Database User Name | The user name for accessing the OpenPages database. By default, this is: openpages |
OpenPages Database Password | The password for the OpenPages database account. |
Workflow Database User Name | The user name for accessing the Workflow (Interstage BPM) database. By default, this is: opworkflow |
Workflow Database Password | The password for the Workflow (Interstage BPM) database account. |
Task 9: Start Servers
This task applies in all patch scenarios.
Note: For details on starting and stopping servers, see the “Starting and Stopping Servers” chapter in the IBM® OpenPages® GRC Platform Administrator’s Guide.
Steps:
- Start all application and workflow servers using the StartAllServers script.
- Start the reporting server (including the CommandCenter and OpenPages Framework Model Generator services).
- For a horizontal clustered environment, use the following sequence to restart IBM Cognos services:
- Stop IBM Cognos services on all secondary servers.
- Stop IBM Cognos service on the primary server.
- Start IBM Cognos service on the primary server.
- Start IBM Cognos services on all secondary servers.
Locating Patch Installation Log Files
If errors occur during the patch installation process, you can review the following patch installer log files for troubleshooting.
Patch Log Files for the Application, Workflow, and Reporting Servers
Log files related to the OpenPages application, workflow, and reporting servers can be found on the server where you ran the patch installer:
- <OP_Home>\patch\logs\OpenPages_Patch_Installer_Debug.log
- <OP_Home>\patch\logs\OpenPages_Patch_Installer_Error.log
Where: <OP_Home> is the installation location of the IBM OpenPages GRC Platform application. By default, the path is:
Windows | C:\OpenPages |
AIX or Linux | /opt/OpenPages |
Patch Log Files for the Database Server
Log files related to the database server patch can be found on the server where you ran the database patch sql.
- <OP_Home>\patch\logs\debug\OpenPages_Patch_Installer_Debug.log
Where: <OP_Home> is the installation location of the IBM OpenPages GRC Platform application. By default, the path is:
Windows | C:\OpenPages |
AIX or Linux | /opt/OpenPages |
Note that in the case of a database only install, the logs will be located here:
Windows | <User>\AppData\Local\Temp\patch |
AIX or Linux | /tmp |
Perform the following tasks after completing the patch to 7.0.0.1.
Task 1: Apply the Modules Patch
This task is required for all OpenPages environments.
After you have updated your system to IBM OpenPages GRC Platform 7.0.0.1, apply the OpenPages Modules patch
Use Case 1:
Make sure you have Fresh installation of OpenPages v7.0 Fresh with modules without any customization.
<OpenPages 7.0.0.1 Kit>\Modules contains triggers, solutions reports, version update files
Steps:
- Stop OP and Cognos
- Copy "openpages-ext.jar" from Modules/triggers in the Modules patch kit to <OP_HOME>/aurora/lib/
- Copy "OpenPages_Solutions_V6.zip" from Modules/Oracle or Modules/DB2 Module in patch kit into <COGNOS_HOME>/deployment
- Replace the "_trigger_config.xml" contained in <MODULE_HOME>/temp/applications/loaderdata/Triggers/TriggerLoader-op-file-content.zip with the one from Modules/triggers in the Modules patch kit
- Copy "solutions-sosa-files.zip" from Modules patch kit into
For IBM WebSphere Application Server,
<OP_HOME>/applications/ and explode this zip into <OP_HOME>/profiles/<HOST_NAME>-OPNode1/installedApps/OpenPagesCell/op-apps.ear/sosa.war (Select to override if prompted)
For Oracle WebLogic Application Server,
Explode this zip into <OP_HOME>/applications/opapps/sosa (Select to override if prompted)
- Start OP and Cognos
- Load the trigger
Navigate to <OP_HOME>/bin
ObjectManager.cmd|sh l c <OP_APP_USER_NAME> <OP_APP_USER_PASSWD> <MODULE_HOME>/temp/applications/loaderdata/Triggers TriggerLoader - Load the Solution Reports package
Navigate to <CC_HOME>/temp/bin
importReports.bat|sh -a "OpenPages_Solutions_V6" -s OpenPagesSecurityRealm -u <OP_APP_USER_NAME> -p <OP_APP_USER_PASSWD> -g <COGNOS_DISPATCHER_URL> - Update the Modules version
Navigate to <OP_HOME>/bin
Objectmanager.cmd|sh l c <OP_APP_USER_NAME> <OP_APP_USER_PASSWD> <Location of the Modules Kit>/Modules/loader-data OpenPages-register-fcm-module
Objectmanager.cmd|sh l c <OP_APP_USER_NAME> <OP_APP_USER_PASSWD> <Location of the Modules Kit>/Modules/loader-data OpenPages-register-iam-module
Objectmanager.cmd|sh l c <OP_APP_USER_NAME> <OP_APP_USER_PASSWD> <Location of the Modules Kit>/Modules/loader-data OpenPages-register-itg-module
Objectmanager.cmd|sh l c <OP_APP_USER_NAME> <OP_APP_USER_PASSWD> <Location of the Modules Kit>/Modules/loader-data OpenPages-register-orm-module
Objectmanager.cmd|sh l c <OP_APP_USER_NAME> <OP_APP_USER_PASSWD> <Location of the Modules Kit>/Modules/loader-data OpenPages-register-pcm-module - Restart OP and Cognos
Use Case 2:
Make sure you have Upgraded OpenPages v7.0 with modules. [Modules upgraded using the steps/tools shipped in the Module Upgrade Kit]
Steps:
- Stop OP and Cognos
- Merge openpages-ext.jar
- Backup openpages-ext.jar from <OP_HOME>/aurora/lib/
- Extract "openpages-ext.jar" from <OP_HOME>/aurora/lib/ to <OP_HOME>/merge/
- Extract “openpages-ext.jar” from Modules/triggers in the Modules patch kit to <OP_HOME>/merge/ [allow/choose to overwrite existing file)
- Zip/Jar the files and folders under the “merge” folder as “openpages-ext.jar”
- Copy the Updated “openpages-ext.jar” to <OP_HOME>/aurora/lib/ [allow/choose to overwrite the file]
- Copy "OpenPages_Solutions_V6.zip" from Modules/ORA or Modules/DB2 in Modules patch kit into <COGNOS_HOME>/deployment
- Copy "solutions-sosa-files.zip" from Modules patch kit into
For IBM WebSphere Application Server
<OP_HOME>/applications/ and explode this zip into <OP_HOME>/profiles/<HOST_NAME>-OPNode1/installedApps/OpenPagesCell/op-apps.ear/sosa.war (Select to override if prompted)
For Oracle WebLogic Application Server
Explode this zip into <OP_HOME>/applications/op-app/sosa (Select to override if prompted) - Start OP and Cognos
- Load the Solution Reports package
Navigate to <CC_HOME>/temp/bin
importReports.bat|sh -a "OpenPages_Solutions_V6" -s OpenPagesSecurityRealm -u <OP_APP_USER_NAME> -p <OP_APP_USER_PASSWD> -g <COGNOS_DISPATCHER_URL> - Update the Modules version
Navigate to <OP_HOME>/bin
Objectmanager.cmd|sh l c <OP_APP_USER_NAME> <OP_APP_USER_PASSWD> <Location of the Modules Kit>/Modules/loader-data OpenPages-register-fcm-module
Objectmanager.cmd|sh l c <OP_APP_USER_NAME> <OP_APP_USER_PASSWD> <Location of the Modules Kit>/Modules/loader-data OpenPages-register-iam-module
Objectmanager.cmd|sh l c <OP_APP_USER_NAME> <OP_APP_USER_PASSWD> <Location of the Modules Kit>/Modules/loader-data OpenPages-register-itg-module
Objectmanager.cmd|sh l c <OP_APP_USER_NAME> <OP_APP_USER_PASSWD> <Location of the Modules Kit>/Modules/loader-data OpenPages-register-orm-module
Objectmanager.cmd|sh l c <OP_APP_USER_NAME> <OP_APP_USER_PASSWD> <Location of the Modules Kit>/Modules/loader-data OpenPages-register-pcm-module
Task 2: Apply the Process Survey Patch
This task is Optional (if Process Survey is not configured)
Use Case 1: If you already configured Process Survey in v7.0
Steps:
- Copy ProcessSurvey.jsp from the Media to the OpenPages Application
For IBM WebSphere Application Server:
<OP_HOME>/profiles/<HOST_NAME>-OPNode1/installedApps/OpenPagesCell/op-apps.ear/sosa.war/survey (Select to override if prompted)
For Oracle WebLogic Application Server
<OP_HOME>/applications/op-app/sosa/survey (Select to override if prompted) - Restart OpenPages Application
Use Case 2: If you want to configure Survey in v7.0 fp1
Steps:
- Copy Process Survey files from v7.0 Media
- Replace process-survey-op-file-content.zip from v7.0 fp1
- Follow the Instructions on how to configure process survey in the IBM® OpenPages® GRC Platform Administrator’s Guide under section "Modifying Object Types - About Property Rendering JSP Files"
Creating Back Up Directories in the Event of a Rollback
This task is recommended.
Before installing the IBM OpenPages GRC Platform 7.0.0.1 patch, create a backup directory and copy essential system files in the event you need to restore your previous OpenPages environment.
Task 1: Stop all Services
- Log on to the admin server as a user with administrative privileges and full access to the local server drives. For AIX or Linux, use non-root user, such as the user you created for the IBM OpenPages GRC Platform installation, for example opuser.
- Stop all services including the following:
- OpenPages application and workflow services
- IBM Cognos service
- OpenPages Framework Model Generator service
Note: For details on stopping services, see the “Starting and Stopping Servers” chapter in the IBM® OpenPages® GRC Platform Administrator’s Guide.
Task 2: Create a Backup Directory
- Create a backup directory in a location that is different from the installation location. For example:
Windows | C:\OpenPages7000Backup |
AIX or Linux | /opt/OpenPages7000Backup |
Task 3: Backup OpenPages Application Directories
- Navigate to the <OP_Home> installation directory.
- Copy the following directories and file from the <OP_Home> installation directory to the backup directory location:
Copy this directory or file in <OP_Home>… | To the backup location… |
applications | For example, copy the applications directory from <OP_Home> to OpenPages7000Backup\OpenPages\applications |
aurora | For example, copy the aurora directory from <OP_Home> to OpenPages7000Backup\OpenPages\aurora |
bin | For example, copy the bin directory from <OP_Home> to OpenPages7000Backup\OpenPages\bin |
for Oracle WebLogic only: OpenPagesDomain | For example, copy the OpenPagesDomain directory from <OP_Home> to C:\OpenPages7000Backup\OpenPages\OpenPagesDomain |
for IBM WebSphere only: profiles | For example, copy the profiles directory from <OP_Home> to /opt/OpenPages7000Backup/OpenPages/profiles |
openpagesregistry.xml | For example, copy the openpagesregistry.xml file from <OP_Home> to OpenPages7000Backup\OpenPages\ openpagesregistry.xml |
Task 4: Backup the Interstage BPM Directory
Copy specified files to the backup directories you created.
Steps:
- Navigate to the <Workflow_Home> installation directory where: <Workflow_Home> represents the installation location of the Fujitsu Interstage BPM server. By default, this is:
- Copy the <Workflow_Home> root installation directory to the backup directory location:
Windows | C:\Fujitsu\InterstageBPM |
AIX or Linux | /opt/Fujitsu/InterstageBPM |
Copy this directory… | To the backup location… |
<Workflow_Home> | For example, copy the <Workflow_Home> directory to OpenPages7000Backup\Fujitsu\InterstageBPM |
Task 5: Backup IBM Cognos Directories
Copy specified files to the backup directories you created.
Steps:
- Log on to the reporting server as a user with administrative privileges and full access to the local server drives. For AIX or Linux, use non-root user, such as the user you created for the IBM OpenPages GRC Platform installation, for example opuser.
- Navigate to the <Cognos_Home> installation directory where: <Cognos_Home> represents the installation location of the IBM Cognos application, by default:
- Copy the following directories from the <Cognos_Home> installation directory to the backup directory location:
Windows | C:\OpenPages\Cognos\cognos\c10_64 |
AIX or Linux | /opt/OpenPages/Cognos/cognos/c10_64 |
Copy this directory in <Cognos_Home>… | To the backup location… |
Webapps\p2pd\WEB-INF\lib | For example, copy the lib directory from <Cognos_Home>\webapps\p2pd\WEB-INF to OpenPages7000Backup\Cognos\lib |
configuration | For example, copy the configuration directory from <Cognos_Home> to OpenPages7000Backup\Cognos\configuration |
Task 6: Backup CommandCenter Directories and Files
Steps:
- 1. On the reporting server, navigate to the <CC_Home> installation directory where: <CC_Home> represents the installation location of the OpenPages CommandCenter application. By default, this is:
- Copy the following directories and file from the <CC_Home> installation directory to the backup directory location:
Windows | C:\OpenPages\CommandCenter |
AIX or Linux | /opt/OpenPages/CommandCenter |
Copy this directory or file in <CC_Home>… | To the backup location… |
apache-tomcat | For example, copy the apache-tomcat directory from <CC_Home> to OpenPages7000Backup\CommandCenter\apache-tomcat |
tools\bin | For example, copy the bin directory from <CC_Home>\tools to OpenPages7000Backup\CommandCenter\bin |
openpagesregistry.xml | For example, copy the openpagesregistry.xml file from <CC_Home> to OpenPages7000Backup\CommandCenter\ openpagesregistry.xml |
Task 7: Start all Services
Start all services including the following:
- OpenPages application and workflow services
- IBM Cognos service
- OpenPages Framework Model Generator service
Note: For details on starting services, see the “Starting and Stopping Servers” chapter in the IBM® OpenPages® GRC Platform Administrator’s Guide.
Uninstalling This Patch
Uninstalling the 7.0.0.1 patch will revert the system to the previous 7.0.0.0 level, including the data in the database.
To uninstall the IBM OpenPages GRC Platform 7.0.0.1 patch perform the following tasks.
Task 1: Stop all Services
Stop all services including the following:
· OpenPages application and workflow services
· IBM Cognos service
· OpenPages Framework Model Generator service
Note: For details on stopping services, see the “Starting and Stopping Servers” chapter in the IBM® OpenPages® GRC Platform Administrator’s Guide.
Task 2: Run Patch Uninstaller
Steps:
1. Log on to the admin server as a user with administrative privileges and full access to the local server drives.
For Unix, use non-root user, such as the user you created for the IBM OpenPages GRC Platform installation, for example opuser.
2. Navigate to the <OP_Home> patch uninstallation directory.
Where: <OP_Home> represents the installation location of the OpenPages application, by default:
Windows | C:\OpenPages\Patch\Uninstall_OpenPages_Patch |
AIX or Linux | /opt/OpenPages/patch/Uninstall_OpenPages_Patch |
3. Run Patch Uninstaller
a. OpenPagesPatchUninstall.exe for Windows
b. OpenPagesPatchUninstall.bin for Unix
Task 3: Restore the Database
Run the OpenPages restore (OPRestore) and CommandCenter restore (OPCCRestore) utilities to restore the database to the previous IBM OpenPages GRC Platform 7.0.0.0 level.
Note: For details on using the restore utilities, see the “Using Utilities” chapter in the IBM® OpenPages® GRC Platform Administrator’s Guide.
Task 4: Start all Services
Start all services including the following:
· OpenPages application and workflow services
· IBM Cognos service
· OpenPages Framework Model Generator service
Note: For details on starting services, see the “Starting and Stopping Servers” chapter in the IBM® OpenPages® GRC Platform Administrator’s Guide.
Documentation Updates
You can download the latest revision to the IBM® OpenPages® GRC Platform 7.0.0.0 documentation set from the IBM information server at:
http://www-01.ibm.com/support/docview.wss?uid=swg27036766
Appendix A – Silent Patch Installation and Uninstallation
Silent Patch Installation:
Task 1: Complete Task 1 and Task 2 from the “Patch Installation Tasks”
Task 2: Update Silent Installer Properties
1. Log on to the server where you will perform the patch as a user with administrative privileges and full access to the local server drives.
Note: For Unix installs, log in as a non-root user, such as the user you created for the reporting server installation, for example: opuser.
2. From the IBM OpenPages GRC Platform Patch Installer 7.0.0.1 installation kit, copy the entire OP_7.0.0.1_Installer\IBM OpenPages GRC Platform Patch Installer directory to the application server.
3. Navigate to the IBM OpenPages GRC Platform Patch Installer directory you just copied.
4. Navigate to the patch installer in the IBM OpenPages GRC Platform Patch Installer directory:
OP_7.0.0.1_Installer\silent-install
5. Update op-silentInstaller-Patch-WAS.properties file with the right values and copy it to Disk1\InstData\[Linux, AIX64 or WIN64]\NoVM
Task 3: Run Patch Installer Silently
Silently Launch the OpenPagesPatchSetup installer program to launch the patch installation.
Notes
· If this is a horizontal clustered environment, the patch installer must be installed on the administrative server first, and then on all non-administrative servers.
· You must use the patch installer program to update the OpenPages application, workflow, and reporting servers. To update the database server, manually run scripts and needs to be executed before using the patch installer program.
Steps:
1. Open a Command Prompt window (using the Run as Administrator option) or Unix shell, and do the following:
a. Navigate to the IBM OpenPages GRC Platform Patch Installer directory you just copied.
Navigate to the patch installer in the IBM OpenPages GRC Platform Patch Installer directory:
Disk1\InstData\[Linux, AIX64 or WIN64]\NoVM
b. Launch the IBM OpenPages GRC Platform patch installer program silently as follows:
For Oracle WebLogic
Windows | OpenPagesPatchSetup.exe -i silent -f op-silentInstaller-Patch-WLS.properties |
For IBM WebSphere
Windows | OpenPagesPatchSetup.exe -i silent -f op-silentInstaller-Patch-WAS.properties |
AIX/Linux | OpenPagesPatchSetup.bin -i silent -f op-silentInstaller-Patch-WAS.properties |
Task 4: Start Servers
This task applies in all patch scenarios.
Note: For details on starting and stopping servers, see the “Starting and Stopping Servers” chapter in the IBM® OpenPages® GRC Platform Administrator’s Guide.
Steps:
1. Start all application and workflow servers using the StartAllServers script.
2. Start the reporting server (including the CommandCenter and OpenPages Framework Model Generator services).
For a horizontal clustered environment, use the following sequence to restart IBM Cognos services:
a. Stop IBM Cognos services on all secondary servers.
b. Stop IBM Cognos service on the primary server.
c. Start IBM Cognos service on the primary server.
d. Start IBM Cognos services on all secondary servers.
Task 5: Complete the “Locating Patch Installation Log Files” and “Post-Installation Tasks”
Silent Patch Uninstallation:
If you have run the Patch Installer silent then Uninstaller automatically run silently. Follow all the instructions under “Uninstalling the Patch”
Appendix B – Manually Uninstalling Patch
Task 1: Stop all Services
Stop all services including the following:
· OpenPages application and workflow services
· IBM Cognos service
· OpenPages Framework Model Generator service
Note: For details on stopping services, see the “Starting and Stopping Servers” chapter in the IBM® OpenPages® GRC Platform Administrator’s Guide.
Task 2: Restore OpenPages Application Directories and File
Steps:
1. Log on to the admin server as a user with administrative privileges and full access to the local server drives.
For AIX or Linux, use non-root user, such as the user you created for the IBM OpenPages GRC Platform installation, for example opuser.
2. Navigate to the <OP_Home> installation directory.
Where: <OP_Home> represents the installation location of the OpenPages application, by default:
Windows | C:\OpenPages |
AIX or Linux | /opt/OpenPages |
3. Delete the following directories and file from the <OP_Home> installation directory, and then copy the corresponding directories and file from the backup directory location into the <OP_Home> installation directory to restore them:
Delete this directory or file in <OP_Home>… | Copy the corresponding directory or file from the backup location into <OP_Home>… |
applications | For example, copy the applications directory from OpenPages7000Backup\OpenPages\applications into <OP_Home> |
aurora | For example, copy the aurora directory from OpenPages7000Backup\OpenPages\aurora into <OP_Home> |
bin | For example, copy the bin directory from OpenPages7000Backup\OpenPages\bin into <OP_Home> |
For Oracle WebLogic only: OpenPagesDomain | For example, copy the OpenPagesDomain directory from C:\OpenPages7000Backup\OpenPages\OpenPagesDomain into <OP_Home> |
For IBM WebSphere only: profiles | For example, copy the profiles directory from /opt/OpenPages7000Backup/OpenPages/profiles into <OP_Home> |
openpagesregistry.xml | For example, copy the openpagesregistry.xml file from OpenPages7000Backup\OpenPages\ openpagesregistry.xml into <OP_Home> |
Task 3: Restore the Workflow Directory
Steps:
1. Navigate to the <Workflow_Home> installation directory.
Where: <Workflow_Home> represents the installation location of the Fujitsu Interstage BPM server, by default:
Windows | C:\Fujitsu\InterstageBPM |
AIX or Linux | /opt/Fujitsu/InterstageBPM |
2. Delete the <Workflow_Home> root directory, and then copy the corresponding <Workflow_Home> root installation directory from the backup directory location into the <Workflow_Home> installation directory to restore it:
Delete this installation directory… | Copy the corresponding directory from the backup location into <Workflow_Home>… |
<Workflow_Home> | For example, copy the root Fujitsu\InterstageBPM directory from OpenPages7000Backup\Fujitsu\InterstageBPM into the <Workflow_Home> location. |
Task 4: Restore IBM Cognos Directories
Steps:
1. Log on to the reporting server as a user with administrative privileges and full access to the local server drives.
For AIX or Linux, use non-root user, such as the user you created for the IBM OpenPages GRC Platform installation, for example opuser.
2. Navigate to the <Cognos_Home> installation directory.
Where: <Cognos_Home> represents the installation location of the IBM Cognos application, by default:
Windows | C:\OpenPages\Cognos\cognos\c10_64 |
AIX or Linux | /opt/OpenPages/Cognos/cognos/c10_64 |
3. Delete the following directories from the <Cognos_Home> installation directory, and then copy the corresponding directories from the backup directory location into the <Cognos_Home> installation directory to restore them:
Delete this directory in <Cognos_Home>… | Example backup path |
webapps\p2pd\WEB-INF\lib | For example, copy the lib directory from OpenPages7000Backup\Cognos\lib into <Cognos_Home>\webapps\p2pd\WEB-INF |
configuration | For example, copy the configuration directory from OpenPages7000Backup\Cognos\configuration into <Cognos_Home> |
Task 5: Restore OpenPages CommandCenter Directories and File
Steps:
1. On the reporting server, navigate to the <CC_Home> installation directory.
Where: <CC_Home> represents the installation location of the OpenPages CommandCenter application, by default:
Windows | C:\OpenPages\CommandCenter |
AIX or Linux | /opt/OpenPages/CommandCenter |
2. Delete the following directories and file from the <CC_Home> installation directory, and then copy the corresponding directories and file from the backup directory location into the <CC_Home> installation directory to restore them:
Delete this directory file in <CC_Home>... | Copy the corresponding directory or file from the backup location into <CC_Home>… |
apache-tomcat | For example, copy the apache-tomcat directory from OpenPages7000Backup\CommandCenter\apache-tomcat into <CC_Home> |
tools\bin | For example, copy the bin directory from OpenPages7000Backup\CommandCenter\bin into <CC_Home>\tools |
openpagesregistry.xml | For example, copy the openpagesregistry.xml file from OpenPages7000Backup\CommandCenter\ openpagesregistry.xml |
Run the OpenPages restore (OPRestore) and CommandCenter restore (OPCCRestore) utilities to restore the database to the previous IBM OpenPages GRC Platform 7.0.0.0 level.
Note: For details on using the restore utilities, see the “Using Utilities” chapter in the IBM® OpenPages® GRC Platform Administrator’s Guide.
Task 7: Start all Services
Start all services including the following:
· OpenPages application and workflow services
· IBM Cognos service
· OpenPages Framework Model Generator service
Note: For details on starting services, see the “Starting and Stopping Servers” chapter in the IBM® OpenPages® GRC Platform Administrator’s Guide.
Notices
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. This document may describe products, services, or features that are not included in the Program or license entitlement that you have purchased.
IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japan
The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:
IBM Corporation
Location Code FT0
550 King Street
Littleton, MA
01460-1250
U.S.A.
Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.
The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.
Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.
All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.
This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.
If you are viewing this information softcopy, the photographs and color illustrations may not appear.
This Software Offering does not use cookies or other technologies to collect personally identifiable information.
Copyright
Licensed Materials - Property of IBM Corporation.
© Copyright IBM Corporation, 2003, 2014.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written.
These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM's application programming interfaces.
Trademarks
IBM, the IBM logo and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in any jurisdictions worldwide.
The following terms are trademarks or registered trademarks of other companies:
· Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.
· Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.
· Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.
· UNIX is a registered trademark of The Open Group in the United States and other countries.
· Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.
Other product and service names might be trademarks of IBM or other companies.
A current list of IBM trademarks is available on the Web at “ Copyright and trademark information ” at www.ibm.com/legal/copytrade.shtml.
Was this topic helpful?
Document Information
Modified date:
15 June 2018
UID
swg21667236