Chapter 3   Installation Instructions


This chapter describes how to install iPlanet Messaging Server 5.0. It includes the following sections:

• Pre-Installation Checklist

• Making the Install Files Available for Installation

• Running the setup Program

• Installation Scenarios and Instructions

• Silent Installation

Pre-Installation Checklist

---

At this point, you are almost ready to run the setup program and begin the Messaging Server installation. You should be able to answer "yes" to the following questions before you continue:

1. Have you reviewed the system requirements defined in Chapter 1 "Installation Overview" and verified that they have been met?

2. Have you reviewed Product Hierarchy and Interaction and determined which components you will be installing and where?

3. Have you determined the type of installation you would like to perform and gathered all the necessary info?

4. Have you decided whether you want to use an existing Directory Server or install the one that comes with the Messaging Server?
   1. If you have an existing Directory Server that you want to use as the Configuration Directory Server, have you run ims_dssetup to prepare it for the Messaging Server installation? See Running the ims_dssetup Utility for details.

   2. If you have an existing Directory Server that you want to use as the Users/Groups Directory Server, have you run ims_dssetup to prepare it for the Messaging Server installation? See Running the ims_dssetup Utility for details.

Making the Install Files Available for Installation

---

From the Web

To transfer and extract the compressed installation program files from the World Wide Web, locate the iPlanet Messaging Server 5.0 archive file on the Messaging Server web site. The file will be in the format archive.tar.gz, where archive represents the name of the compressed archive file.

After you have located the archive file:

1. Create a directory (for example, /opt/msg5install) on the machine that will host the Messaging Server and copy the archive file to that directory.

2. Go to the directory where you copied the archive file and then uncompress and extract the contents. Use the following command:

   gunzip -c arhive.tar.gz | tar -xvf -

   Status messages are displayed as the archive file is uncompressed and unpacked.

After the archive file is uncompressed and unpacked, you are ready to run the setup program.

From the CD

To install the Messaging Server from the product CD:

1. Insert the CD into the CD-ROM drive on your installation machine.

2. cd to the solaris directory.

3. cd to the appropriate subdirectory of the product you want to install:
   • ES (Netscape Enterprise Server)

   • iDA (iPlanet Delegated Administrator for Messaging)

   • iMS (iPlanet Messaging Server)

At this point, you are ready to run the setup program.

Running the setup Program

---

The setup program is used to install the Messaging Server Suite. You can run the command as follows:

./setup [options]

---

Note	You must use a terminal display with a minimum of 50 rows in order for all the screens to appear properly.

---

The optional parameters for the setup command are listed in Table 3-1:

Table 3-1    Optional Parameters for the setup Command

Parameter	Description
-h	List the optional parameters.
-s	Silent install mode. This parameter must be used in conjunction with the -f file parameter.
-f file	Specify file as the silent install script. This parameter must be used in conjunction with the -s parameter.
-b dir	Install only the binaries from the specified dir; do not install any configuration files.
-k	Keep the installation cache.

If you are going to perform a Silent Installation, you must first run the setup command with the -k option. This creates a file called install.inf which is used for the Silent Installation. For more information, see Silent Installation in Chapter 1 "Installation Overview," and also Silent Installation.

Installation Scenarios and Instructions

---

This section provides detailed instructions for installing the Messaging Server Suite. You must select one of the following installation scenarios:

---

Note	The instructions in these scenarios are geared for a Custom Installation. If you are performing an Express or Typical Installation, you will not see all of the questions listed here.

---

• "Scenario One:" You are installing the Messaging Server and Directory Server on the same server.

• "Scenario Two:" You are installing the Messaging Server with an existing Configuration and Users/Groups Directory Server.

• "Scenario Three:" You are installing the Messaging Server with an existing Configuration Directory Server only.

• "Scenario Four:" You are installing the Messaging Server with an existing Users/Groups Directory Server only.
  

  ---

  Note	If you are installing the Messaging Server with an existing Directory Server, you must run the ims_dssetup utility against that existing Directory Server to prepare it for the Messaging Server installation. For more information, see Configuring an Existing Directory Server.

  ---

  
  

For some questions, you are instructed to provide a specific answer; for the others, you will need to provide your own answer. Detailed information about each question can be found in Chapter 2 "Installation Questions."

---

Tip	It is important that you record your answer for each question; you may need them for another product installation (for example, iPlanet Delegated Administrator for Messaging requires answers to several of the questions specified during the Messaging Server installation).

