Install vFunction Viper for a Java on Linux

1. Copy the binaries of your application (.ear/.war/.jar) to a directory in Linux. We will call this directory binaries dir.

2. Download and copy the sudoless vFunction package to the Linux machine

   a. If you have access to the vFunction portal:

    - Login to the portal
    - Go to vFunction Installation Physical Files from the Dashboard
    - Go to the Controller Folder and the version subfolder (e.g. 4.0)
    - Next to the sudoless file (e.g. vfunction-sudo-less-installation.v4.0.1603.tgz) click on the three dots menu to the right and download the file
    - Copy the file to the Linux machine and move it to the folder under which you’d like to install vFunction (e.g. /home/tomcatuser) 
   

   b. Alternatively, ask your vFunction contact for the public link of the sudoless installation package and download it to your Linux machine. If you have access to the internet you can use wget or curl to download the package:

    Example:
   

   curl https://portal.vfunction.com/file/fe09339e19e/vfunction-controller-sudo-less-installation.v4.0.1603.tgz --output vfunction-sudoloess-controller.tgz
   

3. Extract the content of the installation package in the folder you want to install the agent (we will call this folder installation folder), this will create a subfolder called vfunction under the installation folder, which will contain all the installation files

   example:

   tar zxvf vfunction-sudoloess-controller.tgz
   

4. Run the following script from the installation folder to create a viper instance:

   bash ./vfunction/opt/vfunction/controller-installation/create-instance.sh -i viperinst -t java -v
   

5. Click here to download a script (vfviperenv.sh) that sets the environment variables.

6. Copy vfviperenv.sh file to the installation folder in Linux machine (the parent folder of the vfunction folder). Then edit the file and set the values based on the comments in this script.

7. Apply the environment variables by doing:

   source vfviperenv.sh
   

8. Run the installation from the installation folder:

   bash ./vfunction/opt/vfunction/controller-installation/install.sh -i viperinst
   

9. You should see a success message at the end of the run. You should see viper running in the application in the vFunction server Web UI, in the select controllers page in the learning tab.