Repman

Overview

The page covers the acceptance tests for the repman utility. See the [Downloads] page for the utility itself.

Test 1

Use CaseUser adds a process to the replication manager to launch and manage
FunctionalityBaseline
Test DistributionNone
Known ProblemsNone
Test Sequence
  1. Have repman in the local directory or in your path
  2. Start a managed process by passing in the process and label on the command line
  3. Run repman with no flags
  4. Should print out the process label and machine that you created
Configuration/Deployment Issues
  1. User must have read/write access to the /tmp directory
  2. In order for the replication manager to tracks its managed processes, it stores all of its managed processes in /tmp/polaris.proclist. If this file is modified outside of repman, or moved, repman will no longer know its managed processes.

Test 2

Use CaseUser kills a process that has been managed by repman
FunctionalityBaseline
Test DistributionNone
Known ProblemsNone
Test Sequence
  1. Follow the steps in test 1
  2. Run repman with the k flag and the label of the process just created
  3. Should print out its managed process list without the process just killed
Configuration/Deployment Issues
  1. User must have read/write access to the /tmp directory
  2. In order for the replication manager to tracks its managed processes, it stores all of its managed processes in /tmp/polaris.proclist. If this file is modified outside of repman, or moved, repman will no longer know its managed processes.

Test 3

Use CaseThe replication manager displays a list of the processes that it is managing.
FunctionalityBaseline
Test DistributionNone
Known ProblemsNone
Test Sequence
  1. Run the test sequence in test number 1 several times, modifying the label each time.
  2. Run repman with no flags
  3. Should print out a list of all managed processes
Configuration/Deployment Issues
  1. User must have read/write access to the /tmp directory
  2. In order for the replication manager to tracks its managed processes, it stores all of its managed processes in /tmp/polaris.proclist. If this file is modified outside of repman, or moved, repman will no longer know its managed processes.

Test 4

Use CaseThe replication manager should detect when a process it is managing goes down external to repman.
FunctionalityBaseline
Test DistributionNone
Known ProblemsNone
Test Sequence
  1. Run the test sequence in test number 1 several times
  2. Run repman with no flags
  3. Should print out a list of all managed processes
  4. Externally kill on of its managed processes
  5. Run repman with no flags
  6. The list printed out should not show the killed process
Configuration/Deployment Issues
  1. User must have read/write access to the /tmp directory
  2. In order for the replication manager to tracks its managed processes, it stores all of its managed processes in /tmp/polaris.proclist. If this file is modified outside of repman, or moved, repman will no longer know its managed processes.

Test 5

Use CaseThe replication manager should not manage a process that is never started.
FunctionalityBaseline
Test DistributionNone
Known ProblemsNone
Test Sequence
  1. Run repman with the process and label flags. However, for the process flag, use a command which does not exist.
  2. Repman should print out an error.
Configuration/Deployment Issues
  1. User must have read/write access to the /tmp directory
  2. In order for the replication manager to tracks its managed processes, it stores all of its managed processes in /tmp/polaris.proclist. If this file is modified outside of repman, or moved, repman will no longer know its managed processes.

Test 6

Use CaseThe replication manager does not allow creation of duplicate labels.
FunctionalityBaseline
Test DistributionNone
Known ProblemsNone
Test Sequence
  1. Run the test script in test number 1
  2. Run it again, with the identical flags
  3. An error message should appear stating that the label has already been used.
Configuration/Deployment Issues
  1. User must have read/write access to the /tmp directory
  2. In order for the replication manager to tracks its managed processes, it stores all of its managed processes in /tmp/polaris.proclist. If this file is modified outside of repman, or moved, repman will no longer know its managed processes.

Test 7

Use CaseThe replication manager should detect invalid flags.
FunctionalityBaseline
Test DistributionNone
Known ProblemsNone
Test Sequence
  1. Have repman in the local directory or in your path
  2. Run repman with invalid or incompatible flags
  3. Should print out a usage message
Configuration/Deployment Issues
  1. User must have read/write access to the /tmp directory
  2. In order for the replication manager to tracks its managed processes, it stores all of its managed processes in /tmp/polaris.proclist. If this file is modified outside of repman, or moved, repman will no longer know its managed processes.