IBM. Installing. IBM Emptoris Suite. Version

Transcription

1 IBM Emptoris Suite IBM Installing Version

2

3 IBM Emptoris Suite IBM Installing Version

4 ii IBM Emptoris Suite: Installing

5 Copyright Note: Before using this information and the product it supports, read the information in Notices on page 143. Copyright IBM Corporation 2012, All rights resered. Copyright Emptoris 1999, All rights resered. US Goernment Users Restricted Rights - Use, duplication or disclosure restricted by GS ADP Schedule Contract with IBM Corp. Copyright IBM Corp. 2012, 2015 iii

6 i IBM Emptoris Suite: Installing

7 Contents Copyright iii Chapter 1. About Installing Chapter 2. Installation Quick Reference 3 Quick Reference for Installation Disclaimer Downloading Installation Items Prerequisites Installation Items Starting the Installation Configuring Post-Installation Tasks Chapter 3. Installation Downloading Installation Items Installation Items that are Proided Download Approaches based on Release Type.. 10 Passport Adantage Fix Central Customer Support for Downloading Installation Items Prerequisites for Installing Emptoris Products Additional Configurations Database and Reporting Configurations Preparing Systems for Installation Configuring the DNS Entries for Emptoris Sourcing and Emptoris Contract Management.. 27 Preparing Serer Systems for Installation Emptoris Strategic Supply Management Installer 41 Installing Emptoris Applications Modes of Installation Emptoris HTTP proxy serer installation Option for Installing Emptoris Program Management Installing Emptoris Suite Applications by using a Command-Line Interface Running the Emptoris Strategic Supply Management Platform Installer Logging in to the Emptoris Applications for the First Time after Installation Post-Installation Configurations Post-Installation Configurations for Emptoris Strategic Supply Management Platform Post-Installation Configurations for Emptoris Sourcing Post-Installation Configurations for Emptoris Contract Management Post-Installation Configurations for Emptoris Spend Analysis Post-Installation Configurations for Emptoris Supplier Lifecycle Management Post-Installation Configurations for Emptoris Program Management Web Serer Configuration for Large File Size 126 Troubleshooting Installation Troubleshooting for Installation Failure Troubleshooting re-installation, upgrade, or update Troubleshooting InfoSphere DataStage installation failure Changing the Projects Directory for InfoSphere DataStage Configuring Trust Association Settings for Emptoris Contract Management Uninstalling Emptoris Applications Cleaning up for Uninstalling on Windows Cleaning up for Uninstalling on Linux Cleaning up for InfoSphere DataStage and Cognos Configuration Failure Reference Information Port numbers Application Specific Port Numbers Notices Copyright IBM Corp. 2012, 2015

8 i IBM Emptoris Suite: Installing

9 Chapter 1. About Installing The Installing section proides a quick reference to the installation process of the IBM Emptoris Suite of products, followed by the detailed process of installation. The installation process includes downloading installation items, completing prerequisites for installation, preparing systems for installation, running the installer, and completing the post-installation configurations. Information about troubleshooting installation failures and uninstalling Emptoris products is also proided. Quick Reference for Installation on page 3 Installation Copyright IBM Corp. 2012,

10 2 IBM Emptoris Suite: Installing

11 Chapter 2. Installation Quick Reference Quick Reference for Installation Disclaimer The Quick Reference for Installation proides a brief understanding of the installation process of the IBM Emptoris products. IBM Emptoris products The following products are proided by IBM Emptoris. IBM Emptoris Sourcing IBM Emptoris Contract Management IBM Emptoris Spend Analysis IBM Emptoris Supplier Lifecycle Management IBM Emptoris Program Management The following three internal components are proided to all customers irrespectie of whether they purchase one or all products. IBM Emptoris Analytics Integration Module IBM Emptoris Strategic Supply Management Installer IBM Emptoris Strategic Supply Management Platform Steps for installation Use the following high-leel steps that are required to complete an end-to-end installation of the IBM Emptoris products. Downloading Installation Items Prerequisites on page 4 Installation Items on page 5 Starting the Installation on page 5 Configuring Post-Installation Tasks on page 6 The Installation Quick Reference does not coer all required steps. You must refer to the Installation section for the complete detailed steps that are required for preinstallation, installation, and postinstallation tasks. Downloading Installation Items You can download the installation items from the Passport Adantage or Fix Central websites. Passport Adantage You can download the software for Version, Release, and Modification releases from the Passport Adantage website. To download the software items, you must register at the website. Copyright IBM Corp. 2012,

12 Fix Central You can download the software for the Fix Pack and ifix releases from the Fix Central website. For information about downloading items, see the IBM Emptoris Suite Installation section. Registering and downloading files For information about registering at the Passport Adantage and Fix Central websites, and to download the installation items, see the following topics. Registering at the Passport Adantage and Fix Central Sites on page 20 Downloading Installation Items from Passport Adantage on page 21 Downloading installation items from the Fix Central website on page 22 Prerequisites The Emptoris products are installed by using the IBM Emptoris Strategic Supply Management Installer. Before you can run the installer, you must prepare your setup for the products that you install. The following table lists the prerequisite tasks. Table 1. Prerequisite Tasks Task Configure the required database serers, database schema, and database clients. Create appropriate user accounts according to the operating system. Install and configure the IBM WebSphere Application Serers on target systems. Install the EchOS agent by running the echosagent-installer.jar file on target systems. Prepare the Emptoris Strategic Supply Management Installer system. Refer to Database Configurations Reporting Configurations (For Emptoris Contract Management and Emptoris Spend Analysis) Installation Guide topics: Red Hat Enterprise Linux Systems on page 28 Windows Systems on page 32 Refer to the appropriate installation document for the WebSphere Application Serer. Installing the EchOS Agent on page 36 Configuring the Emptoris Strategic Supply Management Installer System on page 43 4 IBM Emptoris Suite: Installing

13 Table 1. Prerequisite Tasks (continued) Task Extract and copy the following files to a directory on the Emptoris Strategic Supply Management Installer system. Installer file Appliance template (either Windows or Linux based on your operating system) CWS file: emptoris_web-##-snapshot- ##.zip Required product builds Refer to Installation Items that are Proided on page 7 The product builds contain the files for Emptoris Strategic Supply Management Platform and the installer package. Extract the Appliance Template and CWS file from the installer package. Start the EchOS agent serice on all target systems. Starting the EchOS agent on Linux on page 39 Starting the EchOS agent on Windows on page 38 Installation Items IBM Emptoris proides files to install the Emptoris products. The installation files can be downloaded from the Passport Adantage or Fix Central websites. Installation files of the following items are proided. EchOS agent Emptoris Strategic Supply Management Installer Appliance template (common for all products) WebSphere Application Serer configuration package Product builds Starting the Installation Reporting configuration package For the detailed list of the items and the files, see Installation Items that are Proided on page 7. The IBM Emptoris Strategic Supply Management Installer is run by using a command. After the installer is run, you can access the installer wizard in a URL. You must specify the settings for all the products that you are installing in the wizard. Procedure To run the IBM Emptoris Strategic Supply Management Installer, complete the following steps: 1. Run the IBM Emptoris Strategic Supply Management Installer from the directory where it is saed by using the following command. jaa -jar echos-launcher.jar Chapter 2. Installation Quick Reference 5

14 Note: The installer might take seeral minutes to start. For Windows, run the installer as an administrator. If you get a Jaa not found error, proide the full Jaa path to run the installer. 2. Use the following URL to access the installer URL in a browser Follow the wizard by specifying the configuration properties for the global and indiidual application settings. After you click Install, deployment can take up to 3 hours. For more information, see Installing Emptoris Applications on page 44. Configuring Post-Installation Tasks After the installation of the Emptoris products by using the Emptoris Strategic Supply Management Installer is successful, you must complete post-installation tasks for the Emptoris products. Procedure After the installation is successfully completed, complete the following steps: 1. Start the serices of the applications on the target systems in the following order. a. Stop and restart the Emptoris Strategic Supply Management Platform. b. Sourcing Primary (if Emptoris Sourcing is installed) c. All other Emptoris serices can be started concurrently d. Start the Emptoris HTTP Proxy (CWS) serice last to ensure that the enironment is accessible only after all modules are started For more information, see Starting and Stopping Application Serices on page Complete the post-installation configurations for all Emptoris products. For more information, see Post-Installation Configurations on page Configure the reporting serers. For more information, see Reporting Configurations. 6 IBM Emptoris Suite: Installing

15 Chapter 3. Installation Downloading Installation Items Depending on the release package that you want to download, you can download the software from Passport Adantage or Fix Central. Software for the Version, Release, and Modification releases is aailable on Passport Adantage. Software for Fix Pack and ifix releases is aailable on Fix Central. The following table proides information about the location and items that you can download. Table 2. Location for downloading software What do you want to do? Install Emptoris applications for the first time Upgrade to new ersion, release, or modification Upgrade to a Fix Pack or ifix Download Location Passport Adantage Fix Central Items that you can download Location Comments Version: Example, 10.0, 11.0 Release: Example, Modification: Example, Fix Pack: Example, ifix: Example, iFix2 Passport Adantage Fix Central If you want to moe to the latest Fix Pack or an ifix of these releases, download and install them from Fix Central. To install a fix pack or an ifix, you must download and install its base ersion from Passport Adantage. Compatibility of applications in Emptoris Suite For information about the suite compatibility among different Emptoris applications, see Suite Compatibility Matrix for Installation Items that are Proided IBM Emptoris proides files to install the Emptoris products. The installation files can be downloaded from the Passport Adantage or Fix Central websites. The following table lists the files or software that are proided to you for installation. Table 3. Installation items that are proided Software EchOS Agent : echos-agentinstaller.jar file Purpose For Preparing Serers for Installation Installing the EchOS agent that communicates with the Emptoris Strategic Supply Management Installer system. Copyright IBM Corp. 2012,

16 Table 3. Installation items that are proided (continued) Software JRE: Windows: IBM JRE 1.7 SR8 Linux: IBM JRE SR2 Emptoris Strategic Supply Management Installer : echos-launcher.jar file Appliance templates (common for all products and aailable with the Emptoris Strategic Supply Management Platform download): For Windows: appliance-templatewindows-35.zip For Linux: appliance-template-linux- 35.zip Note: Keep only one of the proided appliance templates in the installation directory that is applicable to your operating system. Common Web Serer (CWS): emptoris_web zip Database scripts common for all products and aailable with the Emptoris Strategic Supply Management Platform download: EMP_Resources_ _36.zip Package for the configurations required for the WebSphere Application Serer. Purpose For Installing Applications For running and installing the EchOS agent. Starting the EchOS serer for installing the products. You must copy the file to the Emptoris Strategic Supply Management Installer system. Proiding the framework for the Emptoris Strategic Supply Management Installer based on the operating system. You must copy the appliance template applicable for your operating system to the Emptoris Strategic Supply Management Installer system. Installing and configuring the common web serer that is used with all Emptoris products. Configuring the databases for Oracle and DB2 serers for Emptoris applications. Configuring the WebSphere Application Serer for Emptoris products. 8 IBM Emptoris Suite: Installing

17 Table 3. Installation items that are proided (continued) Software Product builds: Emptoris Sourcing: EMP_Sourcing_10.1_Base zip Emptoris Contract Management: EMP_CM zip The following components are included in this file: EMP_CM-ContractMgmtAnalytics zip EMP_CM-tools zip Search Serer for Emptoris Contract Management: search-serer zip Emptoris Spend Analysis: EMP_Spend_Analysis zip Emptoris Supplier Lifecycle Management: EMP-SLM_ zip Emptoris Strategic Supply Management Platform: EMP-SSM_ zip Emptoris Program Management: EMP_PGM_ _36.zip JRE: Windows: IBM JRE 1.7 SR8 Linux: IBM JRE SR2 The following two packages are proided for the reporting configurations. CognosIntegration_ _20.zip EmptorisCAP jar EmptorisNamespace.properties securitymanager dist.zip ContractMgmtAnalytics_ _ 20.zip The following files are aailable in the \application\codebase directory of the file. etl folder - For Windows: EtlDeploymentPackage-windows.pkg - For Linux: EtlDeploymentPackagelinux.pkg - EtlEmptyKeyFiles.zip - createecmrepschema.sql EmptorisCognosPackage.zip CMReportingModel.zip model-manager-1.0.zip Purpose For Reporting Serer Installation Installing products. Build file of each product includes the database driers packaged along with it from IBM Emptoris application. You must copy the compressed files of the products to your installation directory. Note: The build package for Emptoris Strategic Supply Management Platform is proided with each product. If you are planning a standalone setup of a product, use the build package that is proided with the indiidual product. For an integrated setup, use the separate Emptoris Strategic Supply Management Platform build package. Required on systems that does not hae WebSphere Application Serer. Files required for configuring the reporting database for Emptoris Contract Management. Chapter 3. Installation 9

18 Download Approaches based on Release Type You must use Passport Adantage or Fix Central or both depending on the type of release you want to install. The following table proides the scenarios of downloading installation items. Based on your requirement, you can use one or combinations of the following download scenarios. Table 4. Download Approaches based on Release Types Scenario 1. You are moing from a preious Version, Release, or Modification release to a higher Version, Release, or Modification release. For example, you are moing from a 9.5 release to a modification of an Emptoris product. 2. You hae purchased a Version, Release, or Modification release of Emptoris product or Emptoris Suite of applications for the first time. You are moing from a Fix Pack of a preious Version, Release, or Modification release to a Fix Pack of a higher Version, Release, or Modification release. For example, you are moing from Fix Pack to a Fix Pack of an Emptoris product. You are moing from a Fix Pack of a preious Version, Release, or Modification release to a higher Fix Pack of the same Version, Release, or Modification release. Download Approach Download the release of the product you hae purchased from Passport Adantage. 1. Download the release of the product you hae purchased from Passport Adantage (10.0.2). 2. Download the Fix Pack ( ) from Fix Central. 3. Ensure that the files of the base ersion (10.0.2) and the Fix Pack ( ) are saed at the same location. 4. Install the Fix Pack by running the installer. The base ersion and the Fix Pack are both installed. Note: The same approach must be taken when upgrading from x to x. Download the Fix Pack ( ) from Fix Central. For example, you are moing from Fix Pack to a Fix Pack of an Emptoris product. You are installing an ifix. For example, you are currently on ersion of an Emptoris product and want to install ifix3 of Ensure that you hae installed and running in your enironment. Download the ifix3 for an Emptoris product from Fix Central. Passport Adantage Major releases such as Version, Release, and Modification are aailable on Passport Adantage. 10 IBM Emptoris Suite: Installing

19 On Passport Adantage, each product is aailable as a stand-alone eassembly or package. All compatible components that are required to install a product are bundled in an eassembly. In all Emptoris products, few components are common across the eassemblies. See the Common Download Components across Applications on page 16 topic to know about the common components. Download options The Passport Adantage portal proides different download options that are based on the type of installation that you are planning. The following figures illustrate the aailable options. Product eassembly and Components Each product is aailable on Passport Adantage as an eassembly. An eassembly contains the components that are required to install a product. In the following figure, the eassembly of a product is displayed in bold and one of the components is highlighted to show the distinction. Chapter 3. Installation 11

20 Though downloading indiidual components is possible, downloading a complete eassembly proides all compatible components. If you hae the latest ersion of one of the components already, it is best to check whether it is compatible to work with IBM Emptoris products. Installation Components of Emptoris Products Use information in this topic to decide which components you want to download from Passport Adantage. Common components across Emptoris applications The following table includes the information about installation download components that are common across the IBM Emptoris applications. Component Name IBM Emptoris Strategic Supply Management Enterprise <ersion> Multiplatform Multilingual IBM Emptoris Strategic Supply Management Installer <ersion> Multiplatform English IBM Emptoris Strategic Supply Management Platform <ersion> Multiplatform Multilingual IBM WebSphere Application Serer <ersion> for Multiplatform Multilingual (Total 3 components) Usage IBM Emptoris Suite platform component common for all products. Used for installing Emptoris Strategic Supply Management Platform application serer. You must download this component. Supported on 32-bit and 64-bit systems. Emptoris Strategic Supply Management Installer to install, upgrade, or update all products. Supported only on 64-bit system. IBM Emptoris Suite platform component common for all products. Supported only on 64-bit system. Web serer application software for IBM Emptoris Suite. Supported on 32-bit and 64-bit systems. 12 IBM Emptoris Suite: Installing

