15.9 Renaming a Shared Volume in a DST Cluster Resource

The DST cluster resource is a pool cluster resource for the primary pool that has been modified to manage both the primary pool and secondary pool. Renaming a volume changes the Volume object name, updates the volume information for the pool, and updates the volume name in its pool’s resource scripts. However, a volume rename for a secondary volume cannot also update the scripts for the primary pool’s resource because its default Pool object and Volume object do not contain information about the primary pool. You must manually modify the scripts for the DST cluster resource after you rename a secondary volume.

When you rename a shared volume in a DST cluster resource, you also affect the settings that define the DST shadow relationship. The DST settings are not automatically updated when you rename the primary volume or secondary volume.

The DST relationship between the primary volume and secondary volume is defined by the ncpcon mount command in the DST cluster resource. DST settings that use the volume names are found in the following files that exist on each cluster node. You must manually remove the information on each node.

  • /etc/opt/novell/ncp2nss.conf

    This file contains the EXCLUDE_VOLUME <secondary_volume_name> entry that prevents the secondary volume from being mounted in NCP. For example:

    EXCLUDE_VOLUME VOLD
    

    The rename function does not remove this entry from the file. Cluster Services also does not remove the entry from the file. After the volume is renamed, when you bring the resource online on a node, a new entry is made for the secondary volume with the new name. You must manually remove the entry for the old volume name from the file on each node as part of the rename process.

  • /etc/opt/novell/ncpserv.conf

    This file contains the shadow volume entry. For example:

    SHADOW_VOLUME HOME /media/nss/VOLD
    

    After you rename the primary volume or secondary volume, a new entry is made in the file with the new primary volume name or secondary volume path. You must remove the entry for the DST volume from the file as part of the rename process.

After you rename the volume, new entries are added to the ncp2nss.conf file and ncpserv.conf file on the node where you bring the modified resource online.

To rename a volume in a shared DST shadow volume pair:

  1. Log in to the master node as the root user, then launch a terminal console.

  2. Ensure that the DST cluster resource is running on the master node. Enter

    cluster status
    

    If you need to migrate the resource, enter the following at the command prompt:

    cluster migrate <resource_name> <master_node_name>
    
  3. Take the DST cluster resource offline. At the command prompt, enter

    cluster offline <resource_name>
    

    You can verify the offline state by entering

    cluster status
    
  4. Open the /etc/opt/novell/ncpserv.conf file in a text editor, remove the entry for the DST shadow volume pair, then save the file. Repeat this task for every node in the cluster.

    SHADOW_VOLUME <primary_volume_name> /media/nss/<secondary_volume_name>
    

    For example:

    SHADOW_VOLUME HOME /media/nss/VOLD
    
  5. If you are renaming the secondary volume, open the /etc/opt/novell/ncp2nss.conf file in a text editor, remove the EXCLUDE_VOLUME entry for the volume, then save the file. Repeat this task for every node in the cluster.

    EXCLUDE_VOLUME <secondary_volume_name>
    

    For example:

    EXCLUDE_VOLUME VOLD
    
  6. Activate the pool locally on the master node:

    1. At the command prompt, enter

      nssmu
      
    2. On the NSSMU Main Menu, select Pools, then press Enter.

    3. On the Pools page, select the pool that contains the volume you want to rename, then press F7 Activate.

    4. Press Esc to return to the NSSMU Main Menu.

  7. Mount the volume to be renamed locally on the master node:

    1. On the NSSMU Main Menu, select Volumes, then press Enter.

    2. On the Volumes page, select the volume, then press F7 Mount.

  8. On the Volumes page, view the volume properties to ensure that the attribute Allow renaming the mount point has been enabled. If it is disabled, select the attribute value, press y (Yes) to enable it, then select Apply and press Enter.

  9. Rename the volume:

    1. On the Volumes page, select the mounted NSS volume that you want to rename.

    2. Press F3 Rename, specify the new name, then press Enter.

    3. Wait for the volume to be automatically dismounted and remounted. When the page refreshes, the volume is mounted in the default mount point path /media/nss/<new_volume_name>.

      If you try to force the page to refresh before the eDirectory changes have been synchronized, you might get an eDirectory error. The error condition is temporary and should not prevent the transaction from completing successfully.

  10. Dismount the volume:

    1. On the NSSMU Volumes page, select the volume, then press F7 Dismount.

    2. Read the warning message that open files will be closed by the action, then press y (Yes) to confirm the dismount.

    3. Press Esc to return to the NSSMU Main Menu.

  11. Deactivate the pool that you activated in Step 6:

    1. On the NSSMU Main Menu, select Pools, then press Enter.

    2. On the Pools page, select the pool, then press F7 Deactivate.

    3. Read the warning message that the pool’s volumes will be dismounted, then press y (Yes) to confirm the deactivation.

    4. When the page refreshes, verify that the pool state is Deactive.

    5. Press Esc twice to exit NSSMU.

  12. Modify the volume name in the scripts for its DST cluster resource:

    1. In iManager, select Clusters > My Clusters, then select the cluster that you want to manage.

    2. On the Cluster Manager page or Cluster Options page, click the name of the pool cluster resource to open the resource properties.

    3. Click the Scripts tab.

    4. On the Load Script page, modify the volume name in the ncpcon mount command. Also check any custom commands where the volume name appears. If you modify the load script, click Apply.

      exit_on_error ncpcon mount <primary_volume_name>=<volume_id>,shadowvolume=<secondary_volume_name>
      

      For example, if you rename the primary volume from HOME to USERS, and the secondary volume is VOLD, change this line

      exit_on_error ncpcon mount HOME=252,shadowvolume=VOLD
      

      to this:

      exit_on_error ncpcon mount USERS=252,shadowvolume=VOLD
      

      If you rename the secondary volume name from VOLD to HOME_SH, and the primary volume is named HOME, change this line

      exit_on_error ncpcon mount HOME=252,shadowvolume=VOLD
      

      to this:

      exit_on_error ncpcon mount HOME=252,shadowvolume=HOME_SH
      
    5. Click Unload Script, then check any custom commands where the volume name appears. If you modify the unload script, click Apply.

      The unload script does not contain any default volume commands.

    6. If you renamed the primary volume, click Monitor Script, then modify the primary volume name in the ncpcon volume command. The secondary volume is not monitored because it is hidden from NCP. If you modify the monitor script, click Apply.

      exit_on_error ncpcon volume <new_primary_volume_name>
      

      For example, if you rename the primary volume from HOME to USERS, change this line

      exit_on_error ncpcon volume HOME
      

      to this:

      exit_on_error ncpcon volume USERS
      
    7. Click Cancel to return to the Cluster Manager page, or click OK to apply any changes you made in the scripts.

  13. Bring the pool cluster resource online. At the command prompt, enter

    cluster online <resource_name>
    

    You can verify the online state by entering

    cluster status
    

    The first time that the modified DST cluster resource is brought online on a node, the new entries are added to the ncp2nss.conf file and ncpserv.conf file.