IBM Maximo Asset Management: Installation Guide (Oracle ... · PDF fileConfiguring and managing Oracle WebLogic Server ... Linux 5 systems, ... This utility cannot be used to check

Embed Size (px)

Citation preview

  • IBM Maximo Asset ManagementVersion 7 Release 5

    Installation Guide(Oracle WebLogic Server)

  • NoteBefore using this information and the product it supports, read the information in Notices on page 197.

    This edition applies to version 7, release 5, modification 0 of IBM Maximo Asset Management and to all subsequentreleases and modifications until otherwise indicated in new editions.

    Copyright IBM Corporation 2007, 2011.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

  • Contents

    Chapter 1. Preparing for installation . . 1Software installation images . . . . . . . . . 1Before you begin . . . . . . . . . . . . . 1

    Programmatically verifying prerequisites . . . . 2Checking port availability . . . . . . . . . 7AIX and HP-UX tar command requirements . . . 7AIX font requirements . . . . . . . . . . 8Enabling asynchronous I/O on AIX. . . . . . 8Checking for required libraries on Linux . . . . 8Configuring the JRE in Linux . . . . . . . . 9Setting the ulimit . . . . . . . . . . . . 9Setting the swap size . . . . . . . . . . 10Setting shared memory . . . . . . . . . 10Remote configuration enablement . . . . . . 10System password policy settings . . . . . . 12Backing up the Deployment Engine database . . 12Specifying host name values. . . . . . . . 13

    Establishing a fully qualified host name onWindows systems . . . . . . . . . . 13Forcing the middleware installer to usealphanumeric hostnames . . . . . . . . 13

    Launchpad . . . . . . . . . . . . . . 13Starting the launchpad . . . . . . . . . 14

    Chapter 2. Deploy with automaticmiddleware configuration. . . . . . . 15Middleware installation program middlewaredeployment plan overview . . . . . . . . . 16Installing middleware using the middlewareinstallation program . . . . . . . . . . . 16

    Middleware installation program logs . . . . 18Middleware installation program log reference 20

    Configuring IBM Tivoli Directory Server user andgroup strings . . . . . . . . . . . . . 25

    Uninstalling middleware . . . . . . . . . . 25Reinstalling middleware with IBM DB2 . . . . . 27Manually configuring WebLogic Server . . . . . 27

    Creating the MAXIMOSERVER domain . . . . 28Configuring JMS options for integrationframework . . . . . . . . . . . . . 28Configuring JMS for the email listener inWebLogic Server. . . . . . . . . . . . 30

    Installation program overview . . . . . . . . 32Installing the product and automaticallyconfiguring middleware . . . . . . . . . 33Creating a maxdemo database during installation 38

    Post installation for Oracle WebLogic Serverdeployments . . . . . . . . . . . . . . 38Deploying ear files . . . . . . . . . . . . 40Setting the Oracle WebLogic Server host name. . . 41Language deployment after database updatedeferral . . . . . . . . . . . . . . . . 42

    Manually deploying languages after databaseupdate deferral . . . . . . . . . . . . 42

    Chapter 3. Deploying automaticallyreusing existing middleware . . . . . 43Run the middleware installation program onexisting middleware servers . . . . . . . . . 44

    Configuring an existing DB2 with themiddleware installation program . . . . . . 46

    Manually configuring WebLogic Server . . . . . 47Creating the MAXIMOSERVER domain . . . . 47Configuring JMS options for integrationframework . . . . . . . . . . . . . 48Configuring JMS for the email listener inWebLogic Server. . . . . . . . . . . . 50

    Installation program overview . . . . . . . . 52Installing the product and automaticallyconfiguring middleware . . . . . . . . . 53Creating a maxdemo database during installation 58

    Post installation for Oracle WebLogic Serverdeployments . . . . . . . . . . . . . . 58Deploying ear files . . . . . . . . . . . . 60Setting the Oracle WebLogic Server host name. . . 61Language deployment after database updatedeferral . . . . . . . . . . . . . . . . 62

    Manually deploying languages after databaseupdate deferral . . . . . . . . . . . . 62

    Chapter 4. Deploying manually reusingexisting middleware . . . . . . . . . 63Maximo Asset Management installation withmanual middleware configuration . . . . . . . 65

    Manually configuring the database . . . . . 65Manually configuring DB2 9.x . . . . . . 65Manually configuring Oracle 11g . . . . . 67Manually configuring Oracle 10g . . . . . 70Manually configuring Microsoft SQL Server 72

    Manually configuring the directory server . . . 74Manually configuring IBM Tivoli DirectoryServer . . . . . . . . . . . . . . 75Manually configuring Microsoft ActiveDirectory . . . . . . . . . . . . . 79

    Manually configuring the J2EE server . . . . 82Manually configuring WebLogic Server . . . 82

    Installing the product and manually configuringmiddleware . . . . . . . . . . . . . . 86Creating a maxdemo database during installation . 91Post installation for Oracle WebLogic Serverdeployments . . . . . . . . . . . . . . 92Deploying ear files . . . . . . . . . . . . 93Setting the Oracle WebLogic Server host name. . . 95Language deployment after database updatedeferral . . . . . . . . . . . . . . . . 95

    Manually deploying languages after databaseupdate deferral . . . . . . . . . . . . 95

    Chapter 5. Silent installation . . . . . 97Installing Maximo Asset Management silently . . . 97

    Copyright IBM Corp. 2007, 2011 iii

  • Silent installation properties . . . . . . . . . 99

    Chapter 6. Programmatically verifyingthat the installation was successful . . 119

    Chapter 7. Verifying the installationmanually . . . . . . . . . . . . . 123

    Chapter 8. Post installation tasks . . . 125Accessing product documentation . . . . . . 125Initial data configuration . . . . . . . . . 125

    Signing in using a default user ID . . . . . 125Configuring SMTP . . . . . . . . . . 126Create currency codes . . . . . . . . . 126Create item and company sets . . . . . . . 127Create an organization . . . . . . . . . 127Create a general ledger account component . . 127Applying changes to the database . . . . . 128Create a general ledger account . . . . . . 128Update General Ledger Component TypeAuthorization . . . . . . . . . . . . 129Update Company-Related Accounts . . . . . 129Create default insert site. . . . . . . . . 130Create worktypes . . . . . . . . . . . 130Signing out and signing in . . . . . . . . 131

    Synchronizing users and groups . . . . . . . 131Create a maxdemo database after installation. . . 132Understanding and configuring security . . . . 133

    Chapter 9. Uninstalling the product 135Uninstalling an automatically configureddeployment . . . . . . . . . . . . . . 135

    Running the product uninstallation program forautomatically configured middleware . . . . 136

    Uninstalling a manually configured deployment 137Running the product uninstall program formanually configured middleware. . . . . . 137Database configuration recovery . . . . . . 138

    Restoring the DB2 database server . . . . 138Restoring the Oracle database . . . . . . 139Restoring the Microsoft SQL Server database 140

    Uninstalling the product without the uninstallationprogram . . . . . . . . . . . . . . . 141

    Uninstall program recovery tool . . . . . . 141Using the uninstallation program recoverytool. . . . . . . . . . . . . . . 142

    Manual uninstallation . . . . . . . . . 143Removing files from the system . . . . . 143

    Chapter 10. Starting and stoppingmiddleware . . . . . . . . . . . . 145Restarting middleware on Windows . . . . . . 145Restarting middleware on UNIX . . . . . . . 146

    Chapter 11. Advanced installationtopics. . . . . . . . . . . . . . . 147Configuring and managing Oracle WebLogicServer . . . . . . . . . . . . . . . . 147

    Starting Oracle WebLogic Server . . . . . . 147

    Stopping the Oracle WebLogic Server . . . . 147Changing the middleware installation programconfiguration parameters . . . . . . . . . 148Deploying EAR files . . . . . . . . . . . 148

    Building EAR files. . . . . . . . . . . 149Manually uninstalling applications from OracleWebLogic Server . . . . . . . . . . . 149

    Manually uninstalling applications fromOracle WebLogic Server . . . . . . . . 149

    Chapter 12. Middleware on Solarisand HP-UX . . . . . . . . . . . . 151Operating system preparation . . . . . . . . 151

    Middleware installation on Solaris . . . . . 151HP-UX . . . . . . . . . . . . . . 151

    Installing the components . . . . . . . . . 152Installing DB2 . . . . . . . . . . . . 152Installing IBM Tivoli Directory Server on Solaris 154

    Chapter 13. Backup and restoration 157Backing up the administrative workstation . . . 157Restoring the administrative workstation . . . . 158Installation properties . . . . . . . . . . 158

    Updating environment data . . . . . . . 168

    Chapter 14. Troubleshooting . . . . . 171Error when starting the middleware installationprogram . . . . . . . . . . . . . . . 171Troubleshooting the middleware installer . . . . 171

    Middleware installation programtroubleshooting feature . . . . . . . . . 171Segmentation fault . . . . . . . . . . 172Encountering error ACUINI0044E . . . . . 173Incorrect db2admin password . . . . . . . 173Password expiration for db2admin . . . . . 175Improper configuration of DB2 or IBM TivoliDirectory Server . . . . . . . . . . . 175Incorrect idsccmdb user password . . . . . 177Incorrect service pack requirement for AIX . . 179Failure when system directories cannot berenamed . . . . . . . . . . . . . . 179Invalid DB2 password value . . . . . . . 181Recovering from DB2 installation failure on AIX 182IBM Tivoli Directory Server starts inconfiguration mode . . . . . . . . . . 184Middleware setup script error codes. . . . . 184Troubleshooting middleware uninstall . . . . 185

    Troubleshooting the product installation program 185General troubleshooting of the produ