Using Express
Installation
Use
express installation if you are installing Directory Server to evaluate
or test the product. Because express installation does not offer you
the choice of selecting your server port number or your directory
suffix, you should not use it for production installations.
To perform an express installation, do the
following:
- On UNIX machines, log in as root (root login
is required for express installation). On Windows machines, log in with
administrator privileges.
- Create a new directory:
# mkdir ds
# cd ds
- If you have not already
done so, download the product binaries file to the installation
directory.
- On UNIX, unpack the
product binaries file
using the following command:
# gunzip -dc filename
.tar.gz | tar -xvof -
where
filename corresponds to the product binaries you want to unpack.
On a Windows system, unzip the product
binaries.
- Run the
setup program. You can find it in the directory in which you
untarred or unzipped the binary files. On a UNIX system, issue the
following command:
./setup
Select "yes" to continue with
installation, then select "yes" to agree to the license.
- When you are asked what
you would like to install, select the default, Netscape Servers.
- When you are asked
what type of
installation you would like to perform, select Express Installation.
- For server root or
destination directory,
enter a full path to the location where you want to install your server.
The location that you enter must be some
directory other than the directory from which you are running the setup
program. Also, the name of the directory where you install files must
not contain any space characters. If the directory that you specify
does not exist, the
setup program creates it for you.
- UNIX only. For the user and group
to run the servers as, enter the identity that you want this server to
run as. For more information on the user and groups that you should use
when running Netscape servers, see Deciding the User and Group for Your Netscape Servers
(UNIX only).
- For configuration
directory administrator
ID and password, enter the name and password that you will log in as
when you want to authenticate to the console with full privileges
(think of this as the root or superuser identity for the Netscape
Console).
The server is then unpackaged, minimally
configured, and started. You are told on what host and port number the
server is listening.
Note the following about your new Directory
Server installation:
- The Directory Server
is listening on port 389.
- The server is
configured to use the
following suffixes:
- dc=your_machine's_DNS_domain_name
If your machine is named test.example.com,
then you will have the suffix dc=example,dc=com configured
for this server.
- o=NetscapeRoot
Do not modify the contents of
the directory under the o=NetscapeRoot suffix.
Either create data under the first suffix or create a new suffix to be
used for this purpose. For details on how to create new suffixes for
your Directory Server, see the Netscape Directory
Server Administrator's Guide.
Using Typical
Installation
Most first time installations of Directory
Server can be performed using the Typical Installation option of the
setup program. Typical installation differs slightly depending
on whether you are installing on UNIX or Windows. The following
sections outline the different procedures.
Using Typical Installation on UNIX
To
perform a typical installation on UNIX:
- Log in as
root.
- Create a new directory:
# mkdir ds
# cd ds
- If you have not already
done so, download the product binaries file to the installation
directory.
- Unpack the product
binaries file using
the following command:
# gunzip -dc filename .tar.gz |
tar -xvof -
where
filename corresponds to the product binaries that you want to
unpack.
- Run the
setup program. You can find it in the directory where you
untarred binary files. Issue the following command from the
installation directory:
./setup
- The setup
program asks if you would like to proceed with the setup. Press Enter
to respond with the default (the default for this prompt is Yes) or
press n
if you would like to exit the setup
program.
If you want to log in as root or
superuser (su),
you will need to exit the setup
program.
- Next, the setup
program asks you if you agree to the license terms. Press y to agree
with the license terms.
- When you are asked
what you would like
to install, press Enter to select the default, Netscape Servers.
- When you are asked
what type of
installation you would like to perform, press Enter to select the
default, Typical Installation.
- For server root, enter
a full path to the
location where you want to install your server.
The location that you enter must be some
directory other than the directory from which you are running setup.
Also, the name of the directory where you install files must not
contain any space characters. If the directory that you specify does
not exist, setup
creates it for you.
By default, the setup
program provides the following path:
/usr/netscape/servers
If you want to install the
software into this directory tree, press Enter; otherwise, supply your
own path.
- For the Server Products
Core Components, Directory Suite, Administration Services, nsPerl, and
PerLDAP, press Enter to select the default (all components).
- Press Enter to select
all of the Server
Products Core Components.
- Press Enter to select
all the Directory
Suite components.
- Press Enter to select
all of the
Administration Services components (Netscape Administration Server and
the Administration Server Console).
- Press Enter to
install nsPerl.
- Press Enter to
install PerLDAP.
- For the hostname,
either enter a fully
qualified hostname or select the default (which is the local host).
|
|
Caution
|
The default
hostname may be incorrect if the
installer cannot locate a DNS name in your system. For example, you
might not have a DNS name if your system uses NIS.
The hostname
must be a fully qualified host
and domain name. If the default hostname is not a fully qualified host
and domain name, installation will fail. Refer to Common Installation Problems
for more information
about entering a fully qualified domain name.
|
|
- The setup
program then asks you for the System User and the System Group names.
Enter the identity under which you want the servers to run.
For more information on the user and
group names that you should use when running Netscape servers, see Deciding the User and Group for
Your Netscape Servers (UNIX only).
- For the configuration
directory, select the default if this directory will host your
o=NetscapeRoot tree. Otherwise, enter yes. You
will then be asked for the contact information for the configuration
directory.
If the server you are currently
installing is not the configuration directory, then the configuration
directory must exist before you can continue this installation.
- The setup
program then asks if the server you are currently installing will be
the one for your user data. For most cases, you can select the default.
However, if you intend this server instance to be used as a
configuration directory only, then you should enter yes.
- For the Directory
Server port, select the
default (389)
unless you already have another application using that port.
- For the Directory
Server Identifier,
enter a unique value (normally the default is sufficient).
This value is used as part of the name
of the directory in which the Directory Server instance is installed.
For example, if your machine's host name is phonebook,
then this name is the default, and selecting it will cause the
Directory Server instance to be installed into a directory labeled slapd-phonebook.
|
|
Caution
|
The Directory
Server identifier must not contain a period. For example, example.server.com
is not a valid server identifier name.
|
|
- For configuration
directory administrator ID and password, enter the name and password
that you will log in as when you want to authenticate to the console
with full privileges.
- For a directory
suffix, enter a
distinguished name (DN) meaningful to your enterprise.
This string is used to form the name of
all your organization's directory entries. Therefore, pick a name that
is representative of your organization. It is recommended that you pick
a suffix that corresponds to your internet DNS name. Avoid space
characters in the suffix.
For example, if your organization uses
the DNS name example.com,
then enter dc=example,dc=com
here.
- For Directory Manager
DN, enter the DN that you will use when managing the contents of your
directory with unlimited privileges.
|
|
Note
|
Any DN must be entered in the UTF-8
character set encoding. Older encodings such as ISO-8859-1 are not
supported.
|
|
In former releases of Directory Server,
the Directory Manager was known as the root DN. This is the entry that
you use to bind to the directory when you want access control to be
ignored. This DN can be short and does not have to conform to any
suffix configured for your directory. However, it should not correspond
to an actual entry stored in your directory.
- For the Directory
Manager password, enter a value that is at least 8 characters long.
- For Administration
Domain, enter the
domain to which you want this server to belong.
The name you enter should be a unique
string that is descriptive of the organization responsible for
administering the domain. For information on administration domains,
see Determining the
Administration Domain.
- For the administration port number, enter a value
that is not in use. Be sure to record this value.
- For the user you want
to run
Administration Server as, enter
root. This is the default.
For information on why you should run
Administration Server as root, see Deciding the User and Group for
Your Netscape Servers (UNIX only).
The server is then
unpackaged, minimally
configured, and started. You are told on what host and port number
Administration Server is listening.
The server is configured to use the following
suffixes:
- The suffix that you
configured.
- o=NetscapeRoot
Do not modify the contents of the directory
under the o=NetscapeRoot
suffix. Either create data under the first suffix or create a new
suffix to be used for this purpose. For details on how to create new
suffixes for your Directory Server, see the Netscape Directory
Server Administrator's Guide.
Using Typical
Installation on Windows
To perform a typical
installation on Windows:
- Log in as a user with administrator
privileges.
- If you have not already
done so, download the product binaries file to the installation
directory.
- Unzip the product
binaries files, and run
the setup
program.
- When you are asked
what you would like to
install, select the default, Netscape Servers.
- When you are asked
what type of
installation you would like to perform, select the default, Typical.
- For server
installation root, enter a
full path to the location where you want to install your server.
The location that you enter must be some
directory other than the directory from which you are running setup. If
the directory that you specify does not exist, the setup
program creates it for you.
- For configuration
directory, select the default if this directory will host your o=NetscapeRoot
tree. Otherwise, enter the appropriate contact information for the
configuration directory.
If this Directory Server instance is not
the configuration directory, then the configuration directory must
exist and be running before you can continue this installation.
- For the directory to
store data in, you must decide if this Directory Server instance will
store your enterprise's data. For most cases, you can select the
default, "Store data in this Directory Server." However, if this
Directory Server instance is intended to be a configuration directory
only, then you should select "Store data in an existing Directory
Server."
- For server identifier,
enter a unique
value (normally the default is sufficient).
This value is used as part of the name
of the directory in which the Directory Server instance is installed.
For example, if your machine's host name is phonebook, then
this name is the default and selecting it will cause the Directory
Server instance to be installed into a directory labeled
slapd-phonebook.
- For a directory suffix,
enter a distinguished name (DN) that is meaningful to your enterprise.
This string is used to form the name of
all your organization's directory entries. Therefore, pick some name
that is representative of your organization. It is recommended that you
pick a suffix that corresponds to your Internet DNS name. For example,
if your organization uses the DNS name example.com,
then enter dc=example,dc=com
here. Avoid space characters in the suffix.
- For the Directory Server
port, select the default (389) unless
you already have another application using that port.
- For Configuration
Directory Administrator
ID and password, enter the name and password that you will log in as
when you want to authenticate to the console with full privileges.
- For Administration
Domain, enter the
domain to which you want this server to belong.
The name that you enter should be a
unique string that is descriptive of the organization responsible for
administering the domain. For information on administration domains,
see Determining the
Administration Domain.
- For Directory Manager
DN, enter the DN that you will use when managing the contents of your
directory with unlimited privileges.
|
|
Note
|
Any DN must be entered in the UTF-8
character set encoding. Older encodings such as ISO-8859-1 are not
supported.
|
|
In former releases of Directory Server,
the Directory Manager was known as the root DN.
This is the entry that you bind to the directory as when you want
access control to be ignored. This DN can be short and does not have to
conform to any suffix configured for your directory. However, it should
not correspond to an actual entry stored in your directory.
- For Directory Manager
password, enter a value that is at least 8 characters long.
- For administration
port number, enter a
value that is not in use. Be sure to record this value.