21 Component Name IBM Installation Manager V1.6.2 (required Install WebSphere Application Serer V8.5.5) for Linux x86 Multilingual IBM Installation Manager V1.6.2 (required Install WebSphere Application Serer V8.5.5) for Windows x86 Multilingual Usage Used to install WebSphere Application Serer on Linux. Supported only on 32-bit system. Used to install WebSphere Application Serer on Windows. Supported only on 32-bit system. Emptoris Sourcing installation components The following table includes the information about installation download components by the IBM Emptoris applications. Component Name IBM Emptoris Sourcing <ersion> Multiplatform Multilingual IBM Emptoris Strategic Supply Management Analytics Integration Module <ersion> Multiplatform Multilingual IBM Cognos Business Intelligence Serer <ersion> Linux x86-64 Multilingual IBM Cognos Business Intelligence Serer 32-bit <ersion> Microsoft Windows Multilingual IBM Cognos Business Intelligence Serer 64-bit <ersion> Microsoft Windows Multilingual IBM Cognos Supplementary Languages Documentation <ersion> Multiplatform Multilingual IBM Cognos Business Intelligence Samples <ersion> Multiplatform Multilingual Usage Includes Emptoris Sourcing application serer installation file. Download this if you want to install Emptoris Sourcing product. Supported only on 64-bit system. It proides integration between IBM Cognos Business Intelligence Serer and Strategic Supply Management. This module supports SSO. Download this if the product you are downloading also has reporting module. Supported on 32-bit and 64-bit systems. IBM Cognos Business Intelligence Linux-based serer for reporting. Applicable to only those suite products certified for Cognos-based reporting. Supported only on 64-bit system. IBM Cognos Business Intelligence Windows-based serer for reporting. Applicable to only those suite products certified for Cognos-based reporting. Supported only on 32-bit system. IBM Cognos Business Intelligence Windows-based serer for reporting. Applicable to only those suite products certified for Cognos-based reporting. Supported only on 64-bit system. Proides translated user documentation in the supported language. Samples of IBM Cognos Business Intelligence. Emptoris Contract Management installation components Component Name IBM Emptoris Contract Management <ersion> Multiplatform Multilingual Usage Includes Emptoris Contract Management application serer installation file. Download this if you want to install Emptoris Contract Management product. Supported only on 64-bit system. Chapter 3. Installation 13

22 Component Name IBM Emptoris Strategic Supply Management Analytics Integration Module <ersion> Multiplatform Multilingual IBM Cognos Business Intelligence Serer <ersion> Linux x86-64 Multilingual IBM Cognos Business Intelligence Serer 32-bit <ersion> Microsoft Windows Multilingual IBM Cognos Business Intelligence Serer 64-bit <ersion> Microsoft Windows Multilingual IBM Cognos Supplementary Languages Documentation <ersion> Multiplatform Multilingual IBM Cognos Business Intelligence Samples <ersion> Multiplatform Multilingual IBM InfoSphere Information Serer <ersion> Windows Client Multilingual IBM InfoSphere Information Serer <ersion> Windows Serer 32 bit Multilingual IBM InfoSphere Information Serer <ersion> Windows 64 Multilingual IBM InfoSphere Information Serer <ersion> Linux x86_64 Multilingual IBM InfoSphere Information Serer <ersion> Bundle Spec File Multiplatform Multilingual IBM InfoSphere Information Serer <ersion> Client Bundle Spec File Windows Multilingual Usage It proides integration between IBM Cognos Business Intelligence Serer and Strategic Supply Management. This module supports SSO. Download this if the product you are downloading also has reporting module. Supported on 32-bit and 64-bit systems. IBM Cognos Business Intelligence Linux-based serer for reporting. Applicable to only those suite products certified for Cognos-based reporting. Supported only on 64-bit system. IBM Cognos Business Intelligence Windows-based serer for reporting. Applicable to only those suite products certified for Cognos-based reporting. Supported only on 32-bit system. IBM Cognos Business Intelligence Windows-based serer for reporting. Applicable to only those suite products certified for Cognos-based reporting. Supported only on 64-bit system. Proides translated user documentation in the supported language. Samples of IBM Cognos Business Intelligence. IBM InfoSphere Information Serer Windows Client. ETL Tool. IBM InfoSphere Information Serer for Windows 32-bit IBM InfoSphere Information Serer for Windows 64-bit IBM InfoSphere Information Serer for Linux 64-bit Bundle specification for IBM InfoSphere Information Serer Client bundle specification for IBM InfoSphere Information Serer Emptoris Spend Analysis installation components Component Name Spend Analysis <ersion> Multiplatform Multilingual Usage Includes Emptoris Spend Analysis application serer installation file. Download this if you want to install Emptoris Spend Analysis product. Supported only on 64-bit system. 14 IBM Emptoris Suite: Installing

23 Component Name IBM Emptoris Strategic Supply Management Analytics Integration Module <ersion> Multiplatform Multilingual IBM Cognos Business Intelligence Serer <ersion> Linux x86-64 Multilingual IBM Cognos Business Intelligence Serer 32-bit <ersion> Microsoft Windows Multilingual IBM Cognos Business Intelligence Serer 64-bit <ersion> Microsoft Windows Multilingual IBM Cognos Supplementary Languages Documentation <ersion> Multiplatform Multilingual IBM Cognos Business Intelligence Samples <ersion> Multiplatform Multilingual Usage It proides integration between IBM Cognos Business Intelligence Serer and Strategic Supply Management. This module supports SSO. Download this if the product you are downloading also has reporting module. Supported on 32-bit and 64-bit systems. IBM Cognos Business Intelligence Linux-based serer for reporting. Applicable to only those suite products certified for Cognos-based reporting. Supported only on 64-bit system. IBM Cognos Business Intelligence Windows-based serer for reporting. Applicable to only those suite products certified for Cognos-based reporting. Supported only on 32-bit system. IBM Cognos Business Intelligence Windows-based serer for reporting. Applicable to only those suite products certified for Cognos-based reporting. Supported only on 64-bit system. Proides translated user documentation in the supported language. Samples of IBM Cognos Business Intelligence. Emptoris Supplier Lifecycle Management installation components Component Name IBM Emptoris Supplier Lifecycle Management <ersion> Multiplatform Multilingual IBM Emptoris Strategic Supply Management Analytics Integration Module <ersion> Multiplatform Multilingual IBM Cognos Business Intelligence Serer <ersion> Linux x86-64 Multilingual IBM Cognos Business Intelligence Serer 32-bit <ersion> Microsoft Windows Multilingual Usage Includes Emptoris Supplier Lifecycle Management application serer installation file. Download this if you want to install Emptoris Supplier Lifecycle Management product. Supported only on 64-bit system. It proides integration between IBM Cognos Business Intelligence Serer and Strategic Supply Management. This module supports SSO. Download this if the product you are downloading also has reporting module. Supported on 32-bit and 64-bit systems. IBM Cognos Business Intelligence Linux-based serer for reporting. Applicable to only those suite products certified for Cognos-based reporting. Supported only on 64-bit system. IBM Cognos Business Intelligence Windows-based serer for reporting. Applicable to only those suite products certified for Cognos-based reporting. Supported only on 32-bit system. Chapter 3. Installation 15

24 Component Name IBM Cognos Business Intelligence Serer 64-bit <ersion> Microsoft Windows Multilingual IBM Cognos Supplementary Languages Documentation <ersion> Multiplatform Multilingual IBM Cognos Business Intelligence Samples <ersion> Multiplatform Multilingual Usage IBM Cognos Business Intelligence Windows-based serer for reporting. Applicable to only those suite products certified for Cognos-based reporting. Supported only on 64-bit system. Proides translated user documentation in the supported language. Samples of IBM Cognos Business Intelligence. Emptoris Program Management installation components Component Name IBM Emptoris Program Management <ersion> Multiplatform Multilingual IBM Emptoris Strategic Supply Management Analytics Integration Module <ersion> Multiplatform Multilingual IBM Cognos Business Intelligence Serer <ersion> Linux x86-64 Multilingual IBM Cognos Business Intelligence Serer 32-bit <ersion> Microsoft Windows Multilingual IBM Cognos Business Intelligence Serer 64-bit <ersion> Microsoft Windows Multilingual IBM Cognos Supplementary Languages Documentation <ersion> Multiplatform Multilingual IBM Cognos Business Intelligence Samples <ersion> Multiplatform Multilingual Usage Includes Emptoris Program Management application serer installation file. Download this if you want to install Emptoris Program Management product. Supported only on 64-bit system. It proides integration between IBM Cognos Business Intelligence Serer and Strategic Supply Management. This module supports SSO. Download this if the product you are downloading also has reporting module. Supported on 32-bit and 64-bit systems. IBM Cognos Business Intelligence Linux-based serer for reporting. Applicable to only those suite products certified for Cognos-based reporting. Supported only on 64-bit system. IBM Cognos Business Intelligence Windows-based serer for reporting. Applicable to only those suite products certified for Cognos-based reporting. Supported only on 32-bit system. IBM Cognos Business Intelligence Windows-based serer for reporting. Applicable to only those suite products certified for Cognos-based reporting. Supported only on 64-bit system. Proides translated user documentation in the supported language. Samples of IBM Cognos Business Intelligence. Common Download Components across Applications Knowing common download components across IBM Emptoris products helps you to aoid downloading same components. The following table lists all components that can be downloaded from Passport Adantage. The table also lists whether indiidual components are applicable to an 16 IBM Emptoris Suite: Installing

25 Emptoris application. Note that not all components that are aailable in an application download package are required for that application. Component Name IBM Emptoris Strategic Supply Management Enterprise <ersion> Multiplatform Multilingual IBM Emptoris Strategic Supply Management Installer <ersion> Multiplatform English IBM Emptoris Strategic Supply Management Platform <ersion> Multiplatform Multilingual IBM WebSphere Application Serer <ersion> for Multiplatform Multilingual (Total 3 components) IBM Installation Manager V1.6.2 (required Install WebSphere Application Serer V8.5.5) for Linux x86 Multilingual Emptoris Sourcing Emptoris Contract Management Emptoris Spend Analysis Emptoris Program Management Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Emptoris Supplier Lifecycle Management Chapter 3. Installation 17

26 Component Name IBM Installation Manager V1.6.2 (required Install WebSphere Application Serer V8.5.5) for Windows x86 Multilingual IBM Emptoris Strategic Supply Management Analytics Integration Module <ersion> Multiplatform Multilingual IBM Cognos Business Intelligence Serer <ersion> Linux x86-64 Multilingual IBM Cognos Business Intelligence Serer 32-bit <ersion> Microsoft Windows Multilingual IBM Cognos Business Intelligence Serer 64-bit <ersion> Microsoft Windows Multilingual Emptoris Sourcing Emptoris Contract Management Emptoris Spend Analysis Emptoris Program Management Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes IBM Cognos Supplementary Languages Documentation <ersion> Multiplatform Multilingual Yes Yes Yes Yes Yes Emptoris Supplier Lifecycle Management 18 IBM Emptoris Suite: Installing

27 Component Name IBM Cognos Business Intelligence Samples <ersion> Microsoft Multilingual IBM InfoSphere Information Serer <ersion> Windows Client Multilingual IBM InfoSphere Information Serer <ersion> Windows Serer 32 bit Multilingual IBM InfoSphere Information Serer <ersion> Windows 64 Multilingual IBM InfoSphere Information Serer <ersion> Linux x86_64 Multilingual IBM InfoSphere Information Serer <ersion> Bundle Spec File Multiplatform Multilingual Emptoris Sourcing Emptoris Contract Management Emptoris Spend Analysis Emptoris Program Management Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Emptoris Supplier Lifecycle Management Chapter 3. Installation 19

28 Component Name Emptoris Sourcing Emptoris Contract Management Emptoris Spend Analysis Emptoris Program Management Emptoris Supplier Lifecycle Management IBM InfoSphere Information Serer <ersion> Client Bundle Spec File Windows Multilingual Yes IBM Emptoris Sourcing <ersion> Multiplatform Multilingual Yes IBM Emptoris Contract Management <ersion> Multiplatform Multilingual Yes IBM Emptoris Spend Analysis <ersion> Multiplatform Multilingual Yes IBM Emptoris Supplier Lifecycle Management <ersion> Multiplatform Multilingual Yes IBM Emptoris Program Management <ersion> Multiplatform Multilingual Yes Registering at the Passport Adantage and Fix Central Sites You must register yourself to download IBM Emptoris software. Your log-in credentials are common for Passport Adantage and Fix Central sites. About this task New customers and resellers must register at the Passport Adantage website. Procedure 20 IBM Emptoris Suite: Installing To register at the Passport Adantage site, complete the following steps: 1. Access the Passport Adantage web site.

29 2. Click the Passport Adantage Online tab. 3. Complete one of the following actions: If you are a customer, click For Customers, and click the Customer sign in link. If you are a Business Partner, click For Business Partners, and click the Reseller sign in link. 4. Enter the required details, and click Register. 5. Follow the wizard to request access. Downloading Installation Items from Passport Adantage Use the Passport Adantage web site to download installation items of ersion, release, and modification releases. Procedure To download the installation items from the Passport Adantage site, complete the following steps: 1. Log on to the Passport Adantage web site by using your IBM ID or Passport Adantage ID. 2. Click Software Download & Media Access > Download finder. 3. Select the product that you want to download, and click Continue. 4. Select a language. 5. Select the platforms for which you want to download the product. 6. Select Yes for the two following options: To iew preious ersions of the software. To iew associated products that are included without any additional charges. 7. Click Continue. 8. Select the latest ersion of the product. 9. (Optional) If you want to download a preious ersion, select the preious ersions of the product by expanding Preious ersions, and selecting the ersion that you require. 10. (Optional) Select the associate product that is included with the software. 11. Select I agree. 12. Click Download now. Fix Central The Fix Packs and ifixes of an IBM Emptoris product are aailable on the Fix Central web site for download. Fix Pack and ifix are the incremental fixes on a base ersion of an IBM Emptoris product on which they are deliered. Make sure that you hae the base ersion of the product to install a Fix Pack or an ifix. If you want to install Fix Pack or ifixes of more than one IBM Emptoris products, you must download them indiidually from Fix Central. From the Fix Central web site, you can download the following types of releases: Fix Pack: A four-digit release on a base ersion of an IBM Emptoris product. For example, IBM Emptoris Contract Management is a Fix Pack release on the base ersion Chapter 3. Installation 21

30 ifix: A release to delier a specific fix to a customer deployment. For example, IBM Emptoris Contract Management ifix1 is an ifix on Fix Pack. You must hae the Fix Pack installed to apply an ifix. Product eassembly and components Each Fix Pack or an ifix of a product is aailable on Fix Central as an eassembly. You must download the complete eassembly to install a Fix Pack or an ifix successfully. Ensure to download an eassembly to your root installation directory. Downloading installation items from the Fix Central website The software for Fix Packs and ifixes of Emptoris products is aailable on the Fix Central web site. Procedure To download installation items from the Fix Central web site, complete the following steps: 1. Access the Fix Central web site. 2. On the Select Product tab, from the Product Group drop-down list, select Other Software. 3. From the Select from Other Software drop-down list, select an IBM Emptoris product. 4. From the Installed Version drop-down list, select the appropriate ersion. 5. Click Continue. 6. Select the Platform, and click Continue. 7. Select Browse for fixes, and click Continue. If you know the specific APAR, SPR, or fix ID, you can specify the number. You can also search by specific text. All ifixes for the selected ersion are displayed. 8. Select the appropriate ifixes, and click Continue. The naming conention of the files is EMP_<Product name>_<ersion number>_ifix<number>_<xx>. For example, EMP_Contracts_ _iFix1_ Sign in with your IBM ID, or the Passport Adantage ID. 10. Select a download option, and click Continue. 11. Reiew the software that you are downloading, and click Download now. Customer Support for Downloading Installation Items Use this topic to find information about customer support for Passport Adantage and Fix Central. 22 IBM Emptoris Suite: Installing Customer support for the Passport Adantage If you face issues in signing into Passport Adantage, or locating and downloading software, contact ecustomer care. For more information, see ecustomer care contact information. If you face any of the following issues, send an to Emptoris_DSW_ InternalSite_Download_Issues@wwpdl.net.ibm.com. The required software package is missing or not isible on the Passport Adantage site een after the ecustomer care team confirms product entitlement for you.

