Install and Configure EdgeView

To install and configure EdgeView, perform the following steps:

1. Download the EdgeView artifacts, install-ev.sh, ev-fullpkg.tar.xz, and MD5SUM.txt to the /opt directory of your system.                                                                                   

   Note

   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.

   To download a software package from the Ribbon Support Portal, see Ribbon Support Portal - Download Center.

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

   chmod +x install-ev.sh

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

   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:

   ./install-ev.sh

   
   

   Note

   Beginning with Release 16.4.4, using the install-ev.sh script to install Docker and Docker Compose is not supported. Hence, customers must set up Docker before installing or upgrading the EdgeView to Release 16.4.4.

   
   As the EdgeView installation continues, set the GUI_IP, EV_IP, and EV_IP6 values, so that the EdgeView works correctly. Respond to any prompts that arise, especially the GUI_IP, EV_IP, and EV_IP6 prompts, which are critical to the installation. 

   • GUI_IP - The host name or address that the users can use to access EdgeView from the browser's address bar.
     

     Note

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

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

     Note

     The EV_IP6 address is not set by default. If you want to access EdgeView 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 “ EdgeView Installation/Upgrade Completed ”. A directory named scc-build is created.

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

   docker ps --format "table 
   {{.ID}}\t{{.Image}}\t{{.Status}}\t{{.Names}}"

   Tip

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

   docker inspect $container_name

   For example:

   docker inspect scc

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

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

7. For initial SCC configuration, register your EdgeView 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 Ribbon Support.

   Note

   Refer to Manually Configure ZTP when upgrading from EdgeView 15.2.0 or 15.2.1.

   

8. Enter the EdgeView 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 EdgeView.