---

Scenario One

Follow the installation instructions provided below if you are installing the Messaging Server and Directory Server on the same machine:

1. Go to the directory where you downloaded the install files. For example:

   cd /opt/msg5install

2. Run the following command to stop sendmail and free up port 25 for SMTP:

   /etc/init.d/sendmail stop

3. Run the setup program to begin the installation. For example:

   ./setup -k

4. Provide answers for the following screens/questions as described in Chapter 2 "Installation Questions:"
   • Question 1. Welcome Screen

   • Question 2. License Agreement

   • Question 3. Install iPlanet Servers

   • Question 4. Installation Type

   • Question 5. Installation Location (server-root)

   • Question 6. iPlanet Server Products Components (select all the components on this screen)

   • Question 7. Netscape Server Products Core Components

   • Question 8. Netscape Directory Suite Components

   • Question 9. Administration Services Components

   • Question 10. iPlanet Messaging Applications Components

   • Question 11. Fully Qualified Domain Name of the installation machine

   • Question 12. System User and System Group

   • Question 16. Register with an existing Directory Server? (answer no to this question)

   • Question 25. Do you want another Directory Server to store your Users and Groups data? (answer no to this question)

   • Question 21. Directory Server network port

   • Question 22. Unique ID for this Directory Server

   • Question 19. Login ID and password of the Configuration Server Administrator

   • Question 23. Suffix

   • Question 24. Bind DN and password of the Directory Manager

   • Question 20. Administration Domain

   • Question 30. Directory Server replication (answer no to this question)

   • Question 31. Sample entries (answer no to this question)

   • Question 32. Populate your new Directory Instance with some data (answer suggest to this question)

   • Question 33. Disable schema checking (answer no to this question)

   • Question 34. Administration Server Port

   • Question 35. Bind the Administration Server to a specific IP address rather than the default IP address of the current host?

   • Question 36. User name of the Administration Server

   • Question 37. Unique identifier for this Messaging Server

   • Question 38. Messaging Server hostname and domainname

   • Question 39. User name of the Messaging Server

   • Question 40. Default domain and organization for the Messaging Server

   • Question 42. Hostname and port of the Web server that will host the iPlanet Delegated Administrator for Messaging

   • Question 43. Specify whether or not the Messaging Server will be run from behind a firewall

   • Question 44. Primary message store directory

   • Question 45. TCP/IP port numbers for POP3, IMAP, SMTP, and Messenger Express

   • Question 46. Login ID and password for the Service Administrator

   • Question 47. Email address that you want to add to the postmaster group

   • Question 48. User ID under which the MMP will run

   • Question 49. LDAP URL for the domain component tree in the Users/Groups Directory Server

Scenario Two

Follow the installation instructions provided below if you are installing the Messaging Server with an existing Configuration and Users/Groups Directory Server:

1. Go to the directory where you downloaded the install files. For example:

   cd /opt/msg5install

2. Run the following command to stop sendmail and free up port 25 for SMTP:

   /etc/init.d/sendmail stop

3. Run the setup program to begin the installation. For example:

   ./setup -k

4. Provide answers for the following screens/questions as described in Chapter 2 "Installation Questions:"
   • Question 1. Welcome Screen

   • Question 2. License Agreement

   • Question 3. Install iPlanet Servers

   • Question 4. Installation Type

   • Question 5. Installation Location (server-root)

   • Question 6. iPlanet Server Products Components (do not select the Netscape Directory Suite component)

   • Question 7. Netscape Server Products Core Components

   • Question 9. Administration Services Components

   • Question 10. iPlanet Messaging Applications Components

   • Question 11. Fully Qualified Domain Name of the installation machine

   • Question 12. System User and System Group

   • Question 13. LDAP URL of the Directory Server

   • Question 14. Administration Domain in the Configuration Directory

   • Question 15. Login ID and password of the Configuration Server Administrator

   • Question 34. Administration Server Port

   • Question 35. Bind the Administration Server to a specific IP address rather than the default IP address of the current host?

   • Question 36. User name of the Administration Server

   • Question 37. Unique identifier for this Messaging Server

   • Question 38. Messaging Server hostname and domainname

   • Question 39. User name of the Messaging Server

   • Question 40. Default domain and organization for the Messaging Server

   • Question 41. Distinguished name and password of the Directory Manager

   • Question 42. Hostname and port of the Web server that will host the iPlanet Delegated Administrator for Messaging

   • Question 43. Specify whether or not the Messaging Server will be run from behind a firewall

   • Question 44. Primary message store directory

   • Question 45. TCP/IP port numbers for POP3, IMAP, SMTP, and Messenger Express

   • Question 48. User ID under which the MMP will run

   • Question 49. LDAP URL for the domain component tree in the Users/Groups Directory Server

