This section discusses known errors or omissions for man pages, documentation, or online help and steps to correct these problems.
This section discusses errors and omissions from the Sun Cluster Geographic Edition man pages.
Problem Summary: If the fence_level parameter is not set to never or async, data replication might not function properly when the secondary site goes down.
Workaround: To avoid application failure on the primary cluster, specify a Fence_level of never or async.
If you have special requirements to use a Fence_level of data or status, consult your Sun representative.
Problem Summary: The geopg man page does not document the upper limit of the timeout property.
Workaround: The timeout property now has a maximum of 1000000 seconds.
Problem Summary: The geopg man page does adequately describe the purpose of the timeout property.
Workaround: The timeout period is the longest time Sun Cluster Geographic Edition waits for a response after a geopg command is executed, such as start, stop, switchover, and takeover. If the command does not respond within the timeout period, Sun Cluster Geographic Edition reports the operation as timed out, even if the underlying command that was executed eventually completes successfully.
The timeout period applies to operations on a per-cluster basis. An operation with a local scope times out if the operation does not complete after the specified timeout period.
An operation with a global scope consists of an action on the local cluster and an action on the remote cluster. The local and remote action are timed separately. So, an operation with a global scope times out if the local operation does not complete after the specified timeout period or if the remote operation does not complete after the specified timeout period.
For example, the following operation is launched with a local scope:
# geopg start -e Local |
If the timeout property is set to 200 seconds, then the geopg start operation times out if the operation does not complete after 200 seconds.
The same operation is launched with a global scope:
# geopg start -e Global |
If the timeout property is set to 200 seconds, then the geopg start operation times out if the operation does not complete on the local cluster after 200 seconds or if the operation does not complete on the remote cluster after 200 seconds. If the local action takes 150 seconds and the remote action takes 150 seconds, the operation does not time out.
The protection group timeout value is estimated. Not every operation on a protection group is timed against the timeout period. For example, the time taken to initialize the data structure and check for the precondition of the operation are not timed in the timeout period.
Problem Summary: The geops incorrectly gives the property for setting the notification email address as Notification_EmailAddrss.
Workaround: The correct property name for the notification email address is Notification_EmailAddrs.
Problem Summary: The default TCP/UDP heartbeat port number is given as 8765 in the man page. However, this port number has been assigned to someone else by the Internet Assigned Numbers Authority (IANA).
Workaround: To avoid any potential conflicts, the TCP/UDP now uses port number 2084 by default.
Problem Summary: The syntax for adding resource group and device groups is not correct in the geopg man page.
Workaround: The correct syntax for adding a resource group is geopg add-resource-group resource-group protection-group-name. The correct syntax for adding a device group is geopg add-device-group device-group protection-group-name.
Problem Summary: The geohb man page contains the following incorrect example in the DESCRIPTION section:
To create a heartbeat plug-in that is named command1, use the following:
# geohb add paris-to-newyork -g command1 -p Query_cmd=/usr/bin/hb/ |
Workaround: The example should read as follows:
To add a custom heartbeat plug-in that is named command1 to the paris-to-newyork heartbeat, use the following:
# geohb add-plugin -p Query_cmd=/usr/bin/hb/ command1 paris-to-newyork |
Problem Summary: The geops udpate command synchronizes information with the partner cluster. The command cannot update a partnership while the cluster is disconnected from the partner cluster.
Workaround: Do not use the geops udpate command to update a partnership while the cluster is disconnected from the partner cluster.
Problem Summary: The characters “ 6 appear randomly in the man pages.
Workaround: Disregard these extra characters.
Problem Summary: The geohb(1M) and the geopg(1M) man pages contain some references to incorrect subcommands in the examples.
Workaround: Always refer to the correct usage information by using the command--help command.
This section discusses errors and omissions from the Sun Cluster Geographic Edition Installation Guide.
Problem Summary: The Sun Cluster Geographic Edition Installation Guide is missing the following requirements:
All nodes of the cluster must have the same default locale.
The How to Enable Sun Cluster Geographic Edition Software in Sun Cluster Geographic Edition Installation Guide procedure requirements should also state that the cluster must be configured for secure cluster communication using security certificates. When the cluster has not be configured for secure cluster communication using security certificates, many Sun Cluster Geographic Edition commands will fail.
Workaround: Ensure that all the nodes of the cluster are running with the same default locale and that the cluster has been configured for secure cluster communication using security certificates before you begin this procedure.
Problem Summary: The How to Install Certificates on Partner Clusters in Sun Cluster Geographic Edition Installation Guide states that you must restart the Common Agent Container on each node of each cluster by using the cacaoadm start command.
Workaround: Use the cacaoadm restart command to restart the Common Agent Container.
This section discusses errors and omissions from the Sun Cluster Geographic Edition System Administration Guide.
Problem Summary: The Sun Cluster Geographic Edition System Administration Guide does not include instructions on troubleshooting.
Workaround: Contact your Sun service representative.
Problem Summary: The Sun Cluster Geographic Edition software supports using Oracle Real Application Clusters with hardware RAID. The documentation does not explain the requirements for creating a protection group that uses Oracle Real Application Clusters.
Workaround: Before you create a protection group for Oracle Real Application Clusters, ensure that the following conditions are met:
The nodelist of the protection group must be the same as the nodelist of Oracle Real Application Clusters framework resource group.
If one cluster is running Oracle Real Application Clusters on a different number of nodes than another cluster, ensure that all nodes on both clusters have the same resource groups defined.
All Oracle Real Application Clusters server resource groups and all Oracle Real Application Clusters listener resource groups must belong to the same protection group.
Problem Summary: The Sun Cluster Geographic Edition System Administration Guide does not accurately describe when the executable command specified by the RoleChange_ActionCmd property is run.
Workaround: The executable command you specify in the RoleChange_ActionCmd property runs on the new primary cluster when the primary cluster for the protection group changes and the protection group is started.
This section discusses errors and omissions from the Sun Cluster Geographic Edition documentation on the product CD.
Problem Summary: The links in main page of the CD are broken.
Workaround: To view the Sun Cluster Geographic Edition documentation, go to the following pages:
HTML version of the documentation:
cd_root/Solaris_sparc/Product/sun_cluster_geo/Solaris_9/\
Packages/SUNWscgdoc/reloc/sun_docs/C/suncluster_3_1_geo/\
SUNWscgdoc/booklist.html
PDF version of the documentation:
cd_root/Solaris_sparc/Product/sun_cluster_geo/Solaris_9/\
Packages/SUNWpscgdoc/reloc/sun_docs/C/suncluster_3_1_geo/\
SUNWpscgdoc/booklist.html