Add a Colony from the Command Line Interface

About this task

You can add colonies to your Sterling Selling and Fulfillment Foundation deployment as follows:

Procedure

  1. Run the Manage Colony installation by entering the following command from the <INSTALL_DIR>/bin directory:

    Windows: <INSTALL_DIR>\bin manageColonyWizard.cmd

    UNIX or Linux: <INSTALL_DIR>/bin ./manageColonyWizard.sh

  2. At the Enter Colony ID prompt, enter the Colony ID, which is the name of the colony you wish to create.
  3. At the next prompt, enter the Colony Prefix, enter a two-digit colony prefix for the colony. This can be a number from 10 – 99 (except 19 and 20). Press Enter.
  4. The installation guides you through entering database account information for Transaction/Master Schema. Enter a value for each item, then press Enter:
    • Database user name
    • Database password
    • Confirm database password
    • Database catalog name (for more information, see the Sterling Selling and Fulfillment Foundation: Installation Guide
    • Database host name (or IP address)
    • Database port
  5. After you enter the database information and press Enter, the Confirm Database Information screen (read-only) for Transaction/Master displays the database account information you entered. Review each item's value, and press Enter to accept each one.
  6. The installation program verifies the database connection. If a connection cannot be established, you receive an error and can re-enter the database information to make another connection attempt. If you cannot make a connection, consult with your database administrator.
  7. If you have installed Sterling Analytics, the installation prompts for the following information. Otherwise, proceed to Step 8.
    1. The installation guides you through entering database account information for the Sterling Analytics Transaction/Master schema. Enter a value for each of the following items, then press Enter:
      • Database user name
      • Database password
      • Confirm database password
      • Database catalog name (for more information, see the Sterling Selling and Fulfillment Foundation: Installation Guide)
      • Database host name (or IP address)
      • Database port
    2. After you enter the database information and press Enter, the Confirm Sterling Analytics Database Information Transaction/Master Schema screen (read-only) displays the database account information you entered. Review each item's value, and press Enter to accept each one.
    3. The installation program verifies the database connection. If a connection cannot be established, you receive an error and can re-enter the database information to make another connection attempt. If you cannot make a connection, consult with your database administrator.
    4. The installation guides you through entering database account information for the Sterling Analytics Staging Schema. Enter a value for each database item and press Enter.
    5. After you enter the database information and press Enter, the Confirm Database Account Information for Sterling Analytics Staging schema screen (read-only) displays the database account information you entered. Review each item's value, and press Enter to accept each one.
  8. When the installation is finished, the system displays the message installation completed.
  9. If you wish to add another colony to your deployment, go back to Step 1 and run the manageColonyWizard script again, entering database information for the next colony.

Results

This command-line installation writes an addColony.xml file, which contains the colony configuration data you entered during this procedure.