Scenario Three

Follow the installation instructions provided below if you are installing the Messaging Server with an existing Configuration Directory Server only:

1. Go to the directory where you downloaded the install files. For example:

   cd /opt/msg5install

2. Run the following command to stop sendmail and free up port 25 for SMTP:

   /etc/init.d/sendmail stop

3. Run the setup program to begin the installation. For example:

   ./setup -k

4. Provide answers for the following screens/questions as described in Chapter 2 "Installation Questions:"
   • Question 1. Welcome Screen

   • Question 2. License Agreement

   • Question 3. Install iPlanet Servers

   • Question 4. Installation Type

   • Question 5. Installation Location (server-root)

   • Question 6. iPlanet Server Products Components (select all the components on this screen)

   • Question 7. Netscape Server Products Core Components

   • Question 9. Administration Services Components

   • Question 10. iPlanet Messaging Applications Components

   • Question 11. Fully Qualified Domain Name of the installation machine

   • Question 12. System User and System Group

   • Question 16. Register with an existing Directory Server? (answer yes to this question)

   • Question 17. Fully Qualified Domain Name of the existing Configuration Directory Server in the form hostname.domainname

   • Question 18. Port number on which the Configuration Directory Server listens

   • Question 19. Login ID and password of the Configuration Server Administrator

   • Question 20. Administration Domain

   • Question 21. Directory Server network port

   • Question 22. Unique ID for this Directory Server

   • Question 23. Suffix

   • Question 24. Bind DN and password of the Directory Manager

   • Question 30. Directory Server replication (answer no to this question)

   • Question 31. Sample entries (answer no to this question)

   • Question 32. Populate your new Directory Instance with some data (answer suggest to this question)

   • Question 33. Disable schema checking (answer no to this question)

   • Question 34. Administration Server Port

   • Question 35. Bind the Administration Server to a specific IP address rather than the default IP address of the current host?

   • Question 36. User name of the Administration Server

   • Question 37. Unique identifier for this Messaging Server

   • Question 38. Messaging Server hostname and domainname

   • Question 39. User name of the Messaging Server

   • Question 40. Default domain and organization for the Messaging Server

   • Question 42. Hostname and port of the Web server that will host the iPlanet Delegated Administrator for Messaging

   • Question 43. Specify whether or not the Messaging Server will be run from behind a firewall

   • Question 44. Primary message store directory

   • Question 45. TCP/IP port numbers for POP3, IMAP, SMTP, and Messenger Express

   • Question 46. Login ID and password for the Service Administrator

   • Question 47. Email address that you want to add to the postmaster group

   • Question 48. User ID under which the MMP will run

   • Question 49. LDAP URL for the domain component tree in the Users/Groups Directory Server

Scenario Four

Follow the installation instructions provided below if you are installing the Messaging Server with an existing Users/Groups Directory Server only:

1. Go to the directory where you downloaded the install files. For example:

   cd /opt/msg5install

2. Run the following command to stop sendmail and free up port 25 for SMTP:

   /etc/init.d/sendmail stop

3. Run the setup program to begin the installation. For example:

   ./setup -k

