Netscape Calendar Server 4.0 - README

Netscape Calendar Server 4.0

This file was last updated on March 8, 2000

Thank you for choosing Netscape Calendar Server. This file contains installation instructions only. Please see the Netscape Calendar Server Administrator's Guide for information about administering your Netscape Calendar Server. Please see the release notes for a description of new features and known problems, and other information about this release.

A web browser, such as Netscape Navigator , is required to install and administer the Calendar Server. A calendar client is required to access the Netscape Calendar Server. Netscape Calendar, a component of Netscape Communicator with Enterprise Calendaring , is used as a calendar client. An LDAP directory server, such as Netscape Directory Server,  is required. An SMTP messaging server, such as Netscape Messaging Server, is required for mail notification of calendar entries.

This version of Netscape Calendar Server is available for Windows NT 4.0 (Service Pack 4), Solaris 2.5.1/2.6, HPUX 10.20/11.0 and AIX 4.21/4.32

NOTE: Under Solaris 2.5.1, in order to run the Administration Server component of Calendar Server, you will need the libresolv.so.2 library, which is part of Sun patch #103663. To obtain this patch from the Sun website, click here.

Contents of this README file

How to report problems

Search the available resources at Netscape Business Technical Support or post problems or questions to the Netscape Calendar user group snews://secnews.netscape.com/netscape.server.calendar.

How to get more information

For complete instructions on deploying, configuring, and administering your Calendar Server, consult the Administrator's Guide. An on-line version of the Administrator's Guide is provided with the Calendar Server software under <Netscape Server root>/manual/calendar/cs. Click the Help button on any Calendar Server or Administration Server form to access the on-line help. Search our on-line database for answers to your questions or view the release notes for a description of new features and known problems of this release.

Before installing Calendar Server

Before you install the Calendar Server, ensure that: NOTE:  Refer to Chapter 1 "Deployment and Installation" and Appendices A "Disk Space and Memory" and B "Sizing Guidelines" in the Administrator's Guide for more detailed instructions on estimating the anticipated calendar usage within your organization.

During installation of Netscape Directory Server 3.x:

During installation of Netscape Directory Server 4.x: NOTE: Under UNIX, the Calendar Server must run as the root or unison user. If you install Calendar Server in the same server root as other SuiteSpot servers, all the SuiteSpot servers must be run as the same user.

Installing Calendar Server -- UNIX

Clean (first time) Install

1. Preparing for installation:
  1. Login as root
  2. Create a group account called dxoffice with an ID of less than 60000
  3. Create a user account called unison with an ID of less than 60000 in the group dxoffice
  4. Edit /etc/services to include the following entries:
      unieng 5730/tcp
      unisnc 5731/tcp
      unidas 5732/tcp

2. Running the installation script:

3. Creating the Calendar Server instance:
  1. Use a web browser to open URL  <calendar server host>:<calendar server administration port>
      2. NOTE: If you cannot connect to the Administration Server, ensure that the Hosts and Addresses entries in <Netscape SuiteSpot root>/admin-serv/config/ns-admin.conf includes the host and address you are connecting from. If you change these parameters, stop and start the Administration Server using <Netscape SuiteSpot root>/start-admin and <Netscape SuiteSpot root>/stop-admin.
  2. Click Create New Netscape Calendar Server 4.0
  3. Use defaults except as noted below:
  4. Click Submit
  5. Monitor the status display for error messages
4. Adding users to the Calendar Server: A Netscape Calendar client can now connect to this Netscape Calendar Server.

Installing Calendar Server -- Windows NT

Note: Calendar server can be installed on either an NTFS or FAT partition.

Clean (first time) Install

  1. Run a40eiu.exe
  2. Follow the InstallShield instructions
  3. Follow the instructions under Adding users to the Calendar Server

Upgrade/Migration from Calendar Server 3.5x (UNIX/NT)

A note about Netscape Calendar Server  - As the contract with our NCS supplier has been abruptly terminated,  the Alliance is legally unable to sell the NCS product family, including additional seats. To our existing NCS 3.5 customers with a valid maintenance subscription, you can still upgrade to NCS 4.0 without additional cost. This upgrade does not include any additional seats.
Please contact technical support for information on getting this upgrade.
To find the alternative solution and more information about Enterprise Calendaring and Netscape Calendar Server click here.

Once you complete the upgrade from Calendar Server 3.5 to 4.0, review the parameters (preserved from the 3.5 installation) in the /users/unison/misc/unison.ini file to ensure that the settings are correct.

UNIX Upgrade (from Netscape Calendar Server 3.5x)

If you are already using Calendar Server 3.5, follow the instructions in this section before installing Calendar Server 4.0. Ignore the Migrate from previous version link on the Administration Server page.
  1. Back up the LDAP directory.
  2. Stop and back up each Calendar Server. Ensure that the backup has a unique file name and is not saved under the Calendar Server root.
  3. On the Calendar Server that is to be migrated:
    1. Stop the Administration Server.
    2. Run ns-setup
    3. Ensure that the Calendar Server backup is not in the /users/unison directory
    4. Install Calendar Server 4.0 with the following directions (see installation instruction) and caveats:
  4. Start the Calendar Server
Note: If you abort once the /users/unison directory has been backed up, you must untar the archived directory and relink to /users/unison before attempting the migration procedure again.

NT Upgrade (from Netscape Calendar Server 3.51)

Before migrating from CS 3.51 on NT, with an existing configuration of more than 9 nodes on a single server, migrate the number of nodes over 9 to another 3.51 server.  Calendar 4.0 does not support more than 9 nodes on a server, on the NT platform.  See the release notes and this Technical Note for more information.
  1. Run a40eiu.exe
  2. Follow the InstallShield instructions


Uninstalling Calendar Server -- UNIX

  1. Stop the Calendar Server.
    1. Using your web browser, open URL: <calendar server host>:<calendar server administration port>
    2. Select Server Preferences | Server On/Off from the Calendar Server Manager
    3. Click Stop Server
    4. If your server does not stop, execute unistop
  2. Remove all calendar objects and attributes in the Directory Server
  3. Remove the Administration Server if you are not sharing the Administration Server with other SuiteSpot servers
    1. Return to the Netscape Server Administration Page
    2. Select Admin Preferences | Shut Down and click on Shut down the administration server!
    3. If your server does not stop, use the kill command against all the "ns" daemons that are running your Calendar Server
  4. Remove the Calendar Server. If you are sharing the Administration Server with other SuiteSpot servers, follow these steps to remove Calendar Server specific information:
  5. Remove the /users directory
  6. Remove the unison user account
  7. Remove the dxoffice group account
  8. Remove the unieng, unisnc, and unidas entries from /etc/services

Uninstalling Calendar Server -- Windows NT

  1. Stop the Calendar Server
    1. Using your web browser, open URL: <calendar server host>:<calendar server administration port>
    2. Select Server Preferences | Server On/Off from the Calendar Server Manager
    3. Click Stop Server
    4. If your server does not stop, refer to the Administrator's Guide for how to use unistop or use Control Panel | Services to stop all the calendar services
  2. Remove all calendar objects and attributes in the Directory Server
    1. Using ldapsearch and ldapmodify, remove all nsCalUser attributes from the users that were in this Calendar Server
    2. Using ldapsearch and ldapmodify, remove the nsCalAdmin members for the calendar nodes that were in this Calendar Server, from the Calendar Server Admins group. If this is the last member of this group, also remove this group and the associated aci object for this group.
    3. Using ldapsearch and ldapmodify, remove all nsCalAdmin objects for the calendar nodes that were in this Calendar Server
    4. Refer to the Netscape Directory Server Administrator's Guide for information on how to use these LDAP tools
  3. Remove the Administration Server if you are not sharing the Administration Server with other SuiteSpot servers
    1. Return to the Netscape Server Administration Page
    2. Select Admin Preferences | Shut Down and click Shut down the administration server!
    3. If your server does not stop, use Control Panel | Services to stop the Administration Server
    4. Run <calendar server path>\uninst.exe
  4. Remove the Calendar Server. If you are sharing the Administration Server with other SuiteSpot servers, follow these steps to remove Calendar Server specific information:
    1. Remove <calendar server path>\admin-serv\config\dsgw-calendar.conf
    2. Remove <calendar server path>\admin-serv\config\dsgw-calendar-defs.conf
    3. Remove <calendar server path>\bin\admin\admin\bin\addcaluser.exe
    4. Remove <calendar server path>\bin\admin\admin\html\display-cal-resource.html
    5. Remove <calendar server path>\bin\admin\admin\html\display-cal-user.html
    6. Remove <calendar server path>\bin\admin\admin\html\dscrresource.html
    7. Remove <calendar server path>\bin\admin\admin\html\dslsresource.html
    8. Remove <calendar server path>\bin\admin\admin\html\list-Resource.html
    9. Remove <calendar server path>\bin\calendar
    10. Remove <calendar server path>\calendar-<host>
    11. Remove <calendar server path>\manual\calendar
    12. In <calendar server path>\admin-serv\config\dsgw.conf, remove the line include dsgw-calendar.conf
    13. In <calendar server path>\admin-serv\config\dsgwfilter.conf, remove the "dsgw-resource" section
    14. In <calendar server path>\admin-serv\config\dsgwsearchprefs.conf, remove the Resource section
    15. In <calendar server path>\admin-serv\config\servers.lst, remove the line calendar:Netscape Calendar Server
    16. Select Control Panel | Add/Remove Programs | Netscape Calendar Server 4.0
  5. Remove the \users directory
  6. Using regedit, find and remove HKEY_LOCAL_MACHINE/SOFTWARE/NETSCAPE/CALENDAR SERVER
  7. Using regedit, find and remove the unicwsd, uniengd, unilckd, unisncd, and unidasd entries under HKEY_LOCAL_MACHINE/SYSTEM/CURRENT CONTROL SET/SERVICES.
  8. Reboot the machine

Troubleshooting

Disabling anonymous binds

If you chose to disable anonymous binds during installation of your Calendar Server, you must manually enter a value in the /users/unison/misc/unison.ini, in UTF-8 format, for the binddn parameter. To complete this step:

  1. Run /users/unison/bin/unistrconv with no arguments/options to determine the current terminal character set
  2. Run ./unistrconv -from <current terminal character set> <binddn value> to convert your binddn value to UTF-8
  3. Copy and paste the value output in step #2 to the [LDAP] section of the /users/unison/misc/unison.ini file. The completed entry should follow the format "binddn = <binddn value output in step #2>"

Finding Documentation


You can use your web browser to examine the documentation for this  release of the directory server.  The following manuals and release notes are available at the following locations:
 

http://developer.iplanet.com/docs/manuals/calendar.html#40
http://developer.iplanet.com/docs/manuals/calendar.html#40