Signed Installable

<< PREVIOUS NEXT >>

USING SIGNED INSTALLABLE

Install VSP Probe using the below process:

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
Execute the commands below:
1. Import the Virsec key using the command below:
  1. gpg --import virsec.gpg.key
2. Verification: List the available keys using the command:
  1. gpg --list-keys
3. Un-sign the downloaded gpg file using the command:
  1. gpg --output vsp-<SKU>-vm.sh --decrypt vsp-<SKU>-vm.sh.gpg
4. The above command creates an un-signed output file vsp-<SKU>-vm.sh in the same directory
Execute the below commands:
1. sudo bash
2. The below command displays the help menu
  
  ./vsp_install_vm.sh -h
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 "-r" – To restart VSP services after installation. They are not restarted by default
  14. Parameter "-s" SKU – Provide the required SKU. Allowed values are web, host, mem
  15. (Optional) Parameter "-t" – List of comma-separated Application Service tags to enable a Probe to auto-associate with a CMS Application
  16. (Optional) Parameter "-u" – To uninstall already existing Probe services and install the latest available version
  17. (Optional) Parameter "-U" – To uninstall already existing Probe services
  18. (Optional) Parameter "-v" – To print Verbose information. Allowed values are 0 (INFO level), 1 (DEBUG level) and 2 (TRACE level)
  19. (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
  20. (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
  21. (Optional) Parameter "-o"* – To specify the Operating System. Allowed values are: rhel, ubuntu, debian_stretch, debian_buster, az_linux
  22. (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"
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
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 "-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 16 (minimum) – 511 (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
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
If the parameter -r is not provided during installation, restart the services using the below command:
1. service vsp start
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
Verification
1. In CMS, navigate to Deploy > Probes
2. Verify that the Probe server is listed and in Connected state

<< PREVIOUS NEXT >>