31 The downloaded package from the Passport Adantage site is corrupted or the package contains wrong files. Customer support for Fix Central If you get an entitlement error while you are downloading software from Fix Central, contact Customer Support. To contact, click the Feedback link in the left pane on the page where you get the error, and proide the following information. Product for which you are attempting to download a fix Your IBM ID Customer account number and site number If you cannot open the downloaded package or the package is corrupted, send an to Emptoris_FixCentral_Download_Issues@wwpdl.net.ibm.com. Prerequisites for Installing Emptoris Products Before you install the Emptoris products, you must complete certain prerequisite tasks. This is the second step in the process of installing the Emptoris products. The following diagram shows the installation steps. Additional Configurations For the Emptoris Suite of products to work, you must hae a mail, antiirus, and perimeter web serer in your setup. Mail Serer The mail serer is used by all Emptoris applications to send notification s to users. Chapter 3. Installation 23

32 An SMTP-compliant mail serer is required. You can use the existing mail serer of your organization for this purpose. This document does not coer the installation of a mail serer. Mail serer configuration Mail serer configuration is done during the installation of Emptoris products by using the Emptoris Strategic Supply Management Installer. The installer alidates that the proided serer is a alid SMTP serer. You must specify the SMTP serer when you run the Emptoris Strategic Supply Management Installer. Antiirus Serer Only ClamAV antiirus serer is supported for the Emptoris products. This document does not coer the installation of an antiirus serer. Antiirus serer configuration is done during the installation of the products by using the Emptoris Strategic Supply Management Installer. Note the following information. It is required at the time of the installation of the Emptoris products. Antiirus serer host: Antiirus serer port: If you plan to use a different antiirus software, configure the antiirus application by referring to its documentation. Perimeter Web Serer In addition to the installation of the Emptoris HTTP proxy serer that is installed through the Emptoris Strategic Supply Management Installer, you must also install a perimeter web serer (PWS) that is outside your firewall and routes all users through this serer. The PWS secures your enironment encompassing all Emptoris application and other associated serers. Configuring the PWS inoles forwarding all incoming HTTP traffic to the Emptoris HTTP Proxy web serer, also known as the Common Web Serer (CWS). To configure the forwarding rules, each application must hae its own VirtualHost, except Emptoris Spend Analysis when integrated with Emptoris Sourcing. Ports for the PWS: You must use different ports for the HTTP and HTTPS connections to PWS. Use the following ports for the perimeter web serer to connect to the Emptoris HTTP web serer. HTTP: 80 HTTPS: IBM Emptoris Suite: Installing

33 Configuring the PWS: You must implement some minimum functional items for the Perimeter Web Serer (PWS) must to successfully proxy requests to the Emptoris applications. About this task Note: The PWS is not installed when root priileges are not aailable. Procedure To configure the PWS, complete the following steps: 1. Enable secure connections (HTTPS) between the user and the application, and preent non-encrypted (HTTP) requests. 2. Redirect requests from domain name>/emptoris and domain name>/ to domain name>/emptoris/login.jsp. 3. Rewrite paths and cookies such that domain and URL alues are passed to the <emptoris domain name> browser reference instead of to a back-end IP address. 4. Pass the incoming "Host" request header to the Common Web Serer (CWS). 5. Proxy the requests to the following contexts to the CWS: /emptoris, /emptoris-ws. If Emptoris Sourcing is installed, add /sourcing, /sourcing-api, /IFSerices If Emptoris Spend Analysis is installed, add /expensemap If Emptoris Contract Management is installed, add /dicarta, /ecm_help, /webserices If you are planning to use Contracts Transport Utility, add /oauth2 If Emptoris Supplier Lifecycle Management is installed, add /srm-app If you installed Cognos, add /ibmcognos If SAML is used for authentication, add /samlsps Oerriding authentication properties to allow Emptoris Virtual Supply Master authentication When authentication is disabled for the internal or the external users, the Use VSM Authentication roles can be used to supersede the comprehensie setting. This is applicable in scenarios where the external authentication is accomplished through a TAI that has been configured in the WebSphere Application Serer security domain. This allows users who are specifically assigned the Use VSM Authentication roles to still authenticate internally, and consequently access the following password related features. Change password Reset password Password expiration Security Q & A Forgot password To allow an internal or external user to use Emptoris Virtual Supply Master authentication een if the default authentication proider properties are set to FALSE, the user must be assigned the roles that are list in the following table. Chapter 3. Installation 25

34 Table 5. Authentication properties Default Authentication Property Enable Authentication of Internal Users Enable Authentication of External Users Roles Use VSM authentication - Internal Use VSM authentication - External The Use VSM Authentication roles are set with the default Enable Show Login permission, through which this functionality is enabled. You do not hae to exclusiely use the Use VSM Authentication roles. Any other roles that are granted the Enable Show Login permission can oerride the disabled authentication for the user type, and therefore can be used instead of the Use VSM Authentication roles. If you are upgrading to the or later ersion, and use external authentication for users with Administrator and System Administrator roles, you must disable the Enable Show Login permission on these roles. To disable this permission, from the Administration tab, click Roles > [Name of the role] > Business Objects > User > Security, and clear the Enable Show Login check box. You must perform this actiity for the Administrator and System Administrator roles. Notes: The Forgot Username and the Forgot Password hyperlinks are proided on the Emptoris Strategic Supply Management Platform login page. You can use these hyperlinks if you use Emptoris Strategic Supply Management Platform for password management and authentication. Database and Reporting Configurations Before you install the Emptoris applications, you must configure the databases for the applications. For information about the configurations that are required on the database serers and reporting database serers, see the following topics. Database Configurations Reporting Configurations Preparing Systems for Installation Before you can use the echos-installer.jar file to run the installer, you must configure the systems that are used in installation. This is the third step in installing Emptoris products. The following diagram shows the installation steps. 26 IBM Emptoris Suite: Installing

35 You must ensure that the system clocks of all systems in the setup are set to the same time. Configuring the DNS Entries for Emptoris Sourcing and Emptoris Contract Management You must also configure DNS entries for Emptoris Sourcing and Emptoris Contract Management. You can use multi-byte characters in file paths and folder names to install Emptoris applications. DNS entries must be configured for stand-alone or integrated setups of Emptoris Sourcing and Emptoris Contract Management. Preparing Serer Systems for Installation All products are installed and configured by using the Emptoris Strategic Supply Management Platform Installer. Before you begin installing the components on serer machines, you must configure the serer machines for installation. This includes making some configurations on the serer machines and installing some of the software packages that you downloaded. The following table displays the different setup types. Use the procedure corresponding to your setup to prepare the machines required for installation. Table 6. Setup types Setup type Physical or irtual systems that run on Red Hat Enterprise Linux 6.6 or 7.1. Physical or irtual systems that run on Microsoft Windows Serer 2008 or Windows Serer Instructions to use Red Hat Enterprise Linux Systems on page 28 Windows Systems on page 32 Chapter 3. Installation 27

36 Cognos and InfoSphere DataStage are not supported on Linux 7.1. InfoSphere DataStage is also not supported on Windows. Red Hat Enterprise Linux Systems If the operating system that you use is Red Hat Enterprise Linux (physical or irtual system,) you must prepare the systems by proiding permissions, installing software, applying security patches, and other checks. WebSphere Application Serer Installation Install the WebSphere Application Serer on Red Hat Enterprise Linux machine as root. After the installation is complete, change the owner of the installation binary files to the emptoris user by using the following WebSphere Application Serer script. ${Websphere_Home}/instutils/chutils -installlocation=${websphere_home} -setowner=<username> -setgroup=<groupname> Security and other patches to be applied After you install or upgrade the WebSphere Application Serer to 8.5.5, ensure that you apply the following patches: For Emptoris Sourcing: After installing the patch, add the sib.meenableinstanceonfailure=false property in the WebSphere Administration Console > Serice Integration > Buses > SourcingBus > Custom properties. For Emptoris Supplier Lifecycle Management: Install the following patch on all application serers of the products that are integrating with Emptoris Supplier Lifecycle Management: ws-wasprod-ifpm For InfoSphere DataStage: Install the following patch on the InfoSphere DataStage serer on Linux enironment before running the Emptoris Strategic Supply Management Installer for configuring the serer: patch_jr47817_ccoracle_linux64_ Prerequisite Software for Red Hat Enterprise Linux Systems: To prepare Red Hat Enterprise Linux systems to install Emptoris applications, you must install database clients based on the serers, WebSphere Application Serer, and JDK. Red Hat Enterprise Linux ersion Emptoris applications can be installed on Red Hat Enterprise Linux ersions 6.0, 6.6, or 7.1. Apache Web Serer Install Apache Web Serer 2.2.x or 2.4.x for the Emptoris HTTP Proxy Serer. Database clients Install the following database clients for IBM Cognos and IBM InfoSphere DataStage before you install WebSphere Application Serer. DB2 client for if your database serer is DB2. The JDBC.jar files for DB2 are aailable with the DB2 installation and must be copied from the DB2 28 IBM Emptoris Suite: Installing

37 installation. While installing the DB2 client, you must catalog the Emptoris Virtual Supply Master DB2 database that you are using. To catalog the database, complete the following steps: 1. Catalog the node by using the command db2 catalog tcpip node <node-name> remote hostname serer ssl_port. 2. Catalog the database by using the command db2 catalog database <database-name> at node <node-name>. Note: Ensure that the InfoSphere DataStage serer has Oracle and DB2 client libraries. Oracle client 12c or later if your database serer is Oracle. While installing the Oracle client for Oracle serers, ensure that you create the TNSNAMES.ORA serice. You must also erify the connectiity to the Oracle database by using sqlplus or an appropriate tool. WebSphere Application Serer Install WebSphere Application Serer with security ifix. If you are using a pre-8.5 ersion of the WebSphere Application Serer, you cannot upgrade it to You must download the base 8.5 ersion and during installation, install the patch release in a separate directory. Use Installation Manager 1.6 to install WebSphere Application Serer. The WebSphere Application Serer is not required for Emptoris HTTP Proxy web serer. Jaa Deelopment Kit Install the Jaa Deelopment Kit For information about installing JDK, see Installing and uninstalling SDK Jaa Technology Edition Version 7.0 or 7.1 on distributed operating systems. Apache for Red Hat Enterprise Linux Systems: To install the Emptoris HTTP Proxy serer, you must install the Apache HTTP Serer 2.2.x or 2.4.x. While installing Apache, ensure that the directory path has no spaces in it. Also, you must not install the HTTP serer in the Home directory of the user. If you are planning to use an Emptoris HTTP Proxy for each serer, you must install Apache HTTP Serer on each serer machine. If you plan to use Apache 2.4.x for Red Hat Enterprise Linux 6.0 and 6.6, you must download and install the Apache 2.4.x ersion. For Red Hat Enterprise Linux 7.1, Apache 2.4.x is aailable by default. You can use the default ersion. Preparing Red Hat Enterprise Linux Systems: You must prepare the systems on which you plan to install Emptoris applications by proiding sudo permissions, creating users, creating directories, and other required steps. Chapter 3. Installation 29

38 Before you begin Ensure the following checks for successful installations of Emptoris applications. In the /etc/sudoers file, comment the Defaults requiretty line. If this command is kept actie, the[wsadmin] sudo: sorry you must hae tty to run sudo error occurs during installation. disable SELinux Ensure that the Apache mod_ssl module is installed for the PWS. If it is not installed, use yum install mod_ssl to install it. To install the HTTP Proxy module and enable the built-in test perimeter web serer, add the path to your Apache installer file to your sudoers configuration for the emptoris user. For example, add /usr/sbin/httpd or /usr/sbin/httpd.worker. The HTTP Proxy module uses httpd.worker instead of httpd when the worker MPM is installed. If you do not add the path, errors occur when you are trying to automatically start or stop the HTTP Proxy module on Linux enironments. Procedure To prepare a system for installation, complete the following steps: 1. Create emptoris user. 2. Create emptoris group. Attention: You must use the emptoris user and group for installation. Validation errors might occur if the emptoris user and group are not used for installation. 3. Assign the following sudo permissions to the emptoris user. emptoris ALL=NOPASSWD: /sbin/serice, /bin/rm, /bin/mkdir, /usr/bin/unzip, /bin/cp, /usr/sbin/apachectl, /bin/kill, /bin/ln, /bin/chmod, /bin/chown, /bin/chgrp, /opt/ibm/websphere/appserer/jaa/bin/jaa, /opt/ibm/websphere/appserer/bin/wasserice.sh, /usr/sbin/chkconfig Depending on your distribution, the paths to the aboe standard utilities might ary. You can use the 'which' command to locate the correct path. The path to the wasserice.sh script depends on your WebSphere Application Serer installation. Note: Configure the sudo permissions for the emptoris user so that no password and no TTY is required during the installation. After the installation is complete, you may restore the requirement of password for the user. 4. If you do not gie sudo permissions to the emptoris user, complete the Prerequisites for Installing Emptoris Products with Non-Root User on page If you want to use the emptoris user, reset the password for the emptoris user. 6. Log on as emptoris user. Note: For Emptoris Spend Analysis, the group ID of the emptoris group and user ID of the emptoris user on the database serer must sync with the group ID and user ID of the VM node on which the primary and reporting serers will be installed. OLF jobs fail if these group and user IDs are not synced with each other. 7. Ensure that the WebSphere Application Serer Jaa path is set. 8. If you are using the system as the Emptoris HTTP Proxy, install the Apache HTTP Serer. 30 IBM Emptoris Suite: Installing

39 9. For Emptoris Strategic Supply Management Platform, create a directory outside the WebSphere Application Serer directory called SSM_Home, and make the emptoris user the owner of this directory. This directory will contain attachments, batch upload temporary files, logs, and any other file-based data. While installing the Emptoris Strategic Supply Management Platform, specify the location of the ssm_home directory in the Home Directory field. 10. For Emptoris Supplier Lifecycle Management, create two directories: one for logs and one for attachments. 11. For Emptoris Contract Management, create a directory for attachments and templates. 12. For Emptoris Contract Management reporting, complete the following steps. a. Create a directory on the Cognos serer as the home directory. This is the Cognos Model Home directory. b. Create a directory on the InfoSphere DataStage serer as the projects directory. 13. Assign ownership for these directories to the emptoris user. Prerequisites for Installing Emptoris Products with Non-Root User: If you do not want to gie sudo permissions to the user who will install the Emptoris suite applications, you can install as a non-root user. You must install the EchOS agent as root and proide write access to all installation directories. About this task sudo permissions are required for the following items. To register the following serices in /etc/init.d. EmptorisPws EmptorisHttpProxy ecm1_was.init gateway_was.init To start and stop the serices. Procedure For installing Emptoris products with a non-root user, complete the following steps: 1. Create a non-root user on the Linux system by not proiding any sudo permissions to the user. 2. Install the EchOS agent as root on all application serers. 3. Start the EchOS agent by using the following command. /opt/emptoris/echos-agent/installer/echosagent [start / stop / restart] 4. Install all Emptoris applications in the /opt/emptoris/tools directory. 5. Gie write access to the non-root user to all installation directories and sub directories including WebSphere Application Serer and Apache Serer by giing ownership rights to them. For example, gie write access to the /opt/ibm/websphere and /opt/apache directories. Chapter 3. Installation 31

40 What to do next Windows Systems If the operating system that you use is Windows Serer 2008 or Windows Serer 2012 (physical or irtual system) use the information proided in this topic to prepare your system for installation. Security and other patches to be applied After you install or upgrade the WebSphere Application Serer to 8.5.5, ensure that you apply the following patches: For Emptoris Sourcing, after installing the patch, add the sib.meenableinstanceonfailure=false property in the WebSphere Administration Console > Serice Integration > Buses > SourcingBus > Custom properties. For Emptoris Supplier Lifecycle Management: Install the following patch on all application serers of the products that are integrating with Emptoris Supplier Lifecycle Management ws-wasprod-ifpm90932 Prerequisite Software for Windows: To prepare Windows systems, you must install the database clients based on the serer, WebSphere Application Serer, and JDK Windows Serer ersion You must install Windows Serer 2008 or Windows Serer 2012 on the Windows systems. Microsoft.NET Framework Install the Microsoft.Net Framework 4.0 or 4.5 for the Emptoris Contract Management Document serer. Apache Web Serer Install Apache Web Serer 2.2.x or 2.4.x for the Emptoris HTTP Proxy Serer. Note: While installing Apache, ensure that the directory path has no spaces in it. Database clients Install the following database clients for IBM Cognos and IBM InfoSphere DataStage before you install WebSphere Application Serer. DB2 client for if your database serer is DB2. The JDBC.jar files for DB2 are aailable with the DB2 installation and must be copied from the DB2 installation. While installing the DB2 client, you must catalog the Emptoris Virtual Supply Master DB2 database that you are using. To catalog the database, complete the following steps: 1. Catalog the node by using the command db2 catalog tcpip node <node-name> remote hostname serer ssl_port. 2. Catalog the database by using the command db2 catalog database <database-name> at node <node-name>. 32 IBM Emptoris Suite: Installing

