Identity Manager 7.1 Installation

Transcription

1 Sun Java System Identity Manager 7.1 Installation Sun Microsystems, Inc Network Circle Santa Clara, CA U.S.A. Part No:

2 Copyright 2007 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved. Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at and one or more additional patents or pending patent applications in the U.S. and in other countries. THIS PRODUCT CONTAINS CONFIDENTIAL INFORMATION AND TRADE SECRETS OF SUN MICROSYSTEMS, INC. USE, DISCLOSURE OR REPRODUCTION IS PROHIBITED WITHOUT THE PRIOR EXPRESS WRITTEN PERMISSION OF SUN MICROSYSTEMS, INC. U.S. Government Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements. Use is subject to license terms. This distribution may include materials developed by third parties. Sun, Sun Microsystems, the Sun logo, Java, Solaris and the Java Coffee Cup logo are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. UNIX is a registered trademark in the U.S. and other countries, exclusively licensed through X/Open Company, Ltd. This product is covered and controlled by U.S. Export Control laws and may be subject to the export or import laws in other countries. Nuclear, missile, chemical biological weapons or nuclear maritime end uses or end users, whether direct or indirect, are strictly prohibited. Export or reexport to countries subject to U.S. embargo or to entities identified on U.S. export exclusion lists, including, but not limited to, the denied persons and specially designated nationals lists is strictly prohibited. DOCUMENTATION IS PROVIDED AS IS AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID. Copyright 2007 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, Etats-Unis. Tous droits réservés. Sun Microsystems, Inc. détient les droits de propriété intellectuels relatifs à la technologie incorporée dans le produit qui est décrit dans ce document. En particulier, et ce sans limitation, ces droits de propriété intellectuelle peuvent inclure un ou plus des brevets américains listés à l'adresse et un ou les brevets supplémentaires ou les applications de brevet en attente aux Etats - Unis et dans les autres pays. CE PRODUIT CONTIENT DES INFORMATIONS CONFIDENTIELLES ET DES SECRETS COMMERCIAUX DE SUN MICROSYSTEMS, INC. SON UTILISATION, SA DIVULGATION ET SA REPRODUCTION SONT INTERDITES SANS LAUTORISATION EXPRESSE, ECRITE ET PREALABLE DE SUN MICROSYSTEMS, INC. L'utilisation est soumise aux termes de la Licence.Cette distribution peut comprendre des composants développés par des tierces parties. Sun, Sun Microsystems, le logo Sun, Java, Solaris et le logo Java Coffee Cup sont des marques de fabrique ou des marques déposées de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays.unix est une marque déposée aux Etats-Unis et dans d'autres pays et licenciée exlusivement par X/Open Company, Ltd. Ce produit est soumis à la législation américaine en matière de contrôle des exportations et peut être soumis à la règlementation en vigueur dans d'autres pays dans le domaine des exportations et importations. Les utilisations, ou utilisateurs finaux, pour des armes nucléaires,des missiles, des armes biologiques et chimiques ou du nucléaire maritime, directement ou indirectement, sont strictement interdites. Les exportations ou réexportations vers les pays sous embargo américain, ou vers des entités figurant sur les listes d'exclusion d'exportation américaines, y compris, mais de manière non exhaustive, la liste de personnes qui font objet d'un ordre de ne pas participer, d'une façon directe ou indirecte, aux exportations des produits ou des services qui sont régis par la législation américaine en matière de contrôle des exportations et la liste de ressortissants spécifiquement désignés, sont rigoureusement interdites. LA DOCUMENTATION EST FOURNIE "EN L'ETAT" ET TOUTES AUTRES CONDITIONS, DECLARATIONS ET GARANTIES EXPRESSES OU TACITES SONT FORMELLEMENT EXCLUES, DANS LA MESURE AUTORISEE PAR LA LOI APPLICABLE, Y COMPRIS NOTAMMENT TOUTE GARANTIE IMPLICITE RELATIVE A LA QUALITE MARCHANDE, A L'APTITUDE A UNE UTILISATION PARTICULIERE OU A L'ABSENCE DE CONTREFACON.

