<< PREVIOUS NEXT >>

 

 

USING SIGNED INSTALLABLE

 

Install VSP Probe using the below process:

  1. Download the files listed below from LFR:

    1. virsec.gpg.key from the directory: vsp

    2. vsp-<SKU>-vm.sh.gpg from the directory: vsp > Operating System > Version > Signed

    image162

  2. Execute the commands below:

    1. Import the Virsec key using the command below:

      1. gpg --import virsec.gpg.key

         

        image131

    2. Verification: List the available keys using the command:

      1. gpg --list-keys

         

         

        image 132

    3. Un-sign the downloaded gpg file using the command:

      1. gpg --output vsp-<SKU>-vm.sh --decrypt vsp-<SKU>-vm.sh.gpg

         

        image 133

    4. The above command creates an un-signed output file vsp-<SKU>-vm.sh in the same directory

      image 134

  3. Execute the below commands:

    1. sudo bash

       

       

    2. The below command displays the help menu

      ./vsp_install_vm.sh -h

       

       

      image163

    3. ./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> -g

       

      1. (Optional) Parameter "-g" – To specify the utilization of the signed scripts for installation of the specified SKU

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

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

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

      5. (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

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

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

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

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

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

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

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

      13. (Optional) Parameter "-P" – To enable pristine host mode for VSP-Host

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

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

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

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

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

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

      20. (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

      21. (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

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

      23. (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. Execute the commands below to install VSP Probe:

    1. sudo bash

       

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

       

       

    3. The below command displays the help menu

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

         

         

        image 135

    4. 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 “-P” – To enable pristine host mode for VSP-Host

      10. (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

      11. (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 16 (minimum) – 511 (maximum) characters in length and must have alphanumeric characters in both upper and lower cases

      12. (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 >>