Chapter 5. Setting up Red Hat Directory Server on Sun Solaris

Install the required version of the Java® Runtime Environment (JRE).
Install the Directory Server packages.
Run the setup program. The setup step is where all of the information about the new Directory Server instance is supplied.

WARNING

If Directory Server is already installed on your machine, it is extremely important that you perform a migration, not a fresh installation. Migration is described in Chapter 8, Migrating from Previous Versions.

There are three interactive ways of setting up Directory Server: express, typical, and custom. These setup types provide different levels of control over the configuration settings, such as port numbers, directory suffixes, and users and groups for the Directory Server processes. Express has the least amount of input, meaning it uses more default or randomly-generated settings, while custom allows the most control over the configuration by having the user supply a lot of configuration information. These setup types are described more in Table 1.2, “Comparison of Setup Types”. For most deployments, the typical installation type is all that is required.

NOTE

There is a fourth setup option called a silent installation. This uses a file with predefined settings to create a new Directory Server without any user interaction. This is extremely useful for doing large numbers of Directory Server instances, since it does not require any user involvement after the packages are installed. Silent installations are explained more in Section 6.3.1, “Silent Setup for Directory Server and Administration Server”.

This chapter describes the complete process to install Red Hat Directory Server on Solaris, including both the JRE and Directory Server packages, and the different setup options.

5.1. Installing the JRE

Necessary Java JRE libraries are not bundled with Directory Server. They must be downloaded and extracted separately before installing the Directory Server packages.

NOTE

Directory Server 8.0 requires JRE version 1.5.0.

Install the latest version of the 64-bit Sun J2SE Java Runtime Environment 5.0 (Update 9), available from the Sun download site, http://java.sun.com/javase/downloads/index.jsp.

IMPORTANT

Solaris requires installing the 32-bit version of the JRE as well as installing the 64-bit version. The 32-bit version is used for the applet and Java Web Start support. Read http://java.sun.com/j2se/1.5.0/README.html, http://java.sun.com/j2se/1.5.0/ReleaseNotes.html, and http://java.sun.com/j2se/1.5.0/jre/install-solaris-64.html before installing the Directory Server.

Under the section Java Runtime Environment (JRE) 5.0 Update 9, Sun only makes this JRE available through a self-extracting file which is incompatible with Directory Server since this format does not use the native Solaris packaging utility database.
It is possible to obtain the Sun 5.0 JRE in a compatible format. Click Download under the JDK 5.0 Update 9 section, and, under Solaris SPARC Platform - J2SETM Development Kit 5.0 Update 9, select Solaris SPARC 32-bit packages - tar.Z (jdk-1_5_0_09-solaris-sparc.tar.Z) and Solaris SPARC 64-bit packages - tar.Z (use 32-bit version for applet and Java Web Start support) (jdk-1_5_0_09-solaris-sparcv9.tar.Z).
After downloading these two files, uncompress them using the gunzip utility, and extract the contents using the tar utility.
The contents of the 32-bit file, jdk-1_5_0_09-solaris-sparc.tar.Z, are COPYRIGHT, LICENSE, README.html, SUNWj5cfg, SUNWj5dev, SUNWj5dmo, SUNWj5jmp, SUNWj5man, and SUNWj5rt.
The contents of the 64-bit file, jdk-1_5_0_09-solaris-sparcv9.tar.Z, are SUNWj5dmx, SUNWj5dvx, and SUNWj5rtx.
Since only the JRE is needed on Solaris 9 systems, use the pkgadd utility to add the 32-bit package, SUNWj5rt, first, and then add the 64-bit package, SUNWj5rtx.

After installing the JRE, install the Directory Server packages, as described in Section 5.2, “Installing the Directory Server Packages”.