Standalone Installation

Before You Begin

Before continuing, you should have followed the OVA installation according to the steps and preliminary requirements specified in: Create a New VM Using the Platform-Install OVA

Note

  • Template installation and upgrade takes approximately two hours. You can follow the progress on the GUI transaction list.

The standard screen command should be used where indicated. See: Using the screen command.

Procedure

  1. Install VMware tools:

    1. Log in to the node as the platform user and run the app install vmware command.
    2. Verify that vmware is running: app list.

  2. Check that the time server is running with app status services:time.

  3. Initialize the database and clear all data with the voss cleardown command.

    Note that this step may take some time. You can follow the process by running log follow upgrade_db.log or log follow voss-deviceapi/app.log.

  4. Issue the network domain <your_domain> command.

  5. Issue the security check command. If at least one update is required, run security update.

  6. Issue the system reboot command. Since all services will be stopped, this takes some time.

  7. Import the templates:

    1. Use scp to transfer the template files to the platform user’s media directory server.

      scp <template_file> platform@<unified_node_ip_address>:~/media

    2. Install the VOSS-4-UC template. It is recommended that this step is run in a terminal opened with the screen command.

      1. Run screen.
      2. Run app template media/<VOSS-4-UC_template_file>

      The following message appears:

      Deploying the template-product for VOSS-4-UC ....

      The template detects the deployment mode of the system as a New/Fresh installation.

    3. When prompted to select the product deployment type, provide and confirm the deployment type:

      • Enterprise
      • Provider without HCM-F
      • Provider with HCM-F

      In accordance with the selected deployment type, you are prompted to enter and verify a top-level administrator password:

      • Enterprise : Please enter a password for "entadmin@sys.hcs"
      • Provider : Please enter a password for "hcsadmin@sys.hcs"

      Upon installation, the password length should be at least 8 characters.

      Deployment-specific artifacts are installed according to the selected type of product deployment. A message displays according to the selected deployment type - one of:

      "Importing EnterpriseOverlay.json"

"Importing ProviderOverlay_Hcmf.json ..."

"Importing ProviderOverlay_Decoupled.json ..."

      Deployment specific system artifacts are imported and a message is displayed:

      Deployment-specific Overlay artifacts successfully imported.
      1. Python functions are deployed
      2. System artifacts are imported.
      3. You are prompted to provide administrator passwords.

      The template install automatically restarts necessary applications. If a cluster is detected, the installation propagates changes throughout the cluster.

  8. Review the output from the app template commands and confirm that the install message appears:

    Deployment summary of UPDATED template solution (i.e. current values after installation):
-----------------------------------------------------------------------------------------

Product: [PRODUCT]
Version: [UPDATED PRODUCT RELEASE]
Iteration-version: [UPDATED ITERATION]
Platform-version: [UPDATED PLATFORM VERSION]
    • If there are no errors indicated, make a backup or snapshot.
    • If there was an error, the install script has stopped with a failure message listing the problem. Resolve the problem and retry the installation.

  9. Issue the system reboot command. Since all services will be stopped, this takes some time.

  10. (Optional) Install language templates for languages other than English.

    1. Copy the language template file to the primary Unified node with the command:

      scp <language_template_file> platform@<unified_node_ip_address>:~/media

    2. Log in to the primary Unified node and install the template with the command:

      app template media/<language_template_file>

      For example, to install French:

      app template media/VOSS-4-UCLanguagePack_fr-fr.template

  11. (Optional) If the VOSS-4-UC Phone Based Registration Add-on is required, follow the installation instructions in the Appendix of your Core Feature Guide:

    “Install the Phone Based Registration Web Service”