3 Contents Preface Typographic Conventions Symbols Chapter 1 Before You Install Supported Software and Environments Operating Systems Application Servers Browsers Repository Database Servers Sun Identity Manager Gateway Supported Resources Web Servers Memory Requirements Setup Task Flow Prerequisite Tasks Decide Where to Store Index Repository Files Using a Staging Directory Using a Web Application Directory Set Up a Java Virtual Machine and Java Compiler Set Up an Index Database About the Sample Database Scripts Setting Up MySQL Setting Up Oracle Setting Up DB Setting Up SQL Server Set Up a Service Provider Edition Transaction Database Globalization Configuration What's Next?

4 Chapter 2 Installing Identity Manager for Tomcat Before You Begin Tomcat 5 Requirements Installation Steps Step 1: Install the Tomcat Software Installing on Windows Installing on UNIX Step 2: Install the Identity Manager Software Getting More Information Step 3: Install the Sun Identity Manager Gateway Chapter 3 Installing Identity Manager for WebLogic Before You Begin Installation Procedures Step 1: Configure the WebLogic Software Step 2: Install the Identity Manager Software Getting More Information Step 3: Deploy the Application Step 4: Add the Application Main Page to Default Documents for IIS (optional) Step 5: Install the Sun Identity Manager Gateway Chapter 4 Installing Identity Manager for WebSphere Before You Begin Installation Steps Step 1: Install and Configure the Identity Manager Software Step 2. Install the Sun Identity Manager Gateway Chapter 5 Installing Identity Manager for iplanet Application Server Before You Begin Installation Steps Step 1: Install the Identity Manager Software Getting More Information Create and Deploy a.war File Step 2. Install the Sun Identity Manager Gateway Chapter 6 Installing Identity Manager for Sun ONE Application Server Before You Begin Installation Steps Step 1: Install the Sun ONE Application Server Software Step 2: Install the Identity Manager Software Getting More Information Step 3. Deploy Identity Manager into Sun ONE Application Server Identity Manager 7.1 Installation

5 Step 4. Install the Sun Identity Manager Gateway Step 5: Edit the server.policy File Chapter 7 Installing Identity Manager for Sun Java System Application Server Before You Begin Installation Steps Step 1: Install the Sun Java System Application Server Software Step 2: Install the Identity Manager Software Getting More Information Step 3. Deploy Identity Manager into Sun Java System Application Server Step 4. Install the Sun Identity Manager Gateway Step 5: Edit the server.policy File on Application Server Chapter 8 Installing Identity Manager for JBoss Before You Begin Installation Steps Step 1: Install the JBoss Software Step 2: Install the Identity Manager Software Step 3: Install the Sun Identity Manager Gateway Chapter 9 Install the Sun Identity Manager Gateway Prerequisites Installation Failure Messages What s Next? Chapter 10 Getting Started Enabling Language Support Deploying Identity Manager for Mac OS X Modify the lh.sh File Customize MultiSelect Components for the User Interface Use Safari Enhancer for the Administrator Interface Setting the lh Environment Help and More Information Chapter 11 Updating Identity Manager Prepare for Update Assess Your Current Identity Manager Installation inventory installed Contents 5

6 Chapter 12 Uninstalling Applications Remove the Software On Windows On UNIX Remove the Application Database Chapter 13 Installing Identity Manager Manually Installation Steps Step 1: Install the Application Server software Step 2: Install the Application Software On Windows ON UNIX Before You Continue Step 3: Configure the Identity Manager Index Database Connection Windows or Xwindows (UNIX) Environments Non-Xwindows Environments Step 4: Install the Sun Identity Manager Gateway Chapter 14 Installing Service Packs Downloading Service Packs Backing Up Installing Service Packs Appendix A Index Database Reference Appendix B Configuring MySQL Appendix C Configuring Data Sources for Identity Manager Configuring a WebSphere Data Source for Identity Manager Servlet 2.3 Data Sources Configuring a JDBC Provider Configuring a WebSphere JDBC Data Source Configure the 5.1 Authentication Data Configure the Data Source Configure the DataSource in a Websphere Cluster Point the Identity Manager Repository to the Data Source Specifying Additional JNDI Properties to the setrepo Command Configuring a WebLogic Data Source for Identity Manager Create a WebLogic Data Source Create a Connection Pool Create a JDBC Data Source Point the Identity Manager Repository to the Data Source Identity Manager 7.1 Installation

