Chapter 3
The DSAME Installation Program for Solaris
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 installation program, as well as some pointers on determining the installation tasks you'll need to perform. Topics include:
Before You Begin
Be sure to resolve the following before you start the installation program:
You must have root 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 "Installing 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 3-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) DSAME Management and Policy Services
When you choose this option, if you don't already have an existing Directory Server, the following are automatically installed for you:
iPlanet Directory Server (optional)
iPlanet Web Server
DSAME Policy Service
DSAME Management Service
You are given the option to install a URL policy agent on the local host. When the installation program is done, the complete product is installed, and you can immediately log into DSAME. No user data will be present in the directory.
Option 2) DSAME Policy Agent
Policy agents intercept each request received by a Web Server and perform two functions: they validate a user's sign-on and enforce the user's URL policies. When you choose this option, a single agent is installed on the Web Server you specify.
You cannot use the installation program to install more than one Web Agent on the same machine. If multiple Web Servers are installed on the same machine, only one instance of Web Server may have a Web Agent. For more information, see "Installing Multiple Policy Agents on the Same Computer System".
Option 3) iPlanet Directory Server only
When you choose this option, only Directory Server 5.1 and DSAME schema installed. For detailed information on installing Directory Server 5.1 or upgrading to version 5.1, see the documentation that comes with iPlanet Directory Server 5.1 Installation Guide. Or you can access the documentation on the Internet at http://docs.iplanet.com/docs/manuals/directory.html.
Option 4) Configure an Existing Directory Server for DSAME
When you choose this option, you are prompted for the host and port number of your existing Directory Server. 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 use DSAME with an existing Directory Server 5.1 instance 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 pressing Ctrl-C.
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 3-1 summarizes the common installation scenarios, and where to find the step-by-step instructions for each scenario.
Starting DSAME Services
If you choose not to start DSAME automatically, you must start it manually before you can login. At the command line enter the following command:
# /etc/init.d/amserver 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, provide the Super Administrator user id and password you specified at 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:
To Uninstall DSAME Components
You must have root permissions to run the DSAME installation program. Be sure all web browsers are closed before starting the installation program.
Insert the DSAME product CD into the drive of the system on which DSAME components are installed.
In the DSAME directory, at the command line, enter aminstall.
-
The aminstall command accepts the -v [verbose] option. The verbose option gives brief progress messages as the actions of the install program take place.
Read the License Agreement. At the prompt, Do you agree to the license terms? enter y for Yes.
When the following message displays, enter 1.
|
Checking for DSAME 5.0 components ...done.
The following DSAME Components are installed:
DSAME Management and Policy Services
DSAME Agents
iPlanet Directory Server 5.1
iPlanet Directory Server Configuration for DSAME
One or more components that are part of DSAME 5.0
have been detected on this system.
If you are going to install components which already exist, you
must uninstall them first.
Otherwise, choose option 2 to continue the installation.
What would you like to do?
1) Remove existing components, then continue installation
2) Continue installation without removing existing components
3) Exit
|
|
The following message displays.
|
Please select one of the bundles to remove from ...
1) DSAME Management and Policy Services
2) DSAME Agents
3) iPlanet Directory Server 5.1
4) iPlanet Directory Server Configuration for DSAME
5) All
6) Continue with installation
7) Quit
|
|
If you want to remove nothing but the Policy and Management Services, then enter 1.
If you want to remove nothing but DSAME agent packages, enter 2. You'll be given the opportunity to specify which agent you want to remove.
If you want to remove nothing but the Directory Server 5.1 application, then enter 3.
If you want to remove nothing but the DSAME schema, then enter 4.
If you want to remove all bundles related to DSAME, then enter 5.
If you have changed your mind and do not want to uninstall any packages, but you want to install other DSAME components, then enter 6.
If you have changed your mind and do not want to uninstall any bundles, and you do not want to install additional bundles, then enter 7 to exit the installation program.