<< PREVIOUS NEXT >>

 

 

USING UNSIGNED INSTALLABLE

 

NOTE:

VSP is not supported for:

  • Workloads running SELinux or AppArmor in enforcing mode

  • VSP is not supported for hosts running hypervisor: ESXi/Hyper-V/Zen/KVM

  • Hosts running docker

 

Install VSP Probe on the Application Instance using the below process:

  1. Using any browser, navigate to the Local File Repository URL: https://<Local Repository URL>:8443

  2. Navigate to the directory vsp

  3. To install all the available SKUs (VSP-Enterprise, VSP-Web, VSP-Memory and VSP-Host), right click on the file vsp_install_vm.sh and select the option Copy link address

    1. Download this file to the server using the command:

      1. wget <copiedLink> --no-check-certificate

         

         

        image107

      2. chmod +x vsp_install_vm.sh

         

         

    2. Execute the below commands:

      1. sudo bash

         

         

      2. The below command displays the help menu

        ./vsp_install_vm.sh -h

         

         

      3. Execute the below command to install the probe

        ./vsp_install_vm.sh -c <CMS_IP> -i <Host_IP> -k <VSP_Kafka_Node_IP> -l <LFR_IP> -n <Hostname> -L <LFR_Port> -s <SKU>

         

        1. Parameter "-c" CMS_IP – IP Address of CMS

        2. (Optional) Parameter "-C" <CMS DNS Name> – Custom DNS name for CMS

        3. (Optional) Parameter "-e" – To indicate Remote vRule configuration. Do not provide this option for Remote vRule option

        4. (Optional) Parameter "-H" – Entries are not added in the /etc/host file to resolve the LFR and CMS DNS names. If this parameter is used, ensure that the parameters -C and -K are provided

        5. (Optional) Parameter "-i" Host_IP – IP Address of Application Instance (Host) 

        6. (Optional) Parameter "-k" VSP_Kafka_Node_IP – IP Address of Kafka

        7. (Optional) Parameter "-K" <Kafka DNS Name> – Custom DNS name for Kafka

        8. Parameter "-l" LFR_IP – IP Address of LFR

        9. (Optional) Parameter "-L" LFR_Port – VSP LFR Port (Default port is 8443)

        10. (Optional) Parameter "-n" Hostname – Hostname of the Application Instance. This is utilized during probe registration with CMS

        11. (Optional) Parameter "-p" Host Profile Tag – Appropriate Host Profile Tag

        12. (Optional) Parameter "-r" – To restart VSP services after installation. They are not restarted by default

        13. Parameter "-s" SKU – Provide the required SKU. Allowed values are web, host, mem

        14. (Optional) Parameter "-t" – List of comma-separated Application Service tags to enable a Probe to auto-associate with a CMS Application

        15. (Optional) Parameter "-u" – To uninstall already existing Probe services and install the latest available version

        16. (Optional) Parameter "-U" – To uninstall already existing Probe services

        17. (Optional) Parameter "-v" – To print Verbose information. Allowed values are 0 (INFO level), 1 (DEBUG level) and 2 (TRACE level)

        18. (Optional) Parameter "-X" – To set the password to stop/modify a service using VSP-CLI utility. When this parameter is used, the user is prompted to provide the password (this method is preferred due to security reasons). A valid password must be 16 (minimum) – 511 (maximum) characters in length and must have alphanumeric characters in both upper and lower cases

        19. (Optional) Parameter "-x" – To set the password to stop/modify a service using VSP-CLI utility. When this parameter is used, the password must be provided along with the command. A valid password must be 16 (minimum) – 511 (maximum) characters in length and must have alphanumeric characters in both upper and lower cases

        20. (Optional) Parameter "-o"* – To specify the Operating System. Allowed values are: rhel, ubuntu, debian_stretch, debian_buster, az_linux

        21. (Optional) Parameter "-V"* – To specify the version of the Operating System


      * For Oracle Linux 8, provide the value rhel for parameter "-o" and 8 for the parameter "-V"

  4. Alternatively, to install a specific SKU, follow the steps below: 

    1. Navigate to the directory vsp > <Operating System> > <Operating System Version>

       

      NOTE:

      Navigate to the directory rpm for the Operating Systems RHEL and CentOS

       

    2. Right click on the relevant .sh file and select the option Copy link address

    3. SKU: Select the appropriate file with web (VSP-Enterprise, VSP-Web), memory (VSP-Memory) and host (VSP-Host) in its name

    4. The file name format is: vsp-<SKU>-vm.sh

      image29

    5. Download this .sh file to the server using the command:

      1. wget <copiedLink> --no-check-certificate

         

         

      2. chmod +x vsp-<SKU>-vm.sh

         

         

    6. Execute the below commands:

      1. sudo bash

         

         

      2. The below command displays the help menu

        ./vsp-<SKU>-vm.sh -h

         

         

    7. Execute the below command to install the probe

      ./vsp-<SKU>-vm.sh -c <CMS_IP> -i <Host_IP> -k <VSP_Kafka_Node_IP> -n <Hostname> -0 <Hostname> -o <Host_OS> -V <Host_OS_Version> -r

       

      1. CMS_IP – IP Address of CMS

      2. Host_IP - IP Address of Application Instance 

      3. VSP_Kafka_Node_IP – IP Address of Kafka

      4. Hostname - Hostname of the Application Instance. This is utilized during probe registration with CMS

      5. Host_OS - Operating System of the Application Instance

      6. Host_OS_Version - Operating System Version of the Application Instance

      7. Parameter “-r” - To start VSP services after Installation

      8. (Optional) Parameter “-e” - To indicate Remote vRule configuration. Do not provide this option for Remote vRule option

      9. (Optional) Parameter "-X" – To set the password to stop/modify a service using VSP-CLI utility. When this parameter is used, the user is prompted to provide the password (this method is preferred due to security reasons). A valid password must be 16 (minimum) – 511 (maximum) characters in length and must have alphanumeric characters in both upper and lower cases

      10. (Optional) Parameter "-y" – To set the password to stop/modify a service using VSP-CLI utility. When this parameter is used, the password must be provided along with the command. A valid password must be 511 (minimum) – 32 (maximum) characters in length and must have alphanumeric characters in both upper and lower cases

      11. (Optional) Parameter "-x" – To extract the tar file and exit

  5. At the end of the installation, the installed probe instance automatically registers with VSP CMS and a restart of the Linux machine is NOT required if the parameter -r is provided during installation

  6. If the parameter -r is not provided during installation, restart the services using the below command:

    1. service vsp start

       

       

       

  7. For container-based CMS instance, restart the VSP services in Ubuntu and RHEL Probe instances using the below command:

    1. Method 1: Stop and start VSP services

      1. service vsp stop

         

         

      2. service vsp start

         

         

         

    2. Method 2: Restart VSP services

      1. service vsp restart

         

         

  8. Verification

    1. In CMS, navigate to Deploy > Probes

      image 84

    2. Verify that the Probe server is listed and in Connected state

 

<< PREVIOUS NEXT >>