7 Configurating a Sun Java System Application Server Data Source for Identity Manager Appendix D Changing the Database Repository Password When Identity Manager Stores the Password When the DataSource Stores the Password Appendix E Configuring JCE What is JCE? When to Implement JCE? Configuring the Application to Work with JCE When the JDK Includes an Implementation of JCE 1.2.x Appendix F setrepo Reference Usage location_flags Options Syntax Examples Appendix G DBMS Recovery and the Repository Recovering the Repository redo Logs Index Contents 7

8 8 Identity Manager 7.1 Installation

9 Preface This Sun Java System Identity Manager Installation publication provides detailed information and instructions to help you install and update Sun Java Systems Identity Manager and associated software. Who Should Use This Book Sun Java System Identity Manager Installation was designed for those who will install Identity Manager and perform initial deployment tasks. Deployers should have a background in application servers, databases, and network connectivity. How This Book Is Organized Identity Manager Installation is organized into these chapters: Chapter 1, Before You Install Details system requirements and tasks you should perform before installing the Identity Manager software. The contents of Chapter 2 through Chapter 8 provide detailed procedures for installing Identity Manager and associated software for use with these application servers: m m m m Chapter 2 Tomcat Chapter 3 WebLogic Chapter 4 WebSphere Chapter 5 iplanet Application Server 9

10 m m m Chapter 6 Sun ONE Application Server Chapter 7 Sun Java System Application Server Chapter 8 JBoss Chapter 9, Install the Sun Identity Manager Gateway Provides procedures for installing the Sun Identity Manager Gateway. Chapter 10, Getting Started Describes how to begin using Identity Manager and where to go for help and information. Chapter 11, Updating Identity Manager Provides procedures for preparing to update an installed version of the Identity Manager product For full upgrade information see Identity Manager Upgrade.. Chapter 12, Uninstalling Applications Lists steps for removing an installed version of the product. Chapter 13, Installing Identity Manager Manually Details alternate, manual procedures for installing Identity Manager. Chapter 14, Installing Service Packs Provides instructions for downloading and installing service packs. Appendix A, Index Database Reference Shows selection options for index database setup during Identity Manager installation. Appendix B, Configuring MySQL Describes how to set up and configure a MySQL database for use as the Identity Manager default data store. Appendix C, Configuring Data Sources for Identity Manager Describes how to update the repository configuration in Identity Manager to point to a WebSphere or WebLogic data source. Appendix D, Changing the Database Repository Password Appendix D. Changing Your Database Repository Password Procedures for changing the repository password for your index database. Appendix E, Configuring JCE Details steps to configure the Java Cryptography Extension (JCE) to work with Identity Manager. Appendix F, setrepo Reference Reference page for the setrepo command. Appendix G, DBMS Recovery and the Repository Details steps to recovering the repository from a failure. 10 Identity Manager 7.1 Installation

11 Conventions Used in This Book The tables in this section describe the conventions used in this book. Typographic Conventions The following table describes the typographic changes used in this book. Table 1 Typographic Conventions Typeface Meaning Examples AaBbCc123 (Monospace) AaBbCc123 (Monospace bold) API and language elements, HTML tags, web site URLs, command names, file names, directory path names, onscreen computer output, sample code. What you type, when contrasted with onscreen computer output. Edit your.login file. Use ls -a to list all files. % You have mail. % su Password: AaBbCc123 (Italic) Book titles, new terms, words to be emphasized. A placeholder in a command or path name to be replaced with a real name or value. Read Chapter 6 in the User s Guide. These are called class options. Do not save the file. The file is located in the install-dir/bin directory. Symbols The following table describes the symbol conventions used in this book. Table 2 Symbol Conventions Symbol Description Example Meaning [ ] Contains optional command options. ls [-l] The -l option is not required. { } Contains a set of choices for a required command option. -d {y n} The -d option requires that you use either the y argument or the n argument. 11

