A.6 CSMPORT Utility (Cluster Segment Manager Import/Export)

The Novell Cluster Services Cluster Segment Manager (CSM) Import/Export utility allows you to use a Linux POSIX volume that was cluster-enabled with a CSM container. This conversion is required because the Enterprise Volume Segment Manager (EVMS) was deprecated on SUSE Linux Enterprise Server 11, and the CSM is no longer available on OES 11 and later servers.

The utility can be used to scan for CSM containers and check if they can be imported for use in the cluster. This is the default mode when you run it without any options, or with only the -v option. By default, the utility searches block devices (/dev/sd*) for containers. Information about each device is displayed. Details about the CSM container are present if the container exists and can be imported for use in the cluster.

The utility also allows you to do the following:

Search for a specified CSM container and check if it can be imported for use in the cluster.

Import a specified CSM container for exclusive use in the cluster, and generate a corresponding Device Mapper object for it as /dev/mapper/csm_name .

Export a specified CSM container by removing its Device Mapper object from the /dev/mapper directory. This allows the container to be imported by other nodes.

You can specify devices to search for any of the options. Wildcards such as the question mark (?) and asterisk (*) can be used when specifying devices. A question mark replaces a character in that position. An asterisk replaces any number of characters in that position.

A.6.1 Syntax

A.6.2 Options

No options

Use the command with no options to search the block devices (/dev/sd*) for containers.

/opt/novell/ncs/bin/csmport

[devices]

Use the command with no options and specify the devices to search in order to specify which devices to search for CSM containers. By default, the utility searches block devices (/dev/sd*) for containers.

/opt/novell/ncs/bin/csmport [device...]

When specifying devices, wildcards (? and *) can be used.

Examples

The following command searches the multipath device /dev/mapper/MD_EMC_005G for CSM containers.

/opt/novell/ncs/bin/csmport -v /dev/mapper/MD_EMC_005G

The following command uses three question mark wildcards to search multipath devices with any three characters in those positions in the device name:

/opt/novell/ncs/bin/csmport -v /dev/mapper/MD_EMC_???G

The following command uses an asterisk wildcard to search multipath devices with any number of characters in that position in the device name:

/opt/novell/ncs/bin/csmport -v /dev/mapper/MD_EMC_*

-h

Prints the help page for this command.

-c <container_name> [device...]

Searches the /dev/sd* devices or specified devices for the named CSM container.

/opt/novell/ncs/bin/csmport -c container_name

-i <container_name> [device...]

Use this option to import a CSM container on a node for exclusive use in the cluster. The utility achieves this by searching for the container and if found, extracting the volume inside the container and exposing it exclusively at /dev/mapper/container_name.

The utility uses the container name instead of the Linux POSIX volume name because some CSM containers might contain compatibility volumes, which do not have names. The /dev/mapper/container_name object can be mounted at the old mount point that was used for the shared Linux POSIX volume in that container. The mount point can have the same name or different name than the Device Mapper object.

/opt/novell/ncs/bin/csmport -i container_name

Example

Suppose that you created a Linux POSIX cluster resource with the following settings on an OES 2 server or an OES 1 server:

Use this option to export the Device Mapper object from the node. It removes the object from the /dev/mapper directory. Basically, the option undoes what the -i option did, so that the container can be imported by other nodes.

/opt/novell/ncs/bin/csmport -e devmapper_object

Example

The following command exports the Device Mapper object /dev/mapper/csm44.

/opt/novell/ncs/bin/csmport -e csm44

-v

Verbose mode can be used with any of the options.

-s

Silent mode can be used with any of the options.

A.6.3 Examples

This section provides examples of typical tasks you perform when using the csmport command.