|C H A P T E R 2|
Initial Configuration Procedures
After you install the Sun StorageTek Availability Suite software and before you use it for the first time, you must configure certain files for the Point-in-Time Copy software and the Remote Mirror software. This chapter describes the required initial configuration procedures:
This chapter also describes the following topics for your information:
TABLE 2-1 summarizes the required and optional initial configuration tasks.
This section describes how to edit and check the following system files so that the Sun StorageTek Remote Mirror software runs properly:
This ensures that the host names in the /etc/hosts file are read and known by machines running the Remote Mirror software.
Add the names and IP addresses of all machines you plan to use with the Remote Mirror software to the /etc/hosts file.
Edit this file on each machine where you are installing and running the Remote Mirror software.
If you use the Internet Protocol version 6 (IPv6) transport protocol for replication, configure the IPv4 and IPv6 stack concurrently on the host for the interface where the Remote Mirror software is used. The IPv6 protocol provides increased addressability. For the Solaris 10 OS, see the System Administration Guide: IP Services for more information about IPv6.
To use the IPv6 protocol, define the IPv4 and IPv6 interfaces with the same name. You must define the primary and secondary hosts such that the same transport protocol is used by both machines.
This example procedure shows how to set your network interface to use IPv6 addresses. Use this procedure to test your Remote Mirror hosts connection. The following procedure assumes this configuration information:
1. Use a text editor to create the /etc/hostname6.hme1 file on both the primary host and the secondary host. On the primary host, add the interface name sndrpri to the file. On the secondary host, add the interface name sndrsec to the file. Save and close the files.
2. Shut down and restart both machines to activate IPv6.
3. After both machines reboot, get the IPv6 inet address for the hme1 interface address.
4. In the following example, the address is fe80::a00:20ff:febd:c33f/128
5. Edit the /etc/inet/ipnodes file and add the inet address from Step 4, assigning the primary host address to sndrpri and the secondary host address to sndrsec. Do not include the /128 portion of the address.
6. Save and close the file and then check the file contents.
In the following example, sndrsec is the secondary host interface name.
7. Edit the /etc/nsswitch.conf file to make sure that ipnodes: points to files.
Look for the following text in the file and make sure the ipnodes: line is uncommented.
8. Add the host names and IPv6 inet primary addresses of all machines you plan to use with the Remote Mirror software to the /etc/hosts file on each machine.
Edit this file on each machine where you are installing and running the Remote Mirror software.
Note - If you do not complete this step (described in To Edit the /etc/hosts File), the following error message is displayedwhen you enable the Remote Mirror software:
9. Ensure that one system can ping another and that these systems are using the IPv6 protocol.
To ping from the primary host, enter the following:
To ping from the secondary host, enter the following:
10. Use the netstat(1M) command to verify that the interface has the correct IPv6 address and IPv6 name.
Use this command on both the sndrpri and sndrsec hosts. For example:
Port 121 is the default port for use by the Remote Mirror rdc daemon.
If you change the port number, you must change it on all Remote Mirror hosts within this configuration set (that is, primary and secondary hosts, and all hosts in one-to-many, many-to-one, and multihop configurations).
1. Edit the /etc/services file on each machine running the Remote Mirror software.
2. Shutdown and restart all hosts to make that the new port number take effect.
If the file includes the hosts: and services: entries, verify that files is placed before nis, nisplus, ldap, dns, or any other service that the machine is using. For example, for systems using the NIS naming service, the file contains the following lines:
If the host and service entries are not correct, edit the file and save it.
If you are using the IPv6 protocol, see the changes for this file in Configuring the IP Stack (IPv4 and IPv6).
The following sections describe how to modify the Remote Mirror software settings.
Note - After editing the files in this section, shut down and restart your server using the shutdown command for changes to take effect. If you edit the rdc.conf file to use more than 64 volume sets, ensure that you have enough system resources such as a large swap space.
A bitmap maintained on disk can persist across a system crash, depending on the setting of rdc_bitmap_mode in /usr/kernel/drv/rdc.conf. The default setting is 1 (force bitmap writes for every write operation).
Edit the rdc.conf file and locate the following section. Edit the value for the bitmap mode, save the file, and close it.
The default number of configured volume sets is 64. To configure more than 64 volume sets, edit the rdc_max_sets field in the /usr/kernel/drv/rdc.conf file on each machine running the Remote Mirror software.
Edit the rdc.conf file and locate the following section. Edit the value for the volume sets, save the file, and close it.
For example, to use 128 sets, change the file as shown in the following section:
The Availability Suite software has a default limit of 4096 storage volumes. The default number of storage volume driver devices (that is, volumes) is set by the nsc_max_devices value in the nsctl.conf file.
The number of volumes is divided for use between the Remote Mirror and Point-in-Time Copy software. For example, if you use the point-in-time copy software only, you can have 1365 volume sets, each consisting of master, shadow, and bitmap volumes. If you use the Remote Mirror and Point-in-Time Copy software packages together, the number of volume sets is divided between the two packages.
Some installations might benefit from changing this limit. Sites with plenty of available memory can increase the limit if necessary to enable more storage volumes. Sites with limited available memory might benefit from lowering this limit, thus freeing up system resources.
Edit the nsctl.conf file and locate the nsc_max_devices field. Edit the value, save the file, and close it.
The startup and shutdown of the Availability Suite software is implemented through Service Management Facility (SMF) services, which may be administered using the dscfgadm utility.
dscfgadm controls the Availability Suite configuration services by providing facilities to set the configuration location, and to enable and disable the Availability Suite services.
dscfgadm [-x ]
dscfgadm [-x ] -i
dscfgadm [-x ] -e [-r] [-p]
dscfgadm [-x ] -d [-r]
-i displays information on the Availability Suite services
-e enables the Availability Suite SMF services (all, by default)
-d disables the Availability Suite SMF services (all, by default)
-r enables/disables the Remote Mirror software
-p enables the Point-in-Time Copy software
-x displays verbose debugging information
By default, Availability Suite services are not started, and no Availability Suite configuration database is present on the system. When dscfgadm is executed with no options (or with only -x), it runs in interactive mode. This mode allows you to initialize the local configuration database required by the Availability Suite software, and gives you the choice of starting the Availability Suite services at that time.
If you choose not to start the Availability Suite SMF services during the intialization of the database, you may start the SMF services later using the dscfgadm -e command.
To enable or disable services at a later time, use the -e and -d options with dscfgadm.
The default behavior acts upon all services, but the -r and -p options allow selectively disabling or enabling the Remote Mirror or Point-in-Time Copy services, respectively.
Both Point-in-Time Copy software and Remote Mirror software use raw volumes to store bitmaps. Bitmap files are not supported.
Store bitmap raw volumes on a disk separate from the disk that contains its associated master and shadow volumes (for Point-in-Time Copy software) for replicated volumes (for Remote Mirror software). Configure RAID (such as mirrored partitions) for these bitmap volumes and ensure that the mirrored members are not stored on the same disk as the master and shadow volumes or replicated volumes.
When you use Point-in-Time Copy software in a clustered environment, the bitmap volume must be part of the same disk group or cluster resource group as the corresponding master or shadow volume.
A bitmap volume's size is based on the size of the master volume and the type of volume set being created (independent, dependent, or compact dependent).
8 KBytes per 1 GBytes of master volume size (rounded-up to the nearest whole GByte), plus an additional 24 KByte for overhead.
For example, to shadow a 3 GByte master volume, the bitmap size must be (3 × 8 KBytes) + 24 KBytes, or 48 KBytes in size. A 50 GByte master volume requires a 424 KByte bitmap volume.
264 KByte per 1 GByte of master volume size (rounded up to the nearest whole GByte), plus an additional 24 KByte for overhead.
For example, to shadow a 3 GByte master volume, the bitmap size must be (3 × 264 KByte + 24 KByte, or 816 KByte in size. A 50 GByte master volume in a compact dependent shadow volume set requires a 13224 KBytes bitmap volume.
If you enable a shadow volume set with a bitmap that is too large, the shadow volume set is created even though space might be wasted. If you enable a shadow volume set with a bitmap that is too small, the enable command fails with an error message.
The Availability Suite software provides the dsbitmap utility to calculate the required size of a bitmap for a Point-in-Time Copy shadow volume set or a Remote Mirror volume set.
1. To obtain the size of a Point-in-Time Copy bitmap, use this command:
2. To obtain the size of a Remote Mirror bitmap, use this command:
Refer to the dsbitmap(1SCM) man page for more information on the dsbitmap utility.
When you enable the Remote Mirror software, you can specify an optional volume set file containing information about the volume set: volumes, primary and secondary hosts, bitmaps, operating mode, and so on. Use the sndradm -f volset-file option when you use a volume set file.
You can also enter information about each volume set from the command line, but it is convenient to put this information in a file when you have multiple volume sets. Another advantage is that you can operate on specific volume sets, excluding other sets from the operation. Unlike adding the volume sets to an I/O group, you can mix replication modes in a volume set file. The fields for the volume set file specified are:
TABLE 2-2 describes these fields. See the rdc.cf man page for more information about the volume set file format.
The following shows an example file entry:
You must back up your Sun StorageTek, VERITAS Volume Manager, and Solaris Volume Manager configuration information on a regular basis. To make any volume set-related changes, use the /usr/sbin/iiadm command, described in the Sun StorageTek Availability Suite 4.0 Point-in-Time Copy Software Administration Guide, and consider the following:
You may wish to set up a cron(1M) job to periodically back up the configuration database automatically. In addition, back up the configuration information whenever you change your configuration, for example, adding and deleting volumes.
Copy the configuration database (/etc/dscfg_local) to a safe location.