12 Table 2 Symbol Conventions<E Emphasis>(Continued) Symbol Description Example Meaning - Joins simultaneous multiple keystrokes. Control-A Press the Control key while you press the A key. + Joins consecutive multiple keystrokes. > Indicates menu item selection in a graphical user interface. Ctrl+A+N File > New > Templates Press the Control key, release it, and then press the subsequent keys. From the File menu, choose New. From the New submenu, choose Templates. Related Documentation and Help Sun provides additional printed and online documentation and information to help you install, use, and configure Identity Manager: Identity Manager Upgrade: Step-by-step instructions and reference information to help you upgrade and configure Identity Manager and associated software. Identity Manager Administration: Procedures, tutorials, and examples that describe how to use Identity Manager to provide secure user access to your enterprise information systems. Identity Manager Technical Deployment Overview: Conceptual overview of the Identity Manager product (including object architectures) with an introduction to basic product components. Identity Manager Workflows, Forms, and Views: Reference and procedural information that describe how to use the Identity Manager workflows, forms, and views including information about the tools you need to customize these objects. Identity Manager Resources Reference: Reference and procedural information that describe how to load and synchronize account information from a resource into Sun Java System Identity Manager. Identity Manager Deployment Tools: Reference and procedural information that describe how to use different Identity Manager deployment tools including rules and rules libraries, common tasks and processes, dictionary support, and the SOAP-based Web service interface provided by the Identity Manager server. 12 Identity Manager 7.1 Installation

13 Identity Manager Tuning, Troubleshooting, and Error Messages: Reference and procedural information that describe Identity Manager error messages and exceptions, and provide instructions for tracing and troubleshooting problems you might encounter as you work. Identity Manager Service Provider Edition Deployment: Reference and procedural information that describes how to plan and implement Sun Java System Identity Manager Service Provider Edition. Identity Manager Help Online guidance and information that offers complete procedural, reference, and terminology information about Identity Manager. You can access help by clicking the Help link from the Identity Manager menu bar. Guidance (field-specific information) is available on key fields. Accessing Sun Resources Online For product downloads, professional services, patches and support, and additional developer information, go to the following: Download Center Professional Services Sun Enterprise Services, Solaris Patches, and Support Developer Information Contacting Sun Technical Support If you have technical questions about this product that are not answered in the product documentation, contact customer support using one of the following mechanisms: The online support web site at The telephone dispatch number associated with your maintenance contract 13

14 Related Third-Party Web Site References Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources. Sun Welcomes Your Comments Sun is interested in improving its documentation and welcomes your comments and suggestions. To share your comments, go to and click Send Comments. In the online form, provide the document title and part number. The part number is a seven-digit or nine-digit number that can be found on the title page of the book or at the top of the document. For example, the title of this book is Sun Java System Identity Manager Resource Reference, and the part number is Identity Manager 7.1 Installation

15 Chapter 1 Before You Install Use the information and procedures in the following sections to prepare for installation of Identity Manager: Supported Software and Environments Memory Requirements Setup Task Flow Prerequisite Tasks Supported Software and Environments This section lists software and environments that are compatible with the software: Operating Systems Application Servers Browsers Database Servers Java Runtime Environment Sun Identity Manager Gateway Supported Resources Web Servers 15

16 Supported Software and Environments Because software product developers frequently ship new versions, updates, and fixes to their software, the information published here changes often. Review the release notes for updates before proceeding with installation. Operating Systems AIX 4.3.3, 5.2, 5L v5.3 HP-UX 11i v1, 11i v2 Microsoft Windows 2000 SP3 or above Microsoft Windows 2003 Solaris 8, 9, 10 Sparc and x86d Red Hat Linux Advanced Server 2.1 Red Hat Linux Enterprise Server 3.0, 4.0 Novell SuSE Linux Enterprise Server 9 SP1 Application Servers The application server you use with these applications must be Servlet 2.3-compliant and installed with the included Java platform (unless noted as follows): Apache Tomcat Version 4.1.x (with JDK 1.4.2) Version 5.0.x (with JDK 1.4.2) Version 5.5 (with JDK 1.5) BEA WebLogic Express 8.1 (with JDK 1.4.2) BEA WebLogic Server 8.1 (with JDK 1.4.2) BEA WebLogic Server 9.1 and 9.2 (with JDK 1.5) IBM WebSphere 6.0, 6.1 IBM WebSphere Application Server - Express Version (with JDK 1.4.2) 16 Identity Manager 7.1 Installation

