Activating the LDM Installation

1. Become the LDM user in their home directory.
2. If the home directory isn't the LDM installation directory (which is unusual) then go to the LDM installation directory:

   $ cd $LDMHOME
   

3. If an LDM is running, then stop it:

   $ ldmadmin stop
   

4. If the runtime symbolic link exists, then remove it:

   $ rm runtime

5. Create the runtime symbolic link to the just-installed LDM:

   $ ln -s $VDIR runtime

   where $VDIR is the version-dependent directory of the LDM.
6. Ensure that a valid product-queue exists by doing one of the following:
   1. If the product-queue doesn't exist and the command

      $ df -k data

      indicates that sufficient space exists for it, then create the product-queue with the following command:

      $ ldmadmin mkqueue -f

      where the -f option requests "fast" creation.

      If you don't have sufficient space for the product-queue, then you'll have to free-up some space or configure-in a smaller queue.

   2. If the product-queue exists, then execute the command

      $ pqcheck -v

      and do one of the following:
      1. If the product-queue is invalid, then recreate it with the following commands:

         ldmadmin delqueue
         ldmadmin mkqueue -f

      2. If the product-queue doesn't have a writer-counter, then create the counter and set it to zero with the following command:

         $ pqcheck -F

7. Start the LDM:

   $ ldmadmin start

8. Verify that the LDM is working:

   $ ldmadmin watch

   How quickly this verifies your LDM depends on the rate at which data-products are inserted into the product-queue.

If the LDM system is already running, then you can minimize the time that the LDM is off-line by combining some of the above steps. For example

$ cd $LDMHOME && ldmadmin stop && rm -f runtime && \
ln -s $VDIR runtime && ldmadmin start && ldmadmin watch

If you encounter a problem, check the LDM logfile for relevant messages.