Embed Size (px)
Citation preview
IBM OpenPages GRC - Workflow StudioVersion 7.3.0
Installation Guide
IBM
NoteBefore using this information and the product it supports, read the information in “Notices” on page 11.
Product Information
This document applies to IBM OpenPages GRC - Workflow Studio Version 7.3.0 and may also apply to subsequentreleases.
Licensed Materials - Property of IBM Corporation.
© Copyright IBM Corporation, 2003, 2016.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.
Contents
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Chapter 1. What's new? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Chapter 2. Installing Workflow Studio . . . . . . . . . . . . . . . . . . . . . . . 3Installation prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Hardware requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Software requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3OpenPages GRC Platform application server requirements . . . . . . . . . . . . . . . . . . . 3
Install OpenPages GRC Platform - Workflow Studio on Windows . . . . . . . . . . . . . . . . . 3Installing Installation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Installing Workflow Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Configuring SSL for Interstage BPM Studio . . . . . . . . . . . . . . . . . . . . . . . . . 5Uninstalling Workflow Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Chapter 3. Upgrading Workflow Studio . . . . . . . . . . . . . . . . . . . . . . 9Software requirements for upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Uninstalling Workflow Studio before an upgrade . . . . . . . . . . . . . . . . . . . . . . . 9Updating server projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
iii
iv IBM OpenPages GRC - Workflow Studio Version 7.3.0: Installation Guide
Introduction
IBM® OpenPages® GRC Platform - Workflow Studio uses Fujitsu InterstageBusiness Process Manager (Interstage BPM) as its workflow engine. It installs amodified version of Interstage BPM Studio so that workflow authors can defineand publish workflow processes within the OpenPages application.
Audience
The IBM OpenPages GRC Platform - Workflow Studio Installation Guide providesinstructions for installing OpenPages GRC Platform - Workflow Studio.
Please read the following important information regarding IBMOpenPages GRC documentation
IBM maintains one set of documentation serving both cloud and on premise IBMOpenPages GRC deployments. The IBM OpenPages documentation describescertain features and functions which may not be available in OpenPages GRC onCloud. For example, OpenPages GRC on Cloud does not include integration withIBM Business Process Manager and certain administrative functions.
If you have any questions about the functionality available in the product versionthat you are using, please contact IBM OpenPages Support via the IBM SupportPortal (http://www.ibm.com/support).
Finding information
To find product documentation on the web, including all translateddocumentation, access IBM Knowledge Center (http://www.ibm.com/support/knowledgecenter).
Accessibility features
Accessibility features help users who have a physical disability, such as restrictedmobility or limited vision, to use information technology products. OpenPagesGRC Platform - Workflow Studio documentation has accessibility features. PDFdocuments are supplemental and include no added accessibility features.
Forward-looking statements
This documentation describes the current functionality of the product. Referencesto items that are not currently available may be included. No implication of anyfuture availability should be inferred. Any such references are not a commitment,promise, or legal obligation to deliver any material, code, or functionality. Thedevelopment, release, and timing of features or functionality remain at the solediscretion of IBM.
v
vi IBM OpenPages GRC - Workflow Studio Version 7.3.0: Installation Guide
Chapter 1. What's new?
New features affect the installation and configuration of IBM OpenPages GRCPlatform - Workflow Studio.
For information about all new features for this release, see the IBM OpenPages GRCPlatform New Features Guide.
For an up-to-date list of environments that are supported by OpenPages GRCPlatform, see the IBM Software Product Compatibility Reports(http://www.ibm.com/support/docview.wss?uid=swg27039467).
New features in version 7.1.0
You now use IBM Installation Manager to install, update, and uninstall IBMOpenPages GRC Platform - Workflow Studio.
1
2 IBM OpenPages GRC - Workflow Studio Version 7.3.0: Installation Guide
Chapter 2. Installing Workflow Studio
The IBM OpenPages GRC Platform - Workflow Studio installer installs a modifiedversion of Fujitsu Interstage BPM Studio. This product is compatible with the wayin which workflows are implemented within the OpenPages application.
Installation prerequisitesEnsure that your computer meets the software and hardware requirements.
Hardware requirementsThe following table lists the minimum hardware requirements to install IBMOpenPages GRC Platform - Workflow Studio.
Table 1. Minimum hardware requirements
Component Minimum hardware requirement
Computer architecture Intel 32-bit or 64-bit PC or server
Memory (RAM) 512 MB or greater
Processor Pentium III 500 MHz or greater
Disk space 250 MB or greater
Software requirementsIBM OpenPages GRC Platform runs on the following operating systems:v Microsoft Windows 7 (64-bit)v Microsoft Windows Server 2008 R2v Microsoft Windows Server 2012
OpenPages GRC Platform application server requirementsThe client computer on which Workflow Studio is installed must have networkaccess to an IBM OpenPages GRC Platform application server.
You configure the server connection parameters when you create a server project inInterstage BPM Studio. For more information, see the IBM OpenPages GRCWorkflow Author's Guide.
Install OpenPages GRC Platform - Workflow Studio on WindowsYou install IBM OpenPages GRC Platform - Workflow Studio on Windows for useby workflow authors.
Before you install Workflow Studio, you must install IBM Installation Manager. Formore information, see “Installing Installation Manager.”
Installing Installation ManagerYou must install IBM Installation Manager so that you can install Workflow Studio.
For more information about Installation Manager, see the IBM Knowledge Center(http://www.ibm.com/support/knowledgecenter/SSDV2W).
3
Procedure1. Download IBM Installation Manager from Passport Advantage® or locate the
version that is supplied with WebSphere® Application Server.2. Double-click install.exe.3. Follow the steps to install IBM Installation Manager.
What to do next
Copy the Workflow Studio package to a suitable location so that you can install itby using IBM Installation Manager.
Installing Workflow StudioYou install IBM OpenPages GRC Platform - Workflow Studio from IBM InstallationManager. Workflow Studio is provided as an IBM Installation Manager package.
When you install, the following tasks are completed:v Automatically installs the required IBM JRE version (if it is not already present
on the computer).v Silently runs the Fujitsu installer for installing the Interstage BPM Studio
application.v Installs OpenPages GRC Platform components into Interstage BPM Studio and
configures the application.
Procedure1. Start IBM Installation Manager.2. Click File > Preferences > Repositories.3. Click Add Repository.4. Enter the path to the Workflow Studio installation files. For example, enter the
path to Workflow_Studio_package\OP_version_IBPM_Studio_Plugin_Installer\repository.conf.
5. Click OK to return to the main IBM Installation Manager window.6. Click Install.7. Select the IBM OpenPages GRC Platform - Workflow Studio > Version
7.2.0.0 package, and click Next.8. Accept the License agreement and click Next.9. Update the Installation directory to C:\IBM\OpenPagesWorkflowStudio, and
click Next.10. Follow the steps in IBM Installation Manager to complete the installation.11. Click Finish and close IBM Installation Manager.
Results
If errors occur during the installation process, review the log files fortroubleshooting information. For more information about log files, see “Log files”on page 7.
What to do next
You must now configure Workflow Studio to communicate with the OpenPagesGRC Platform application server. For more information, see “Configuring SSL forInterstage BPM Studio” on page 5.
4 IBM OpenPages GRC - Workflow Studio Version 7.3.0: Installation Guide
Configuring SSL for Interstage BPM StudioTo connect to a workflow server from Interstage BPM Studio over an SSLconnection, you must complete additional configuration steps for IBM OpenPagesGRC Platform.
Procedure1. For each managed server instance, to configure SSL access, do the following
steps:a. Start the Interstage BPM service if it is not already running for the managed
server instance.b. In a web browser, start the Interstage BPM by typing the following URL:
http://<server_name>:<port>/fujitsu-ibpm-config-webapp/IBPMConfigServlet.The <server_name> in the URL is the host name of your OpenPages GRCPlatform application server.The <port> in the URL is the non-SSL HTTP port number of the managedworkflow server instance. For WebSphere, the non-SSL managed server portnumbers for the Workflow Server typically start at 20108.
c. Log on to the configuration tool as a user who has administrator privileges.d. Enter values for the following parameters:
ServerBaseURLThe value is https://<server_name>:<SSL_port>/ibpmconsole/
The <server_name> in the URL is the host name of your OpenPagesapplication server, and the <SSL_port> is the secure HTTP portnumber of the managed workflow server instance that you areconfiguring for SSL access.For WebSphere installations, the secure port numbers can vary foreach installation.To determine the correct port number, log on to the IntegratedSolutions WebSphere Console on the computer where the managedworkflow server instance is located, select the appropriate managedserver instance, and display the ports page.The WC_defaulthost_secure entry in the ports page contains thecorrect port number (for example, 20111). You can also find the portnumber in the appropriate IBPM .props file.For more information about locating port numbers, see the IBMOpenPages GRC Installation and Deployment Guide.
ServerEmailBaseURLThe value is https://<server_name>:<SSL_port>/ibpmconsole/System/.
Use the same parameter values as in the ServerBaseURL field.e. Click Save and Reload properties.
The new settings take effect immediately. You do not need to restart theOpenPages application server.
2. On the system where Interstage BPM Studio is installed, open theWorkflow_Studio_Home\bin\IBPMStudio.ini file in a text editor.
3. Add the following text in the line of code before -Dstudio.home=:-Djavax.net.ssl.trustStore=drive:
Workflow_Studio_Home\java\jre\lib\security\cacerts
This location points to the truststore that contains the valid root certificates.
Chapter 2. Installing Workflow Studio 5
4. Save the .ini file in a text format and exit the text editor.5. If you are acquiring the root certificate for the workflow server from an internal
(private) certificate authority (CA), the following steps are required on thecomputer where Interstage BPM Studio is installed. Generally, root certificatesfrom an external or publicly accessible CA are already included in the cacertsfile.On the system where Interstage BPM Studio is installed, complete the followingtasks:a. Obtain the root certificate from the CA.b. In the Windows command prompt, ensure that you add a path environment
variable to access the directory where the Java™ keytool program is located:set PATH=JAVA_HOME\bin;%PATH%
JAVA_HOME is the path for the Java runtime environment. The default pathfor JAVA_HOME is c:\OpenPages\WorkflowStudio\java\jre.
c. Issue the keytool command to import the root certificate into the cacertsfile:keytool -v -import -trustcacerts -keystore cacerts_path-file certfile_from_CA_path.cer -aliasdescr_name_for_root_cert
cacerts_path is the full or relative path to the cacerts file.certfile_from_CA_path is the full or relative path to the root certificate fileof the same name that is received from the CA (without an extension).descr_name_for_root_cert is an easily remembered, descriptive name forthe root certificate.The following example imports the root certificate caroot_cert.cer into thecacerts file.keytool -v -import -trustcacerts -keystore Workflow_Studio_Home\java\jre\lib\security\cacerts -file c:\certs\caroot_cert -alias my_private_cert
d. At the password prompt, type changeit and click Enter.e. When prompted whether to trust the certificate, type yes and click Enter.
Certificate chains are not imported properly. If there are multiple rootcertificates, you must run keytool to import each certificate individually.Import the root certificate first, followed by each individual certificate in thesequence in the trust hierarchy.
6. Start or restart Interstage BPM Studio to complete the SSL configurationprocess.When you log in to the OpenPages application in Interstage BPM Studio in anSSL environment, ensure that you select the Use SSL check box and enter theappropriate managed server SSL port number. For more information, see“Connecting to the OpenPages GRC Platform server” in the IBM OpenPagesGRC Workflow Author's Guide.
Uninstalling Workflow StudioYou uninstall IBM OpenPages GRC Platform - Workflow Studio from IBMInstallation Manager. The uninstallation removes Interstage BPM Studio and theOpenPages GRC Platform components.
Procedure1. Start IBM Installation Manager.2. Click Uninstall.
6 IBM OpenPages GRC - Workflow Studio Version 7.3.0: Installation Guide
3. Select IBPMStudioInstaller > IBM OpenPages GRC Platform - WorkflowStudio 7.2.0.0, then click Next.
4. Review the summary and click Uninstall.If you see the following error during the uninstall process, you can safelyignore it. Click OK to continue.An error occurred while processing the file.
5. If any other errors occur during the uninstallation, you can review them byclicking View Log File.For more information about log files, see “Log files.”
6. Click Finish and close IBM Installation Manager.
Log filesIf errors occur during installation or uninstallation, review the IBM InstallationManager log files for troubleshooting.
You can access the log files from IBM Installation Manager in the following places:v File > View Logs
v File > Installation History, select the Workflow Studio installation package, andclick View Log.
These log files are in the c:\ProgramData\IBM\Installation Manager\logs folder.
In addition, there is a Studio_Installation.log file for the Interstage BPM Studioapplication. This file is in Workflow_Studio_Home where Workflow_Studio_Home isthe installation location of the Interstage BPM Studio application. The defaultlocation is C:\OpenPages\IBPMStudio.
Chapter 2. Installing Workflow Studio 7
8 IBM OpenPages GRC - Workflow Studio Version 7.3.0: Installation Guide
Chapter 3. Upgrading Workflow Studio
You can upgrade the Interstage BPM Studio files from 6.0.1.1 or a later version to7.2.
To upgrade, you must carry out the following tasks on each Windows computerwhere the Interstage BPM Studio application is installed:v Back up your existing IBM OpenPages GRC Platform - Workflow Studio
workspace.v If you upgrading from Workflow Studio version 7.0 or a previous version,
uninstall it.For more information, see “Uninstalling Workflow Studio before an upgrade.”If you are upgrading from Workflow Studio version 7.1 or a later version, thisstep is not required.
v Run the Workflow Studio installation.For more information, see “Install OpenPages GRC Platform - Workflow Studioon Windows” on page 3.
v Update server projects to point to the existing Workflow Studio workspace.For more information, see “Updating server projects” on page 10.
Software requirements for upgradeBefore you upgrade IBM OpenPages GRC Platform - Workflow Studio, ensure thatthe installed version of OpenPages GRC Platform matches the Workflow Studioversion you intend to install.
Only one version of Workflow Studio can be installed on the same computer.
Ensure that the JAVA_HOME environment variable is set and points to the installationof the Java Runtime Environment.
Uninstalling Workflow Studio before an upgradeTo upgrade from IBM OpenPages GRC Platform - Workflow Studio version 7.0 ora previous version, you must uninstall it. If you are upgrading from version 7.1 ora later version, this task is not required.
Procedure1. Log on to Windows as an administrator.2. Go to the OpenPages_IBPM_Studio_Uninstall folder. The default uninstall
directory is C:\OpenPages\IBPMStudio\OpenPages_IBPM_Studio_Uninstall.3. Right-click IBM OpenPages GRC Platform - Workflow Studio
UnInstallation.exe and then click Run as administrator.4. Click OK to confirm that you want to uninstall OpenPages GRC Platform -
Workflow Studio.5. In the Uninstall IBM OpenPages GRC Platform - Workflow Studio window,
click Uninstall.6. In the Uninstall Complete window, select one of the following options:
9
v Yes, restart my system - to restart the system automatically after you exit theuninstaller.
v No, I will restart my system myself - to restart the system manually tocomplete the uninstallation after you exit the uninstaller.
If you see the following error during the uninstall process, you can safelyignore it. Click OK to continue.An error occurred while processing the file.
7. Click Done to complete the uninstallation.
Updating server projectsWhen IBM OpenPages GRC Platform - Workflow Studio is installed, you mustupdate server projects to point to the existing Workflow Studio workspace.
Procedure1. In Windows Explorer, go to the Workflow_Studio_Home\InterstageBPM_Studio\
bin directory and open a Command Prompt window as an administrator.Workflow_Studio_Home is the installation location of the Interstage BPM Studioapplication.
2. Right-click IBPMStudio.exe -clean and click Run as administrator.3. At the prompt, select the workspace that you previously backed up, and click
OK.
10 IBM OpenPages GRC - Workflow Studio Version 7.3.0: Installation Guide
Notices
This information was developed for products and services offered worldwide.
This material may be available from IBM in other languages. However, you may berequired to own a copy of the product or product version in that language in orderto access it.
IBM may not offer the products, services, or features discussed in this document inother countries. Consult your local IBM representative for information on theproducts and services currently available in your area. Any reference to an IBMproduct, program, or service is not intended to state or imply that only that IBMproduct, program, or service may be used. Any functionally equivalent product,program, or service that does not infringe any IBM intellectual property right maybe used instead. However, it is the user's responsibility to evaluate and verify theoperation of any non-IBM product, program, or service. This document maydescribe products, services, or features that are not included in the Program orlicense entitlement that you have purchased.
IBM may have patents or pending patent applications covering subject matterdescribed in this document. The furnishing of this document does not grant youany license to these patents. You can send license inquiries, in writing, to:
IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBMIntellectual Property Department in your country or send inquiries, in writing, to:
Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan Ltd.19-21, Nihonbashi-Hakozakicho, Chuo-kuTokyo 103-8510, Japan
The following paragraph does not apply to the United Kingdom or any othercountry where such provisions are inconsistent with local law: INTERNATIONALBUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS"WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFNON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULARPURPOSE. Some states do not allow disclaimer of express or implied warranties incertain 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 beincorporated in new editions of the publication. IBM may make improvementsand/or changes in the product(s) and/or the program(s) described in thispublication at any time without notice.
11
Any references in this information to non-IBM Web sites are provided forconvenience only and do not in any manner serve as an endorsement of those Websites. The materials at those Web sites are not part of the materials for this IBMproduct 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 itbelieves appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purposeof enabling: (i) the exchange of information between independently createdprograms and other programs (including this one) and (ii) the mutual use of theinformation which has been exchanged, should contact:
IBM CorporationLocation Code FT0550 King StreetLittleton, MA01460-1250U.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 materialavailable for it are provided by IBM under terms of the IBM Customer Agreement,IBM International Program License Agreement or any equivalent agreementbetween us.
Any performance data contained herein was determined in a controlledenvironment. Therefore, the results obtained in other operating environments mayvary significantly. Some measurements may have been made on development-levelsystems and there is no guarantee that these measurements will be the same ongenerally available systems. Furthermore, some measurements may have beenestimated through extrapolation. Actual results may vary. Users of this documentshould verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers ofthose products, their published announcements or other publicly available sources.IBM has not tested those products and cannot confirm the accuracy ofperformance, compatibility or any other claims related to non-IBM products.Questions on the capabilities of non-IBM products should be addressed to thesuppliers of those products.
All statements regarding IBM's future direction or intent are subject to change orwithdrawal without notice, and represent goals and objectives only.
This information contains examples of data and reports used in daily businessoperations. To illustrate them as completely as possible, the examples include thenames of individuals, companies, brands, and products. All of these names arefictitious and any similarity to the names and addresses used by an actual businessenterprise is entirely coincidental.
If you are viewing this information softcopy, the photographs and colorillustrations may not appear.
12 IBM OpenPages GRC - Workflow Studio Version 7.3.0: Installation Guide
This Software Offering does not use cookies or other technologies to collectpersonally identifiable information.
Copyright
Licensed Materials - Property of IBM Corporation.
© Copyright IBM Corporation, 2003, 2016.
US Government Users Restricted Rights – Use, duplication or disclosure restrictedby GSA ADP Schedule Contract with IBM Corp.
This information contains sample application programs in source language, whichillustrate programming techniques on various operating platforms. You may copy,modify, and distribute these sample programs in any form without payment toIBM, for the purposes of developing, using, marketing or distributing applicationprograms conforming to the application programming interface for the operatingplatform 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 theseprograms. You may copy, modify, and distribute these sample programs in anyform without payment to IBM for the purposes of developing, using, marketing, ordistributing application programs conforming to IBM's application programminginterfaces.
Trademarks
IBM, the IBM logo and ibm.com are trademarks or registered trademarks ofInternational Business Machines Corp., registered in many jurisdictions worldwide.
The following terms are trademarks or registered trademarks of other companies:v Microsoft, Windows, Windows NT, and the Windows logo are trademarks of
Microsoft Corporation in the United States, other countries, or both.v Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo,
Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks orregistered trademarks of Intel Corporation or its subsidiaries in the United Statesand other countries.
v Java and all Java-based trademarks and logos are trademarks or registeredtrademarks 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 andtrademark information ” at www.ibm.com/legal/copytrade.shtml.
Notices 13
14 IBM OpenPages GRC - Workflow Studio Version 7.3.0: Installation Guide
Index
Iinstallation
steps 4
Pprerequisites
minimum hardware requirements 3minimum software requirements 3
SSSL
configuration steps 5
Uuninstallation
steps 6
15