17 Supported Software and Environments JBoss Application Server Sun ONE Application Server 7 Sun Java System Application Server Platform Edition 8, 8.2 Sun Java System Application Server Platform Edition and Enterprise Edition 8.1 Sun Java System Application Server Platform Edition 9 If your current application server does not support JDK or 1.5, please check with your vendor to examine the implications of upgrading to one that does before installing Identity Manager. Your current application server container must support UTF-8. Browsers Microsoft Internet Explorer 5.x and later Safari 2.0 and later for Mac OS X and later Mozilla 1.78 with JRE 1.5 Firefox 1.04,1.05,1.06 with JRE 1.5 Repository Database Servers IBM DB2 Universal Database for Linux, UNIX, and Windows (Version 7.x, 8.1, 8.2) Microsoft SQL Server 2000, 2005 MySQL 4.1, 5.0 Oracle 9i and Oracle Database 10g, 10gR1 and 10gR2 You must configure your database with a character set that will support the characters that you want to store. If you need to store multi-byte characters, you should use a character set (such as UTF-8) that supports Unicode. Chapter 1 Before You Install 17

18 Supported Software and Environments See DBMS Recovery and the Repository on page 145 for DBMS recovery information. Sun Identity Manager Gateway See Install the Sun Identity Manager Gateway on page 85, for further information on the Sun Identity Manager Gateway. Supported Resources See the Identity Manager Resources Reference for a list of all supported resource adapters. Web Servers Integration between an application server and Web server is not required. You may choose to use a Web server for better load balancing and for increased security (through the https protocol). Apache iplanet 4.1 Microsoft Internet Information Server (IIS) 4.0, 5.0 Sun ONE Web Server 6 When using Web Server 6 add the Java mail.jar and activation.jar files to the WEB-INF/lib directory. The mail and activation jar files can be found at: Identity Manager 7.1 Installation

19 Memory Requirements Memory Requirements You should determine your memory needs and set values in your application server's JVM. Do this by adding maximum and minimum heap size to the Java command line; for example: java -Xmx512M -Xms512M For best performance, set these values to the same size. Depending on your specific implementation, you may need to increase these recommended values if you run reconciliation. For performance tuning purposes, you may also set the following in the waveset.property file: max.post.memory.size value The max.post.memory.size specifies the maximum number of bytes that a posted file (for example., via an HTML FileSelect control) may contain without being spooled to the disk. For cases where you do not have permission to write to temp files, you should increase the max.post.memory.size to avoid having to spool to the disk. The default value is 8 Kbytes. For additional system requirements and information, refer to the Identity Manager release notes. Setup Task Flow Depending on your choice of application server and database, the steps you will follow for setup differ. In general, you will: Perform prerequisite tasks, such as installing a Java compiler and JVM, and setting up an index database Install and configure an application server Install and configure the Identity Manager software Chapter 1 Before You Install 19

20 Prerequisite Tasks The installer now supports upgrading installations that have renamed/deleted/disabled the default Configurator account. The installer now prompts for the proper username and password that can import the update.xml during the upgrade post process. If the incorrect user or password is entered the user is prompted up to three times. The error should be displayed in the text box behind it. For manual installation you must provide the -U <username> -P <password> in order to pass the credentials to UpgradePostProcess. On UNIX or Linux systems: When installing versions SP1, /var/tmp must exist and be writable by the user running the installer. When installing versions 5.0 SP2 and higher, /var/opt/sun/install must exist and be writable by the user running the installer. When using application servers with staging directories, keep the staging directory that was used for Identity Manager installation after deploying the product. Optionally set up the Sun Identity Manager Gateway Optionally set up PasswordSync For some application server types and preferences, these general steps are combined, performed in a different order, or eliminated entirely. Prerequisite Tasks Before installing the Identity Manager software, you need to: Decide Where to Store Index Repository Files Set Up a Java Virtual Machine and Java Compiler Set Up an Index Database What's Next? 20 Identity Manager 7.1 Installation

