Novell Business Continuity Clustering 1.2 Readme

August 14, 2009

This Readme identifies known issues for Novell® Business Continuity Clustering 1.2 for your Novell Open Enterprise Server (OES) 2 Support Pack 1 (SP1) for Linux* servers that are running Novell Cluster Services™ 1.8.5.

1.0 Downloads

You can download Business Continuity Clustering 1.2 for OES 2 SP1 from the Novell Downloads Web site. BCC supports 32-bit and 64-bit OES 2 SP1 Linux architectures.

In addition, you must download the following products:

2.0 Known Issues

This section identifies known issues for BCC 1.2 for OES 2 SP1 Linux.

2.1 Identity Manager 3.6.1 Is Supported for Use With BCC 1.2

Identity Manager 3.6.1 (released in June 2009) supports the 64-bit version of the OES 2 SP1 Linux operating system. BCC supports using Identity Manager 3.6.1 in a peer cluster. You can upgrade to 3.6.1 on a 32-bit OES 2 SP1 Linux operating system, or re-configure the node with a 64-bit OES 2 SP1 Linux operating system and software.

To upgrade an Identity Manager node to 3.6.1:

  1. Before you upgrade to Identity Manager 3.6.1, save the BCC driver configuration information, then stop the BCC drivers and delete them.

  2. Use one of the following methods to upgrade to Identity Manager 3.6.1:

    • Install 3.6.1 on a 32-bit OES 2 SP1 Linux operating system to upgrade Identity Manager from 3.6 to 3.6.1.

    • Re-install the system with the 64-bit OES 2 SP1 Linux operating system, then install Identity Manager 3.6.1 and iManager 2.7.2 on the system.

  3. Re-create the BCC drivers.

If you uninstall Identity Manager 3.6 before installing 3.6.1 on the 32-bit platform, the Identity Manager uninstall script removes the symbolic link to the BCC ncs_bcc.jar file in the /opt/novell/eDirectory/lib/dirxml/classes/ directory, which causes the error

com.novell.xml.xpath.XPathEvaluationException: function 'bcc:IncrementRevision'
not found 

Re-install the novell-business-continuity-cluster rpm using the --force and --replacepkgs options. This re-creates the symbolic link to the BCC ncs_bcc.jar file.

2.2 Identity Manager 3.6 Node Requires 32-Bit OES 2 SP1 Linux

The Identity Manager 3.6 Bundle Edition requires a 32-bit OES 2 SP1 Linux operating system. In a 64-bit cluster, you must have one node running 32-bit OES 2 SP1 Linux where you will install Identity Manager 3.6.

BCC-enabled cluster resources are not assigned to run on the Identity Manager node in 64-bit cluster because of the architecture difference.

2.3 Multiple-Tree Configurations Are Not Supported

In the BCC 1.2 for Linux release, multiple-tree configurations of business continuity clusters are not supported. All peer clusters must reside in the same tree.

2.4 Do Not Disable BCC for a Resource from Multiple Peer Clusters

If a given BCC enabled resource is disabled for BCC from multiple peer clusters, and is then BCC enabled from one or more peer clusters, the resource can come online as primary in multiple clusters.

If a resource is seen as primary in a peer cluster where you know it should actually be seen as Secondary, execute the cluster resetresources command to force it to reset the status to its proper state.

IMPORTANT:This command changes the state of all resources on this peer cluster to offline and secondary.

2.5 Upgrading the Clusters Plug-In for iManager 2.7.2

The BCC management tool is integrated in an update to the Novell Cluster Services Clusters plug-in for Novell iManager 2.7.2 (the version released with OES 2 SP1) or later. In addition to managing Novell Cluster Services, the Clusters plug-in is used to manage BCC 1.1 SP2 for NetWare 6.5 SP8 (same as OES 2 SP1 NetWare) and BCC 1.2 for OES 2 SP1 Linux.

To use the BCC options in the Clusters role in iManager, the following storage-related plug-ins must be installed:

  • ncsmgmt.npm
  • storagemgmt.npm

The storagemgmt.npm contains code in common with other storage-related plug-ins for OES 2 SP1, including Novell Storage Services, Novell Archive and Version Services, Novell Apple* Filing Protocol (AFP), Novell CIFS, and Novell Distributed File Services. Make sure that you include this common plug-in module when installing any of the others.

IMPORTANT:If you use more than one of these plug-ins, you should install, update, or remove them all at the same time to make sure the common code works for all plug-ins. If you remove only one of the plug-ins, it removes the common code and breaks the remaining installed plug-ins.

These iManager plug-ins support iManager 2.7.2 on all operating systems supported by iManager and iManager Workstation.

These plug-ins are not automatically included with the iManager download. If you want these plug-ins, you must download them separately.

  1. Download the Novell Storage Related Plug-Ins for iManager 2.7.2 with support for BCC from the Novell Downloads Web site.

  2. On the iManager server, if the OES 2 version of the storage-related plug-ins are installed, or if you upgraded this server from OES 2 Linux or NetWare 6.5 SP7, log in to iManager, then uninstall all of the storage-related plug-ins that are currently installed, including storagemgmt.npm.

    This step is necessary for upgrades only if you did not uninstall and reinstall the storage-related plug-ins as part of the upgrade process.

  3. On the server, copy the new plug-ins to the packages folder, and manually overwrite the older version of the plug-ins with the newer version of the plug-ins.

  4. Install all of the storage-related plug-ins, or install only the ones you need plus storagemgmt.npm.

  5. Restart Tomcat.

  6. Restart Apache.

3.0 Documentation

This Readme lists all known issues for BCC 1.2 for Linux. For information about installing and managing BCC, see the BCC 1.2: Administration Guide for Linux.

The latest documentation for BCC is available on the Business Continuity Clustering documentation Web site.

4.0 Additional Information

For information about installing and managing Identity Manager 3.6, see the Identity Manager 3.6 documentation Web site.

For information about Novell iManager 2.7.2, see the iManager 2.7.x documentation Web site.

For information about OES 2 SP1 Linux, see the OES 2 SP1 documentation Web site.

For information about Novell Cluster Services 1.8.5, see the Clustering (High Availability) documentation Web site for OES 2 SP1.

5.0 Documentation Conventions

In this documentation, a greater-than symbol (>) is used to separate actions within a step and items in a cross-reference path.

A trademark symbol (®, ™, etc.) denotes a Novell trademark; an asterisk (*) denotes a third-party trademark