Chapter 3. Installation and Removal

Table of Contents

Native Linux Stand-alone Installation
Native Caldera OpenLinux Upgrade
UnixWare 7 Installation and Upgrade
Non-Graphical Installation and Upgrade
Removing the SCOoffice Mail Server
Setting the Language
DNS Setup
Known Limitations in This Release

The SCOoffice Mail Server provides a graphical installation with sufficient tools to completely set up and configure a fully functional mail server, as well as an in-place upgrade from earlier SCOoffice Mail Server releases. This chapter describes:

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

http://www.sco.com/support/docs/SCOoffice/mail

Native Linux Stand-alone Installation

Use the graphical Installer to install the SCOoffice Mail Server on a local SCO Linux, UnitedLinux, or Caldera OpenLinux system. The SCOoffice Mail Server Installer can be started from the autorun.sh or install.sh scripts on installation media.

To install on a local SCO Linux,UnitedLinux, or Caldera OpenLinux system:

  1. Prepare the installation media. You must have SCOoffice Mail 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 SCOoffice Mail 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

      The graphical installation will start.

  4. Review the licensing statement, and select Continue.

  5. Enter the license information from your Certificate of License and Authentication. You may only have a Serial Number and Activation Key, not necessarily License Data.

    If you don't yet have a license, you may skip entering the license at this step, in which case you will be using a 60-day evaluation license.

    Select Continue.

  6. If you did not enter license information, or entered incorrect license information, you are given an opportunity to select Back to go back to the licensing screen. Otherwise select Continue to go on.

  7. Review the displayed confirmation statement. When you select Continue, installation will begin.

  8. When the installation is complete, you are prompted to view the installation log files, with the option to save them. From the screen you can select to view the Log, Debug, or Error messages. Select Save to save any one of them.

The installation script will not start if RPM packages required by the SCOoffice Mail 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 SCOoffice Mail 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.

The main log file displays the results of default component configuration conducted during the installation process, including:

  • verbose output of the pre- and post-install scripts

  • daemons started:

    • slapd (LDAP daemon)

    • Postfix master(8) daemon

    • Cyrus master daemon (imap_master(8) )

    • httpd instances for Apache and DocView

  • default configuration values

Installation errors are reported in the Errors log file.

Note

Many of the error notices at the beginning of the log file are normal and expected. If your installation fails, check the end of the Errors log file.

Caution

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

This completes SCOoffice Mail Server installation. You can now configure mail service as described in Chapter 4 “Administering the SCOoffice Mail Server”.

Native Caldera OpenLinux Upgrade

You can upgrade the SCOoffice Mail Server to Release 2.0 using the install.sh utility. Upgrades are supported from:

  • SCOoffice Mail Server Release 1.0

  • SCOoffice Mail Server Release 1.0 with Maintenance Pack 1

  • SCOoffice Mail Server Release 1.0 with Maintenance Pack 2

  • SCOoffice Mail Server Release 1.1

  • SCOoffice Mail Server Release 1.1.1

It is not necessary to add or remove SCOoffice Mail Server maintenance packs before performing an upgrade.

Note

The Release 2.0 upgrade cannot be removed. That is, once the upgrade has been performed, you cannot roll back to an earlier release. If you want to return to an earlier release, you must back up your data, remove the SCOoffice Mail Server and reinstall with any desired maintenance packs.

To upgrade a local Caldera OpenLinux system, follow the procedure described in “Native Linux Stand-alone Installation ”. The installation process will detect the previous version and upgrade it appropriately.

UnixWare 7 Installation and Upgrade

You can also install or upgrade the SCOoffice Mail Server on a UnixWare 7 system (including Open UNIX 8) with LKP using the same install.sh script. However, before doing so, you must follow these steps as root on the UnixWare 7 system:

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

  2. Log in as root. If you are installing the SCOoffice Mail Server for the first time, start a terminal window from your graphical environment. The X server must be running for the SCOoffice Mail Server installation, but it is not required for the SCOoffice Mail Server upgrade.

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

    mount `devattr cdrom1 bdevice` /linux/mnt

    Be sure to use left quotes in the command.

  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.

  6. In the LKP environment, you can then change directories (cd) to /mnt/cdrom and do:

    cd /mnt/cdrom
    ./install.sh

    Note

    The autorun.sh script does not run under LKP.

    The graphical installation will start.

  7. Follow the rest of the steps described in “Native Linux Stand-alone Installation ”. The installation process will automatically detect any previous versions and perform the appropriate upgrade. If no previous version is detected, and fresh install is performed.

  8. When the installation or upgrade is complete, reboot your UnixWare 7 system by either:

    • clicking the reboot button after the graphical installation completes, or

    • exiting the Linux Kernel Personality environment and running the shutdown command from the UnixWare 7 environment.

Caution

If this is your first SCOoffice Mail Server installation, we recommend that you immediately change the initial admin password, set by default to "admin"; see “The admin Administrative Account”.

The mailbox for the admin administrator account might not be created automatically during installation on UnixWare 7. 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”.

Non-Graphical Installation and Upgrade

The SCOoffice Mail Server can be installed or upgraded without the graphical Installer using the install.sh utility with the -c option. This performs a non-interactive install that does not rely on the X server; the installation proceeds directly with no prompts or checks. This can be useful if you have an archive file of the SCOoffice Mail Server media that you would like to install on a remote system.

