Install - Java Controller on Linux VM with Root / Sudo Access
Installation Steps
- Ensure the Linux VM meets the vFunction Prerequisites
- Download the latest vFunction Sudo Controller Installation TGZ from the vFunction Portal
- Move the Installation TGZ to any location on the Linux VM
- Extract the vFunction Installation Package by running the following command. Replace VERSION with the actual value.
sudo tar Pxvf vfunction-controller-sudo-installation.vVERSION.tgz
- Open the server-installation.yaml by running the following command. Replace the INSTANCE_NAME with the actual value.
sudo vi /etc/sysconfig/vfunction/installation/instances/INSTANCE_NAME/installation.yaml
- Modify the required and optional fields following the vFunction Configurable Settings
- Run the installation script. Replace the INSTANCE_NAME with the actual value.
sudo bash /opt/vfunction/controller-installation/install.sh -i INSTANCE_NAME -v
- Configure the JVM Startup Parameters for the vFunction Agent
- Restart the application
Optional flags that can be used in the install.sh script
| Flag | Full Command | Purpose |
|---|---|---|
| -i | –instance | Used to input the Instance Name as a String following the flag |
| -u | –server-username | Used to input the server-installation.yaml’s server.admin.email address to create the vFunction App in the Server UI from the Controller |
| -p | –server-password | Used to input the server-installation.yaml’s server.admin.password to create the vFunction App in the Server UI from the Controller |
| -s | –script-mode | Used to run the installation in script mode so that all no user prompts are displayed and console output is minimized |
| -n | –no-services | Used to install but not start the vFunction services |
| -v | –viper-mode | Used when installed Viper but not the vFunction Agent |
| -a | –agent-mode | Used when installing the vFunction Agent but not Viper |
Installation Video
This video walks through the installation process. Relevant timestamps are included below to jump forward to relevant sections.