41 Note: Ensure that the InfoSphere DataStage serer has Oracle and DB2 client libraries. Oracle client 12c or later if your database serer is Oracle. While installing the Oracle client for Oracle serers, ensure that you create the TNSNAMES.ORA serice. You must also erify the connectiity to the Oracle database by using sqlplus or an appropriate tool. WebSphere Application Serer Install WebSphere Application Serer with security ifix. If you are using a pre-8.5 ersion of the WebSphere Application Serer, you cannot upgrade it to You must download the base 8.5 ersion and during installation, install the patch release in a separate directory. Use Installation Manager 1.6 to install WebSphere Application Serer. The WebSphere Application Serer is not required for Emptoris HTTP Proxy web serer. Jaa Deelopment Kit Install the Jaa Deelopment Kit For information about installing JDK, see Installing and uninstalling SDK Jaa Technology Edition Version 7.0 or 7.1 on distributed operating systems. WebSphere Application Serer: WebSphere Application Serer is a prerequisite for the installing Emptoris applications. You must use the IBM Installation Manager to install the WebSphere Application Serer. Creating a repository for WebSphere Application Serer: On Windows systems, an IBM Installation Manager repository must be created for the WebSphere Application Serer. Procedure To create an IBM Installation Manager repository for WebSphere Application Serer, complete the following steps: 1. Go to (Drie) > IBM > Installation_Manager > Eclipse. 2. Run the launcher.exe file. 3. On the Select Mode page, click File > Preferences. 4. Click Add Repository to add a location for WebSphere Application Serer. 5. Go to (Drie) > Emptoris application > WAS Select the repository.config file. 7. Click Open > OK > Apply. Installing the IBM Installation Manager: You must install the IBM Installation Manager to install WebSphere Application Serer. Chapter 3. Installation 33

42 Procedure To install the IBM Installation Manager, complete the following steps: 1. Log into the system with Administrator permissions. 2. Click (Drie) > (Emptoris application) > WAS8.5 > Installation_Manager > InstaMgr(ersion). 3. Run the install.exe file. 4. Select the ersion and click Next. 5. Read and Accept the license agreement. 6. Click Browse to select the location for Installation Manager. 7. Click Install. 8. Restart the Installation Manager. Installing WebSphere Application Serer: The WebSphere Application Serer is required for eery Emptoris application. Procedure To install WebSphere Application Serer, complete the following steps: 1. On the Select Mode page, click Install. 2. Select ersion Read and accept the license agreement. 4. Click Browse to select the location for the shared resources directory. 5. Create a new package group by using the IBM WebSphere Application Serer V8.5 package. 6. Click Browse to select the location for the installation directory. 7. Click Next > Install > Finish. What to do next Upgrade to the WebSphere Application Serer fix pack after you hae installed WebSphere Application Serer Setting Enironment Variables: Enironment ariables must be set on serer systems for successful installation of IBM Emptoris applications. Procedure To set enironment ariables, complete the following procedure: 1. Go to Control Panel > Adanced System Properties > Enironment Variables > New. 2. Set the following parameters: Variable name: Jaa_HOME Variable alue: (drie)/emptoris/ibm/websphere/appserer/jaa 3. Click OK > New. 4. Set the following parameters: Variable name: Path 34 IBM Emptoris Suite: Installing

43 Variable alue: <drie>/emptoris/ibm/websphere/appserer/jaa/bin 5. Click Apply and OK. Installing Apache for Windows: Apache 2.2.x or 2.4.x is a prerequisite for installing the Emptoris HTTP Proxy serer. It supports a ariety of features such as serer-side programming language support and authentication schemes. To install Apache 2.2.x or 2.4.x, complete the following steps: 1. Run the apache.msi file. 2. Set the following parameters: Network Domain: Enter the DNS domain in which your serer is registered. Serer Name: Enter the full DNS name of the serer. Administrator's Address: Enter the serer administrator or webmaster address. For whom to install Apache: Select for All Users, on Port 80, as a Serice. Installation type: Select Typical. Where to install: Click Browse to select the location. 3. Click Install. Preparing Windows Systems: You must log in to the systems as administrator and complete certain tasks to prepare Windows systems for installation. Procedure To prepare each Windows serer machine for installation, complete the following steps: 1. Log on as an administrator. 2. For Emptoris Sourcing, note the MaxUserPort property from the Windows registry. When you upgrade to or install a new ersion, the MaxUserPort property that represents the maximum number of ports that can be opened by the user is added or updated to You can compare the new alue with the older alue of the property after upgrade or install. 3. Ensure IBM WebSphere Jaa path is set. (Not for the Emptoris Contract Management Document serer.) 4. Install Apache HTTP Serer if you are using the system as the Emptoris HTTP Proxy. If you are planning to use an Emptoris HTTP Proxy for each serer, you must install Apache HTTP Serer on each serer system. 5. For Emptoris Strategic Supply Management Platform, create a directory outside the WebSphere Application Serer directory called SSM_home. This directory will contain attachments, batch upload temporary files, logs, and any other file-based data. While installing Emptoris Strategic Supply Management Platform, specify the location of this directory in the Home Directory field. 6. Create two directories for Emptoris Supplier Lifecycle Management, one for logs and one for attachments. Chapter 3. Installation 35

44 7. Create a directory for attachments and templates for Emptoris Contract Management. 8. Create a directory on the Cognos serer as the home directory. EchOS Agent The EchOS agent is required on all systems in your setup on which you will install Emptoris applications. The EchOS agent communicates with the installer to install the applications. The Emptoris Strategic Supply Management Installer requires that the EchOS agent must be running on all target systems with which it communicates. The agent must be running during installation and upgrade. The EchOS agent is not required on the Emptoris Strategic Supply Management Installer system if no products are to be installed on that system. Installing Jaa: For running the EchOS agent, and installing the Emptoris applications, Jaa is required on the systems. About this task Make sure that the correct ersion of Jaa is installed on the systems. Download the Jaa Deelopment Kit from swg/selectfixes?parent=ibm%2fwebsphere&product=ibm/websphere/ WebSphere+Application+Serer&release=All&platform=All&function=fixId &fixids= ws-ibmwasjava-part1, ws-ibmwasjava-part2 &includesupersedes=0. For Windows, use IBM JRE 1.7 SR8. For Linux, use IBM JRE SR2. If you are installing Jaa on systems that do not hae the WebSphere Application Serer, you can use the Jaa that is proided with the installer. Procedure To install Jaa, complete the following steps: 1. Download the file and extract the Jaa package to a directory. 2. On Linux, run the chmod -R 777 on the directory where you extracted the files. 3. Run the Jaa executable file to install Jaa. 4. Verify the ersion of Jaa by running one of the following commands on the directory. Windows: jaa -ersion Linux:./jaa -ersion 5. Set the JAVA home path on all target systems. 6. Verify the ariable path. Installing the EchOS Agent: For the Emptoris Strategic Supply Management Installer to communicate with the systems on which applications will be installed, you must install the EchOS agent on all the target systems. 36 IBM Emptoris Suite: Installing

45 Before you begin Install Jaa and configure the Jaa ariable on each target system. About this task On Linux systems, if the agent is not installed as the root user, sudo permissions must be assigned to the user who installs the agent. It is best that you install the agent as the emptoris user. If you do not grant sudo permissions to the emptoris user, the scripts for starting and stopping the agent are not created. Procedure To install the EchOS agent on the target systems, complete the following steps on each system: 1. Open the command prompt. On Windows, open the command prompt as an administrator or the serice to start and stop the agent is not installed. 2. Naigate to the directory where you saed the EchOS agent. 3. Run the following command. <Directory where the file is saed> jaa -jar echos-agent-installer.jar On Linux, if you are running the command with a user who has sudo permissions, run the following command. sudo jaa -jar echos-agentinstaller.jar 4. Accept the default locations of the arious software that are required or specify the following configurations. a. EchOS agent base installation directory b. EchOS agent directory c. Name of the agent serice d. EchOS agent port Note: The default port of the Emptoris Strategic Supply Management Installer is 8080 and that of EchOS agent is You can change the port for the installer and agent. The same port must be used for the agent that is installed for all applications. e. EchOS agent IP address f. Emptoris application installation directory g. EchOS Repository directory h. Tools directory for third-party software i. Jaa directory for WebSphere Application Serer Important: For installing Emptoris Strategic Supply Management ersion or later, you must change the Jaa path from the default to the location where Jaa 7 is installed. For the WebSphere Application Serer Jaa, the path is <WebSphere Install Directory>\WebSphere\AppSerer\ jaa_1.7.1_64. If you do not hae the WebSphere Application Serer installed, you should gie the path to the Jaa that you installed. j. Ant installation directory Chapter 3. Installation 37

46 The following image displays the options that are listed when you run the EchOS agent installer. Results When the EchOS agent is successfully installed, the following messages are displayed. To start the EchOS agent with the emptoris user, use the following command. sudo serice echosagent start For users with non-root priileges, you must start the EchOS agent with a script. The location of the script is proided when the installation of EchOS agent completes. Starting the EchOS agent on Windows: You can start the EchOS agent from the Serices console on Windows. The EchOS agent must be started before you install any Emptoris applications. Procedure To start the EchOS agent serice, complete the following steps: 1. In the command prompt, enter serices.msc, and press Enter. 2. In the Serices console, right-click EchOS Agent [echosagent]. 3. Click Start. 4. Close the Serices console. 5. Type exit in the command prompt. 38 IBM Emptoris Suite: Installing

47 Starting the EchOS Agent on Windows from the Command Line: The EchOS agent must be running on all target systems before you install the Emptoris applications. You can start the EchOS agent from the command line on Windows systems. Procedure To start the EchOS agent from the command line, complete the following steps: 1. Open the command prompt as an Administrator. 2. Run the following command. sc start echosagent If you changed the serice name from the default, use that name in the command. Starting the EchOS agent on Linux: You can start the EchOS agent on Linux by running a command. The EchOS agent must be started on Linux serer systems before you install Emptoris applications. Procedure To start the EchOS agent on Linux, complete the following steps: 1. Log into the system with root priileges. 2. Enter the following command: sudo serice echosagent start. If you changed the serice name from the default, use that name in the command. Note: For users with non-root priileges, you must start the EchOS agent with a script. The location of the script is proided when the installation of the EchOS agent completes. Grant the run permission to the script, and use the following command to run the script:./echosagent start. Verifying the Status of the EchOS agent: After starting the EchOS agent on all systems, you can erify that the EchOS agent is running on all systems. Procedure To erify the status of the EchOS agent, complete the following steps: 1. Access the following URL on the ssystems to erify if the EchOS agent is running. The default port of the EchOS agent is Acknowledge the confirmation that is displayed. Results The following image shows an example of the erification that the EchOS agent is running on a Linux system. Chapter 3. Installation 39

48 The following image shows an example of the erification that the EchOS agent is running on a Windows system. Updating EchOS Agent ersion: If you are using ersion or later of the Emptoris Strategic Supply Management Installer, the ersion of the EchOS agent is automatically detected. If the EchOS agent is not at ersion , it is automatically upgraded when the installer is run. 40 IBM Emptoris Suite: Installing

49 If the installer ersion is pre , a message is displayed prompting you to upgrade the ersion of the EchOS agent manually. You must manually upgrade the EchOS agent on all target systems where it is running. Important: The EchOS agent must be running for the installer to detect its current ersion. Howeer, with ersion , Emptoris applications require Jaa Deelopment Kit (JDK) When upgrading from a preious ersion to , you must re-install the EchOS agent manually on all target systems where it is running to use JDK You must complete this step wheneer the supported ersion of JDK changes. Emptoris Strategic Supply Management Installer The Emptoris Strategic Supply Management Installer is a web-based application that is proided with the IBM Emptoris product software to install Emptoris products. By using the installer, you can install the applications afresh and also upgrade them. The Emptoris Strategic Supply Management Installer is a.jar file that is run from the command line. You must download all required files and sae them to a root installation directory on the system. You can run the installer from any notebook or desktop in your network that has Linux or Windows XP SP3 (32-bit), and later. The system must be on LAN for faster performance. You can use a serer system to run the Emptoris Strategic Supply Management Installer. Howeer, you must ensure that the port numbers are appropriately configured for the Emptoris Strategic Supply Management Installer, EchOS agent, and the application. Installer language The Emptoris Strategic Supply Management Installer is aailable only in English. The user interface (UI) is not multi-lingual and does not support any other language. EchOSRepository When you run the installer, the echos-installer > EchosRepository directories are automatically created on the system from which it is run. Installation artifacts are stored in this directory. The EchosRespository directory continues to grow as newer builds are installed. Archie these builds to a separate location after installation to consere disk space. How does the Emptoris Strategic Supply Management Installer work The Emptoris Strategic Supply Management Installer not only installs and upgrades the Emptoris applications, it also merges build files and archies the old builds. The Emptoris Strategic Supply Management Installer moes the appliance template and installation packages to the EchosRepository directory during installation. Chapter 3. Installation 41

50 The EchosRepository manages space and files in the EchosRepository with the following functions: Merging and archiing builds that are used for base and incremental installation to the Archie folder. If the merging is unsuccessful, archiing of incremental build does not happen. Deleting older ersions of installation packages in the target agent repository after an installation or upgrade on a target machine. Not archiing during an update. Archiing the saed configuration in the EchosRepository/ApplianceArchie folder. No configurations are saed in root directory. Backward Compatibility of the Emptoris Strategic Supply Management Installer Emptoris Strategic Supply Management Installer ersion and later ersions are backward compatible. With ersions or later of the Emptoris Strategic Supply Management Installer, you can use the installer with ersions 9.5 or later of the EchOS agent, and use it to install Emptoris products from ersion 9.5 onwards. Howeer, with ersion , Emptoris applications require Jaa Deelopment Kit (JDK) When upgrading from a preious ersion to , you must re-install the EchOS agent manually on all target systems where it is running to use JDK You must complete this step wheneer the supported ersion of JDK changes. Emptoris Applications that are Installed by using the Emptoris Strategic Supply Management Installer All Emptoris applications are installed by using the Emptoris Strategic Supply Management Installer. Configurations for the application, database, and web serers are also done through the Emptoris Strategic Supply Management Installer. What you can do with the installer The following items are installed or configured through the Emptoris Strategic Supply Management Installer. Installation of the following Emptoris applications. Emptoris Strategic Supply Management Platform Emptoris Sourcing Emptoris Contract Management Emptoris Spend Analysis Emptoris Supplier Lifecycle Management Emptoris Program Management The Emptoris Strategic Supply Management Platform and Emptoris HTTP Proxy are required components and are installed by default along with the other applications that you choose. For Emptoris Contract Management, you must also install the Emptoris Contract Management Document serer. Installation of the Emptoris HTTP proxy web serer, also known as the Common Web Serer (CWS) Configuration settings for the application serers and the related components for the following products. 42 IBM Emptoris Suite: Installing

