Upgrading the Directory Version on a Directory
To use new features in a given release of CDS, you may need to explicitly update the directory version of a directory. This typically occurs when the servers replicating the directory all have been upgraded to the latest version of software, as older versions will not recognize the new features.
To upgrade the directory version, you need write permission to the directory and you must use the following commands:
dcecp> directory modify directory-name -add {CDS_UpgradeTo <v.n>} -single
dcecp> directory synchronize directory-name
Eventually, all clearinghouses that contain a replica of this directory will detect the presence of the CDS_UpgradeTo attribute and upgrade the CDS_ReplicaVersion attribute on the appropriate replica. You can also use the following command on all clearinghouses that are replicating the directory:
dcecp> clearinghouse verify clearinghouse-name
This command forces the server background thread to run, thereby freeing you to perform other tasks until the job finishes. After you have verified all affected clearinghouses, you will need to perform another skulk of the directory to finally set the CSA_DirectoryVersion attribute to the appropriate value. The CDS_DirectoryVersion attribute is not upgraded until all of the CDS_ReplicaVersion attribute values of all replicas contain the new value.