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
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:
Prepare the installation media. You must have Messaging Server distribution media or a CD you created from downloaded ISO images.
Log on as root.
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:
Use the mount(8) command to mount the installation media:
mount /dev/cdrom/mount_point
Run install.sh from the CD mount point:
/mount_point/install.sh
Review the licensing statement.
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:
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
any installation errors
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 log file.
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".
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:
Prepare the installation media. You must have Messaging Server distribution media or a CD you created from downloaded ISO images.
Log in as root and start a terminal window from your graphical environment. The X server must be running for the Messaging Server installation.
Mount the Messaging Server CD-ROM on /linux/mnt/cdrom by entering:
mount -F cdfs -o ro /dev/cdrom/cdrom1 /linux/mnt/cdrom/
Ensure that the X display is available (but only to local system users) by entering:
xhost local:
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".
The Messaging Server can be installed on remote systems using Volution Manager. To do so, you must:
have Volution Manager installed on the local system.
have Volution Manager Client installed on the same target system as the Messaging Server.
ensure that the target system meets other Messaging Server system requirements.
add the Messaging Server to the target system's Profile on the Volution Manager Server.
add the Messaging Server RPMs to the Software Repository on the Volution Manager Server.
create a Volution Manager Action that installs the Messaging Server.
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.
To remove the Messaging Server from your system, enter:
cd /
/opt/lsb-caldera.com-volution/msg/bin/msguninstall
The removal script does not:
reinstall components that were removed at Messaging 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 Messaging 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 Messaging Server CD-ROM is mounted and enter:
/mount_point/uninstall.sh
For more information, see the msguninstall(8) manual page.
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:
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: