Previous     Contents     Index          Next     
iPlanet Calendar Server Installation Guide



Chapter 2   Installing iPlanet Calendar Server on Unix


This chapter describes the steps to follow to install iPlanet Calendar Server (iCS) on a Unix platform. You can run the setup program by either:



Using the Graphical Interface Installation on Unix

The following steps describe how to use the graphical user interface installation program to install iPlanet Calendar Server.

  1. Login as root. You must have superuser privileges (that is, be logged in as root) to run the installation program. If you are not able to login as root, you must set the access permissions on the system to full administration rights for the currently logged in user (for example, type: xhost +) to be able to run the installation program graphical interface.

  2. Create a directory (such as /tmp/ics5) on the machine that will host the iPlanet Calendar Server and download (or copy) the iPlanet Calendar Server archive file to that directory. Make sure that the directory you use has adequate disk space to store the extracted files.

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

  4. In the installation directory in which you untarred the iPlanet Calendar Server archive file, type: ./setup

  5. The installation program displays a Welcome Message. Click Next to continue.

  6. 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 iPlanet Calendar Server.)

  7. On most systems, the installation program will automatically detect the host name and DNS domain name of the system on which you are installing the server and you can proceed to the next step.

    If the installation program cannot detect the host name or DNS domain name, it will display the "Unable to make network connection" screen. Please be sure that the host name and DNS 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: The Host Name or Domain Name fields will be blank if the installation program is unable to detect these values. In this case, you must enter a valid host name or DNS 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 DNS domain name. At this point you can:

    • Click Accept if you want to continue with the installation anyway using these values. If you accept these values, you will not be able to run the server until you supply a valid host name and DNS domain name. In this case, you can edit the ics.conf file after you complete the installation and supply a valid host name and DNS domain name. The ics.conf file is located in the server-root/cal/bin/config directory (for example, /opt/SUNWics5/cal/bin/config).

    • Click Choose New to enter another host name or DNS domain name, or both.

  8. 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 indicated as such in this guide and you can proceed to the next step.

  9. Select the software components that you want to install (default is all):

    • iPlanet Calendar Server Product - the software used to run the server.

    • iPlanet Calendar Server API (CSAPI) - an application programming interface that enables third party application developers to add functionality to iCS or change how the server performs certain operations.

    When you have finished making your selections, click Next to continue.

  10. This step applies only if you have a previous version of iPlanet Calendar Server, version 5.0 installed on this system. The installation program will automatically detect an existing version 5.0 installation and will display a window that lets you choose to either:

    • upgrade

    • remove and reinstall the selected components

    Upgrade: To upgrade your installation of iPlanet Calendar Server, version 5.0, leave the box next to Remove and Reinstall Existing Components unchecked (this is the default) and click Next. The installation program then displays a window reminding you to back up your existing database and configuration information before you continue. Click Continue if you are sure you want to proceed. (Otherwise, click Cancel to return to the previous window.) If you click Continue, the installation program will stop all Calendar Server services running on this system. (If the installation program is unable to verify that all Calendar Server services on this system are stopped, a warning message displays and you should use your operating system administration tools to ensure that all Calendar Server services on this systems are stopped before you proceed with the upgrade.) Next, the installation program displays the Ready to Install window. To complete the installation, click Install Now. The installation program will then upgrade all installed components and will preserve all existing database and configuration information, such as users' calendar data.

    After the upgrade finishes successfully, the installation process is now complete and 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 Exit to end the installation program.

    Remove and reinstall: To remove and reinstall iPlanet Calendar Server, version 5.0, click the box next to Remove and Reinstall Existing Components, then click Next. This action tells the installation program to completely remove the existing installation of iPlanet Calendar Server, version 5.0 and reinstall it from scratch.

    If you choose to remove and reinstall iPlanet Calendar Server, a window displays asking you to confirm that you want to continue. Click Continue (remove/reinstall) if you are sure you want to proceed. (Otherwise, click Cancel to return to the previous window.) If you click Continue (remove/reinstall), the installation program will stop all Calendar Server services running on this system. (If the installation program is unable to verify that all Calendar Server services on this system are stopped, a warning message displays and you should use your operating system administration tools to ensure that all Calendar Server services on this systems are stopped before you proceed.)

    It is highly recommended that you backup any existing database information before you remove and reinstall iPlanet Calendar Server. Once the actual installation process is started, it cannot be undone.

  11. If the installation program detects that iPlanet Calendar Server version 2.x is installed on this system, a window displays stating that version 5.0 will be installed and the two versions will co-exist on this system. For more details on how to migrate data from version 2.x, see Chapter 4 "Migrating iPlanet Calendar Server Data."

    Click Next to continue with the installation.

  12. Specify the directory where you want to install the iPlanet Calendar Server software. The default is /opt.

    If you want to select another directory, type it in or click Browse, then select a directory and click OK. When you have made your selection, click Next to continue.

    If the directory you selected does not exist, a message box displays and you can either:

    • Click Create Directory to create the directory and install iPlanet Calendar Server in the specified directory and continue the installation.

    • Click Choose New to return to the Select Install Directory window where you can select another installation directory.

  13. Specify the Web Port number that you want iPlanet Calendar Server to listen on. (Default is 80.) The Web Port number is used by iPlanet 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 number 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 their calendars on this Calendar Server.

    When you have finished making your selection, click Next to continue.

    The installation program will warn you if the port number you selected is already being used by another service on this system. If this is acceptable at this point, click Accept. Otherwise, click Choose New and enter another Web port number.

    Note: If port 80 is already in use, you can click Accept to specify that iPlanet Calendar Server listens on port 80 and then free port 80 on the other service. In this case, it is highly recommended that you free port 80 on the other service before you continue with the installation.

  14. Enter the Unix user and group identity that the iPlanet 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 selections, click Next to continue.

  15. Supply the following email and email alarm information:

    Calendar Administrator email address. Enter the full email address (userID and DNS domain name) of the person to whom you want iPlanet Calendar Server to send messages in case of server problems. For example:

    calmaster@siroe.com

    SMTP Server Host Name. Enter the host name of the machine running the SMTP server that iPlanet Calendar Server is to use to send messages.

    Enable email alarms. By default, email alarms for the iPlanet Calendar Server are enabled. If you do not want iPlanet Calendar Server to send email alarms, uncheck this checkbox.

    When you have finished making your selections, click Next to continue.

    Note: If the iPlanet Calendar Server cannot connect to the SMTP server you entered, a message box will display stating that the iPlanet 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.

  16. Specify the directory in which to store the iPlanet Calendar Server database files. The default is:

    /var/opt/SUNWics5/csdb

    If you want to select another directory, type it in or click Browse to 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:

    • Click Create Directory to install iPlanet Calendar Server database files in the specified directory and continue the installation.

    • Click Choose New to return to the Select Install Directory window where you can select another directory.

  17. Specify the directory in which to store the iPlanet Calendar Server temporary files (Custom installation only). The default is:

    /var/opt/SUNWics5/tmp

    If you want to select another directory, type it in or click Browse to 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:

    • Click Create Directory to install iPlanet Calendar Server temporary files in the specified directory and continue the installation.

    • Click Choose New to return to the Select Install Directory window where you can select another directory.

  18. Enter the following LDAP server information for user authentication (this step applies only if you chose Custom Installation — if you chose Typical Installation, proceed to the next step.)

    • Host. Host name of the machine on which the LDAP Server is running.

    • Port. Port number that the LDAP server listens to. The default is 389.

    • Base DN. Base DN (distinguished name) is the entry in your LDAP directory used as the starting point from which searches will occur. For example, if you specify a base DN of ou=people, o=siroe.com, LDAP search operations executed by iPlanet Calendar Server will examine only the ou=people subtree in the o=siroe.com directory tree.

    • Administrator Bind DN. The DN of the account that will be used to bind to the LDAP directory to search for a calendar user's DN during authentication. The default is to bind anonymously.

      Note: If your directory server does not allow anonymous bind authentication or does not allow anonymous search, you must enter a valid DN that has these access rights.

    • Administrator Password. The password for the user account of the Administrator Bind DN described above. No password is required for the default user <anonymous>.

    When you have finished making your selections, click Next to continue.

    Note: If the installation program cannot verify the LDAP credentials you specified, a message box displays and you can either:

    • Click Accept to install iPlanet Calendar Server anyway if this is acceptable at this point.

    • Click Choose New to return to the LDAP user authentication window where you can enter different directory server information.

  19. Enter the following LDAP server information (in a Typical Installation these settings apply to where user authentication information and user preferences are stored; in a Custom Installation these settings apply only to where user preferences are stored):

    • Host. Host name of the machine on which the LDAP Server is running.

    • Port. Port number that the LDAP server listens to. The default is 389.

    • Base DN. Base DN (distinguished name) is the entry in your LDAP directory used as the starting point from which searches will occur. For example, if you specify a base DN of ou=people, o=siroe.com, the LDAP search operations executed by iPlanet Calendar Server will examine only the ou=people subtree in the o=siroe.com directory tree. The installation program does not attempt to verify your entry.

    • Administrator Bind DN. The DN of the account that has privileges to manage the attributes of any calendar user in the LDAP directory that stores user preferences. The installation program does not attempt to verify your entry. The default is:

      uid=admin,ou=Administrators,ou=TopologyManagement,o=NetscapeRoot

      The default bind DN will work with any 4.x version of the Netscape/iPlanet LDAP directory. You can verify that this DN exists by using the directory server ldapsearch utility, for example:

      ./ldapsearch -b o=NetscapeRoot uid=admin

    • Administrator Password. The password for the user account of the Administrator Bind DN described above. The installation program does not attempt to verify your entry.

    When you have finished making your selections, click Next to continue.

    Note: If the installation program cannot bind to the LDAP server specified or if it cannot find the LDAP schema for iPlanet Calendar Server, a message box will display stating that iPlanet 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.

  20. iPlanet Calendar Server 5.0 requires specific schema updates if you are using an LDAP directory server to store user and group information. If you are using Netscape Directory Server 4.12 (or later), you can choose to have the installation program automatically update the LDAP schema.

    To automatically update the LDAP schema, supply the user ID and password of the Directory Manager (this is the user with the rights to update the schema also known as "Unrestricted User"). This is the username and associated password that can make changes in the Netscape Directory Server schema. The default DN is cn=Directory Manager. The installation program will then attempt to automatically update the LDAP schema of the directory server you specify.

    Choose Next to continue and the installation program asks you to confirm that you want to update the LDAP schema. Click Continue if you update the LDAP schema at this time. Otherwise click Cancel to return to the previous window.

    The installation program will warn you if it cannot update the LDAP schema automatically because it:

    • did not detect Netscape Directory Server 4.12 or later.

    • detected an earlier version of the iPlanet Calendar Server 5.0 schema extension on the specified Directory Server. In this case, you can manually remove the um50-common-schema.conf and ics50-schema.conf files on your Directory Server (located in the server-root/slapd-hostname/config directory) and run the installation program again.

    You may choose., however, to update the LDAP schema manually. For more information, see Updating the LDAP Schema.

    If you do not specify a Directory Manager and password, if you click Next, the installation program warns iPlanet Calendar Server 5.0 will not run properly if you do not update the LDAP schema. If this is acceptable at this point, click Accept. Otherwise, click Choose New to re-enter the requested information.

  21. Choose if you want to save the LDAP schema extension files to disk.

    If you want to save the schema files locally (in the event that you want to update the LDAP schema manually), accept the suggested location (/tmp) or, to select a another directory, type it in or click Browse and make your selection, then click Next.

    If you do not specify a directory and click Next, the installation program warns you that copies of the schema files will not be saved locally. If this is acceptable, click Accept. Otherwise, click Choose New to select a directory in which to save the schema files as described above.

    For more information on updating the LDAP schema, see Installing and Configuring an LDAP Server.

  22. Specify the iPlanet Calendar Server Administrator. This is the user account that has privileges to use the iPlanet 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.

    The user ID you specify must be a valid user that exists in your LDAP server. For example, if you accept the default calmaster, then the user calmaster must exist in the LDAP directory that is accessed for user authentication. If you are using one directory server for user authentication and another directory server to store user preferences, the user you specify here must exist on both of these LDAP directory servers.

    When you have finished making your selections, click Next to continue.

    Note: If the installation program cannot verify that the user you specified is a valid user, a message box displays and you can either:

    • Click Accept to install iPlanet Calendar Server anyway if this is acceptable at this point.

    • Click Choose New to return Calendar Server Administration window where you can enter different user.

  23. Select the desired values for the following system resource allocations to run iPlanet Calendar Server (Custom Installation only.):

    Maximum sessions (default is 5000)

    Maximum threads (default is 1000)

    Number of server processes (default is the number of CPUs on the machine on which you are installing iPlanet Calendar Server)

  24. Select the options for automatically starting iPlanet 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.

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

  26. When the installation process completes, 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 Exit to end the installation program.