51 Emptoris Strategic Supply Management Platform Emptoris Sourcing Emptoris Contract Management Emptoris Spend Analysis Emptoris Supplier Lifecycle Management Emptoris Program Management Integration settings for the applications. Configuration settings for the following serers. Database serers Web serers Reporting serers Mail serer Antiirus serer FTP serer for Emptoris Sourcing Items that are not Installed by using the Emptoris Strategic Supply Management Installer The installation of all serers that are required for the Emptoris applications is not done through the Emptoris Strategic Supply Management Installer. The following serers are not installed by using the Emptoris Strategic Supply Management Platform Installer. Database serers IBM WebSphere Application Serer Perimeter web serer Mail serer Antiirus serer Reporting serers for Emptoris Contract Management and Emptoris Spend Analysis FTP serer for Emptoris Sourcing Note: You must install the serers by using their respectie installation documents. Use the instructions in this guide to configure them for Emptoris products. Configuring the Emptoris Strategic Supply Management Installer System Before you run the installer, you must prepare the system from which you will run the installer. You must set certain ariables on the system and ensure that you sae the installer file and application packages on the system. Procedure To configure the Emptoris Strategic Supply Management Installer system, complete the following steps: 1. Create a root installation directory on the system from which you will run the installer and sae the following software in that directory. Emptoris Strategic Supply Management Installer file (echos-launcher.jar.) Product build for each product that you are planning to install. (Proided to you in.zip files.) Appliance template. (Proided to you in.zip file.) Chapter 3. Installation 43

52 Note: Based on your operating system, use either the Windows or Linux template. An error occurs if you keep both the templates in the installation directory. IBM JRE For information about the build files, see Installation Items that are Proided on page Ensure that the Emptoris Strategic Supply Management Installer system can connect to all the systems on which the products will be installed. 3. Remoe the Firewall for the port that communicates with the other systems. The default port is On the Cognos system, set the following ariables. ORACLE_HOME TNS_ADMIN LD_LIBRARY_PATH PATH NLS_LANG Installing Emptoris Applications For more information, see the Reporting Configurations. You can run the Emptoris Strategic Supply Management Platform Installer in the graphical, silent, and command-line mode to install and integrate Emptoris applications. Successful installation of Emptoris products inoles seeral steps. The following diagram shows the installation steps. Products that you can install You can install and integrate the following Emptoris applications by running the Emptoris Strategic Supply Management Platform Installer. Emptoris HTTP Proxy 44 IBM Emptoris Suite: Installing

53 Emptoris Strategic Supply Management Platform Emptoris Sourcing Emptoris Contract Management Emptoris Spend Analysis Emptoris Supplier Lifecycle Management Emptoris Program Management Modes of Installation You can install Emptoris products in the graphical, silent, and command-line modes. Graphical mode: Uses the graphical interface in your default browser to install the applications. This is the default mode of the installer and is recommended for most installations. Silent mode: Uses the installation properties from an encrypted saed configuration file and installs applications with no user interaction. This mode cannot be used for fresh installation. Command-line mode: Uses the command-line mode for installation. When you run the Emptoris Strategic Supply Management Installer to install Emptoris applications, the message on the upper left corner of the interface reads You are installing Emptoris Suite Appliance. When you update or upgrade an application, the message that is displayed is You are updating Emptoris Suite Appliance. Emptoris HTTP proxy serer installation You can install the Emptoris HTTP Proxy serer as a shared resource for all applications in the suite or as a separate proxy serer for each application in the suite. Installing it as a separate proxy serer is useful for using it as a load balancer for the applications. If you install the Emptoris HTTP Proxy serer as a separate proxy serer for each application, you must install it on the same machine as the application to which it sends the proxy requests. You can use any aailable port, including the default port 8080, for each of the Emptoris HTTP proxy serer instances. Note: If you hae an existing stand-alone installation of an application that is configured with a shared Emptoris HTTP proxy serer instance, and you want to hae a separate instance for each application, you must create a new configuration with all the required components. An error might occur if you attempt to use a preiously saed configuration for the installation. Option for Installing Emptoris Program Management By using the Emptoris Strategic Supply Management Installer, you can install Emptoris Program Management in your setup. Installing Emptoris Program Management An option is aailable on the Emptoris Strategic Supply Management Installer UI while configuring Emptoris Strategic Supply Management Platform to enable Emptoris Program Management. This option is aailable only if the EMP_PGM_<ersion>_xx.zip file is aailable in the EchOSRepository directory. Chapter 3. Installation 45

54 Installing Emptoris Suite Applications by using a Command-Line Interface You can install the Emptoris Suite applications by using a command-line interface. Before you begin Follow all the instructions that are proided in Preparing Systems for Installation on page 26 to prepare your enironment to install Emptoris Suite applications. Use the worksheet to note all alues for field entries. Procedure To install the IBM Emptoris applications by using the command-line interface, complete the following steps: 1. Open a command-line interface from the folder where the echos-launcher.jar file is located. 2. Run the following command: jaa -jar echos-launcher.jar -consolemode true. Note: The command-line interface prompts you with options, press Enter to accept a default alue. 3. Press Enter to read and enter 1 to accept the software license agreement. 4. Enter Y to install an Emptoris Suite application. Install Contract Management [Y/N]: 5. Configure all parameters for the applications that you want in your setup. For more information about the parameters, see the following topics. Configuring Global Settings on page 49 Configuring Emptoris HTTP Proxy settings on page 53 Configurations for Emptoris Sourcing on page 56 Configurations for Emptoris Contract Management on page 60 Configurations for Emptoris Spend Analysis on page 65 Configurations for the Emptoris Strategic Supply Management Platform and Emptoris Program Management on page 70 Configurations for Emptoris Supplier Lifecycle Management on page 76 Configurations for Analytics Installation Module on page 84 Configurations for the Search Serer on page Enter Y to install the applications. Running the Emptoris Strategic Supply Management Platform Installer The default port of the Emptoris Strategic Supply Management Installer is 8080 and that of EchOS agent is You can change the port for the serer and agent but the same port must be used for the agent that is installed for all applications. Before you run the installer For a fresh installation, update or upgrade, ensure that the following prerequisites are met. 46 IBM Emptoris Suite: Installing

55 Database configurations for all serers are completed. For more information, see Database Configurations and Reporting Configurations. All systems are prepared for the installation. For more information, see Preparing Serer Systems for Installation on page 27. All product builds are aailable in the installation directory. For more information about the product files that are required for installation, see Installation Items that are Proided on page 7. Note: The EchosRepository continues to grow as newer builds are added. To consere disk space, you can archie these builds to a separate location after installation. Ensure that the /tmp directory has 2-3 GB space. All packages that are sent to the arious serers during installation are extracted to the /tmp directory. It must therefore hae enough space for the extraction and merging of the packages. Running the Emptoris Strategic Supply Management Installer on Windows To run the Emptoris Strategic Supply Management Installer, run the following command as administrator from the command prompt: jaa -jar echos-launcher.jar You must run the echos-launcher.jar file from the directory where it is copied. To start the Emptoris Strategic Supply Management Installer with the changed port for the EchOS agent, use the following command. jaa -Dechos.port=8081 -Dechos.agent.port=<New EchOS agent port> -jar echos-launcher.jar You must specify the changed port for the agent also from the Emptoris Strategic Supply Management Installer user interface in the Topology Configuration section of the Emptoris HTTP Proxy page. This is to aoid any port clashes. URL for installation After the Emptoris Strategic Supply Management Installer starts successfully, the screen displays the URL that is to be used for installing the products as shown below. The UI for the Emptoris Strategic Supply Management Installer opens automatically in a browser. Log files The following table lists the log files for the installer, EchOS agent, and the Apache web serer. Table 7. Log files Software File name Location Emptoris Strategic Supply Management Installer EchOS agent echos.log echos-installer > logs file directory emptoris\echos-agent\log directory emptoris\echos-agent\tasks\ <task name Chapter 3. Installation 47

56 Table 7. Log files (continued) Software File name Location Apache Web Serer echos-installer > tomcat > apache-tomcat-<number> > logs Installation Type You can create a new configuration for the installation, or reuse a preiously saed configuration for upgrade or update. You can also import a configuration to another system and reuse it for a new installation. The following table proides the configuration options. Table 8. Configuration options Options Create New Appliance Configuration Update/Upgrade Preiously Saed Configuration Import Configuration When to use For first time installations and complete reinstallations. For updating, upgrading, or adding applications to a preiously installed configuration. For selecting configurations that are not saed in the installation directory. You cannot use the Import Configuration feature to upgrade or update your existing application. Note: The Import Configuration option is used for adding files to the EchosRepository directory when the files are not aailable in the root installation directory. Howeer, the option is not used as an installation option. 48 IBM Emptoris Suite: Installing You can click Check for new build if a new build is aailable for the applications that you hae already installed. The new builds must be aailable in the root installation directory. Cleaning the repository You can click Compact Local Repository to clean the EchOSRepository directory. Old build files are automatically deleted when you use this option. CAUTION: You must use this option only after the upgrade or update of the existing Emptoris applications is successfully completed. When the upgrade or update is successful, when you click Next, the home page of the installer is displayed. You can click Next to come to the Select the Install Type page to use the Compact Local Repository option. Licenses When you install Emptoris applications using the Emptoris Strategic Supply Management Installer, you must accept the Software License Agreement for all the Emptoris applications that you hae selected. You must click Accept on the Software License Agreement module to proceed to the next Emptoris product build that you hae selected. After you accept the

57 licenses, a compressed file for each product is generated in the Echos-installer > EchOSRepository > Packages directory. The name of the license file is appended with _license. Example: EMP-SLM_ _license.zip. The license files are copied to the target machine (where the application is to be installed) during the installation. Configuring Global Settings Global Settings are configured for all applications. In an integrated enironment, the Global settings are applicable for all applications in the suite. Global settings are also applicable when you install a single application. Procedure Use the following procedure to configure the Global settings page for Emptoris Strategic Supply Management Installer 1. Configure Suite Properties. 2. Configure Software Properties. 3. Configure Application Web Serer properties. 4. Click Next. Suite Properties: The following image details the Suite settings in the Global Settings module: Suite Settings Configure the fields shown in the following table to configure Suite settings: Table 9. Suite Settings Field Installation label Guideline Enter a name for the Emptoris Strategic Supply Management Installer configuration that you are about to create. The production and non-production installation each has a label that is used to identify the installation. Enter the label of the configuration file you want to select. The alue of the production installation label is used to register the production system as a client of the non-production system. Use a string alue for the installation label. If you use an integer alue for the installation label, the installation fails. Production Installation The installations of the IBM Emptoris products are tagged as production or non-production. This tagging is for license purposes. Select the check box if the deployment is intended for a production site. If you do not select the check box, the deployment is tagged as non-production. Chapter 3. Installation 49

58 Table 9. Suite Settings (continued) Field Install Serices Guideline Select the check box if you want to install operating system managed serices for the applications that you selected. If this option is not selected, the serices of the applications must be started manually. SSO Shared Secret If you are installing the Emptoris products as a non-root user, you must clear the Install Serices check box. Use for integrating applications. When you specify the alue, an encrypted key is set for integrating Emptoris applications. Web Serices Select the Use Emptoris Default Web Serice Security check box to enable web serice security. Transport Utility Configuration The following image details the Transport Utility Configurations in the Global Settings module: Configure the fields shown in the following table to configure Transport Utility: Table 10. Transport Utility Settings Field Source Appliance Configuration File Archie Password Client Secret Guideline Upload the configuration file from the source system when you install the target system. This file is required to run the data transport feature. For more information, see Data Transport Feature. Note: During an upgrade, when you select the appliance configuration file and start the installation, a No Upgrade is necessary message is displayed. To resole this issue, make a minor change in the configuration, such as increasing the maximum post size by 1 byte. The archie password that you entered at the time the file was created. You must enter the password before you select the Source Appliance Configuration file. The secret password for authenticating and facilitating exchange of data between source and target systems in Emptoris Contract Management. The alue of the Client Secret is used to register the target system as an OAuth client of the source system. 50 IBM Emptoris Suite: Installing

59 Mail Settings You can configure mail serer to send and receie s and notifications from the Emptoris Strategic Supply Management Platform administrator. Configure the mail serer in the SMTP Serer field. Antiirus Settings You can configure Antiirus settings if you want to enable Antiirus Protection for Emptoris applications in your deployment. When you select Yes to Enable Antiirus Protection, you must configure the following fields. Antiirus Serer Host Antiirus Serer Port The antiirus settings are optional. If proided, the settings are used for all Emptoris applications that are installed. Software Properties: The following image details the Software settings page. Software Settings Configure the fields shown in the following table to configure Software settings. Table 11. Global Software Settings Field Jaa Home WebSphere Home Guideline Enter the location of the folder where Jaa is installed. The default path is /opt/ibm/websphere/appserer/jaa_1.7.1_64. All configurations that are required for JDK are automatically made when the installer is run. Enter the location of the folder where WebSphere is installed Chapter 3. Installation 51

60 Table 11. Global Software Settings (continued) Field WebSphere Global Security User Name WebSphere Global Security User Password Websphere LTPA Timeout Guideline Enter user name Note: For the first installation, the WebSphere Global Security User Name and WebSphere Global User Password is used to configure the administratie user for the WebSphere Application Serer. For subsequent updates or upgrades to the suite you must use the same user and password that you specified for the first time. If you proide a wrong password for the same user name, the update or upgrade fails. Enter password The default is 480 minutes. Note: When you log in to the Emptoris suite of applications through the Emptoris Strategic Supply Management platform, you do not need to log in again to access your application. Your login session remains alid for the time that is specified for this property. Een when you log out of an indiidual application, the LTPA token does not become inalid and you can go to other products for the time specified for this property. Application Web Serer: You must configure web serices settings if you want to use web serices for Emptoris Spend Analysis Web Serer Configuration The following image shows the options. Specify the following options. Suite Application Connection Protocol: Select HTTP or HTTPS for the connection protocol. Emptoris Suite Fully Qualified Domain Name: Specify the fully qualified domain name for the web serer. 52 IBM Emptoris Suite: Installing

61 Web serice for Emptoris Spend Analysis The Spend web serice is required for the integration of Emptoris Contract Management and Emptoris Spend Analysis. You must select True for the Enable Spend Web Serice to integrate Emptoris Contract Management and Emptoris Spend Analysis, and specify the alues for the following settings. Table 12. Spend Web Serice. Spend Web Serice Field Spend web serice security token-id Spend web serice security token-domain Guideline A token ID to alidate the web serice session. Web serice domain for Emptoris Spend Analysis. Configuring Emptoris HTTP Proxy settings An Apache web serer, called the Emptoris HTTP Proxy, is configured during installation. You can install the Emptoris HTTP Proxy web serer on the same system as other serers. Procedure To configure Emptoris HTTP Proxy settings, complete the following steps: 1. Select the HTTP Proxy Modules. You can choose to install fie more Emptoris HTTP Proxy serers for indiidual applications. 2. Configure the Topology Configurations. 3. Configure the Allowed Referer Domains. 4. Configure the General Configuration. 5. Click Next. Topology Configuration: In the Topology Configuration section, you must specify the port for HTTP Proxy and the IP configurations. Topology Configuration The following image details the Topology section of the Topology Configuration module. Chapter 3. Installation 53

62 The following table lists the parameters you must configure. Table 13. Configurations for HTTP Proxy Serer Parameter Description HTTP Proxy Port Port for Apache on localhost. The default port is Enable Pod Configuration Install test perimeter web serer Select Yes to install an Emptoris HTTP Proxy for each application in the suite. You must later assign each Emptoris HTTP Proxy instance to run on the same machine as the Emptoris application. If you select No, you can choose to install the perimeter web serer (PWS). If you select Yes, you cannot specify the PWS. Note: This option is most commonly used when installing multiple Emptoris Contract Management serers behind a load balancer. Install test perimeter web serer: Select this option to install a sample Apache configuration showing how to route requests to the Emptoris HTTP Proxy. The configuration is deployed on the same machine as Emptoris HTTP Proxy. Note: This configuration is not intended for production use. You should use it in test configurations or sandbox enironments. IP Configuration The following image show the IP Configuration section. When you select Yes for the Skip host name resolution option, host names are used when selecting target machines, and the generated Apache configuration contains host names. When you select No, host names are conerted to IP addresses. IP addresses are used in the generated configuration. The following table lists the options that you must specify if you select No for the Skip host name resolution option. 54 IBM Emptoris Suite: Installing

63 Table 14. Configurations for IP on the HTTP Proxy Serer Parameter Prefer IP6 Hosts file Description If you select Yes, IP6 addresses are preferred, and if aailable, used in the configuration. Select the hosts file that lists the IP addresses. Allowed Referer Domains: By default, the HTTP Proxy module blocks non-get requests where the Referer header of the request is not that of the Emptoris installation. You can specify up to fie domains from which non-get HTTP requests specifying a Referer header may originate. The following image shows the referer domains that you can specify. Note: When integrating with SAML2, it is not necessary to proide the domain of your IdP serer in this list. General Configuration: You must specify the installation directory of Apache in the General Configuration section. Specify the installation directory path in the Apache text box. You need not specify the path to the Apache executable file. The following image shows the Apache text box in the General Configuration section. If you hae upgraded from Apache 2.2.x to 2.4.x, make sure that you proide the path to the new installation. Chapter 3. Installation 55

