26.1 Migrating NetStorage to OES 2018 SP2

The supported OES servers are referred as the source server and the OES 2018 SP2 server as the target server.

26.1.1 Prerequisites

Before proceeding to migrate, meet the following prerequisites:

  • NetStorage is installed and configured on OES 2 SP3 32-bit machine.

  • NetStorage is installed on target OES 2018 SP2 machine.

For more information about installing and configuring NetStorage, see Installing NetStorage section in the OES 2018 SP2: NetStorage Administration Guide for Linux.

What is Migrated

The following data is migrated from the source server to the target server:

  • Xtier registry settings and configurations

26.1.2 Migration Procedure

Source Server

  1. Backup the /var/opt/novell/netstorage/shared folder.

  2. Backup the /opt/novell/netstorage/webapp/WEB-INF/classes/Settings.properties file.

  3. At the terminal prompt use the following command to stop the xregd user: rcnovell-xregd stop

  4. Export the registry available at /var/opt/novell/xtier/xregd/db as an xml file using the following commands:

    /opt/novell/xtier/bin/regutil -e srcReg.xml

Target Server

  1. Copy the /var/opt/novell/netstorage/shared folder in the same volume and directory structure.

  2. Copy the /opt/novell/netstorage/webapp/WEB-INF/classes/Settings.properties file in the same volume and directory structure.

  3. Ensure that file permissions are retained.

  4. Copy srcReg.xml to any location. For example, /opt/novell/xtier/bin/regutil -i <location>/srcReg.xml, where <location> is the location of your choice.

  5. At the terminal prompt use the following command to stop the xregd user: rcnovell-xregd stop

  6. Navigate to /var/opt/novell/xtier/xregd/db/ and verify that the directory db is empty using the following command: ls -l. If the directory is empty, continue to step 5.

  7. If any files exist in the db directory, move all the files to a temporary directory, say /tmp.

  8. Generate files inside the xtier registry using the following commands:

    1. To restore the source server registry:

      /opt/novell/xtier/bin/regutil -i srcReg.xml

  9. Navigate to /var/opt/novell/xtier/xregd/db/ and run the command ls –l /var/opt/novell/xtier/xregd/db to ensure that the following files are generated:

    • xtier_registry.db

    • xtier_registry.lck

    • xtier_registry.rfl

  10. Start the xregd user using the rcnovell-xregd start command.

  11. Navigate to the xtier registry using the following command /opt/novell/xtier/bin/regedit.

  12. At the regedit prompt, execute the cd local_machine command and ls -l command to view the contents inside the directory. If a directory named software is present in the local_machine directory, then the registry is rebuilt without any error.

  13. Similarly, enter the following commands in the sequence listed along with ls -l command to view the content in the respective directories:

    • cd software

    • cd Novell

    • cd Xtier

    • cd Configuration

      If the content exists in all the respective directories, then the Xtier registry is completely rebuilt.

  14. Enter exit.

  15. Restart the machine.

Transfer ID - Same Tree

In this scenario, the target server is installed in the same tree as the source server. On successful completion of Transfer ID, the target server functions with the same credentials (such as IP address and host name) as the source server and source server node is no longer available in the network. For more information, see Section 10.0, Using the Migration GUI Tool for Transfer ID

Post Migration

After migrating NetStorage,

  • Login to iManager and go through the NetStorage Task, the configurations should have been properly migrated.

  • Access NetStorage from a browser http://<IP-ADDRESS>/NetStorage/ and should be able to login and access files and folders.