Shut down the Directory Server that you will be configuring.
Backup (or export) your data. (This step is optional, but recommended.)
Log in as root or setuid to root (Unix) or as administrators (Windows NT) on the machine hosting your Directory Server.
Note: You must have superuser (or full administrative) privileges to run the
dssetup command.
Go to the directory where you where you unpacked the dssetup archive file as described in Transferring the Messaging Server Installation Files starting on page 21.
Run the dssetup command. For example:
./dssetup
Note: The dssetup program is not supported on some platforms (such as
HP 10.10 and HP 10.20). In such cases, run instead the script version of
dssetup called msg4ldif that is included as part of the installation
package.
Enter the required information at the prompts.
Enter the information as prompted by the utility. Default values are shown
enclosed in square brackets. You can accept a default value by pressing
Enter, or you can type in an alternative value and then press Enter. To
change a "Yes" or "No" prompt, simply type in "y" or "n" and then press
Enter. Be sure to write down the values that you specify.
Do you wish to continue [yes]
Enter yes (or simply y to continue).
Directory server root [/usr/netscape/suitespot]
This is the directory where the Directory Server is installed. If you installed
a new Directory Server 3.x as described in Installing a 3.x Directory Server,
enter the same directory name you entered in response to the Server root
prompt. This directory is the value referred to as the server-root
throughout this document.
Messaging Server schema in the directory server appears
to be up to date. Do you wish to update the schema
anyway [y]?
This prompt appears only if dssetup has already been run once on this
server. If you answer yes, the previous schema files are overwritten with
new files.
Do you wish to configure this directory for Server
Config [y]?
Configuration information for Netscape servers is stored on a Directory
Server under an Administration domain, in the base suffix
o=NetscapeRoot. Answer "yes" only if you are running dssetup on
the Directory Server instance which stores the data in o=NetscapeRoot. If
this is the first time you have run dssetup on this Directory Server, or if
you want to set up additional Configuration Administrators or
administration domains, answer yes for this Directory Server instance to be
prepared for server configuration tasks.
Do you wish to use this directory for managing Users/
Groups [y]?
Answer yes to prepare this Directory Server instance for managing users
and groups. This Users and Groups base DN will be created if it does not
already exist, and the Users and Groups Administrator account will be set
up with the following configurations:
Please enter the Directory Administrator's DN
[cn=Directory Manager]
Please enter the Directory Administrator's Password
This question is asked if you chose to prepare this server as the
Configuration Server or the Users and Groups administration server (or
both). This account is the Directory Manager. If you installed a new
Directory Server, this is the user ID or DN you entered in response to the
Unrestricted User prompt during the installation procedure. The default is
cn=Directory Manager. See Directory Manager for additional
information.
Please enter the Configuration Administrator's uid
[admin]
Please enter the Configuration Administrator's Password
Enter the Configuration Administrator's Password again
to verify
The default is admin. See Configuration Server Administrator for additional
information.
Please enter the Administration Domain under which
Server Configuration will be stored [default]
This question is asked only if you answered "yes" to the "...configure this
directory for Server Config" prompt. All server configuration is managed
under the suffix o=NetscapeRoot on the Directory Server used for server
configuration (the Configuration Server). Enter the domain that you want
used for this purpose on this Directory Server. For example, airius.com.
Note: You can create multiple administration domains under which your
server can be installed. For example, you can host servers under
administration domains airius.com and acme.com.
Users and Groups
The following prompts display for User and Groups information:
Users/Groups directory URL [ldap://default/o=suffix]
This question is asked only if you answered "no" to the "...use this directory
for managing Users and Groups" prompt, and "yes" to the "...configure this
directory for Server Config" prompt. Enter the LDAP URL to the Users/
Groups directory server that you wish to use. For example:
ldap://users/airius.com:389/o=airius.com
Please enter the base suffix under which the Users/
Groups data should be setup [o=airius.com]
This question is asked only if you answered "yes" to the "...use this directory
for managing Users/Groups" prompt. Enter the base suffix that you wish to
use. The base suffix will be created if it does not already exist. Anonymous
search will be enabled on this base suffix.
Please enter the Users/Groups Administrator's uid
[admin]
Please enter the Users/Groups Administrator's Password:
This question is asked only if you answered "yes" to the "...use this
directory for managing Users/Groups" prompt. This user must have write
access to the users and groups directory suffix on the Directory Server. If
this user ID does not exist, it will be created under the Users and Groups
base DN. See User Directory Administrator for additional information. The
default is admin.
A summary of your settings is then displayed and you are asked if you wish to continue. If the settings are correct, enter yes to continue. If the settings are not correct, enter no and the process will exit. Restart dssetup and enter the correct values.
After choosing to continue, status messages are displayed as the Directory
Server starts and is configured for Messaging Server 4.1.