21 Prerequisite Tasks Decide Where to Store Index Repository Files You must create the directory where you will store application files before launching the installation program. You can store application files in a staging folder, or you can install into your application server's Web application directory. Using a Staging Directory Because the applications are based on J2EE Web, you can store them in a staging folder. This staging folder is used to deploy the application into your specific application server. Typically, a Web Application Archive (.war) file is created for use in the deployment steps. Using a Web Application Directory You may choose to install directly into an application server's Web application directory. In this case, you will specify the Web application directory during installation. The installation program will place the Identity Manager files in folder named idm in that location by default. When using a localfiles index repository in a WebSphere application server environment, set the localfiles repository to a location outside of the Identity Manager directory. For an Oracle RAC environment as Identity Manager repository, connecting with thin driver, use the following format as url parameter in lh setup: jdbc:oracle:thin:@(description=(load_balance=on) (ADDRESS=(PROTOCOL=TCP)(HOST=host01)(PORT=1521))( ADDRESS=(PROTOCOL=TCP)(HOST=host02)(PORT=1521)) (ADDRESS=(PROTOCOL=TCP)(HOST=host03)(PORT=1521)) (CONNECT_DATA=(SERVICE_NAME=PROD))) Set Up a Java Virtual Machine and Java Compiler The application requires a Java compiler and a Java Virtual Machine (JVM) to run the Java classes that perform actions within Identity Manager. Both of these can be found in a Java SDK. (The JRE packages do not include a Java compiler.) Chapter 1 Before You Install 21

22 Prerequisite Tasks Many application servers include a JDK bundled with their installation. The JDK version that is shipped with the application server is always preferred to any other JDK installed on your server. You should add JAVA_HOME to your list of system environment variables and to your system path. To do this, add JAVA_HOME to your system environment and JAVA_HOME\bin to your path, making sure to list it before any other Java variables. While adding JAVA_HOME to your list of system environment variables is helpful for Identity Manager, it may affect other applications. Set Up an Index Database You should use a third-party relational database to store the system index data. If you plan to do this, use the general procedures in this section as guidelines when setting up the index database. Your database administrator may choose to customize the provided scripts to suit your site-specific configuration and standards. CAUTION If you store the Index data in a local file system, you should select a location outside of the application or Web server directory structure. The dynamic directories created for the index data cannot be protected from intruders who might use a Web browser to scan directories serviced by the Web server. You must configure your database with a character set that will support the characters that you want to store. If you need to store multi-byte characters, you should use a character set (such as UTF-8) that supports Unicode. About the Sample Database Scripts Identity Manager provides sample database scripts that you can modify and use to create tables and indexes. You may choose to use an alternate method to create equivalent tables and indexes, but must meet these requirements: Tables (or views) must exist with the names specified in the sample DDL. 22 Identity Manager 7.1 Installation

23 Prerequisite Tasks Each named table (or view) must be owned by (or aliased to) the proxy user that is represented as waveset in the sample DDL. Each named table (or view) must contain all the columns specified for that table in the sample DDL. Each named column must have a data type that is consistent with the data type specified for that column in the sample DDL. You can modify the sample scripts to suit your environment. Common changes include: Specifying a different proxy user Specifying different tablespaces, or separate tablespaces for tables and indexes Changing a data type. This is acceptable if a view or the JDBC driver makes the change transparent. Adding columns. This is acceptable if each column is nullable or defaulted. Removing or renaming columns. This is acceptable if a view makes this transparent. Renaming indexes If you make changes to the sample scripts, then you must make equivalent changes to any sample database upgrade scripts that you receive in the future. If you choose to set up Index data in regular files in a file system, skip to the chapter detailing Identity Manager installation. Otherwise, go to one of the sections in this chapter to set up: MySQL Oracle DB2 SQL Server Setting Up MySQL Follow these steps to set up MySQL for use with Identity Manager. Chapter 1 Before You Install 23

24 Prerequisite Tasks For additional information about setting up and configuring MySQL, refer to Configuring MySQL on page 115. See Supported Software and Environments on page 15 for supported database server versions, and for download or product locations. 1. Install the MySQL software. Start the MySQL process (if it does not start automatically). 2. Create the database. To do this: a. Copy the create_waveset_tables.mysql script from the db_scripts directory on the installation CD (or from the idm\sample directory if you have already installed) to a temporary location. b. Modify the create_waveset_tables.mysql script to change the database user password. c. Create the new tables by using one of the following commands: On Windows c:\mysql\bin\mysql -u root < create_waveset_tables.mysql On UNIX $MYSQL/bin/mysql -u root < create_waveset_tables.mysql Setting Up Oracle Follow these steps to set up Oracle for use with Identity Manager. See Supported Software and Environments on page 15 for supported database server versions, and for download or product locations. 1. Install Oracle or confirm the connection to an Oracle database. 2. Connect to the Oracle instance as a user with privileges to create users and tables. 3. Create the database. To do this: 24 Identity Manager 7.1 Installation

