Configure a StorNext RPM Server Using the Command Line

SUSE Linux distributions automatically associate the FQDN of the local machine with the address 127.0.0.2 in the /etc/hosts file. There is no benefit from doing this when the machine is connected to a network that can resolve its name to an IP address. However, the existence of this entry can sometimes cause a failure of configuration synchronization within and between the server computers in an HA configuration. For this reason, the 127.0.0.2 entry should be deleted from the /etc/hosts file.

The steps for setting up a single server or the primary server in an HA configuration are nearly identical. The HA configuration requires a few extra steps, which are noted in the procedure below.

Note: If you do not have an HA configuration, ignore the steps marked HA Only.

Run the following commands on the Primary node if installing an HA system:

1. Install RPMs using the procedure outlined in Install a StorNext File System Only Using an RPM.
2. Obtain and install licenses.See Obtain and Install Perpetual StorNext Licenses for GUI-based Appliances and Customer-supplied MDCs.

3. Populate the fsnameservers file with the IP addresses of the fsnameserver systems by running this command:

   # vi /usr/cvfs/config/fsnameservers

   Note: For additional information, see the fsnameservers man page. If you add the host name instead of the IP address, the conversion to HA could fail. Use only the IP address when populating the fsnameservers file.

4. (HA Only) Create the ha_peer file by running the command below. This file should contain the IP address of the Secondary in the HA pair.

   # vi /usr/cvfs/config/ha_peer

   Note: For additional information, see the ha_peer man page.

5. Start the fsmpm by running the command:

   # /etc/init.d/cvfs start

6. Create the .cfgx file by running the command:

   # /usr/cvfs/bin/sncfgedit -n snfs1

   Note: For additional information, see the snfs.cfgx and sncfgedit man pages.

   After creating the file, do the following:

   1. Delete first two lines at top that start with ****.

   2. (HA Only) Change the haFsType entry to HaUnmanaged. That is, change this:

      <haFsType>HaUnmonitored</haFsType>

      to this:

      <haFsType>HaUnmanaged</haFsType>
   3. Fix the <diskTypes> and <stripeGroups> sections at the bottom.

7. Make the file system by running the command:

   # /usr/cvfs/bin/cvmkfs snfs1

8. Create the mount point by running the command:

   # mkdir /stornext/snfs1
9. Edit the file /usr/cvfs/config/fsmlist and add your file system name(s) that the file system services will start. To do this:

   1. Open the file by running this command:

      # vi /usr/cvfs/config/fsmlist

   2. Add the name of your file system to launch:

      snfs1
10. Add file system entry to /etc/fstab file:

    1. Edit the /etc/fstab file by running the command:

       # vi /etc/fstab

    2. Add the file system name and mount options to the end of the list:

       snfs1 /stornext/snfs1 cvfs rw,noauto 0 0

       Important

       There are six fields in the fstab file. Spaces are used between the entries to delineate one field from the other. The fields are:

       • First field: Name of the file system to be mounted.
       • Second field: Mount point for the file system.
       • Third field: Type of file system.

       • Fourth field: Mount options.

         Note: You must always specify the noauto option for the Mount options.

       • Fifth field: Flag that tells Linux if this file system need to be dumped.
       • Sixth field: Determines the order in which file system checks are done.

11. Start and mount the file system by running the command:

    # /usr/cvfs/bin/cvadmin -e 'start snfs1'

    # mount /stornext/snfs1

Perform this procedure only if you have an HA configuration. Run the following commands on the Secondary node:

1. Install RPMs using the procedure outlined in Install a StorNext File System Only Using an RPM.
2. Create the fsnameservers file that contains the IP address of the system acting as the name servers by doing the following:

   1. Open the file by running the command:

      # vi /usr/cvfs/config/fsnameservers

   2. Add the IP address of the name servers.

      Note: The fsnameservers file on the secondary must be the same as the fsnameservers file on the primary. Remember, if you add the host name instead of the IP address, the conversion to HA could fail. Use only the IP address when populating the fsnameservers file.

3. Create the ha_peer file and add the IP address of the Primary in the HA pair by doing the following:

   1. Open the file by running the command:

      # vi /usr/cvfs/config/ha_peer
   2. Add the IP address of the Primary.

4. Start up the fsmpm by running the command:

   # /etc/init.d/cvfs start
5. Copy the .cfgx file from the Primary to the /usr/cvfs/config directory on the Secondary.
6. Edit the file /usr/cvfs/config/fsmlist and add your file system name(s) that the file system services will start by doing the following:

   1. Run the command:

      # vi /usr/cvfs/config/fsmlist

   2. Add the name of your file system to launch:

      snfs1
7. Add file system entry to /etc/fstab file:

   1. Edit the /etc/fstab file by running the command:

      # vi /etc/fstab

   2. Add the file system name and mount options to the end of the list:

      snfs1 /stornext/snfs1 cvfs rw,noauto 0 0

8. Start and mount the file system by running the command:

   # /usr/cvfs/bin/cvadmin -e 'start snfs1'

   # mount /stornext/snfs1