Using the Command Line Installation on Unix

iPlanet Calendar Server provides you the option of running the installation script without using the graphical interface. To run the command line installation program, use the following steps:

  1. Login as root or type su to become root. You must have superuser privileges (that is, be logged in as root) to run the installation program.

  2. Create a directory (such as /tmp/ics5) on the machine that will host the iPlanet Calendar Server and download (or copy) the iPlanet Calendar Server archive file to that directory. Make sure that the download directory has adequate disk space to store the extracted files.

  3. Change to the directory in which you placed 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.


  4. In the installation directory in which you untarred the iPlanet Calendar Server archive file, type: ./setup -nodisplay

The installation program will run in the current window and ask the same configuration questions as described above in steps 5-24 in Using the Graphical Interface Installation on Unix.



Uninstalling the Calendar Server on Unix


To uninstall iPlanet Calendar Server, use the following steps:

  1. Change to the installation server-root/cal directory (such as /opt/SUNWics5/cal).

  2. At the command line, type: ./uninst

    (If you want to run the uninstall program as a command line script, type: ./uninst -nodisplay).

  3. The program displays instructions on how to disable client access control. Press Enter to continue.

  4. The uninstall window appears (graphical interface only). Click Next to continue.

  5. Choose either a Full or a Partial uninstall. The Full uninstall removes both components (iPlanet Calendar Server and iPlanet Calendar Server API). The Partial uninstall lets you choose to uninstall either or both of these components.

  6. Click Uninstall Now (or press Enter if you are using the command line interface) to proceed with the uninstallation.


Previous     Contents     Index          Next     
Copyright © 2000 Sun Microsystems, Inc. Some preexisting portions Copyright © 2000 Netscape Communications Corp. All rights reserved.

Last Updated November 02, 2000