Versions Compared

Old Version 3

changes.mady.by.user Ribbon Communications

Saved on

compared with

New Version Current

changes.mady.by.user Ribbon Communications

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Add_workflow_for_techpubs
REV2
AUTH1UserResourceIdentifier{userKey=8a00a0c86ca23f8a016cd6ed6fe90013, userName='null'}
REV5UserResourceIdentifier{userKey=8a00a0c866dc3dee0166ea60b86f00148a00a0c85b2726c2015b58aa779d0003, userName='null'}
REV6UserResourceIdentifier{userKey=8a00a0c85b2726c2015b58aa779d0003, userName='null'}
REV3UserResourceIdentifier{userKey=8a00a02355cd1c2f0155cd26cd8b0a598a00a0c866dc3dee0166f54435370023, userName='null'}
REV1UserResourceIdentifier{userKey=8a00a0c8664c0be0016687d83fdb00258a00a0c866dc3dee0166e4fafc100006, userName='null'}UserResourceIdentifier{userKey=8a00a0c866dc3dee0166f54435370023, userName='null'}

To install and configure

Spacevars
0product
, perform the following steps:

  1. Download the 

    Spacevars
    0product
    artifacts install-ev.sh and ev-fullpkg.tar.xz to the /opt directory of your system (reach out to support@rbbn.com for the URLs of these artifacts):.

    Info
    titleNote

    For these artifacts, log in to Salesforce and open an additional browser for the Ribbon Global Software Center (GSC). In the Downloads section, search for the name and version of the required software.
    Reach out to Ribbon Support for more information.

    Code Block
    cd /opt/ wget ftp://$url_from_support wget ftp://$url_from_support


  2. Enable read-write-execute permissions for the copied files using the command given below:

    Code Block
    chmod +x install-ev.sh


  3. Validate installation media readiness using the command given below:

    Code Block
    pwd && ls -alh


    As depicted in the example screenshot, confirm the two files exhibit approximately the same size and permissions. 

  4. Execute the following command to start installation process:

    Code Block
    ./install-ev.sh

    The installation continues by installing Docker Compose, Docker and

    Spacevars
    0product
    . The GUI_IP, EV_IP, and EV_IP6 values should be set so that
    Spacevars
    0product
     works properly.  Respond to any prompts that arise, especially the GUI_IP, EV_IP, and EV_IP6 prompt which is critical to the installation. GUI_IP, EV_IP, and EV_IP6 values must be set so that
    Spacevars
    0product
     works properly.

    • GUI_IP - The host name or address that the users can use to access 

      Spacevars
      0product
       from the browser's address bar.

      Info
      titleNote

      GUI_IP must be the same as either EV_IP or EV_IP6.


    • EV_IP - The host name or IPv4 address for the managed devices to contact 

      Spacevars
      0product
      .

    • EV_IP6 - The host name or IPv6 address for managed devices to contact 

      Spacevars
      0product
      .

      Info
      titleNote

      The EV_IP6 address is not set by default. If you want to access 

      Spacevars
      0product
       using IPv6 modify the current settings and provide the EV_IP6 address. 


    The installation creates a log file of all actions for historical review/troubleshooting. The resultant filename is in the format of $MM-DD-YYYY-ev-install.log 

    You are prompted to enter information related to your networking configuration. Read this section carefully and enter the appropriate values applicable to your environment.
    Once installation completes, the console screen displays the message “ 

    Spacevars
    0product
    Installation/Upgrade Completed ”. A directory named scc-build is created.

  5. To check whether the containers started successfully, use the following command:

    Code Block
    docker ps --format "table 
{{.ID}}\t{{.Image}}\t{{.Status}}\t{{.Names}}"
    Tip
    titleTip

    Make sure that the STATUS is healthy. If there are unhealthy statuses, run the following command and check the Health section of the output:

    Code Block
    docker inspect $container_name

    For example:

    Code Block
    docker inspect scc


  6. Once the installation completes, optionally run a basic sanity check using the command given below:s

    Code Block
    cd /opt/scc-build ; ./ev_check.sh post-install

  7. For initial SCC configuration, register your 

    Spacevars
    0product
    server by accessing it through the web interface at its IP address and entering the registration information that you received in your email. If the registration information is not available, reach out to support@rbbn.com Ribbon Support.

    Info
    titleNote

    Refer to Manually Configure ZTP when upgrading from

    Spacevars
    0product
     15.2.0 or 15.2.1.

  8. Enter the 
    Spacevars
    0product
     admin registration details, and then click NEXT.
  9. Enter the Tenant Admin registration details, and then click NEXT.
  10. Click APPLY to complete the registration.
  11. Click LOGIN to navigate to the login screen.
  12. Enter the credentials and click SIGN IN to log in to 
    Spacevars
    0product
    .
Info
titleNote

If overcommit_memory is set to 0, it can cause issues with Redis container under low memory conditions. 
To fix this issue:

  • Add vm.overcommit_memory = 1 to /etc/sysctl.conf and then reboot.

  • Alternatively, run the following command:

    Code Block
    sysctl vm.overcommit_memory=1



Info
titleNote

Spacevars
0product
 does not support running on Host OS with Transparent Huge Pages (THP) support  support enabled. 
To disable THP on the Host OS:

  1. Enter the following command as Root user:

    Code Block
    echo never > /sys/kernel/mm/transparent_hugepage/enabled


  2. Add it to your /etc/rc.local directory in order to retain the setting after a reboot.

  3. Restart Redis once THP is disabled.


Note
titleCaution

Redis container does not support overcommit_memory and Transparent Huge Pages. These entries appear in Redis log which can be checked by 'docker-compose logs redis'. The warnings in the Redis log file are as follows:

"09 Sep 2020 19:05:49.043 # WARNING overcommit_memory is set to 0! Background save may fail under low memory condition. To fix this issue add 'vm.overcommit_memory = 1' to /etc/sysctl.conf and then reboot or run the command 'sysctl vm.overcommit_memory=1' for this to take effect.
09 Sep 2020 19:05:49.043 # WARNING you have Transparent Huge Pages (THP) support enabled in your kernel. This will create latency and memory usage issues with Redis. To fix this issue run the command 'echo never > /sys/kernel/mm/transparent_hugepage/enabled' as root, and add it to your /etc/rc.local in order to retain."

Follow the instruction in the log messages to fix the WARNINGs to prevent the 

Spacevars
0product
containers from becoming unhealthy and eventually working incorrectly.

Please note these changes should be on the HOST OS, not in the container.


Pagebreak