Previous     Contents     Index          Next     
iPlanet Calendar Server Installation Guide



Chapter 3   Installing iPlanet Calendar Server on Windows NT


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



Using the Graphical Interface Installation on Windows NT

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

  1. Login as Administrator. You must have superuser privileges (that is, be logged in with full administration rights to the system) to run the installation program.

  2. Create a directory (such as c:\temp\ics5) on the machine that will host the iPlanet Calendar Server and download or copy the self-extracting archive file (such as ics5_0-export-en.x86-windows-nt4.0.exe) to that directory. Ensure that the download directory has adequate disk space to store the extracted files.

    Note: If the archive file is compressed (such as in zip format), you will first need to uncompress it.

  3. In the directory where you placed the archive file, double-click the self-extracting iPlanet Calendar Server archive file.

  4. A message box displays and asks if you want to install iPlanet Calendar Server. Click Yes to continue.

  5. The installation program performs the self extraction process and then displays a Welcome Message. Click Next to continue.

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

  7. 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. If this occurs, 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:

    • 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 domain name. In this case, you can edit the ics.conf file after you complete the installation and supply a valid host name and domain name. The ics.conf file is located in the server-root/cal/bin/config directory (for example, c:/Program Files/iPlanet/CalendarServer5/cal/bin/config).

    • Click Choose New to enter another host name or 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 selection, 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 document and you can proceed to the next step.

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

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

    • Calendar Server API - an application programming interface that enables third party application developers to add functionality to iPlanet Calendar Server 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 detects 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 c:\Program Files\iPlanet

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

    • Click Create Directory to 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 and confirm the password of the user that iPlanet Calendar Server will run as. The installation program assumes this identity is the user and password that is currently logged in to the system and it cannot be changed while you run the installation program. This user must have full administration rights to this system.

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

    Note: The installation program will warn you if it cannot verify that this identity has the account privileges required to manage the Calendar Server services on this system. If this is acceptable at this point, click Accept. Otherwise, click Choose New and supply another password.

  15. 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 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 installation program cannot connect to the SMTP server you entered, a message box will display stating that iPlanet Calendar Server will not run successfully 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. The default is:

    c:\Program Files\iPlanet\CalendarServer5\var\csdb

    If you want to select another directory, type it in or click Browse to select a directory, then 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 install the 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.

    Note: The installation program displays a warning message if you selected a directory located on a drive partition that is not formatted as NTFS (NT File System). It is recommended that, for improved performance, you choose an NTFS-formatted drive in which to install iPlanet Calendar Server database files.

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

    c:\Program Files\iPlanet\CalendarServer5\var\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.

    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 (Custom Installation only — 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, 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.

    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 selection, 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 250)

    • 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 Windows NT

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 Administrator. You must have superuser privileges (that is, be logged in with full administration rights to the system) to run the installation program.

  2. Create a directory (such as c:\temp\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. Open a command prompt and change to the directory in which you placed the iPlanet Calendar Server archive file. For example:

    cd \temp\ics5

  4. Type the name of the iPlanet Calendar Server archive file followed by the argument -nodisplay. For example:

    ics5.0-export-en.x86-windows-nt4.0 -nodisplay

  5. After the installation program extracts the compressed installation files, read the instructions and then press Enter to continue.

The installation program then asks the same configuration questions as described above in Using the Graphical Interface Installation on Windows NT.



Uninstalling the Calendar Server on Windows NT


To uninstall iPlanet Calendar Server, use the following steps:

  1. From the Start menu, choose Settings and then Control Panel.

  2. Choose Add Remove Programs.

  3. From the list of products, select iPlanet Calendar Server and click Add/Remove.

  4. Click Yes if you want to uninstall the product at this time.

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

  6. Click Uninstall Now 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