.. _standalone_installation:

Standalone Installation
-----------------------

.. index:: system;system provision
.. index:: system;system reboot
.. index:: security;security update
.. index:: voss;voss cleardown
.. index:: network;network domain
.. index:: app;app install
.. index:: log;log follow

.. _19.2.1|EKB-2636:
.. _19.2.1|VOSS-542|EKB-2016:

Before You Begin
................

Before continuing, you should have followed the OVA installation according to
the steps and preliminary requirements specified in:
:ref:`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: :ref:`screen-command`.


   
Procedure
.........


1. Install VMware tools:

   a. Log in to the node as the platform user and run the **app install vmware** command.
   #. Verify that vmware is running: **app list**.
#. Check that the time server is running with **app status services:time**.
#. 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**.
#. Issue the **network domain <your_domain>** command.
#. Issue the **security check** command. If at least one update is required, run **security update**.
#. Issue the **system reboot** command. Since all services will be stopped, this takes some time.
#. Import the templates:

   a. Use **scp** to transfer the template files to the platform user's media directory
      server.

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

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

      i. Run **screen**.
      ii. 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.

   c. 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.

      i. Python functions are deployed
      #. System artifacts are imported.
      #. 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.
   
#. 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.
     
#. Issue the **system reboot** command. Since all services will be stopped, this takes some time.


#. (Optional) Install language templates for languages other than English.
  
   a. Copy the language template file to the primary Unified node with the command:
  
      **scp <language_template_file>  platform@<unified_node_ip_address>:~/media**
  
   b. 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**

#. (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"