Login as or setuid to root. You must have superuser privileges (that is, be logged in as root) to run the installation program.
If you are installing the product from the CD, go to the directory on the CD specific to your platform (such as ./solaris/calendar or ./hpux/calendar)and type: ./setup. Then proceed to Step 5 below.
If you are downloading the product from the iPlanet web site, create a
directory (such as /tmp/calsvr) on the machine that will host the iPlanet
Calendar Server and download (or copy) the Calendar Server archive file to
that directory. Make sure that the download directory has adequate disk
space to store the extracted files.
Change to the directory where you copied the archive file and to extract the contents, type:
gunzip -c archive.tar.gz | /usr/bin/tar xvf -
where archive identifies the name of the platform archive file you
downloaded or copied.
Note: You must use /usr/bin/tar. This program should be the tar utility
that is distributed with your operating system and not a third party tar
utility, such as gnu.
In the installation directory in which you untarred the Calendar Server archive file, type: ./setup
The installation program displays a Welcome Message.
Click Next to continue. The license agreement displays.
Read the license agreement and click Yes (Accept License) to accept it and continue. (If you click NO, the installation program will end without installing Calendar Server.)
On most systems, the installation program will automatically detect the host name and domain name of the system on which you are installing the server and you can skip this step.
If the installation program cannot detect the host name or domain name, it
will display the "Unable to make network connection" screen. Please be
sure that the host name and domain name specified are correct, then click
Next to continue the installation. The installation program will then try to
establish a network connection using these values.
Note: If the Host Name or Domain Name field is blank, it is because the
installation program was unable to detect its value. In this case, you must
enter a valid host name or domain name, or both.
If a network connection cannot be made using the new values, you will be
asked again to supply a valid host name and domain name. At this point
you can:
Select the type of installation you wish to use: Typical or Custom. The same software is installed with each type of installation. The only difference between the types of installation is the number of choices you have to make during the installation process. Typical Installation is recommended for most users. Custom Installation requires you to specify all available configuration options and is recommended only for advanced users or for installations that require customized configuration options not provided in the Typical Installation. When you have finished making your selections, click Next to continue.
Note: If you choose Typical Installation, the installation program will skip
some of the following questions because they are configured for you.
Questions that apply only to a Custom Installation are so indicated and you
can proceed to the next step.
Select the software components that you want to install (default is all):
When you have finished making your selections, click Next to continue.
This step applies only if you have a previous version of Calendar Server installed on this system. The installation program automatically detects an existing installation and displays a window that lets you can choose to upgrade or reinstall the existing components.
By default, the installation program upgrades all installed components. This
procedure preserves all existing database and configuration information,
such as user calendar data and user preferences.
Remove and Reinstall Existing Components. Click this box only if you
want to completely remove the existing installation and reinstall it from
scratch. Otherwise, leave this box unchecked (the default) and click Next to
upgrade only the software components and keep all existing database and
configuration information.
If you choose to reinstall Calendar Server, you are asked to confirm that you
want to continue with the remove and reinstall operation. If you click
Continue Remove/Reinstall, all existing database and configuration
information on the system will be destroyed. Both the software components
you selected and all database and configuration information will be
installed as new. It is highly recommended that you backup any existing
data bases before selecting this option - once the actual installation process
is started, it cannot be undone. If you want to upgrade instead, click
Choose New.
If you choose to upgrade a previous Calendar Server installation, the
installation program verifies if there is adequate disk space and then
displays the Ready to Install window. To complete the installation, click
Install Now.
Note: The following steps do not apply if you are upgrading an existing
Calendar Server installation.
Specify the directory where you want to install the Calendar Server
software. The default is /opt.
If you want to select another directory, click Browse, then select a directory
and click OK.
When you have finished making your selection, click Next to continue.
If the directory you selected does not exist, a message box displays and you
can either:
Specify the port numbers that you want the Calendar Server to listen on:
-
Web Port. (Default is 80.) The port number used by the Calendar Server to provide Web (HTTP) access to users. It is highly recommended that you choose the default Web port number suggested by the installation program because it is the default port used by all Web browsers. If you specify a Web port other than 80, calendar users will need to explicitly include this port number in the URL they enter to access this Calendar Server.
Note: The installation program will warn you if port 80 is already being
used by another service on this system. If port 80 is already in use, you
can still specify that Calendar Server listen on port 80 and then free port
80 on the other service. Otherwise, select a Web port number for
Calendar Server other than 80.
-
Listen on Admin Port. By default, the installation program enables the Admin port services. If you want to disable the Admin port, uncheck this checkbox. If you leave Listen on Admin Port checked (enabled), it is recommended that you choose the default port number suggested by the installation program which, for security reasons, is selected randomly at installation time.
-
Admin Port. (Randomly selected at installation time.) The port number used by Calendar Server to provide web (HTTP) access to administer the server, such as commands to stop the server or list all logged-in users.
When you have finished making your selections, click Next to continue.
Enter the Unix user and group identity that the Calendar Server will run as. It is recommended that you use the default accounts icsuser and icsgroup. These accounts will be created automatically by the installation program if they do not already exist.
Note: Do not specify root for either the user or the group account.
When you have finished making your selection, click Next to continue.
Specify the Calendar Server Administrator. This is the user account that has privileges to use the Calendar Server administration utilities: csstop to stop the server, cstats to display server statistics, and cstool to list all logged-in users. The default is calmaster. When you have finished making your selection, click Next to continue.
Supply the following email and email alarm information:
Calendar Administrator email address. Enter the full email address
(userID and domain name) of the person to whom you want Calendar
Server to send messages in case of server problems, for example,
calmaster@airius.com.
SMTP Server Host Name. Enter the host name of the machine running the
SMTP server that Calendar Server is to use to send messages.
Enable email alarms. By default, email alarms for the Calendar Server are
enabled. If you do not want Calendar Server to send email alarms, uncheck
this checkbox.
Note: If the Calendar Server cannot connect to the SMTP server you
entered, a message box will display stating that the Calendar Server will not
run if an SMTP server is not available. If this is acceptable at this point, click
Accept. Otherwise, click Choose New and enter the host name of another
SMTP server.
When you have finished making your selections, click Next to continue.
Specify the directory in which to store the Calendar Server database files. The default is:
/var/opt/SUNWicsrv/csdb
If you want to select another directory, click Browse, then select a directory
and click OK.
When you have finished making your selections, click Next to continue.
Note: If the directory you selected does not exist, a message box displays
and you can either:
Specify the directory in which to store the Calendar Server temporary files (Custom installation only).
The default is:
/var/opt/SUNWicsrv/tmp
If you want to select another directory, click Browse, then select a directory
and click OK.
When you have finished making your selections, click Next to continue.
Note: If the directory you selected does not exist, a message box displays
and you can either:
Enter the following LDAP server information for user authentication (Custom Installation only):
When you have finished making your selections, click Next to continue.
Enter the following LDAP server information (in a Typical Installation these settings apply to both user authentication and user preferences; in a Custom Installation these settings apply only to user preferences):
When you have finished making your selections, click Next to continue.
Note: If the installation program does not detect an LDAP server running on
the specified port, a message box will appear stating that the Calendar
Server will not run if an LDAP server is not available. If this is acceptable at
this point, click Accept. Otherwise, click Choose New and re-enter the
LDAP configuration parameters.
Select the desired values for the following system resources (Custom Installation only.):
Select the options for automatically starting Calendar Server. You can choose to start the server after successful installation and, optionally, to start the server automatically at system startup. If you do not wish to start the server after the installation or upon server startup, uncheck the applicable box or boxes. When you have finished making your selections, click Next to continue.
The installation program verifies if there is adequate disk space and then displays the Ready to Install window. To complete the installation, click Install Now.
When the installation procedure has completed, a summary window displays. Click Details if you want to review summary information about the installation. When you are finished, Click dismiss to close the Summary information window, then click Done to exit the installation program.