64 Configurations for Emptoris Sourcing In Emptoris Sourcing, the Proxy, Primary, and Batch Serer 1 are mandatory, and are installed on a single node. All other serers are installed on separate nodes. Multiple serers can also be installed on a single node. Depending on your setup, you can install two more batch serers and three eent serers. Adding Emptoris Sourcing to your setup If you hae an existing setup of other applications, you can add Emptoris Sourcing to your setup. Make sure that you hae the prerequisite hardware and software for Emptoris Sourcing. For more information, see IBM Emptoris Suite Serer System Requirements and IBM Emptoris Suite Client System Requirements. Upgrading and updating Emptoris Sourcing If you already hae Emptoris Sourcing 10.0 in your setup, you can upgrade or update your existing Emptoris Sourcing application to a later ersion. Upgrading from a pre ersion to the latest ersion is a paid serice and performed by the Emptoris serices team. Contact your IBM Emptoris representatie to request upgrading. Specifying the Settings for Emptoris Sourcing: You must configure the database connection, adanced settings, and serer settings for Emptoris Sourcing. About this task If you want to run the primary and batch serers on separate systems, you must not install the batch serer 1 and select batch serer 2 or 3. Batch serer 1 is always installed on the same system as the primary serer. Procedure To configure Emptoris Sourcing, complete the following steps: 1. Select the Emptoris Sourcing modules. 2. Select the database and configure the Database Connection. 3. Specify the Adanced settings. 4. Specify the Primary Serer Configuration. 5. Specify the batch and eent serer configurations. 6. Click Next. Sourcing Database Connection: You must select an Oracle or a DB2 database to configure for Emptoris Emptoris Sourcing. SSM Database The Emptoris Strategic Supply Management Platform database that you select requires the driers that are located in the Emptoris Sourcing serer. 56 IBM Emptoris Suite: Installing

65 Note: The alues that are listed in the images are examples. Consult your network administrator for details. The following image shows the SSM Database option. You can select Oracle or DB2 for the database. Select Database You can select Oracle or DB2 for the Emptoris Sourcing database. The options that are displayed in the Database Connection section change according to the database that you select. Database Connection The following image shows the options that are displayed when you select Oracle as the database. The following table lists the options for the Oracle database. Table 15. Oracle database settings Field Oracle Database Serer Oracle Database Port Oracle Database Serice Name Description IP address of the serer of the Oracle database. Port for the Oracle database. Name of the Oracle serice on the database. Do not specify the SID. Note: If you are upgrading from an earlier ersion to or later, the alue for Oracle Database Serice Name is not populated automatically from the saed configuration. You must reenter the alue. The alue is the same as the Oracle Database SID/RAC Serice Name field that was aailable in the earlier ersions. Chapter 3. Installation 57

66 Table 15. Oracle database settings (continued) Field Description Oracle Database User User name for the database. Oracle Database Password Password for the database. The following image shows the options that are displayed when you select DB2 as the database. The following table lists the options for the DB2 database. Table 16. DB2 database settings Field DB2 Database Serer DB2 Database Port DB2 Database Name DB2 Database Schema Name DB2 Database User DB2 Database Password Description IP address of the serer of the DB2 database. Port for the DB2 database. Name of the database. Name of DB2 schema. User name for the database. Password for the database. Adanced: You must specify the installation directories for Jaa and the WebSphere Application Serer in the Adanced section. If you plan to use an FTP serer, you must specify the configurations for that. Adanced The following image shows the options for Jaa and WebSphere Application Serer installation directories. 58 IBM Emptoris Suite: Installing

67 Note: The alues listed in the image are examples. Consult your system administrator for details. The following table lists the Adanced settings that you must configure for Emptoris Sourcing. Table 17. Adanced settings Field Jaa home WebSphere home Guidelines Enter the path for the WebSphere Application Serer Jaa directory. Enter the path for the WebSphere Application Serer. FTP Selection If you plan to use an FTP serer, you must select Yes for the Enable FTP option, and configure the properties for the serer. The following image shows the options for the FTP serer. Note: The alues listed in the image are examples. Consult your system administrator for details. Specify the following Properties for the FTP serer. Table 18. FTP settings Field FTP Protocol FTP Host IP FTP User name FTP Password Guidelines Enter the FTP protocol used in your deployment. Enter the IP address for the FTP host serer. Enter User name. Enter password. Chapter 3. Installation 59

68 Table 18. FTP settings (continued) Field FTP Folder Guidelines Enter the path for the FTP folder. Primary, Batch, and Eent Serer Configurations: After you specify the database connection and adanced settings, you need to specify only the JVM heap size for the primary, batch, and eent serers that you plan to configure. You can select one of the following options for JVM Heap Size for all serers. Entry (Min 2 GB - Max 2 GB) Small (Min 2 GB - Max 4 GB) Medium (Min 4 GB - Max 8 GB) Large (Min 4 GB - Max 16 GB) Configurations for Emptoris Contract Management The Emptoris Contract Management Serer 1 is selected by default. You can add more serers depending on the data load you want it to handle. To install the modules, select the check boxes of the modules that you want to install. If you already hae Emptoris Contract Management 10.0 in your setup, you can upgrade or update your existing Emptoris Contract Management application to a later ersion. You must reinstall the Document Serer eery time Emptoris Contract Management is upgraded. You can hae a UNC network path or a mapped drie as the location for the File Repository. A system account user must hae write permissions for that directory. You can proide a UNC path or mapped drie after installing Emptoris Contract Management and before starting the application. Specifying the Settings for Emptoris Contract Management: You must configure the database connections, miscellaneous settings, and adanced settings for Emptoris Contract Management. About this task Procedure To configure Emptoris Contract Management, complete the following steps: 1. Select the Emptoris Contract Management modules. The Emptoris Contract Management Serer 1 is selected by default. To install the modules, select the check boxes of the modules that you want to install. 2. Select the database for Emptoris Strategic Supply Management Platform and Emptoris Contract Management. 3. Specify the miscellaneous and adanced settings for Emptoris Contract Management. 4. Click Next. 60 IBM Emptoris Suite: Installing

69 Contracts Database: You can select Oracle or DB2 as the database for Emptoris Contract Management. You must proide the same user for the Database User and Reporting Schema Database User. Oracle database The following image shows the options for the Oracle database. Note: The alues that are listed in the image are examples. Consult your network administrator for details. The following table lists the Oracle database settings that you must configure for Emptoris Contract Management. Table 19. Oracle database settings Field Database Serer Database Port Database Serice Name Database User Database Password Reporting Schema Database User Reporting Schema Database Password Description IP address of the serer where the Oracle database is installed. Port for the Oracle database. Serice name of the database. Do not specify the SID. User name for the database. Password for the user. Reporting Schema Database user name. Enter the Reporting Schema Database password. Chapter 3. Installation 61

70 DB2 database The following image shows the options for the DB2 database. The following table lists the options for the DB2 database. Table 20. DB2 database settings Field Database Serer Database Port Database Serice Name DB2 Database Schema Name Database User Database Password Reporting Schema Database User Reporting Schema Database Password Description IP address of the serer where the DB2 database is installed. Port for the DB2 database. Serice name of the database. Schema name on the DB2 database. User name for the database. Password for the user. Reporting Schema Database user name. Must be the same as the database user. Enter the Reporting Schema Database password. SSM Database: The Emptoris Strategic Supply Management Platform database that you select requires the driers that are located in the Emptoris Contract Management serer. 62 IBM Emptoris Suite: Installing

71 The following image shows the SSM Database option. You can select Oracle or DB2 for the database. Note: The alues that are listed in the images are examples. Consult your network administrator for details. When you select DB2 as the SSM Database option, you must also specify the DB2 Database Drier Path. Miscellaneous: You must configure arious settings that are required for Emptoris Contract Management in the Miscellaneous section. Miscellaneous The following image shows the settings in the Miscellaneous section. The following table lists the Miscellaneous settings in Emptoris Contract Management. Table 21. Miscellaneous settings Field ECM Application Display Language Wordserice Port Upload User Exits Description Language of the Emptoris Contract Management application. Port number of Contract Document serer. File that contains the triggers at predetermined contracting eents. If you are upgrading, the preiously saed configuration file contains the information for the User Exits. Chapter 3. Installation 63

72 Table 21. Miscellaneous settings (continued) Field Upload Site Configuration Properties Description File that contains the site configuration properties (ecm.properties). If you are upgrading, the preiously saed configuration file contains the information for the site configuration properties. Notify Approal Status to Sourcing PDA SSO Approal URL File Repository Location Option to notify the Emptoris Sourcing application when contracts are approed. Option to generate the PDA URL in an SSO compatible form. Location of the root folder of the Emptoris Contract Management file repository. It seres as the root for contract attachments and parent folder for keyword search index repository. To specify the path, use one of the following options based on your operating system. On Windows, use a double backslash or a single forward slash. The directory must be aailable before you start the installation. <DrieName>:\\<FolderName> Or <DrieName>:/<FolderName> On Linux, use a single forward slash. /<FolderName> URI Configuration The following image shows the URI Configuration options. The following SSO Authentication URIs are required if you are integrating Emptoris Sourcing and Emptoris Contract Management. Application Authentication URI SSO Authentication URI PDA Authentication URI SSO Authentication URI on PDA Word Client SSO Authentication URI 64 IBM Emptoris Suite: Installing

73 Emptoris Contract Management Serer: Adanced: For eery serer that you choose for Emptoris Contract Management, you must specify the Jaa path, WebSphere Application Serer path, post size, and JVM heap size. If you are integrating with Emptoris Sourcing, you must keep minimum 2 GB as the JVM heap size. The following image shows the Adanced settings for the Emptoris Contract Management serer. The following table lists the Adanced settings. Table 22. Adanced settings Field Jaa home WebSphere home Maximum Post Size JVM heap size Description Path of the WebSphere Application Serer Jaa directory. Path for the WebSphere Application Serer. Maximum size in bytes for each post. Heap size for the application. If you are using the Data Transport feature, you must change the heap size to 3 GB. Configurations for Emptoris Spend Analysis By default, the Primary Serer, Reporting Node 1, and Reporting Node 2 modules are selected. You can choose to install Reporting Node 3 and Database Copy Node. Specifying the Settings for Emptoris Spend Analysis: You must configure the adanced settings, primary configurations for the database serer, and properties for the reporting nodes and database copy nodes for Emptoris Spend Analysis. Procedure To configure Emptoris Spend Analysis, complete the following steps: 1. Select Emptoris Spend Analysis modules. 2. Specify the Adanced Settings. 3. Specify the Primary Configuration. 4. Select the database for Emptoris Strategic Supply Management Platform. 5. Specify the Reporting and Database Copy Nodes. Chapter 3. Installation 65

74 6. Click Next. Emptoris Spend Analysis: Adanced: In the Adanced section of the Emptoris Spend Analysis page in the installer, you must specify the Jaa and WebSphere Application Serer installation directory paths, and the path of the TexLie executable. Adanced The following image shows the options in the Adanced section. The following table lists the options in the Adanced section. Table 23. Adanced settings Field Jaa Home WAS Home TexLie Executable Description Path for the WebSphere Application Serer Jaa directory. Path for the WebSphere Application Serer. Path for the directory where the TexLie executable file is saed. Database Connection Note: The alues listed in the image are examples. Consult your network administrator for details. The following table lists the database connection settings that you must configure for Emptoris Spend Analysis. 66 IBM Emptoris Suite: Installing

75 Table 24. Database connection settings for Emptoris Spend Analysis Field Description Database Serer IP address of the database serer. Database Serer Port Port number of the database serer. Database User User name to access the database serer. Database Password Password for the database serer. MySQLConnector JAR file Location of the MySQLConnector.JAR file. Enable Publishing Spend Data Set The following image shows the options for publishing the spend data set. You can select both the options for publishing the data set. After you select the check boxes, you must specify the database details. The following images show the options that are aailable for the databases. Chapter 3. Installation 67

76 Primary Serer: Primary Configuration: Serer Properties Select the JVM Heap Size for which the default is 2 GB. The following image shows the serer properties and database connection. 68 IBM Emptoris Suite: Installing

77 Database Connection Specify the names of the following databases. Control Database Usage Database SSM Database: The Emptoris Strategic Supply Management Platform database that you select requires the driers that are located in the Emptoris Spend Analysis serer. The following image shows the SSM Database that you can select. Reporting and Database Copy Nodes: For the Reporting Nodes and Database Copy Node that you select for Emptoris Spend Analysis, you must specify the JVM heap size and the database name. The following image shows the options for the reporting nodes and database copy node. Chapter 3. Installation 69

78 Configurations for the Emptoris Strategic Supply Management Platform and Emptoris Program Management The Emptoris Strategic Supply Management Platform is mandatory in the Emptoris setup. The option for the primary serer is selected by default and cannot change this option. A primary serer is installed by default and you can optionally add an index serer. The index serer can be installed as a stand-alone index serer. Index serer From the Modules section, you can select the Index Serer to be installed into a separate JVM by selecting the INDEX_SERVER check box. This might increase performance in larger installations, but the Index Serer can be started and stopped separately. Adding Emptoris Program Management to the Emptoris setup The settings for Emptoris Program Management are the same that are specified for the Emptoris Strategic Supply Management Platform. The option to install Emptoris Program Management along with the Emptoris Strategic Supply Management Platform is enabled in the installer if the EMP_PGM_ _<build number>.zip file is aailable in your root installation directory. Specifying the Settings for the Emptoris Strategic Supply Management Platform and Emptoris Program Management: For the Emptoris Strategic Supply Management Platform and Emptoris Program Management, you must specify the database connection, application settings, and primary serer properties. For the Emptoris Strategic Supply Management Platform, you can also add an index serer. Procedure To configure the Emptoris Strategic Supply Management Platform and Emptoris Program Management, complete the following steps: 1. Specify the Database Connection. 2. Specify the Application Settings. 3. Specify the Primary Serer details. 4. Optional: Specify the index serer details. 5. Click Next. Database Connection: For the Emptoris Strategic Supply Management Platform, you can select Oracle or DB2. For DB2, the Database Schema and Database User must be the same, or the installation fails. Oracle database The following image shows the properties for the configuration of the Oracle database. 70 IBM Emptoris Suite: Installing

79 Note: The alues listed in the image are examples. Consult your network administrator for details. The following table lists the configurations of the Oracle database for Emptoris Strategic Supply Management Platform. Table 25. Oracle configurations Field Oracle Database Host Oracle Database Port Oracle Database Serice Name Oracle Database User Oracle Database User Password Description IP address of the Oracle database. Port number of the Oracle database. Name of the serice of the Oracle database. Do not specify the SID. User name of the database. Password for the user of the database. DB2 database The following image shows the properties for the configuration of the DB2 database. Chapter 3. Installation 71

80 Note: The alues listed in the image are examples. Consult your network administrator for details. The following table lists the configurations of the DBB2 database for Emptoris Strategic Supply Management Platform. Table 26. DB2 database settings Field DB2 Database Serer DB2 Database Port DB2 Database Name DB2 Database Schema Name DB2 Database User DB2 Database Password Guideline IP address of the DB2 serer. Port number of the DB2 database. Name of the DB2 database. Schema name of the DB2 database. User name of the database. Password for the user of the database. Application Settings: In the Application Settings for Emptoris Strategic Supply Management Platform, you can enable SQL and Beanshell access, specify the home directory, enable Emptoris Program Management, and select the default language and currency. Adanced The following image shows the option in the Adanced section. 72 IBM Emptoris Suite: Installing

81 Note: The alues listed in the image are examples. Consult your network administrator for details. Select the Enable SQL Access check box to access the database with SQL queries. Home Directory The following image shows the Home Directory option. Specify the full path of the directory that you created when you prepared the system for installation. Program Management The following image shows the Enable Program Management option. Select Yes to install Emptoris Program Management along with Emptoris Strategic Supply Management Platform. This option is aailable only if the EMP_ PGM_ _<build number>.zip file is aailable in the root installation directory. Default Language and Currency The following image shows the options for the default language and currency. The following table lists the options for the default language and currency. Chapter 3. Installation 73

82 Table 27. Default language and currency settings Field Choose Default Language Choose Default Currency Description The following languages are aailable that you can select as the default language for the application. English French German Italian Korean Spanish Brazilian Portuguese Simplified Chinese Traditional Chinese Japanese The currency selected during the initial installation cannot be changed during updates or upgrades. This option is ignored when you run the Emptoris Strategic Supply Management Installer for updates and upgrades. Web Serices: From the Emptoris Strategic Supply Management Installer, you can select and install the web serice APIs for all 10.x ersions. The following image shows the web serices options that are aailable. When you select the Enable Web Serices check box, the options to select the web serice APIs is displayed. You can select the APIs to be installed. By default all web serices are selected to be installed. You can use this option if you do not know which API ersion to use. 74 IBM Emptoris Suite: Installing

83 You can choose to clear the Enable Web Serices check box and not install the APIs if APIs are not used in your setup. You can also choose to select the Preent Error Details in Web Serice Messages check box. When you select this option, error details are not logged in the messages of web serices. When you clear the Preent Error Details in Web Serice Messages check box, the WebSphere Application Serer is set in a mode where the SOAP web serice faults are not unified. For more information about the setting and its security ramifications, see Diagnosing Web Serices Problems. If you are planning to install Emptoris Supplier Lifecycle Management or Emptoris Spend Analysis, you must select API check box. If you are planning to install Emptoris Contract Management, you must select the API check box. Primary: Adanced: You must specify the JVM Heap Size, and the installation directory paths for Jaa and WebSphere Application Serer. The following image displays the options in the Primary: Adanced section. The following table lists the Primary Serer: Adanced settings that you must configure for the Emptoris Strategic Supply Management Platform. Table 28. Primary Adanced settings Field JVM Heap Size Jaa Home WebSphere Home Description JVM heap size. The recommended and default is 4 GB. Path that you specified for Jaa in the Global Settings is displayed. You must specify the path for the WebSphere Application Serer Jaa directory. Path for the WebSphere Application Serer. Index Serer Configurations: If you plan to use an index serer, you must specify the JVM heap size, and the installation directory paths for Jaa and WebSphere Application Serer for the index serer. You must also specify the Emptoris Strategic Supply Management Platform database that you plan to use. Chapter 3. Installation 75

84 Index Serer: Adanced The following image shows the options for the index serer. Note: The alues listed in the image are examples. Consult your network administrator for details. The following table lists the Index Serer: Adanced settings that you must configure for the Emptoris Strategic Supply Management Platform. Table 29. Index serer settings Field Heap Size allocated to the Index Serer JVM Jaa Home WebSphere Home Guidelines The recommended and default is 2 GB. Path for the WebSphere Application Serer Jaa directory. Path for the WebSphere Application Serer. The SSM database that you select is the database that the Emptoris Strategic Supply Management Platform uses. The driers for this database are also located on the Emptoris Strategic Supply Management Platform Index serer. Select the database for the Emptoris Strategic Supply Management Platform. Note: The alues listed in the image are examples. Consult your network administrator for details. Configurations for Emptoris Supplier Lifecycle Management For Emptoris Supplier Lifecycle Management, you can install only a single primary serer. The option for the primary serer is selected by default. You cannot change this option. Specifying the Settings for Emptoris Supplier Lifecycle Management: For Emptoris Supplier Lifecycle Management, you must configure the database connection, application settings, token expiration settings, spend periods, JMS configuration, business rule configuration, and the primary serer details. 76 IBM Emptoris Suite: Installing

85 Procedure To configure Emptoris Supplier Lifecycle Management, complete the following steps: 1. Specify the Database Connection. 2. Specify the Application Settings. 3. Specify the Token Expiration Configuration. 4. Specify the Spend Configuration. 5. Specify the JMS Configuration. 6. Specify the Business Rule Configuration. 7. Specify the Primary Serer details. 8. Click Next. Database Connection: For Emptoris Supplier Lifecycle Management, you can select an Oracle or DB2 database. Oracle database The following image shows the options that you must configure for the Oracle database for Emptoris Supplier Lifecycle Management. Note: The alues listed in the image are examples. Consult your network administrator for details. The following table lists the options for the Oracle database. Table 30. Oracle database settings Field Oracle Database Host Oracle Database Port Oracle Database SID Description IP address of the serer where the Oracle database is installed. Port number for the Oracle database. Serice name of the Oracle database. Do not specify the SID. Chapter 3. Installation 77

86 Table 30. Oracle database settings (continued) Field Oracle Database User Oracle Database Password Description User name to access the database. Password for the user to access the database. DB2 database The following image shows the options that you must configure for the DB2 database for Emptoris Supplier Lifecycle Management. Note: The alues listed in the image are examples. Consult your network administrator for details. The following table lists the options for the DB2 database for Emptoris Supplier Lifecycle Management. Table 31. DB2 database settings Field DB2 Database Serer DB2 Database Port DB2 Database SID Serice Name DB2 Database Schema Name DB2 Database User DB2 Database Password Description IP address of the serer where the DB2 database is installed. Port number for the DB2 database. Serice name of the DB2 database. Schema name on the DB2 database. User name to access the database. Password for the user to access the database. 78 IBM Emptoris Suite: Installing

87 Application Settings: In the Application Settings, you must configure arious settings that are required for Emptoris Supplier Lifecycle Management. The following table lists the options that are required for Emptoris Supplier Lifecycle Management. Table 32. Application Settings for Emptoris Supplier Lifecycle Management Field Image Description Configure Mini OLF QLF Mode is used to install a partial Supplier Qualification module. If you select the check box, you must specify the following options. mini QLF Internal Group Name mini QLF External Group Name Note: The QLF mode option is aailable only from Emptoris Supplier Lifecycle Management release onward. Uploaded Documents Configuration Specify the Max size for eery uploaded file, and specify the Document Configuration Data Path. Translation Updater Mode Document Datapath Select the option to load translations. If you choose to load new translations only, the earlier translations are not replaced. You can also choose to replace the existing translations with the new translations. Specify the directory path where documents that are uploaded are saed. Log file path Specify the log path where the log files are saed. Ealuation by feature Select the check box to enable the Supplier Ealuation by feature. Chapter 3. Installation 79

88 Table 32. Application Settings for Emptoris Supplier Lifecycle Management (continued) Field Image Description Approal requirement Select the Approal Result Logic and specify the Requirement Title and Requirement Status. SLM Supplier Code Select the unique ID as the supplier code. You can specify a prefix that will identify that the ID is receied from Emptoris Virtual Supply Master. Web API Specify whether you want absolute URLs or root relatie URLs for web APIs. Contract Management Sourcing Specify the time in hours for the Emptoris Contract Management information of suppliers to be displayed in Emptoris Supplier Lifecycle Management. Specify the time in hours for the Emptoris Sourcing information of suppliers to be displayed in Emptoris Supplier Lifecycle Management. Note: The alues that are listed in the image are examples. Consult your network administrator for details. Token Expiration Configuration: For IBM Emptoris Supplier Lifecycle Management, you must specify the time for the expiration of tokens. The following image shows the token expiration options that you must configure for IBM Emptoris Supplier Lifecycle Management. 80 IBM Emptoris Suite: Installing

89 The following table lists the options for token expiration. Table 33. Token Expiration Configuration Field Restricted area token alidity time period Restricted area token access count Anonymous area token alidity time period Anonymous area token access count Description Time period for which the token is alid in restricted areas of access. Number of tokens that are alid in restricted areas of access. Time period for which the token is alid in anonymous login. Number of tokens that are alid in anonymous login. Spend Configuration: For an integration of Emptoris Supplier Lifecycle Management and Emptoris Spend Analysis, you must specify one time period and its properties. You can also specify two more time periods and their properties. You can also define the Spend formats for Emptoris Supplier Lifecycle Management. Spend periods The following image shows the options that are aailable for configuring Spend periods for Emptoris Supplier Lifecycle Management. Note: The alues that are listed in the image are examples. Consult your network administrator for details. Chapter 3. Installation 81

90 Spend formats The following image shows the options that you can configure for the Spend formats for Emptoris Supplier Lifecycle Management. Note: The alues that are listed in the image are examples. Consult your network administrator for details. JMS Configuration: JMS authentication and authorization through embedded ActieMQ plug-ins is now possible for Emptoris Supplier Lifecycle Management. You can enable JMS auditing and JMS security for Emptoris Supplier Lifecycle Management. When you enable JMS security, you must specify the passwords for JMS internal and external users, upload the correct keystore file, and specify the passwords for the file. The following image shows the options for JMS Configuration. The keystore file is used to establish an SSL JMS connection with external JMS clients. The keystore file contains the SSL certificate that is required for the connection. 82 IBM Emptoris Suite: Installing

91 Business Rule Configuration: Business rules are required in Emptoris Supplier Lifecycle Management for RESTful interfaces. The page size configuration is applicable to all RESTful resources. The following images show the options that are aailable for business rules for Emptoris Supplier Lifecycle Management on Windows and Linux. Windows Linux Primary: Adanced: In the Primary: Adanced section, you must specify the installation directory paths for Jaa and WebSphere Application Serer, JVM Heap size, and also select the SSM Database. You can also select a site configuration properties file for the application, and choose to configure the internal and external URLs for the application. Adanced The following image shows the options that are aailable in the Primary: Adanced section for Emptoris Supplier Lifecycle Management Chapter 3. Installation 83

92 The following table lists the Adanced properties that you must configure for the Emptoris Supplier Lifecycle Management primary serer. Table 34. Primary Adanced settings Field Jaa Home WebSphere Home JVM Heap Size Upload Site Configuration Properties Description Path that is specified for Jaa in the Global Settings is displayed. You must specify the path for the WebSphere Application Serer Jaa directory. Path of the WebSphere Application Serer installation directory. The recommended and default is 4 GB. File that contains custom site configuration properties. SSM Database Selection The following image shows the option for selecting the database for Emptoris Strategic Supply Management Platform. When you select the check box to automatically calculate the URL for internal and external URLs, notifications are sent to users based on the user access. If notifications are to be sent to an external user, an external URL is automatically generated for the user. If notifications are to be sent to an internal user, an internal URL is automatically generated for the user. Configurations for Analytics Installation Module You must specify the settings on the Analytics Installation Module page in the installer to configure InfoSphere DataStage and Cognos for Emptoris Contract Management. For using InfoSphere DataStage and Cognos for Emptoris Spend Analysis, you must contact your customer representatie. The administratie user credentials for InfoSphere DataStage and Cognos must match the credentials of the default Emptoris Strategic Supply Management Platform administratie user for the initial installation. Modules The Analytics Integration Module Serer is selected by default and cannot be changed. You hae the option to configure the DataStage Integration Serer by selecting the check box. 84 IBM Emptoris Suite: Installing

93 Specifying Settings for the Analytics Installation Adaptor: For the Analytics Installation Adaptor, you must configure the database connection, application settings, and InfoSphere DataStage and Cognos settings. About this task If you are upgrading from the Emptoris application ersion to the ersion, settings from the saed configuration file do not populate automatically in the Analytics Installation Adaptor page. You must reenter them. See the following image for the settings that you must specify. Procedure To configure the Analytics Installation Adaptor, complete the following steps: 1. Specify the Database Connection. 2. Specify the Application Settings. 3. Specify Cognos Configuration. 4. Specify InfoSphere DataStage Configuration. 5. Click Next. Contracts Integration: In the Contracts Integration section, you must select the database and its required properties. Chapter 3. Installation 85

94 Oracle database The following image shows the Oracle database options. Note: The alues listed in the image are examples. Consult your network administrator for details. The following table lists the options for the Oracle database. Table 35. Oracle database settings Field Database Serer Database Port Database Serice Name Database User Database Password Description IP address of the serer where the Oracle database is installed. Port number for the Oracle database. Serice name of the Oracle database. Do not specify the SID. User name to access the database. Password for the user to access the database. 86 IBM Emptoris Suite: Installing

95 DB2 databaase The following image shows the options for the DB2 database. Note: The alues listed in the image are examples. Consult your network administrator for details. The following table lists the options for the DB2 database. Table 36. Database settings Field DB2 Database Serer DB2 Database Port DB2 Database Name DB2 Database Schema Name DB2 Database User DB2 Database Password Description IP address of the serer where the DB2 database is installed. Port number of the database. Name of the database. Schema name on the DB2 database. User name to access the database. Password for the user to access the database. Upgrading the Analytics module While upgrading the Analytics module, the database connection alues are not automatically displayed. You must manually reenter the alues. Cognos Configuration: For integrating Cognos with Emptoris Contract Management, you must specify the details for Cognos. Chapter 3. Installation 87

96 The following image shows the options that you must specify for Cognos. Note: The alues listed in the image are examples. Consult your network administrator for details. The following table lists the options for application configuration for Cognos. Table 37. Application configuration settings for Cognos Field Cognos Home Cognos Administrator User Cognos Administrator User Password Cognos Dispatcher port Cognos Model Home Description The default path is <Cognos installation directory>/ibm/cognos/c10_64. User name for the Cognos user. Password for the Cognos user. Dispatcher port number for Cognos. Directory path of the reporting model. Note: If you are upgrading your setup from a preious ersion to , the alue for Cognos Model Home is not automatically displayed. You must manually enter the alue again. Content Store Configuration: The following image shows the options that you must configure for the Content Store. 88 IBM Emptoris Suite: Installing

97 Note: The alues listed in the image are examples. Consult your network administrator for details. The following table lists the Oracle database settings that you must configure for Cognos Content Store. Table 38. Database settings Field Database Serer Database Port Database SID Database User Database Password Cognos Oracle Database Client Directory DataStage Oracle Database Client Directory Guideline IP address of the serer where the database is installed. Port number for the database. Serice name of the database. User name to access the database. Password for the user to access the database. Directory path of Oracle client for Cognos. Note: Cognos requires a 32-bit Oracle client. Directory path of Oracle client for InfoSphere DataStage. Note: InfoSphere DataStage requires a 64-bit Oracle client. Note: If you are upgrading your setup from a preious ersion to , the Content Store properties are not automatically displayed. You must manually specify the alues again. Analytics Integration Module Serer: Adanced: In the Adanced section, you must specify the paths for Jaa and WebSphere Application Serer, and specify the JVM Heap Size. The following image shows the options that you must configure in the Adanced section. Chapter 3. Installation 89

98 DataStage Integration Serer: DataStage Configuration: For integrating InfoSphere DataStage with Emptoris Contract Management, you must specify the DataStage Configuration details. 90 IBM Emptoris Suite: Installing

99 The following image shows the options that you must configure for InfoSphere DataStage. Note: The alues listed in the image are examples. Consult your network administrator for details. The following table lists the options that you must configure for InfoSphere DataStage. Table 39. Settings for InfoSphere DataStage Field DataStage Home Jaa Home Guidelines The default path is <DataStage installation directory/ibm/informationserer. Directory path to Jaa for InfoSphere DataStage. DataStage Administrator User DataStage Administrator User Password While upgrading the Analytics module, the alue for Jaa Home is not automatically displayed. You must manually reenter the alue. User name to access InfoSphere DataStage. Password for the user to access InfoSphere DataStage. Chapter 3. Installation 91

100 Table 39. Settings for InfoSphere DataStage (continued) Field DataStage Serer Port DataStage Projects Directory DataStage Project Name Prefix Guidelines Port number of the InfoSphere DataStage serer. Path to the projects directory. Prefix for the project name. While upgrading the Analytics module, the alue for the DataStage Project Name Prefix is not automatically displayed. You must manually reenter the alue. Configurations for the Search Serer The Emptoris Contract Management application supports the Solr search engine for indexing and searching. The Search Serer is a mandatory component for Emptoris Contract Management. The installation and configurations of the Solr serers is done through the Emptoris Strategic Supply Management Installer. One indexing serer is selected by default when you run the installer. The recommended minimum configuration is three. You can choose to install only one search serer or add up to seen serers in your setup. One serer can be used for small enironments, such as test enironments. It is recommended that an odd number of modules be selected. All Search Serer modules can be installed on the same or on different systems. After you install Emptoris Contract Management successfully, and start the application, full indexing is automatically started. Specifying Settings for the Search Serer: For installing and configuring the Search Serer for Emptoris Contract Management, you must select the number of search serers that you want to install, specify the Heap size for the serers, and optionally choose to specify different data directories for the serers. Procedure To specify the settings for the Search Serer, complete the following steps: 1. Select the Search Serer Modules. 2. Specify the Global Search Serer Settings. Search Serer Modules: You can install up to seen search serers for Emptoris Contract Management. One serer is selected by default when you run the installer. You can choose to install a single serer or add multiple serers to your setup. Global Search Serer Settings: In the Global Search Serer Settings section, you can specify the Heap size and the topology configuration for the serers. 92 IBM Emptoris Suite: Installing

101 Runtime Configuration The following image shows the Runtime Configuration setting for the Search Serers. The default Heap Size for the Search Serer is 1024 MB. You can select Heap size from the Search Serer Heap Size drop-down list. Topology Configuration The following image shows the Topology Configuration setting for the Search Serers. The following table lists the Topology Configuration options for the Search serer. Table 40. Topology Configuration settings for Search serer Field Use alternate data directories Description The default directory paths for the Search serer are in the <INSTALL_BASE>/perm/SEARCHSERVER/serer[x] directory. Alternate index data directory Alternate ZooKeeper data directory If you select the check box, you can specify different directories for the Search serer data and Zookeeper data. Specify a different directory for the Search serer data. Specify a different directory for the ZooKeeper data. Jaa, Solr, and ZooKeeper software are installed in separate directories. Separate directories are created for each Search Serer module, such as serer1, serer2. Each Search Serer consists of a Solr serer instance data and ZooKeeper instance data. The Solr instance data includes contract collections, such as contracts_shard1_replica1, and index data files. The ZooKeeper instance data includes the ZooKeeper configuration, transaction logs, and contracts configuration sets. Chapter 3. Installation 93

102 Note: For the search serices to be aailable, a majority of the ZooKeeper serices must be running. Related information: Table 55 on page 140 Identifying Hosts After you hae specified the settings for the products, you must identify and alidate the hosts that you hae specified for each application. Enter the host names of the different application serers you hae prepared for installation in the respectie text boxes. If you are using the Data Transport feature, you must use Fully Qualified Domain Names (FQDN) instead of host names. For the Search Serer, you can install all serers on a single system or on different systems. To install all serers on a single system, specify the same host name or IP address for all serers. To install the serers on different systems, specify different host names or IP addresses for each serer. Saing the configuration You can now sae the configuration on the Identifying hosts page before the host alidation. Saing configuration at this point saes your efforts to re-enter configuration details if installation fails for some reasons. Howeer, the saed configuration cannot be used during update or upgrade as the host alidation is not completed. As in the earlier releases, this option is also aailable on the Summary page after host alidation. Validating hosts When you click Validate Hosts, the application performs the following alidations. Communication between hosts and applications Required disk space and RAM on hosts Required operating system for the hosts Paths specified in preious installation screens are alidated If any of these alidations are not passed, an error message is displayed. You must resole the error for the hosts to be alidated. After the hosts are successfully alidated, click Next. Summary On the Summary page, click Print View to iew the configuration settings of the applications that you are installing. You can print the settings by clicking the Print hyperlink. On the Summary page, you can perform the following actions: View the summary Sae the configuration View and print the configuration settings 94 IBM Emptoris Suite: Installing

103 You should sae the configuration only if you plan to exit the installer. The configuration is saed later and the name for the saed file cannot be reused. After the hosts are alidated, you can iew the summary of the installation. A list is displayed of the applications and the host names on which they will be installed. Installing the Applications To install the applications, you must go to the Install page and click Start Installation. Prerequisite For the antiirus serer to scan attachments for Emptoris Sourcing, you must ensure that the alue for the StreamMaxLength property matches in the antiirus serer and in Emptoris Sourcing. To match the alue, copy the alue of the StreamMaxLength property from the clamd.conf file from the antiirus serer to the StreamMaxLength property in the siteconfig.properties file. You must set this property before the Emptoris Sourcing primary serice starts. Installation process When you start the installation, the installer performs the following actions: Appliance and application templates are saed on the serers on which applications will be installed. Configurations are alidated. Applications are installed. The Emptoris Strategic Supply Management Platform is installed first. After it is successfully installed, all other integrating applications are installed in parallel. The Installation Progress Info lists the tasks that are performed by the installer and shows the progress of each task. Successful and failed tasks are displayed in the list. A message is displayed when the installation is successful. After the installation is complete, you can close the Emptoris Strategic Supply Management Platform Installer by closing your browser. Starting the applications After the applications are installed, the Start Installation button is replaced by the Start Modules button. You can click the Start Modules button to start the installed Emptoris Suite applications. Starting and Stopping Application Serices After the applications are installed successfully, the application serices are deployed when the serices are started. Chapter 3. Installation 95

104 Manually starting serices If you did not start the applications on the Install page, you can see the Deploying Applications page for information on the serices that are created and how to start them. The display name for Windows contains IBM WebSphere Application Serer V8.5. For example, the Windows serice name of the Emptoris Sourcing primary serice is displayed as IBM WebSphere Application Serer V8.5 primary. Serice names The following serice names are created on the serers on which applications are installed. Table 41. Emptoris Serices Serice Name on Red Hat Enterprise Linux machines Serice name on Windows machines Module EmptorisHttpProxy EmptorisHttpProxy EmptorisHttpProxy Emptoris Sourcing primary_was.init IBMWAS85Serice primary Primary serer batch1_was.init IBMWAS85Serice - batch1 Batch serer 1 batch2_was.init IBMWAS85Serice - batch2 Batch serer 2 batch3_was.init IBMWAS85Serice - batch3 Batch serer 3 proxy_was.init IBMWAS85Serice proxy Proxy serer eent1_was.init IBMWAS85Serice - eent1 Eent serer 1 eent2_was.init IBMWAS85Serice - eent2 Eent serer 2 eent3_was.init IBMWAS85Serice - eent3 Eent serer 3 Emptoris Contract Management ecm1_was.init IBMWAS85Serice - ecm1 Emptoris Contract Management serer 1 ecm2_was.init IBMWAS85Serice - ecm2 Emptoris Contract Management serer 2 ecm3_was.init IBMWAS85Serice - ecm3 Emptoris Contract Management serer 3 ecm4_was.init IBMWAS85Serice - ecm4 Emptoris Contract Management serer 4 ecm5_was.init IBMWAS85Serice - ecm5 Emptoris Contract Management serer 5 Not Applicable IBM CM Document Serer Contract Document serer cognos1_was.init IBMWAS85Serice - cognos1 Cognos serer solr1 solr1 Search Serer 1 zookeeper-1 solr2 zookeeper-2 solr3 zookeeper-3 zookeeper-1 solr2 zookeeper-2 solr3 zookeeper-3 Search Serer 2 Search Serer 3 96 IBM Emptoris Suite: Installing

105 Table 41. Emptoris Serices (continued) Serice Name on Red Hat Enterprise Linux machines solr4 zookeeper-4 solr5 zookeeper-5 solr6 zookeeper-6 solr7 Serice name on Windows machines solr4 zookeeper-4 solr5 zookeeper-5 solr6 zookeeper-6 solr7 Module Search Serer 4 Search Serer 5 Search Serer 6 Search Serer 7 zookeeper-7 Emptoris Spend Analysis zookeeper-7 spendprimary_was.init IBMWAS85Serice - spendprimary plinthosnode1_was.init IBMWAS85Serice - plinthosnode1 plinthosnode2_was.init IBMWAS85Serice - plinthosnode2 plinthosnode3_was.init IBMWAS85Serice - plinthosnode3 plinthosdbcopynode_was.init IBMWAS85Serice - plinthosdbcopynode Spend primary serer Reporting serer 1 Reporting serer 2 Reporting serer 3 Database copy node (only when OLF is enabled) Emptoris Strategic Supply Management Platform and Emptoris Program Management gateway_was.init IBMWAS85Serice gateway Primary serer SSMIndexSerer_was.init IBMWAS85Serice - SSMIndexSerer Emptoris Supplier Lifecycle Management Index serer slm_was.init IBMWAS85Serice slm Primary serer Note: Depending on the serers you choose for installation, you may not see all the serices listed in the table. Order of starting serices Immediately after the installation, the Emptoris Strategic Supply Management Platform and the Emptoris Sourcing Proxy Serer (if installed) are automatically started. Use the following order to start the serices of Emptoris products. 1. Stop and restart the Emptoris Strategic Supply Management Platform 2. Sourcing Primary (If Emptoris Sourcing is installed) 3. All other Emptoris serices can be started concurrently Start the EmptorisHTTPProxy serice last to ensure that the enironment is accessible only after all modules are started. Chapter 3. Installation 97

106 Starting applications on Windows You can start and stop applications using the Windows serice manager application or by using the Windows sc command. To start the applications when serices are not installed, use the following command. <WAS_HOME>\AppSerer\bin\startSerer <serer_name> -profilename<profile_name> When running from the profile directory of a product, do not specify the profile. <emptoris_install_dir>/perm/.../<profile>/bin/startserer<serer_name> For Emptoris Sourcing, you must start the sourcing_spa1 serice of the primary serer before starting any other Emptoris Sourcing serice. Starting applications on Linux If the application is installed as a serice use the serice start/stop command to start and stop the application. serice gateway_was.init start You may need root or sudo priileges to run this command. Note: For Emptoris Sourcing, you must start the sourcing_spa1 serice of the primary serer before starting any other Emptoris Sourcing serice. Starting the EmptorisHTTPProxy serice If you cannot start the EmptorisHTTPProxy serice, check whether SELinux is enabled. If it is enabled, you must configure it to allow Apache to run as the emptoris user in the installation directory configured by the install process. Please consult your operating system documentation for details. Steps for Emptoris Contract Management for the ecm.properties File: From ersion onwards, some properties from the ecm.properties file for Emptoris Contract Management are configured in the Emptoris Contract Management application. If you hae successfully upgraded Emptoris Contract Management from an earlier ersion to or later, you must complete certain steps to ensure that the ecm.properties file has the latest updated properties. About this task After upgrading from an earlier ersion to or later, you must make sure that the ecm.properties file has the latest alues from the preious installation before you start the Emptoris Contract Management application serice. When the Emptoris Contract Management application serice is started for the first time, the configurations that can be done from the application UI are automatically migrated to the database and remoed from the ecm.properties file. Any upgrades to the or later enironment might result in the re-addition of the properties that are moed to the UI to the ecm.properties file. Howeer, the file is not automatically cleaned up again and the properties that get added do not hae any impact on the application. After upgrading to , the properties must be set from the UI. 98 IBM Emptoris Suite: Installing

107 Procedure To ensure that the ecm.properties is updated, complete the following steps: 1. Modify the configurations in the application UI. 2. Do not add the properties that are now moed to the UI to the ecm.properties file again. 3. Remoe any properties that are seen in the file but can be configured from the UI. 4. Sae the file. For more information about the properties in Emptoris Contract Management, see Configurations for Emptoris Contract Management on page 60. Verifying that the Emptoris Sourcing application is running: After the Emptoris applications are successfully installed and started, you can erify if the Emptoris Sourcing application is running. Procedure To erify that the Emptoris Sourcing application is running, complete the following steps: 1. Open the serer.log file that is located at <emptoris_install_dir>/perm/ SRC/profile/sourcing/logs/primary. 2. Verify that the file contains the following statements: TaskScheduler initialization complete. Recoering eents. Disabling Security Integration for Emptoris Sourcing: After the installation is completed, you must erify that the Security Integration option in the WebSphere Integrated Solutions Console is disabled for all nodes in the Emptoris Sourcing. Procedure To erify that the option is disabled, complete the following steps: 1. Start the primary serer serice for Emptoris Sourcing. 2. Log on to the WebSphere Integrated Solutions Console as the admin user. 3. Click Serers > Serer Types > WebSphere Application Serers. 4. In the serer list, click Primary Serer. 5. Under Container Settings, click Session Management. 6. Ensure that the Security Integration check box is not selected. Starting and Stopping Serices for Non-Root Installation: If you installed the Emptoris products by using a non-root user or if you disabled the option to install serices, serices for the Emptoris products are not created. The user must control the applications by using the instructions in this topic. Chapter 3. Installation 99

108 Procedure To start and stop the serices of Emptoris products, complete the following steps: 1. Complete the following steps to start application serices. a. Log in to the serers as the non-root user. b. Use the following command to start the serer. <WAS_HOME>\AppSerer\bin\startSerer <serer_name> -profilename <profile_name> The profile names for the Emptoris products can be found by using the following command. <WAS_HOME>\AppSerer\bin\manageprofiles.sh -listprofiles If you are running the command from the profile directory, use the following command. <emptoris_install_dir>/perm/.../<profile>/bin/startserer <serer_name> Note: The Emptoris Strategic Supply Management Platform gateway serices are automatically started by the installer. c. Use the following command to stop the serer. <WAS_HOME>\AppSerer\bin\stopSerer <serer_name> -profilename <profile_name> If you are running the command from the profile directory, use the following command. <emptoris_install_dir>/perm/.../<profile>/bin/stopserer <serer_name> 2. From the /opt/emptoris/apps/<installation directory>/apachexxx/ HttpProxyYYY/conf/httpd.conf directory, run the following command to start or stop the Emptoris HTTP Proxy (CWS) serice../emptorishttpproxy.sh [start stop] XXX is the ersion number and YYY is the module-specific identifier. Note: The PWS is not installed when root priileges are not aailable. 3. Complete the following steps to start and stop the serices of the Search serer. a. From the /opt/emptoris/apps/install_base/perm/searchserver/serer[x]/ solr directory, run the following command../solr.sh start where X is the number of Solr serer instance that you want to start. This command also starts the ZooKeeper instance. b. To stop the Search serer, run the./solr.sh stop command. c. To stop the ZooKeeper serice, from the /opt/emptoris/apps/install_base/ perm/searchserver/serer[x]/zookeeper directory, run the./zookeeper.sh stop command. Starting and Stopping the Serices for the Search Serers: After the Search serers are successfully installed and configured by using the Emptoris Strategic Supply Management Installer, separate serices for Solr and ZooKeeper instances are created. About this task The Solr serices are named solr1, solr2, and so on based on the instance number, and the ZooKeeper serices are named zookeeper-1, zookeeper-2 based on the instance number. 100 IBM Emptoris Suite: Installing

109 Procedure To start or stop the Serices for the Search serers, complete the following steps: On Windows, start the serices from the Windows Serices Management Console, or use the following commands. sc start solr[x] sc stop solr[x] sc start zookeeper-[x] sc stop zookeeper-[x] [X] is the number of the Solr or ZooKeeper instance. The ZooKeeper serice is automatically started when you start the Solr serice. On Linux, use the following commands. serice solr[x] start serice solr[x] stop serice zookeeper-[x] start serice zookeeper-[x] stop [X] is the number of the Solr or ZooKeeper instance. The ZooKeeper serice is automatically started when you start the Solr serice. Note: For search serices to be aailable, a majority of the ZooKeeper serices must be running. Logging in to the Emptoris Applications for the First Time after Installation The is a generic URL to access the Emptoris applications after a successful installation. The <FQDN> includes the FQDN and domain name that are specified during the installation in the Emptoris Strategic Supply Management Installer user interface. If you installed an Emptoris application for the first time with a fresh database, you can use admin as a user name. For the password, contact your IBM Emptoris Representatie. If you installed with an existing database, the existing log-in credentials work in a seamless manner. Post-Installation Configurations After the installation of Emptoris products is successfully completed, you must complete some post-installation configurations. Completing the post-installation configurations is the last step in setting up the Emptoris applications. The following diagram shows the installation steps. Chapter 3. Installation 101

110 Post-Installation Configurations for Emptoris Strategic Supply Management Platform After installing Emptoris Strategic Supply Management Platform successfully, you must perform post-installation tasks to configure Emptoris Strategic Supply Management Platform. Adding the From address for the default System Administrator user After installing Emptoris Strategic Supply Management Platform successfully, you must perform post-installation tasks to configure Emptoris Strategic Supply Management Platform. Procedure To configure a alid From address for the default System Administrator user, perform the following tasks: 1. Log on to the Emptoris Strategic Supply Management Platform as the default System Administrator user. 2. From the menu bar, click System Admin > Profile. 3. Enter a alid address. 4. Click Sae. If you do not specify a alid address, notifications are not sent to users, and the following error message is displayed. 102 IBM Emptoris Suite: Installing