Chapter 8   The DSAME Installation Program for Windows 2000


The iPlanet Directory Server Access Management Edition (DSAME) installation program is used to install or uninstall the complete product all at once, or components of the product one at a time. You can use the DSAME installation program in a number of ways depending upon your deployment needs. This chapter provides an overview of the options presented in the Windows version of the installation program, as well as some pointers on determining the installation tasks you'll need to perform. Topics include:

• Before You Begin

• Installation Program Options

• Determining Which Installation Options to Use

• Starting DSAME Services

• Logging In to DSAME

• Uninstalling DSAME

Before You Begin

---

Be sure to resolve the following before you start the installation program:

• You must have Administrator privileges to run the installation program.

• You can only install DSAME, or any of the components, on a machine local to you. You can not install across a network on remote machines.

• Determine whether you will install DSAME in iPlanet-compliant Mode or in Default Mode. For more information, see "The iPlanet-compliant DIT".

• Determine whether or not you will be configuring an existing Directory Server. For more information, see "If You Already Have an Existing Directory" and "Unsupported DITs".

• Determine whether or not you will be installing DSAME policy agents. For more information, see "Policies and URL Policy Agents".

• Be sure that all browsers are closed before starting the installation program.

Installation Program Options

---

Each time you run the installation program, a number of installation options are displayed. Determine which installation option to choose by first identifying your scenario in Table 8-1, and then following the detailed the instructions that correspond to that scenario. The following is a brief summary of what happens when you choose each of the main installation options.

Option 1) iPlanet Directory Server

When you choose this option, iPlanet Directory Server is installed on the local computer system. This option, when selected by itself, is useful if you want to install a stand-alone Directory Server. For example, you might choose this option when you want to upgrade an existing Directory Server, or if you're setting up Directory Server replication. If you want to install DSAME for evaluation purposes, choose this option in addition to the following option, DSAME Management and Policy Services.

When you select this option in addition to the DSAME Management and Policy Services option, DSAME schema is automatically installed. When you select this option by itself, you can specify whether or not you want to install DSAME schema.

Option 2) DSAME Management and Policy Services.

When you choose this option, DSAME Management and Policy Services are installed on the local computer system. Section this option by itself when you want to install DSAME components to work with an existing Directory Server. When you want to install DSAME for evaluation purposes, select this option in addition to the iPlanet Directory Server option.

Option 3) Configure an Existing Directory Server for DSAME

When you choose this option, only the DSAME schema is installed with this option. No new Directory Server is installed; no existing data is overwritten. Choose this option only if you plan to DSAME with use an existing Directory Server 5.1 that's already provisioned with user data.

Exiting the Installation Program

After you've started the DSAME installation program, you can exit the program at any time by clicking Exit.

Determining Which Installation Options to Use

---

You will probably run the DSAME installation program multiple times in order to install Directory Servers, DSAME services and DSAME web agents in the proper number and sequence. Table 8-1 summarizes the common installation scenarios, and where to find the step-by-step instructions for each scenario.

Table 8-1    Where To Find DSAME Installation Instructions for Specific Scenarios. 

Common Installation Scenarios	Where to Find Detailed Installation Instructions
Install DSAME and for evaluation purposes.	"Simple Installations with No Existing Directory Server".
Install and deploy Directory Server and DSAME for the first time for production purposes; you have no existing user data to work with.	"Simple Installations with No Existing Directory Server".
Install DSAME to work with single directory that is already provisioned with user data.	"Using an Existing Directory Server".
Install multiple instances of DSAME against a single Directory Server for agent failover. DSAME and the master Directory Server are already installed; the directory may or may not be already provisioned with users.	"Installing Multiple DSAME Instances Against the Same Directory Server".
Install a stand-alone version of Directory Server with DSAME schema; to be used in multi-master replication.	"Installing a Stand-Alone iPlanet Directory Server".
Upgrade an existing directory by installing a stand-alone version of Directory Server 5.1, without the DSAME schema.	"Installing a Stand-Alone iPlanet Directory Server".
Configure an existing Directory Server 5.1 to be used with DSAME; the existing directory is already provisioned with user data.	"Step 2: Install DSAME Services".
Uninstall or re-install DSAME.	"Uninstalling DSAME".

Starting DSAME Services

---

You must start DSAME Services manually before you can login. You can start DSAME by using one of the following methods:

• Open a DOS prompt window and enter the following commands:

     cd DSAME_root\web-apps\services\WEB-INF\bin

    amserver start

• From the Start menu, select Programs > Administrative Tools > Services. In the Services window, right-click the icon for DSAME-hostname. From the menu, choose Start.

Logging In to DSAME

---

If, at the end of installation, you chose to start DSAME automatically, you can log in to DSAME through your browser. Go to the login URL using the form:

http://localhost.sub-domain.domain:services_port/URI_prefix/login

At installation, the default URI prefix is amserver.

In the Login page, enter the Super Administrator user id and password you specified during installation.

Uninstalling DSAME

---

The installation program in DSAME is also used to uninstall the DSAME application. You can the remove the entire product, or you can remove the following individual components of the product:

• Policy Service and Management Service

• iPlanet Directory Server

• DSAME Configuration only for Directory Server

To Uninstall DSAME Components

You must have Administrator privileges to run the DSAME Installation/Uninstallation program. Be sure all web browsers are closed before starting the program.

1. From the Start Menu, choose Settings > Control Panel.

2. In the Control Panel, double-click Add/Remove Programs.

3. In the Add/Remove Programs window, select iPlanet Server Products 5.1, and then click Change/Remove.
   
   

4. In the Select Type of Uninstall window, select one of the following options, and then click Next:

   Full. Select this option if you want to remove DSAME services and Directory Server installed on the local computer system.

   Partial. Select this option if you want to remove only either the DSAME Service or Directory Server installed on the local computer system.

5. In the Ready to Uninstall window, click Uninstall Now.

6. In the Summary Window, you can click Details to see more information about the uninstallation results. Click Exit to exit the program.