Reinitializing the Mobility XE Warehouse

Technical Note 2222

Last Reviewed 9-May-2008
Applies to:
Mobility XE Warehouse
 Printer-friendly version

Summary

Note: This tech note may be updated frequently. Please refresh this web page for the most current information on reinitializing the Mobility XE primary warehouse.

Under certain conditions the Mobility XE primary warehouse will need to be reinitialized. Refer to the list below to see if your primary warehouse meets any of these conditions.

Brand-new installations of the Mobility XE System (server and warehouse) do not need reinitializing.

Standby Warehouse Note: This procedure does not apply to standby warehouses. It applies only to the primary warehouse. If you need to reinitialize your standby warehouse(s) with the contents from the primary, contact technical support.

Determining if reinitialization is required

If your warehouse meets any of these conditions it should be reinitialized. Follow the instructions in the Reinitializing the Mobility XE warehouse section below.

• If you upgraded your Mobility XE server(s) you may receive a popup message directing you to this tech note. Once the upgrade is complete, reboot the Mobility XE server machine as instructed. After the server machine has rebooted, reinitialize your primary warehouse. You should also check that the Mobility XE server has restarted by opening the Services control panel (Start->Settings->Control Panel->Administrative Tools->Services) and verifying that the NetMotion Control service is running and has been set to Automatic.

• If a Mobility XE server reports it is unable to connect to the warehouse, open the Startup Settings utility and click on the Mobility Warehouse tab. If you see a message similar to "NM_LDAP_DIRECTORY_MISMATCH", your primary warehouse should be reinitialized.

• If the Mobility console is not displaying all the correct information about your servers, devices, and/or users, reinitialize your primary warehouse.

• If you have promoted a standby warehouse to be a primary warehouse, it must be reinitialized.

Reinitializing the Mobility XE warehouse

There are three parts to reinitializing the Mobility XE warehouse. The first part involves making a backup copy of the warehouse data. The second part involves stopping the Directory Server and exporting the data. The third part involves reinitializing and importing the data and then restarting the Directory Server.

Section 1 describes how to back up your warehouse data. Section 2 describes how to perform reinitialization by downloading and running a script (the recommended method). If you need to perform reinitialization manually, Section 3 describes how to do so.

Section 1: Backing up the warehouse

NetMotion recommends always backing up the Mobility warehouse before performing any operation on it. See Tech Note 2129 for instructions on how to back up your warehouse.

Section 2: Performing reinitialization via a script

1. Click here to download the reinitialization script (reinit.zip).

2. Unzip the reinit.zip file into reinit.bat and copy or move it into the directory where your Mobility warehouse resides. The default location is C:\Program Files\Sun\MPS\slapd-[servername]. If you have installed the Mobility warehouse into a non-default location you must find the location of the Sun\MPS\slapd-[servername] directory and move the file there.

3. Open a command prompt window and change directory to this directory location.

4. Run the file by typing "reinit" at the command prompt (do not type the quotation marks).

The command prompt window will display the progress of the script.

If you performed the steps in Section 2 above to run the reinitialization script, the process is complete. Do not go on to Section 3.

Section 3: Performing reinitialization manually

Only perform these steps if you did not choose to run the reinitialization script (Section 2 above).

Step 1: Manual reinitialization: Exporting the warehouse data

Perform these steps to stop the Directory Server and then export the warehouse data to an ldif file.

1. Log into the machine where the warehouse is installed.

2. Open a command prompt window and navigate to the warehouse directory. The default location is C:\Program Files\Sun\MPS\slapd-[servername]. If you have installed the Mobility warehouse into a non-default location you must find the location of the Sun\MPS\slapd-[servername] directory and navigate there.

3. Enter the following two commands:

   • stop-slapd

   • db2ldif -n userroot -r -a c:\nmbackup.ldif

Step 2: Manual reinitialization: Importing the warehouse data

Perform these steps to reinitialize and import the nmbackup.ldif file you created in Step 1 and then restart the Directory Server.

1. Important: The path to the nmbackup.ldif file must be an absolute path with no spaces in it. The path must also be in quotes.

   From the same directory, run the following two commands:

   • ldif2db -n userroot -i "c:\nmbackup.ldif"

   • start-slapd

2. Close the command window.

Related Information

Please comment on this technical note.