Knowledge Base - Optifi
      Back to home
      1. Help Center Home
      2. Knowledge Base - Optifi

      How to deploy Optifi to multiple machines?

      How to perform silent install using Optifi.exe install file.

      Below examples were tested using Optifi.exe version 1.1 build 37 available from Optifi downloads page.

      Microsoft Windows Command Prompt must be run as administrator to test this method.

      1) Type cmd in Windows search and run command as administrator

      cmd-run-as-administrator

      2) Navigate to location of downloaded file. In our case we renamed it to Optifi.exe and on our test laptop the location of exe file is C:\Users\AccessAgility\Desktop>.

      To install the app and have it start after installation, use the command below.

      OptifiAgent.exe /s /v"/qn LAUNCH_AGENT=1"

      3) To uninstall, first exit the app from the config menu by right clicking the gear symbol and selecting Quit Optifi.

      Then run command
      OptifiAgent.exe /x
       
      Settings are stored in the directory below. Please delete this directory after uninstall to force new configuration when testing.
      C:\ProgramData\AccessAgility\Optifi-Agent
       

      Note: Running new setup over a previous one using silent install will automatically update the app but please note  that during update install params are not used and these are only used with fresh install.

       
      4) Example:

      OptifiAgent.exe /s /v"/qn LAUNCH_AGENT=1 DEVICENAME=test-window-system USERNAME=test-user USEREMAIL=test@gmail.com PLACE_HOLDER_LINE_1=\"$R $D\" RUN_DNS=1 RUN_PING=1 RUN_WIFISCAN=1 DIG_HOST=www.google.com  WAN_PING_HOST=www.google.com "

      Need to add \” (slash quote) when using space. This is working when installed using command line. It will not work if Powershell is used.

       

      5) All Optional parameters are below

      Parameter Details Valid Values
      DEVICENAME Name string (space not supported)  
      USERNAME User name string (space not supported)
      USEREMAIL  User email
      SPEED_TEST_INTERVAL

       

      Test frequency in minutes. Automatic testing would be triggered in frequency configured by this setting. For example, setting 60 as a value for this setting would trigger automatic tests every 60 minutes. Tests run during each iteration would depend on other settings. 

      -1 = Only manual testing

      Below values will trigger automated testing every configured time interval in minutes

      1 -1 minute

      2 - 2 minutes

      5 - 5 minutes

      10 - 10 minutes

      30 - 30 minutes

      60 - 1 Hour

      360 - 6 hours

      720 - 12 hours

      1440 - 1 day
      PLACE_HOLDER_LINE_1

      Any string combination where placeholders can be used.

       

      Currently no space is allowed and if using Powershell to install $ sign would need to be escaped using backtick ( ` )
      PLACE_HOLDER_LINE_2

      Any string combination where placeholders can be used.

       

      Currently no space is allowed and if using Powershell to install $ sign would need to be escaped using backtick ( ` )
      RUN_DNS Run DNS test during manual or automated testing

      0 - Don’t run 

      1 - Run
      RUN_PING Run ping test during manual or automated testing

      0 - Don’t run 

      1 - Run
      RUN_SPEED Run speed test during manual or automated testing

      0 - Don’t run 

      1 - Run
      RUN_WIFISCAN Run WiFi Scan during manual or automated testing

      0 - Don’t run

      1 - Run
      LAUNCH_AGENT Start agent after install

      0 - Don’t start

      1 - start
      DIG_HOST Host to use for DIG / DNS command www.google.com
      WAN_PING_HOST

      Host to use for Ping command

      		 www.google.com