Condition | Interpretation |
---|---|
Installation package contains all required files | Verifies that the agent executable can locate and read all required elements that were packaged with it. If this check fails, confirm that that the location of the agent executable relative to its other directories has not changed (you should not move the agent binary outside of the directory it was installed in). Verify that the user account running the agent executable has permissions to read and execute all the directories in the package. |
Able to use Engage engine... | Verifies that the agent executable can load and invoke the Engage Engine dynamically linked library as well as the accompanying “edb” library. If this check fails, confirm that the shared libraries were not moved from the original location and that the user account running the agent has permission to execute the libraries. |
Able to use FIPS 140-2-validated Engage engine. | Verifies that the cryptography module used for transmitting and receiving audio is capable of operating in a US government-certified mode. Note that FIPS-mode is not supported on macOS. If this check fails, confirm the rts-fips shared library exists in the lib/ directory and that the user account running the agent has permission to execute the library. |
Able to read and write ... directory. | Verifies that the agent has permission to read and write files in the named directory. If this check fails, confirm that the directory exists and that the user account running the agent has read and write permissions to the named directory. |
Able to enumerate available network interfaces. | Verifies that the agent can detect one or more available network interfaces. If the check fails, confirm that the host system has at least one “up” network interface. |
Able to infer the IPv4 address of this system. | Verifies that the agent can determine the IP address and (optionally) the system’s hostname. If this check fails, confirm that the host system has at least one “up” interface and the interface has an assigned IP address. |
Able to retrieve the installation ID of this system. | Verifies that an installation ID (used for software licensing) can be determined for the system. Under unusual circumstances this can fail if a suitable hardware identifier cannot be found. If this check fails, try using Docker as an alternate deployment mechanism or contact Instant Connect Support for assistance. |
Able to fetch a web page on the internet. | Verifies that the agent can fetch the Instant Connect corporate website from the internet. It is not critical that ICE Agent reach the Instant Connect website; this check exists only to highlight unexpected network connectivity issues. If you don’t expect ICE Agent to be able to reach this website from your network or host, this check can be ignored. Otherwise, if this check fails it likely indicates a problem with your host’s network setup. ICE Agent does not connect to other systems on the Internet, except for those that may be required by your system configuration (for example, the ICE Server itself, Rallypoints referenced by a channel configuration, or a linguistic service provider like AWS or Azure). Note that ICE Agent utilizes third-party software from https://sentry.io to report crashes and other failures. ICE Agent may attempt to communicate with their servers in the event of an unexpected error. Use the argument --no-crash-reporting to disable any communication with Sentry. |
Able to generate a self-signed SSL certificate | Verifies that OpenSSL is available on the host system and that ICE Agent can execute it. Some operations depend on OpenSSL to generate and verify SSL certificates. If this check fails, confirm that OpenSSL has been installed on the host system and that the openssl command is in the path. |
Able to use GPG on this platform | Verifies that GPG is available on the host system and ICE Agent can execute it. Some operations depend on GPG to validate authenticity of downloadable software packages. If this check fails, confirm that GPG has been installed on the host system and that the gpg command is in the path. |