4. Provide answers for the following screens/questions as described in Chapter 2 "Installation Questions:"
   • Question 1. Welcome Screen

   • Question 2. License Agreement

   • Question 3. Install iPlanet Servers

   • Question 4. Installation Type

   • Question 5. Installation Location (server-root)

   • Question 6. iPlanet Server Products Components (select all the components on this screen)

   • Question 7. Netscape Server Products Core Components

   • Question 9. Administration Services Components

   • Question 10. iPlanet Messaging Applications Components

   • Question 11. Fully Qualified Domain Name of the installation machine

   • Question 12. System User and System Group

   • Question 16. Register with an existing Directory Server? (answer no to this question)

   • Question 25. Do you want another Directory Server to store your Users and Groups data? (answer yes to this question)

   • Question 26. Fully Qualified hostname and domainname of the Users/Groups Directory Server

   • Question 27. Port number on which the Users/Groups Directory Server listens

   • Question 28. Suffix for this Users/Groups Directory Server

   • Question 29. Login ID and password for the Users/Groups Server Administrator

   • Question 21. Directory Server network port

   • Question 22. Unique ID for this Directory Server

   • Question 19. Login ID and password of the Configuration Server Administrator

   • Question 24. Bind DN and password of the Directory Manager

   • Question 20. Administration Domain

   • Question 30. Directory Server replication (answer no to this question)

   • Question 31. Sample entries (answer no to this question)

   • Question 32. Populate your new Directory Instance with some data (answer suggest to this question)

   • Question 33. Disable schema checking (answer no to this question)

   • Question 34. Administration Server Port

   • Question 35. Bind the Administration Server to a specific IP address rather than the default IP address of the current host?

   • Question 36. User name of the Administration Server

   • Question 37. Unique identifier for this Messaging Server

   • Question 38. Messaging Server hostname and domainname

   • Question 39. User name of the Messaging Server

   • Question 40. Default domain and organization for the Messaging Server

   • Question 42. Hostname and port of the Web server that will host the iPlanet Delegated Administrator for Messaging

   • Question 43. Specify whether or not the Messaging Server will be run from behind a firewall

   • Question 44. Primary message store directory

   • Question 45. TCP/IP port numbers for POP3, IMAP, SMTP, and Messenger Express

   • Question 46. Login ID and password for the Service Administrator

   • Question 47. Email address that you want to add to the postmaster group

   • Question 48. User ID under which the MMP will run

   • Question 49. LDAP URL for the domain component tree in the Users/Groups Directory Server

Silent Installation

---

This section provides information for performing a Silent installation. For more information about the Silent installation, see Silent Installation in Chapter 1 "Installation Overview."

---

Note	In order to perform a Silent installation, you must have a cache file from a previous installation. The cache file that is created by default is server-root/setup/install.inf.

---

1. Review and edit the install.inf cache file as necessary.

2. Run the setup command with the -s and -f filename options, where filename represents the full path and name of the cache file. For example:

   ./setup -s -f /usr/iplanet/server5/setup/install.inf
   

   ---

   Note	When you use a cache file in this way, no new cache file is created from this installation.

   ---

   
   

If you have many similar server configurations to set up, you can place the cache file plus the server installation package on each machine. You can then perform a Silent installation on each machine and the setup program will extract all information it needs from the cache file as it performs the installation.

Running the ims_dssetup Utility

---

The ims_dssetup utility is located in the msg subdirectory where you downloaded the archive file from the web; on the CD-ROM, it is located in the solaris/iMS/msg directory. From this directory:

1. Execute the ims_dssetup utility with the following command:

   perl5 ims_dssetup.pl
   

   ---

   Note	The ims_dssetup.pl utility is a Perl script; you must have perl5 available on your system to run it.

   ---

   
   

2. Enter yes or press Return to continue,

   Welcome to the iMS Directory Server preparation tool.

   This tool will help you setup a Netscape Directory Server and make it ready to use for installing iPlanet Messaging Server.

   Do you want to continue [y]:

3. Specify the Directory Server root.

   Please enter the full path to the directory where Netscape Directory Server was installed.

   Directory server root [/usr/netscape/server4] :

4. Select a Directory Server instance from the list.

   Please select a directory server instance from the following list:

   [0] slapd-budgie

   Which instance do you want [0]:

5. Specify the base suffix for the DC tree or press Return to accept the default value.

   Please enter the base suffix for DC Tree [o=internet]:

6. Specify the base suffix under which the Users/Groups data should be set up. Press Return to accept the default value.

   Please enter the base suffix under which the Users/Groups data should be setup [o=siroe.com] :

7. Answer yes or press Return to update the schema files.

   Do you want to update the schema files [yes]:

8. Answer yes or press Return to configure the new indexes.

   Do you want to configure new indexes [yes]:

9. Specify the schema directory; this is the config subdirectory of the directory where the ims_dssetup utility is located:

   Please enter the schema directory [/usr/iplanet/server5/msg/config]:

At this point, you will see a summary of your options. It will look similar to the following:

Here is a summary of the settings that you chose:

Server Root            : /usr/netscape/server4
Server Instance            : slapd-budgie
Update Schema             : yes
DC Root             : o=internet
User/Group Root             : o=siroe.com
Add New Indexes             : yes
Schema Directory             : /usr/iplanet/server5/msg/config

10. Answer yes or press Return to continue, or answer no to start over.

    Do you want to continue [y]:

At this point, the configuration of the specified Directory Server begins.