To install or upgrade the SCOoffice Mail Server in non-graphical mode, unpack the archive file and run the following command in the same directory:

./install.sh -c

When the installation or upgrade is complete, we recommend that you review the /root/install.log file to confirm that the installation was successful.

Removing the SCOoffice Mail Server

To remove the SCOoffice Mail Server from your system, enter:

cd /

/opt/lsb-sco.com/msg/bin/msguninstall

The removal script does not:

  • downgrade to an earlier SCOoffice Mail Server version; it removes the entire product.

  • reinstall components that were removed at SCOoffice Mail Server installation; for example, sendmail™ and imap™.

  • restore updated RPMs to the earlier version.

  • remove configuration directories that you populated or that contain files backed up by the SCOoffice Mail Server. The removal script error listing identifies these directories.

  • remove configuration information from mail clients.

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 SCOoffice Mail Server CD-ROM is mounted and enter:

/mount_point/uninstall.sh

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

Note

After removing the SCOoffice Mail Server from an Open UNIX 8 system and reinstalling it after reconfiguring the system for a security level higher than the normal security setting, the /home/vscan directory is owned an incorrect system user ID. This prevents the SCOoffice Mail Server from sending mail. This is because the /home/vscan directory is not removed by the msguninstall(8) utility, and under higher than normal security settings, user IDs are not recycled. Thus when the vscan user is assigned a different user ID after reinstallation, the directory is owned by the wrong user ID.

To work around this problem, do one of the following:

  • Remove the /home/vscan directory after removing the SCOoffice Mail Server.

  • Run the following command after reinstalling the SCOoffice Mail Server:

    chown vscan /home/vscan

Setting the Language

SCOoffice Mail Server graphical interfaces provide language support for:

  • English

  • French

  • German

  • Italian

  • Polish

  • Spanish

To access the Server Manager in one of these languages, simply set the language in your browser. You should also instruct mail client users to set the appropriate language for their browser; translated Help screens for the Preferences Manager are provided.

Note

The SCOoffice Mail Server default character set is UTF-8.

Netscape Communicator 4.7 does not support automatic switching of character sets. To display SCOoffice Mail Server graphical interfaces correctly, UTF-8 must be set specifically in the View->Character Set menu.

DNS Setup

If you install the SCOoffice Mail Server on a system that is not connected to the Internet -- for example, a stand-alone system with intermittent Internet connections -- additional DNS (Domain Name Service) configuration might be necessary if outgoing mail is not delivered. You can confirm this problem by running the mailq command; if errors indicate that it was not able to contact host 127.0.0.1 for queued messages, use the following procedure to modify your DNS configuration:

  1. Verify that:

    • the output of the nslookup 127.0.0.1 command is localhost.domain_name.

    • the output of the nslookup localhost.domain_name command is 127.0.0.1 with server name localhost.domain_name.

    • there is no MX record for localhost. There is no such record by default, but if there is, Postfix can generate looping errors.

    If these conditions are not met, you must modify your name service configuration accordingly.

  2. Edit the /etc/postfix/main.cf file and change it so that the content_filter assignment line reads:

    content_filter = smtp:localhost.$mydomain:10025

Known Limitations in This Release

Note the following known limitations in this SCOoffice Mail Server release:

No mailbox for admin account on UnixWare 7

In a normal installation, a Cyrus mailbox is created automatically for the admin user. However, installation errors on an UnixWare 7 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 UnixWare 7 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-sco.com/msg/bin/msginboxcreate \
      --name=admin

    You will be prompted for the admin password.

    Note

    The msgusercreate(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.

 

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 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.

Port number cannot be set with msgldaphost

If you use the msgldaphost utility to configure an alternate LDAP server, do not specify the --port option; doing so will cause LDAP authentication failures. The utility automatically sets the default port. For more information, see the msgldaphost(8) manual page.

Using the IMAP ipurge Utility with the SCOoffice Mail Server

The ipurge(8) utility deletes mail from IMAP mailbox or partition based on age or size. However, it has an undocumented -f option, which you must use if you wish to use the utility on SCOoffice Mail Server user mailboxes. By default, ipurge works only on public folders.

 

SCOoffice Mail Server Release 2.0 on Caldera OpenLinux Server 3.1 not fully localized

Because Caldera OpenLinux Server 3.1 is not internationalized or localized, not all localization features of SCOoffice Mail Server are available when it is installed on the Caldera OpenLinux 3.1 platform. If you require localized SCOoffice Mail Server support, we recommend that you upgrade Caldera OpenLinux to release 3.1.1.

SCOoffice Mail Server Release 2.0 localized documentation and help screens

The SCOoffice Mail Server Release 2.0 Client User's Guide is available in English, French, German, Italian, Polish, and Spanish; this also ensures that Help screens for the Preferences Manager user interface are also available in these languages. However, the SCOoffice Mail Server Administrator's Guide guide has not been translated for this release, hence Help screens for the Server Manager interface are available in English only. This Getting Started Guide is also available in English only.

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 SCOoffice Mail Server Late News document, which is updated regularly on the SCO website: