Sun logo      Previous      Contents      Index      Next     

Sun ONE Calendar Server 6.0 Installation Guide for Solaris Operating Systems

Appendix C  
Calendar Server 5.x to 6.0 Upgrade/Migration Process

This appendix describes how to upgrade/migrate Sun™ ONE or iPlanet™ Calendar Server 5.x to Calendar Server  6.0, including:


Upgrade/Migration Process

To upgrade to Calendar Server  6.0:

  1. On the server where Calendar Server 5.x is installed, change to the /opt/SUNWics5/cal/sbin directory and stop Calendar Server 5.x:
  2. ./stop-cal

  3. Backup the following Calendar Server 5.x directories and files:
    • Calendar database directory–Default location is:
    • Calendar Server logs directory–Default location is:
    • ics.conf configuration file–Default is:
  4. Backup any Calendar Server 5.x files that you have customized, including:
    • User interface (UI) XSL files in /opt/SUNWics5/cal/bin/data
    • Mail formatting files–Default location is:
    • default.html file–Default location is:
    • HTML files–For example, in:
    • Time-zone files such as timezones.ics and change_timezone.xml.
    • The language directory includes the files for the language you are using. For example, en–English, de–German, es–Spanish, fr–French, ja–Japanese, zh-TW–Traditional Chinese, or zh-CN–Simplified Chinese.

  5. Change to the /opt/SUNWics5/cal/ directory and uninstall Calendar Server 5.x. You must be running as superuser (root). For example:
  6. ./uninst

  7. Remove all files under the /opt/SUNWics5 directory.
  8. Run the Java Enterprise System installer to install Calendar Server 6.0 in the /opt/SUNWics5 directory. For information, refer to the Sun Java Enterprise System Installation Guide.
  9. Change to the /opt/SUNWics5/cal/sbin directory and run the utility to configure your Sun ONE Directory Server 5.x to work with Calendar Server 6.0. For information about comm_dssetup, refer to the "Directory Server Setup Script (".
  10. Run the Calendar Server 6.0 configuration program ( to create a new ics.conf configuration file. For more information, refer to "Calendar Server Configuration Program ("
  11. If you want to keep your 5.x configuration, copy the ics.conf file from your backup location or tape to the /etc/opt/SUNWics5/config/ics.conf file.
  12. Set the UNIX user and group IDs (default is icsuser and icsgroup) and permissions for the ics.conf file. For example:
  13. chown icsuser:icsgroup /opt/SUNWics5/cal/config/ics.conf
    chmod 600 /opt/SUNWics5/cal/config/ics.conf

  14. Run the cs5migrate utility to migrate your Calendar Server 5.x database to 6.0. For information, refer to the "cs5migrate Utility".
  15. If the cs5migrate migration is successful, copy the migrated 6.0 database to the /var/opt/SUNWics5/csdb directory. Make sure that the owner of all files in the /csdb directory is icsuser and icsgroup (or the user ID and group ID you have specified in the ics.conf file).
  16. The Calendar Server 6.0 XSL. XML, HTML, and mail formatting files have significant changes from the 5.x release. If you saved the 5.x files in Step 3, you must manually merge your customization changes from the 5.x files to the 6.0 files. For tips for merging changes into XSL files, see "XSL Tips".
  17. Change to the /opt/SUNWics5/cal/sbin directory and start Calendar Server 6.0:
  18. ./start-cal

  19. Login to Calendar Server 6.0 using Calendar Express and make sure that you are able to view the Calendar Server components (events and todos).


XSL Tips

If you are merging changes into the Calendar Server 6.0 XSL files, follow these tips and guidelines to avoid common mistakes:

Previous      Contents      Index      Next     

Copyright 2003 Sun Microsystems, Inc. All rights reserved.