25 Prerequisite Tasks a. Copy the create_waveset_tables.oracle script from the db_scripts directory on the installation CD (or from the idm\sample directory if you have already installed) to a temporary location. b. Modify the create_waveset_tables.oracle script: Change the user password. Change the path for DATAFILE to point to the location for your waveset.dbf data file. Your database administrator may want to modify the script to meet site-specific requirements for backup, replications, disk allocation, distribution, or other considerations. c. Create the new tables by using the following command: On Windows sqlplus On UNIX sqlplus Setting Up DB2 Before setting up DB2, you should decide how DB2 will provide JDBC access. JDBC Access Considerations DB2 offers two types of JDBC access, each of which requires a different URL format. The setup process allows you to select a preferred driver and automatically displays the corresponding URL template. The application driver (COM.ibm.db2.jdbc.app.DB2Driver) requires local client software and a local database instance. Since DB2 runs on a separate (often dedicated) host in most production environments, the local database instance usually contains an alias to the remote database instance. In this configuration, the local database instance uses a DB2-specific protocol to communicate with the remote database instance. Chapter 1 Before You Install 25

26 Prerequisite Tasks The Type 2 network driver (COM.ibm.db2.jdbc.net.DB2Driver) does not require local client software or a local database. It does require that the DB2 Java Daemon (db2jd) be running on the target server. (In most production environments, the target server is a separate host, but the network driver works as well with a local database instance.) This daemon is not started by default, but the database administrator can start it manually or configure it to start automatically when the database instance starts. The Type 4 network driver (COM.ibm.db2.jcc.DB2Driver) connects directly to the DB2 database. When using the type 4 driver (in a direct connection) with DB and above, download the following driver: com.ibm.db2.jcc.db2driver The following files that need to be in the $WSHOME/WEB-INF/lib directory: db2jcc db2jcc_license_cisuz.jar or db2jcc_license_cu.jar DB2 Setup Follow these steps to set up DB2. See Supported Software and Environments on page 15 for supported database server versions, and for download or product locations. 26 Identity Manager 7.1 Installation

27 Prerequisite Tasks 1. Install DB2 or confirm the connection to a DB2 database. 2. Connect to the DB2 instance as a user with privileges to create users and tables. 3. Create the database. To do this: a. Copy the create_waveset_tables.db2 script from the db_scripts directory on the installation CD (or from the idm\sample directory if you have already installed) to a temporary location. b. Modify the create_waveset_tables.db2 script: Change the user password. Change the path for the CREATE_TABLESPACE command to a location appropriate for your environment. Your database administrator may want to modify the script to meet site-specific requirements for backup, replications, disk allocation, distribution, or other considerations. Create the new tables by using the following command: On Windows db2 -tvf create_waveset_tables.db2 On UNIX db2 -tvf create_waveset_tables.db2 Setting Up SQL Server Follow these steps to set up SQL Server. See Supported Software and Environments on page 15 for supported database server versions, and for download or product locations. 1. Install Microsoft SQL Server or confirm the connection to a SQL Server installation. 2. Create the database. To do this: Chapter 1 Before You Install 27

28 Prerequisite Tasks a. Copy the create_waveset_tables.sqlserver script from the db_scripts directory on the installation CD (or from the idm\sample directory if you have already installed) to a temporary location. b. Modify the create_waveset_tables.sqlserver script to change the login password. Your database administrator may want to modify the script to meet site-specific requirements for backup, replications, disk allocation, distribution, or other considerations. c. Create the new tables by executing the create_waveset_tables.sqlserver script, located on the installation CD; for example: osql -E -i PathToFile\create_waveset_tables.sqlserver You must have privileges to create databases and logins. 3. Download and install the Microsoft SQL Server 2005 Driver for JDBC. To do this: a. Go to b. In the Search for a Download area, enter SQL Server JDBC in the keywords field, and then click Go. c. Locate, download, and install the correct version of the driver for your installation. During installation, you will pause to install this driver and the Microsoft.jar files (installed with the driver) before continuing setup. Refer to the installation procedures in the following chapters for instructions. 28 Identity Manager 7.1 Installation

