Sun Java Communications Suite 5 Upgrade Guide |
Chapter 5
Upgrading Calendar ServerThis chapter describes how to upgrade previous versions of Calendar Server to Sun Java System Calendar Server 6.3. The chapter provides an overview of upgrade considerations for the different upgrade paths. The chapter covers upgrades on both the Solaris and Linux operating systems:
Overview of Calendar Server UpgradesThis section describes the following general aspects of Calendar Server that impact upgrading to Communications Suite 5:
About Calendar Server 6.3
This version of Calendar Server represents a minor release with respect to Calendar Server 6.2 (Java Enterprise System 2005Q4). It includes several new features such as support for attachments and LDAP groups, but no major functionality changes.
Calendar Server, however, has an private interface change that affects upgrade: the format for data in the Calendar Server store has changed to a new format.
Calendar Server Upgrade Roadmap
Table 5-1 shows the supported Calendar Server upgrade paths to Communications Suite 5. The table applies to both Solaris and Linux operating systems.
Calendar Server Data
The following table shows the type of data that could be impacted by an upgrade of Calendar Server software.
Calendar Server Upgrade Strategy
Your strategy for upgrading Calendar Server depends on the many considerations discussed in Chapter 1, "Planning for Upgrades": upgrade path, dependencies between Communications Suite components, selective upgrade versus upgrade all, multi-instance deployments, and so forth.
This section is to particularize that general discussion to Calendar Server by presenting issues that might influence your Calendar Server upgrade plan.
Compatibility Issues
Calendar Server 6.3 does not introduce any changes in public interfaces, and is therefore backwardly compatible with Calendar Server 6.2 (Java Enterprise System 2005Q4), however the format of data in the Calendar Server Store has changed in this release, impacting the upgrade procedure.
Calendar Server Dependencies
Calendar Server dependencies on other Communications Suite components can impact the procedure for upgrading and re-configuring Calendar Server software. Changes in Calendar Server interfaces or functions, for example, could require upgraded version of components upon which Calendar Server depends. The need to upgrade such components depends upon the specific upgrade path.
Calendar Server has dependencies on the following Communications Suite components:
- Shared components. Calendar Server has dependencies on specific Communications Suite shared components (see Table 1-6).
- Directory Server. Calendar Server accesses user data stored in Directory Server. As a result, Calendar Server upgrades might require extensions of directory schema.
- Directory Preparation Tool. Calendar Server uses the Directory Preparation Tool to prepare the directory to support Calendar Server functions.
- Access Manager (optional). For software solutions that support single user sign-on for web-based services, Calendar Server can be configured to use Access Manager single sign-on capability.
- Messaging Server (optional). Calendar Server can be configured to use Messaging Server to provide messaging notifications of calendar events.
- Delegated Administrator (optional). Delegated Administrator is the preferred utility to use for provisioning users in Directory Server so that Calendar Server has access to the user data needed to provide calendar services.
Upgrading Calendar Server from Calendar Server 6.2 (Java Enterprise System 2005Q4)This section includes information about upgrading Calendar Server from Calendar Server 6.2 (Java Enterprise System 2005Q4). The section covers the following topics:
Introduction
When upgrading to Calendar 6.3, consider the following aspects of the upgrade process:
- General Upgrade Approach. The upgrade is performed by applying patches to the 6.2 (Java Enterprise System 2005Q4) version and then using a migration utility to migrate the Calendar Server database to a new data format.
- Upgrade Dependencies. Calendar Server has dependencies on a number of Communications Suite shared components (see Table 1-6); these are hard upgrade dependencies, therefore, these shared components are required to be upgraded.
In addition, Calendar Server is dependent upon Directory Server and optionally dependent on Access Manager, as described in Calendar Server Dependencies. These are soft upgrade dependencies; upgrade of these components is optional with respect to upgrade of Calendar Server to 6.3.
However, Calendar Server has a hard upgrade dependency on Directory Preparation Tool; Directory Preparation Tool is required to prepare Directory Server for calendaring operations.
- Backward Compatibility. Calendar Server is backwardly compatible with Calendar Server 6.2 (Java Enterprise System 2005Q4) version, even though the format of Calendar Server data has changed.
- Upgrade Rollback. Rollback of the upgrade of Calendar Server to Calendar Server 6.2 (Java Enterprise System 2005Q4) is achieved by removing the patches applied during the upgrade and restoring the Calendar Server 6.2 (Java Enterprise System 2005Q4) database.
- Platform Issues. The general approach for upgrading Calendar Server is the same on both Solaris and Linux operating systems, however the patching technologies are different. The upgrade process therefore includes platform-specific procedures.
Calendar Server 6.2 (Java Enterprise System 2005Q4) Upgrade
This section describes how to perform an upgrade of Calendar Server from Calendar Server 6.2 (Java Enterprise System 2005Q4) to Calendar Server 6.3 on both the Solaris and Linux platform. Where a topic depends on platform-specific procedures, the topic will indicate the operating system to which it applies. The section covers the following topics:
Pre-Upgrade Tasks
Before you upgrade Calendar Server you should perform the tasks described below.
Verify Current Version Information
You can verify the current version of Calendar Server using the following command:
Note: If the cscal command fails on the Solaris 10 platform, set the library path to null when running the command:
Upgrade Calendar Server Dependencies
It is generally recommended that all Communications Suite components on a computer system (and in a computing environment) be upgraded to Communications Suite 5. However, Calendar Server has a hard upgrade dependency only on Directory Preparation Tool. Upgrading of other Calendar Server 6.2 (Java Enterprise System 2005Q4) product components upon which Calendar Server depends is therefore optional.
However, if you choose to upgrade all Calendar Server dependencies, they should be upgraded in the following order, all before you upgrade Calendar Server. You can skip any that might already have been upgraded.
- Shared Components. Instructions for upgrading Communications Suite shared components are provided in Chapter 2, "Upgrading Communications Suite Shared Components".
- Directory Server. Instructions for upgrading Directory Server are provided in the Java Enterprise System Upgrade Guide.
- Access Manager (optional). Instructions for upgrading Access Manager are provided in the Java Enterprise System Upgrade Guide.
- Directory Preparation Tool. Directory Preparation Tool needs to have been run against Directory Server before configuring Calendar Server. If Directory Preparation Tool has not already been run against Directory Server, upgrade Directory Preparation Tool to 5 and use it to modify and extend the schema of Directory Server. See the Chapter 3, "Directory Preparation Tool" for procedures.
- Messaging Server (optional). Instructions for upgrading Messaging Server are provided in Chapter 4, "Upgrading Messaging Server".
Back Up Calendar Server Data
The Calendar Server upgrade to 6.3 involves a change in Calendar Server data format requiring 2005Q4 data to be migrated to the 6.3 format. As a safety precaution, you should shut down Calendar Server and back up your Calendar Server store, located at:
/var/cal-svr-base/csdb
Obtain Required Configuration Information and Passwords
No special information about your currently installed version is needed. However you will have to log in as superuser to perform the upgrade.
Upgrading Calendar Server 6.2 (2005Q4 - Solaris)
This section discusses considerations that impact the upgrade procedure for Calendar Server followed by a description of the procedure itself.
Upgrade Considerations (Solaris)
The upgrade of Calendar Server software to Communications Suite 5 takes into account the following considerations:
- Calendar Server should be shut down when patches are being applied to the installed image.
- In architectures in which different Calendar Server subcomponents reside on different computers, for example Calendar Server back-end store on one computer, and Calendar Server front-end processes (such as cshttpd) on another, the upgrade must be performed on all such computers.
- The Calendar Server upgrade applies to multiple subcomponents of Calendar Server on one computer using the same installed image.
- The Calendar Server upgrade patches for Solaris OS are shown in the following table:
Table 5-4 Patches1 to Upgrade Calendar Server on Solaris
Description
SPARC
Solaris 9 & 10
X86
Solaris 9 & 10
Calendar Server core
121657-17
121658-17
Calendar Server localization
117010-26
117011-26
1Patch revision numbers are the minimum required for upgrade to Communications Suite 5. If newer revisions become available, use the newer ones instead of those shown in the table.
Upgrade Procedure (Solaris)
The procedure documented below applies to Calendar Server on the computer where the upgrade is taking place.
- Obtain the required patches, based on Table 5-4.
Patches can be downloaded to /tmp from: http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access
- Log in as root or become superuser.
su -
- Stop Calendar Server if it is running.
cal-svr-base/cal/sbin/stop-cal
- If you have not already done so, upgrade shared component to Communications Suite 5.
See Upgrade Calendar Server Dependencies.
- Apply the appropriate Calendar Server core and, if needed, localization patches in Table 5-4, in that order.
patchadd patch_ID
- Confirm that the patch upgrades were successful:
showrev -p | grep ics
The output should return the versions of patch IDs applied in Step 5.
- Re-configure Calendar Server.
cd cal-svr-base/sbin
./csconfigurator.sh -noconsole -nodisplay -novalidateThe -noconsole -nodisplay -novalidate arguments pick up the existing Calendar Server 6.2 (Java Enterprise System 2005Q4) configuration values and perform the necessary re-configuration.
If the Calendar Server 6.2 (Java Enterprise System 2005Q4) installation had been configured in non-hosted domain (legacy) mode, then the configurator gives the choice to either stay in that mode or switch to hosted domain mode, the default for Calendar Server 6.3. Switching to hosted domain mode is not reversible.
The csconfigurator command is documented in the Calendar Server Administration Guide, http://docs.sun.com/doc/819-2433/6n4nlfjk2?a=view.
- Move Calendar Server data files to a temporary location.
mkdir /var/cal-svr-base/old_csdb
mv /var/cal-svr-base/csdb/* /var/cal-svr-base/old_csdbwhere old_csdb is a temporary location.
- Change permissions on the temporary location.
chown -R icsuser:icsgroup /var/cal-svr-base/oldcsdb
- Migrate the Calendar Server 6.2 (Java Enterprise System 2005Q4) data using the csmigrate migration tool.
cd cal-svr-base/cal/sbin
./csmigrate -l max /var/cal-svr-base/old_csddb /var/cal-svr-base/csdbThe general syntax for csmigrate is as follows:
csmigrate [-q] [-d] [-l min|max] [-b backup_dir] source_dbdir target_dbdir
Command options and operands are documented in the following table.
If you choose an arbitrary target_dbdir rather than /var/cal-svr-base/csdb, then you have to change the value of the caldb.berkeleydb.homedir.path property in the Calendar Server configuration file to point to that location.
Note: If the csmigrate command fails on the Solaris 10 platform, set the library path to null when running the command:
LD_LIBRARY_PATH= ./csmigrate ...
- Restart the Calendar Server that was stopped in Step 3.
cal-svr-base/cal/sbin/start-cal
Upgrading Calendar Server 6.2 (2005Q4 - Linux)
This section discusses considerations that impact the upgrade procedure for Calendar Server followed by a description of the procedure itself.
Upgrade Considerations (Linux)
The upgrade of Calendar Server software on the Linux platform takes into account the same considerations as on the Solaris platform (see Upgrade Considerations (Solaris)), except that the Linux upgrade patches differ from the Solaris patches.
The Calendar Server upgrade patches for Linux OS are shown in the following table:
Table 5-6 Patches1 to Upgrade Calendar Server on Linux
Description
Patch ID and RPM names
Calendar Server core
121659-17
Calendar Server localization
117852-26
1Patch revision numbers are the minimum required for upgrade to Communications Suite 5. If newer revisions become available, use the newer ones instead of those shown in the table.
Upgrade Procedure (Linux)
The procedure documented below applies to Calendar Server on the computer where the upgrade is taking place.
Caution
An upgrade from Calendar Server 6.2 (Java Enterprise System 2005Q4) Calendar Server 6.3 5 on Linux cannot be rolled back.
- Obtain the required patches using the patch numbers and RPM names from Table 5-6. Use this information to obtain the version numbers for the RPM.
Patches can be downloaded to /tmp from: http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access
- Log in as root or become superuser.
su -
- Stop Calendar Server if it is running.
cal-svr-base/sbin/stop-cal
- If you have not already done so, synchronize all shared component to Release 5.
See Upgrade Calendar Server Dependencies.
- Apply the core and, if needed, localization RPMs for Calendar Server in Table 5-6, in that order.
rpm -Fvh sun-calendar-core-6.2-10.7.i386.rpm
rpm -Fvh sun-calendar-api-6.2-10.7.i386.rpm
rpm -Fvh sun-calendar-core-l10n-6.2-10.3.i386.rpm- Confirm that the patch upgrades were successful:
rpm -qa | grep sun-calendar
The new version numbers of the RPMs in Step 5 should be returned.
- Re-configure Calendar Server.
cd cal-svr-base/sbin
./csconfigurator.sh -noconsole -nodisplay -novalidateThe -noconsole -nodisplay -novalidate arguments pick up the existing Calendar Server 6.2 (Java Enterprise System 2005Q4) configuration values and perform the necessary reconfiguration.
If the Calendar Server 6.2 (Java Enterprise System 2005Q4) Calendar Server installation had been configured in non-hosted domain (legacy) mode, then the configurator gives the choice to either stay in that mode or switch to hosted domain mode, the default for 6.3. Switching to hosted domain mode is not reversible.
The csconfigurator command is documented in the Calendar Server Administration Guide, http://docs.sun.com/doc/819-2433/6n4nlfjk2?a=view.
- Move Calendar Server data files to a temporary location.
mkdir /var/cal-svr-base/oldcsdb
mv /var/cal-svr-base/csdb/* /var/cal-svr-base/oldcsdbwhere oldcsdb is a temporary location.
- Change permissions on the temporary location.
chown -R icsuser:icsgroup //var/cal-svr-base/oldcsdb
- Migrate the Calendar Server 6.2 (Java Enterprise System 2005Q4) data using the csmigrate migration tool.
cd cal-svr-base/sbin
./csmigrate -l max /var/cal-svr-base/old_csddb /var/cal-svr-base/csdbThe general syntax for csmigrate is as follows:
csmigrate [-q] [-d] [-l min|max] [-b backup_dir] source_dbdir target_dbdir
Command options and operands are documented in the following table.
If you choose an arbitrary target_dbdir rather than /var/cal-svr-base/csdb, then you have to change the value of the caldb.berkeleydb.homedir.path property in the Calendar Server configuration file to point to that location.
- Restart the Calendar Server that was stopped in Step 3.
cal-svr-base/sbin/start-cal
Verifying the Upgrade
You can verify the upgrade of Calendar Server by checking the version numbers of patches as described in Step 6 for Solaris platforms and Step 6 for Linux.
You can also use the following commands:
Solaris:
cal-svr-base/cal/sbin/cscal versionLinux:
cal-svr-base/sbin/cscal versionSee Table 5-3 for version values.
Post-Upgrade Tasks
There are no post-upgrade tasks beyond the steps described in Upgrade Procedure (Solaris) and Upgrade Procedure (Linux).
Rolling Back the Upgrade (Solaris)
This section describes considerations that impact the upgrade rollback procedure for Calendar Server followed by the procedure itself.
Rollback Considerations (Solaris)
The procedure for rolling back the upgrade to 6.3 of Calendar Server is pretty much the reverse of the procedure for upgrading to 6.3.
Rollback Procedure (Solaris)
- Log in as root or become superuser.
su -
- Stop Calendar Server.
cal-svr-base/cal/sbin/stop-cal
- Remove the patches in Table 5-4.
patchrm patch_ID
- Revert to the Calendar Server 6.2 (Java Enterprise System 2005Q4) database.
Any new data added since the upgrade to 6.3 will be lost.
- Restart Calendar Server.
cal-svr-base/cal/sbin/start-cal
Multiple Instance Upgrades
In some deployment architectures Calendar Server is deployed on multiple computer systems to provide for high availability. For example, you have the Calendar Server Store component running in a Sun Cluster environment to provide high availability.
For Calendar Server instances running in a cluster environment, those instances share the same configuration. You need to apply Calendar Server upgrade patches to each of the instances, and for a Calendar Server 6.2 (Java Enterprise System 2005Q4) to 6.3 upgrade there is no re-configuration required.
Upgrading Calendar Server from Calendar Server 6 (Java Enterprise System 2005Q1)The procedure for upgrading Calendar Server 6 (Java Enterprise System 2005Q1) to 6.3 is the same as that for upgrading Calendar Server 6.2 (Java Enterprise System 2005Q4) to 6.3.
To upgrade Calendar Server 6 (Java Enterprise System 2005Q1) to 6.3, use the instructions in Upgrading Calendar Server from Calendar Server 6.2 (Java Enterprise System 2005Q4), except substitute Calendar Server 6 (Java Enterprise System 2005Q1) wherever 2005Q4 is referenced.
Upgrading from Calendar Server 6 (Java Enterprise System 2004Q2)The procedure for upgrading Calendar Server 6 (Java Enterprise System 2004Q2) to 6.3 is very similar to that for upgrading Calendar Server 6.2 to 6.3, with the exception that the pre-upgrade tasks must include the synchronizing of all shared components (see Table 1-6) to 6.3 and upgrading all locally-resident product components upon which Calendar Server depends:
- Shared Components. Instructions for updating Communications Suite shared components to 5 are provided in Chapter 2, "Upgrading Communications Suite Shared Components".
- Directory Server. Directory Server rarely resides on the same computer as Messaging Server, however, instructions for upgrading Directory Server are provided in the Java Enterprise System Upgrade Guide.
- Access Manager (optional). Instructions for upgrading Access Manager are provided in the Java Enterprise System Upgrade Guide.
- Directory Preparation Tool. Directory Preparation Tool rarely resides on the same computer as Messaging Server, however, instructions for upgrading Directory Preparation Tool and running it against Directory Server are provided in the Chapter 3, "Directory Preparation Tool."
To upgrade Calendar Server 6 (Java Enterprise System 2004Q2 Calendar Server to 6.3, use the instructions in Upgrading Calendar Server from Calendar Server 6.2 (Java Enterprise System 2005Q4), except substitute 2004Q2 wherever Calendar Server 6.2 (Java Enterprise System 2005Q4) is referenced.
In addition, Calendar Server 6.2 (Java Enterprise System 2005Q4) to Calendar Server 6.3 upgrade requires the post-upgrade task of configuring Calendar Server hot backup, accomplished by adding hotbackup parameters to the Calendar Server ics.conf configuration file. The instructions for this post-upgrade re-configuration can be found at the following location: http://docs.sun.com/doc/819-2433/6n4nlfjnq?a=view