Configuring FortiPresence VM

Perform the following steps to access and configure the VMs after successful installation.

Note: If the hardware recommended for 3000 MACs/sec scaling is deployed, the presence-apps command displays an additional option to select the scale configuration between 1000 MACs/sec (default) and 3000 MACs/sec.

Log in into the newly created VMs as root user with the username root and password root@123. Modify the password after the first login.
Note: root credentials must be used by an administrator only. Login with appropriate user permissions to ensure that the installation is successful.
Ensure that the IP addresses of both the VMs are configured appropriately. Run the ifconfig command, the IP address is displayed after inet in the section beginning with ens192:.
Ensure that the date and time are updated correctly. Run the following commands to manage the time-zone settings.
- timedatectl: To view the system’s current time-zone.
- timedatectl list-timezones: To list the available time-zones.
- timedatectl set-timezone <time_zone>: To set to a new time-zone. For example, timedatectl set-timezone America/Toronto.
Run the source ~/.bash_profile command on both the VMs prior to using the CLI mode.
Logout as the root user and login as presence user with the username and password presence.
Note: This ensures appropriate permissions to files and folders and system upgrades. Login with appropriate user permissions to ensure that the installation is successful.
Download the following files from the Fortinet Support portal.
Infrastructure server: FPVM-infra-vx.y.z-buildxxxx.tar and FPVM-cli-vx.y.z-buildxxxx.tar
Application server: FPVM-apps-vx.y.z-buildxxxx.tar and FPVM-cli-vx.y.z-buildxxxx.tar
After the download is complete, run these commands, sftp username@<SFTP_server_IP>:<filename.tar> OR scp username@<SCP_server_IP>:<filename.tar> /presence.
Extract the appropriate CLI script from the tar on both the servers.
Infrastructure server: tar -xzf FPVM-cli-vx.y.z-buildxxxx.tar presence-infra
Application server: tar -xzf FPVM-cli-vx.y.z-buildxxxx.tar presence-apps
Run the presence-infra --init command in the /presence/ directory on the Infrastructure server to initialize the infrastructure services and follow the instructions.
Run the presence-apps --init command in the /presence/ directory on the Application server and use the displayed options to manage or check the status of the application services.
Update the IP addresses for Infrastructure and Applications hosts, and optionally the FortiPresence VM FQDN for GUI access and the FortiPresence Connect FQDN for captive portal usage.
Enter the required details to create an account, for example, email address and password to access the FortiPresence VM GUI.
Run the presence-apps command to display options to manage or view the services.

Additional Commands

These are details on some commands for FortiPresence VM.

Command	Description
`presence-infra`	Displays general options to manage the infrastructure services.
`presence-apps --help`	Displays presence-apps script usage details with various available options.
`presence-infra --info`	Displays information on the infrastructure services.
`presence-infra --init`	Initializes the infrastructure services for the first time.
`presence-apps --init`	Initializes the application services for the first time.
`Get Status`	Displays the status of the services.
`Start Services`	Starts the services.
`Stop Services`	Stops the services.
`Show Logs`	Displays services' logs.

Configuring FortiPresence VM

Perform the following steps to access and configure the VMs after successful installation.

Log in into the newly created VMs as root user with the username root and password root@123. Modify the password after the first login.
Note: root credentials must be used by an administrator only. Login with appropriate user permissions to ensure that the installation is successful.

Ensure that the IP addresses of both the VMs are configured appropriately. Run the ifconfig command, the IP address is displayed after inet in the section beginning with ens192:.

Ensure that the date and time are updated correctly. Run the following commands to manage the time-zone settings.

timedatectl: To view the system’s current time-zone.
timedatectl list-timezones: To list the available time-zones.
timedatectl set-timezone <time_zone>: To set to a new time-zone. For example, timedatectl set-timezone America/Toronto.

Run the source ~/.bash_profile command on both the VMs prior to using the CLI mode.

Logout as the root user and login as presence user with the username and password presence.
Note: This ensures appropriate permissions to files and folders and system upgrades. Login with appropriate user permissions to ensure that the installation is successful.

Download the following files from the Fortinet Support portal.
Infrastructure server: FPVM-infra-vx.y.z-buildxxxx.tar and FPVM-cli-vx.y.z-buildxxxx.tar
Application server: FPVM-apps-vx.y.z-buildxxxx.tar and FPVM-cli-vx.y.z-buildxxxx.tar
After the download is complete, run these commands, sftp username@<SFTP_server_IP>:<filename.tar> OR scp username@<SCP_server_IP>:<filename.tar> /presence.

Extract the appropriate CLI script from the tar on both the servers.
Infrastructure server: tar -xzf FPVM-cli-vx.y.z-buildxxxx.tar presence-infra
Application server: tar -xzf FPVM-cli-vx.y.z-buildxxxx.tar presence-apps

Run the presence-infra --init command in the /presence/ directory on the Infrastructure server to initialize the infrastructure services and follow the instructions.

Run the presence-apps --init command in the /presence/ directory on the Application server and use the displayed options to manage or check the status of the application services.

Update the IP addresses for Infrastructure and Applications hosts, and optionally the FortiPresence VM FQDN for GUI access and the FortiPresence Connect FQDN for captive portal usage.

Enter the required details to create an account, for example, email address and password to access the FortiPresence VM GUI.

Run the presence-apps command to display options to manage or view the services.

Additional Commands

These are details on some commands for FortiPresence VM.

Command

Description

presence-infra

Displays general options to manage the infrastructure services.

presence-apps --help

Displays presence-apps script usage details with various available options.

presence-infra --info

Displays information on the infrastructure services.

presence-infra --init

Initializes the infrastructure services for the first time.

presence-apps --init

Initializes the application services for the first time.

Get Status

Displays the status of the services.

Start Services

Starts the services.

Stop Services

Stops the services.

Show Logs

Displays services' logs.

Administration Guide

Configuring FortiPresence VM