Moving an index on a UNIX based NetWorker server

The only supported method for moving a client index to another location is uasm. A word of warning to those who are not familiar with uasm...uasm is difficult to use! The uasm command is log and cryptic. It is very easy to make a mistake when working with the uasm command.

Warning: Legato issued a white paper stating that client index files on NetWorker version 6.x servers could be moved using standard "move" commands rather than using uasm. However, I find that each attempted corrupted our NetWorker 6.01 indexes. The uasm technique described below works for NetWorker version 5.x and 6.x

The best way to show you how to move an index is with an example. In this example, we will move the following index:




Step 1: Run an "nsrck -F client_name" command on the client index you are preparing to move. This will ensure that the client index is "clean".

Step 2: Create a new "top level" directory to hold the indexes. This is the location where you wih you move the index to. In this example, we entered the following commands on the NetWorker server:

cd /
mkdir index

Step 3: Make sure thet NetWorker server is idle, then shutdown the NetWorker daemons. To stop NetWorker, enter the following:

nsr_shutdown -aq

Step 4: Enter the following command very carefully:

/usr/lib/nsr/uasm -si /nsr/index/charlie01 | /usr/lib/nsr/uasm -rm /nsr/index/charlie01=/index/charlie01

You may need to replace the path pointing to "uasm" with the appropiate path in your environment.

Note: If he above command works properly, you will see absooltely no output from the command. If you receive any type of error, or prompts to overwrite files, hit CTRL+C to kill the command, then recheck you command syntax.

Step 5: Look in the new directory to make sure the files were actually copied.

Step 6: Rename the "old" directory. In this example, we entered the following commands to rename the old index directory:

cd /nsr/index
mv charlie01 clarie01.old

Step 7: Restart the NetWorker server by entering:

/etc/init.d/networker start

Step 8: From the nwadmin utility, edit the client configuration for the client whose index was moved. Click on View > Details. Change the "Index path" entry point to match the new index location as follows:


Step 9: Run an "nsrck -F client_name" command on the client index you just moved to make sure all is well. The nsrck command should reflect the new location as shown as follows:

nsrck -F charlie01
nsrck: checking index for 'charlie01'
nsrck: /index/charlie01 contains 16483 records occupying 2750 KB
nsrck: Completed checking 1 client(s)