29 Prerequisite Tasks Set Up a Service Provider Edition Transaction Database If you are installing Identity Manager Service Provider Edition, then you must set up a database in which to store transaction data. If you plan to do this, use one of the following sample scripts as a starting point for creating your transaction database: create_spe_tables.oracle create_spe_tables.db2 Use the procedures outlined in Set Up an Index Database on page 22 to guide you through the process of creating a transaction database. You must configure your database with a character set that supports the characters that you want to store. If you need to store multi-byte characters, you should use a character set (such as UTF-8) that supports Unicode. Globalization Configuration Inconsistent encodings may introduce certain globalization issues, such as incorrect handlings of multibyte characters. Make sure the locale or encoding is consistent with the following software in Identity Manager (IDM) deployment environment: Application server instance Database Java Virtual Machine (JVM) In globalized environments, UTF-8 should be implemented on all products. Refer to the documentation for these products for information about setting the locale/encoding. Also, when loading or unloading data via CSV or XML files, ensure that their encodings are consistent with Identity Manager s deployment environment encoding to retain data integrity. For enabling localization support see Enabling Language Support on page 90. Chapter 1 Before You Install 29

30 Prerequisite Tasks What's Next? Use the procedures outlined in one of the following chapters to install and set up Identity Manager for your application server type: Installing Identity Manager for Tomcat on page 31 Installing Identity Manager for WebLogic on page 37 Installing Identity Manager for WebSphere on page 45 Installing Identity Manager for iplanet Application Server 6.5 on page 53 Installing Identity Manager for Sun ONE Application Server 7 on page 59 Installing Identity Manager for Sun Java System Application Server on page 69. Before you begin installing Identity Manager, note that by default, the waveset.serverid Java system property is the name of the machine the application server is installed on. If you need to set this property to another value (for example, the application server machine contains multiple application server installations), add the following command to the startup script for your application server. -Dwaveset.serverId=Name 30 Identity Manager 7.1 Installation

31 Chapter 2 Installing Identity Manager for Tomcat Use the following information and procedures to install Identity Manager for use with the Apache Tomcat application server, Versions 4.1.x 5.0.x, or 5.5. This chapter contains: Before You Begin Installation Steps Before You Begin During installation, you will need to know: The location where Tomcat is installed The login and password you selected when you set up the index database Tomcat 5 Requirements Identity Manager with Tomcat requires the Java x or 1.5 JDK. Installation Steps Follow these installation and configuration steps: Step 1: Install the Tomcat Software Step 2: Install the Identity Manager Software Step 3: Install the Sun Identity Manager Gateway 31

32 Installation Steps Step 1: Install the Tomcat Software Steps in this chapter that outline Tomcat installation are for general reference only. For detailed information about installing Tomcat, refer to the Web page or reference information provided by the application server software provider. Install the Tomcat software according to the instructions provided by the application server provider. You may find helpful information at the Jakarta Project site, at Installing on Windows If you are installing from the Tomcat installer: 1. Specify the Tomcat installation location. 2. Select to start Tomcat as a service, and then select the port to run on. The default port is Installing on UNIX 1. After downloading and unpacking the Tomcat installation bundle, modify the Tomcat startup script by using this procedure: In the setclasspath.sh file in the $TOMCAT_HOME/bin directory, add these lines to the top of the file: JAVA_HOME=Location of a JDK BASEDIR=Location of your unpacked Tomcat export JAVA_HOME BASEDIR 2. When configuring Tomcat to support UTF-8, add the URIEncoding="UTF-8" attribute to the connector element in the TOMCAT DIRconf/server.xml file, for example: <!-- Define a non-ssl Coyote HTTP/1.1 Connector on the port specified during installation --> <Connector port="8080" maxthreads="150" minsparethreads="25" maxsparethreads="75" 32 Identity Manager 7.1 Installation