Sun Java System Messaging Server 6.3 Administration Guide

1.3 Creating the Initial Messaging Server Runtime Configuration

The initial runtime configuration program provides a configuration to get your Messaging Server up and running. It is meant to create an initial runtime configuration to setup a generic functional messaging server configuration. Thus it gives you a base working configuration from which you can make your specific customizations. The program is only meant to be run once. Subsequent running of this program will result in your configuration being overwritten. To modify your initial runtime configuration, use the configuration utilities described here and in the Sun Java System Messaging Server 6.3 Administration Reference.

1.3.1 Messaging Server Prerequisites

Before running the initial runtime configuration program, you must:

1.3.2 Messaging Server Configuration Checklist

When you run the Messaging Server initial runtime configuration program, record your parameters in Table D–3. To answer certain questions, refer to your Directory Server installation checklists in Appendix D, Installation Worksheets.

ProcedureTo Run the Configure Program

This procedure walks you through configuring the Messaging Server initial runtime configuration.

  1. Ensure in your setup that DNS is properly configured and that it is clearly specified how to route to hosts that are not on the local subnet.

    • The /etc/defaultrouter should contain the IP address of the gateway system. This address must be on a local subnet.

    • The /etc/resolv.conf exists and contains the proper entries for reachable DNS servers and domain suffixes.

    • In /etc/nsswitch.conf, the hosts: and ipnodes: line has the files, dns and nis keywords added. The keyword files must precede dns and nis. So if the lines look like this:

      hosts:  nis dns files
      ipnodes:  nis dns files

      They should be changed to this:

      hosts:  files nis dns
      ipnodes:  files nis dns
    • Make sure that the FQDN is the first host name in the /etc/hosts file.

      If your Internet host table in your /etc/hosts file looks like this:

      123.456.78.910 budgie loghost mailhost

      Change it so that there is only one line for the IP address of the host. Be sure the first host name is a fully qualified domain name. For example:

      123.456.78.910 budgie loghost mailhost
    • You can verify that the lines are read correctly by running the following commands:

      # getent hosts ip_address
      # getent ipnodes ip_address

      If the lines are read correctly, you should see the IP address followed by the FQDN and then the other values. For example:

      # getent hosts budgie loghost mailhost

    Note –

    On Solaris OS 10 U3 and earlier platforms, you not only have to add the Fully Qualified Domain Name (FQDN) to the /etc/hosts file, but also to the/etc/inet/ipnodes file. Otherwise, you will get an error indicating that your host name is not a Fully Qualified Domain Name. From Solaris OS 10U4 onwards, the contents of the /etc/inet/ipnodes and /etc/hosts files have been merged together into just the/etc/hosts file. Applying kernel patch 120011-14 on any Solaris 10 system will also perform the merge, and subsequent removal of the/etc/inet/ipnodes file.

  2. Invoke the Messaging Server initial runtime configuration with the following command:

    msg-svr-base/sbin/configure [flag]

    You might need to use the xhost(1) command if you are configuring Messaging Server on a remote system.

    The table below describes optional flags you can set with the configure program:




    Invokes a command-line configuration program. 


    Invokes a GUI user interface program. 

    -state [statefile]

    Uses a silent installation file. Must be used with -nodisplay and -noconsole flags. See To Perform a Silent Installation.

    Once you run the configure command, the configuration program will start:

  3. Welcome

    The first panel in the configure program is a copyright page. Select Next to continue or Cancel to exit. If you didn’t configure the administration server (Messaging Server 2005Q4 or earlier only) you will be warned, select okay to continue.

  4. Enter the Fully Qualified Host Name (FQHN).

    This is the machine on which Messaging Server will operate. When you installed the server using the Java Enterprise System installer, you probably specified the physical host name. However, if you are installing a cluster environment, you will want to use the logical hostname. Here is the chance to change what you originally specified.

  5. Select directory to store configuration and data files.

    Select the directory where you want to store the Messaging Server configuration and data files. Specify a pathname that is not under the msg-svr-base. Symbolic links will be created under msg-svr-base to the configuration and data directory. For more information on these symbolic links, see 1.11 Post-Installation Directory Layout.

    Make sure you have large enough disk space set aside for these files.

  6. You will see a small window indicating that components are being loaded.

    This may take a few minutes.

  7. Select Components to Configure.

    Select the Messaging components that you want to configure.

    • Message Transfer Agent: Handles routing, delivering user mail, and handling SMTP authentication. The MTA provides support for hosted domains, domain aliases, and server-side filters.

    • Message Store: Provides the foundation for unified messaging services through its universal Message Store. Access to the message store is available through multiple protocols (HTTP, POP, IMAP). If you are only configuring a Message Store, you must also select the MTA.

    • Webmail Server: Handles the HTTP protocol retrieval of messages from the Message Store. This component is also used by Communication Express to provide web-based access.

    • Messaging Multiplexor: Acts as a proxy to multiple messaging server machines within an organization. Users connect to the Multiplexor server, which redirects each connection to the appropriate mail server. This component is not enabled by default. If you do check the MMP as well as the Message Store, they will be enabled on the same system; a warning message will appear for you to change your port numbers after configuration. For instructions on doing so, see 1.12 Post-Installation Port Numbers.

      To configure the MMP, see Chapter 7, Configuring and Administering Multiplexor Services.

      Check any components you want to configure, and uncheck those components you do not wish to configure.

  8. Enter the system user name and the group that will own the configured files.

    For information on setting up system users and groups, see 1.1 Creating UNIX System Users and Groups.

  9. Configuration Directory Server Panel

    Enter your Configuration Directory LDAP URL, Administrator and Password. This is taken from the Administration Server configuration. Note that this is for Messaging Server 6 2005Q4 and earlier, later versions do not store configuration data in Directory Server and do not use the Administration Server.)

    Gather the Configuration Server LDAP URL from your Directory Server installation. See the Directory Server Installation worksheet from Table D–1.

    The Directory Manager has overall administrator privileges on the Directory Server and all Sun Java System servers that make use of the Directory Server (for example, the Messaging Server). It also has full administration access to all entries in the Directory Server. The default and recommended Distinguished Name (DN) is cn=Directory Manager and is set during Directory Server configuration.

    Note –

    If you select something other than the default, you will have a mismatch between the Administration Server and the configuration Directory Server. This will require manual post-configuration steps. So modify this entry only if you really know what you are doing.

  10. User/Group Directory Server Panel

    Enter your Users and Groups Directory LDAP URL, Administrator and Password.

    Gather the User/Group Server LDAP URL information from the host and post number information from your Directory Server installation. See the Directory Server Installation worksheet from Table D–1.

    The Directory Manager has overall administrator privileges on the Directory Server and all Sun Java System servers that make use of the Directory Server (for example, the Messaging Server) and has full administration access to all entries in the Directory Server. The default and recommended Distinguished Name (DN) is cn=Directory Manager and is set during Directory Server configuration.

    If you are installing against a replicated Directory Server instance, you must specify the credentials of the replica, not the master directory.

  11. Postmaster Email Address

    Enter a Postmaster Email Address.

    Select an address that your Administrator will actively monitor. For example, for a postmaster on the siroe domain. This address cannot begin with “Postmaster.”

    The user of the email address is not automatically created. Therefore, you will need create it later by using a provisioning tool.

  12. Password for administrator accounts

    Enter an initial password that will be used for service administrator, server, user/group administrator, end user administrator privileges as well as PAB administrator and SSL passwords.

    After the initial runtime configuration, you might change this password for individual administrator accounts. For more information, see 4.1 To Modify Your Passwords.

  13. Default Email Domain

    Enter a Default Email Domain.

    This email domain is the default that is used if no other domain is specified. For example, if is the default email domain, then the domain to which messages addressed to user IDs without a domain will be sent.

    If you are using the Delegated Administrator CLI, the command-line interface for provisioning users and groups with Sun LDAP Schema 2, you will want to specify the same default domain during its configuration. For more information, see the Sun Java System Delegated Administrator 6.4 Administration Guide.

  14. Organization DN

    Enter an Organization DN under which users and groups will be created. The default is the email domain prepended to the user/group suffix.

    For example, if your user/group suffix is o=usergroup, and your email domain is, then the default is, o=usergroup (where o=usergroup is your user/group Directory suffix which was specified in 1.1 Creating UNIX System Users and Groups.

    If you choose the same user/group Directory suffix as your Organization DN, you may have migration problems if you decide to create a hosted domain. If you want to set up a hosted domain during initial runtime configuration, then specify a DN one level below the User/Group suffix.

  15. Ready to Configure

    The configuration program will check for enough disk space on your machine and then outline the components it is ready to configure.

    To configure the Messaging components, select Configure Now. To change any of your configuration variables, select Back. Or to exit from the configuration program, select Cancel.

  16. Starting Task Sequence, Sequence Completed, and Installation Summary Panels

    You can read the installation status by selecting Details on the final Installation Summary page. To exit the program, select Close.

    A log file is created in msg-svr-base/install/configure_YYYYMMDDHHMMSS.log, where YYYYMMDDHHMMSS identifies the 4-digit year, month, date, hour, minute, and second of the configuration.

    An initial runtime configuration is now set up for your Messaging Server. To change any configuration parameter, refer to other parts of this document for instructions on doing so.

    To start Messaging Server, use the following command:


ProcedureTo Perform a Silent Installation

The Messaging Server initial runtime configuration program automatically creates a silent installation state file (called saveState) that can be used to quickly configure additional Messaging Server instances in your deployment where the Messaging Server Solaris packages have been installed. All of your responses to the configuration prompts are recorded in that file.

By running the silent installation, you instruct the configure program to read the silent installation state file. The configure program uses the responses in this file rather than ask the same installation questions again for subsequent initial runtime configurations of Messaging Server. When you use the state file in a new installation, you are not asked any questions. Instead, all of the state file responses are automatically applied as the new installation parameters.

The silent installation saveState state file is stored in the msg-svr-base/install/configure_YYYYMMDDHHMMSS directory, where YYYYMMDDHHMMSS identifies the 4-digit year, month, date, hour, minute, and second of the saveState file.

To use the silent installation state file to configure another Messaging Server instance on another machine in the deployment, follow these steps:

  1. Copy the silent installation state file to a temporary area on the machine where you are performing the new installation.

  2. Review and edit the silent installation state file as necessary.

    You will probably want to change some of the parameters and specifications in the state file. For example, the default email domain for the new installation may be different than the default email domain recorded in the state file. Remember that the parameters listed in the state file will be automatically applied to this installation.

  3. Run the following command to configure other machines with the silent installation file:

    msg-svr-base/sbin/configure -nodisplay -noconsole -state \ 

    where fullpath is the full directory path of where the saveState file is located. (See Step 1 of this section).

    Note –

    After running the silent installation program, a new state file is created from the silent installation in directory location: msg-svr-base/install/configure_YYYYMMDDHHMMSS/saveState, where YYYYMMDDHHMMSS identifies the 4-digit year, month, date, hour, minute, and second of the directory containing the saveState file.