Chapter 3. Installation and Removal

Table of Contents
3.1. Native Caldera OpenLinux Stand-alone Installation
3.2. Open UNIX 8 Installation
3.3. Remote Installation With Volution Manager
3.4. Removing the Messaging Server
3.5. Known Limitations in This Release

The Messaging Server provides a graphical installation with sufficient tools to completely set up and configure a fully functional mail server. This chapter describes:

See also the Late News and FAQ documents for up-to-date information on installation issues and platform support:

http://www.caldera.com/support/docs/volution/msg

3.1. Native Caldera OpenLinux Stand-alone Installation

Use the graphical Installer to install the Messaging Server on a local Caldera OpenLinux Server 3.1 system. The Messaging Server Installer can be started from the autorun.sh or install.sh scripts on installation media.

To install on a local Caldera OpenLinux system:

  1. Prepare the installation media. You must have Messaging Server distribution media or a CD you created from downloaded ISO images.

  2. Log on as root.

  3. Insert the installation media in the drive.

    If the Automount facility is enabled (this is the default), you will see the Messaging Server Welcome screen, where you are prompted to run the installation. This will invoke autorun.sh. You can either:

    • Click on Yes to begin the installation immediately.

    • Click on No to defer installation. You can begin the installation at any time by clicking on the install.sh icon in the Konqueror file manager when it displays the contents of the distribution media.

    If Automount has been disabled:

    1. Use the mount(8) command to mount the installation media:

      mount /dev/cdrom/mount_point

    2. Run install.sh from the CD mount point:

      /mount_point/install.sh

  4. Review the licensing statement.

  5. Review the displayed confirmation statement.

The installation script will not start if RPM packages required by the Messaging Server are not found on the system or if DNS is not configured. If this happens, install the packages, correct any errors listed, and start it again.

After displaying licensing information, install.sh analyzes the installed RPM list and installs any Messaging Server RPMs that are not listed. If any of the RPMs failed to install, try to install them manually or check the installed packages database using the rpm(1) command.

When the installation completes, you are prompted to view the installation log file, with the option to save it (the default location is /root/install.log). The log file displays the results of default component configuration conducted during the installation process, including:

As soon as installation is complete, we recommend that you change the initial admin password, set by default to "admin"; see "The admin Administrative Account".

This completes Messaging Server installation. You can now configure mail service as described in "Administering the Messaging Server".

3.2. Open UNIX 8 Installation

The Messaging Server can also be installed on an Open UNIX 8 system with LKP using the same install.sh script. However, before doing so, you must follow these steps as root on the Open UNIX 8 system:

  1. Prepare the installation media. You must have Messaging Server distribution media or a CD you created from downloaded ISO images.

  2. Log in as root and start a terminal window from your graphical environment. The X server must be running for the Messaging Server installation.

  3. Mount the Messaging Server CD-ROM on /linux/mnt/cdrom by entering:

    mount -F cdfs -o ro /dev/cdrom/cdrom1 /linux/mnt/cdrom/

  4. Ensure that the X display is available (but only to local system users) by entering:

    xhost local:

  5. Run the linux command to enter the LKP environment.

In the LKP environment, you can then change directories (cd) to /mnt/cdrom and run the install.sh script:

cd /mnt/cdrom
./install.sh

The Messaging Server then installs on the LKP system as described in "Native Caldera OpenLinux Stand-alone Installation". When the installation is complete, click the button to reboot your Open UNIX 8 system.

As soon as installation is complete, we recommend that you change the initial admin password, set by default to "admin"; see "The admin Administrative Account".

Note: The autorun.sh script does not run under LKP.

The mailbox for the admin administrator account might not be created automatically during installation on Open UNIX 8. If not, it must be created manually or the admin user will not be able to send or receive mail. For more information, see "Known Limitations in This Release".

3.3. Remote Installation With Volution Manager

The Messaging Server can be installed on remote systems using Volution Manager. To do so, you must:

You may also want to create a Volution Manager Policy to configure system monitoring and other services for the remote Messaging Server.

For more information, see "Using Volution System Management Services" in the Administrator's Guide and the Volution Manager Administration Guide.

3.4. Removing the Messaging Server

To remove the Messaging Server from your system, enter:

cd /

/opt/lsb-caldera.com-volution/msg/bin/msguninstall

The removal script does not:

Note: If the removal script fails for any reason, the removal might not be complete and the msguninstall utility might no longer be available. In this case, you must run the uninstall.sh script from the distribution media. To do so, ensure that the Messaging Server CD-ROM is mounted and enter:

/mount_point/uninstall.sh

For more information, see the msguninstall(8) manual page.

3.5. Known Limitations in This Release

Note the following known limitations in this Messaging Server release:

No mailbox for admin account on Open UNIX 8
  

In a normal installation, a Cyrus mailbox is created automatically for the admin user. However, installation errors on an Open UNIX 8 system might prevent this mailbox from being created; these errors do not appear in the installation log. You must verify that the mailbox exists and create it manually if it does not. Otherwise, the admin user will not be able to send or receive mail. To do so:

  1. Log onto the Open UNIX 8 system as root and switch to the LKP environment by entering:

    linux

  2. Verify the existence of the admin mailbox by entering:

    ls -d /var/spool/imap/user/admin

    If this directory is present, you have an admin mailbox on your system; you do not need to create the mailbox manually.

    If you receive a No such file or directory error, the admin mailbox was not created. You must do so manually as described in the next step.

  3. Use the msginboxcreate utility to create the admin mailbox:

    /opt/lsb-caldera.com-volution/msg/bin/msginboxcreate --name=admin

    You will be prompted for the admin password.

    Note: The msginboxcreate(8) manual page cautions against running this utility from the command line. That is because a user's UserID and mailbox are usually created at the same time using either the Server Manager or the msgusercreate(8) utility. However, due to an installation error, the admin UserID has been created without a corresponding mailbox, so msginboxcreate can be run safely from the command line in this case only.

  4. Verify the existence of the admin mailbox as described in Step 2.

You can now access your admin account mailbox.

postmaster alias not created in new domains
  

Although a postmaster alias is configured by default in the default Messaging Server domain, it is not created automatically when you create new domains. You should therefore configure an alias for the address "postmaster@host.newdomain" that can be delivered successfully to a destination of your choice. For more information, see "Managing Mail Aliases"; make sure you set the the Domain selection box to the new domain.

Deleting users and aliases
  

If you delete a user who is the last owner or member of an alias, the alias will be silently deleted. Before removing a user, we recommend that you see check their aliases; to do so, click on Aliases in their View User display. For this reason, we also recommend that every alias have at least two owners, and that important aliases also include the admin user as an owner or member.

This list includes all product limitations known at the time of publication. Unless otherwise noted, they will be corrected in product updates or future releases. For more information, we recommend that you consult the Messaging Server Late News listing and FAQ, which are updated regularly on the Caldera website:

http://www.caldera.com/support/docs/volution/msg