Fortinet white logo
Fortinet white logo

Configuring FortiPresence VM

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.

  1. 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.
  2. 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:.
  3. 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.
  4. Run the source ~/.bash_profile command on both the VMs prior to using the CLI mode.
  5. 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.
  6. 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

  7. Run the presence-infra --init command in the /presence/ directory on the Infrastructure server to initialize the infrastructure services and follow the instructions.
  8. 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.

  9. 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.
  10. Enter the required details to create an account, for example, email address and password to access the FortiPresence VM GUI.
  11. 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

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.

  1. 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.
  2. 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:.
  3. 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.
  4. Run the source ~/.bash_profile command on both the VMs prior to using the CLI mode.
  5. 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.
  6. 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

  7. Run the presence-infra --init command in the /presence/ directory on the Infrastructure server to initialize the infrastructure services and follow the instructions.
  8. 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.

  9. 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.
  10. Enter the required details to create an account, for example, email address and password to access the FortiPresence VM GUI.
  11. 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.