Troubleshooting - Common problems

Unique code problem

If you are unable to download the certificate linked to your unique code, this may be due to :

  • an error in entering the code (4 sequences of 4 uppercase letters separated by dashes),

  • reuse of a unique code already used by another agent,

  • reinstalling the agent with the same unique code without first revoking the current certificate.

Use an Internet gateway (proxy)

Some Internet gateways substitute the SSL certificates used to secure the connection.

To use the web gateway, add the configuration file to the focalist-agent / config folder:

  1. Open the TextEdit application

  2. Click on New Document

  3. Insert the following line with the IP address or host name:

    proxyHost = <web gateway address>

    e.g. proxyHost = 165.212.24.11

    proxyHost = justin.biber.it

  1. If and only if this gateway requires user authentication, add the following lines:

    proxyUser=<userid>

    proxyPassword=<password>

    eg: proxyUser = Hatsune.Miku

    proxyPassword = HatsuneMiku

    Note: this password will be encrypted during agent installation.

  1. If the gateway modifies SSL certificates, add the following line:

    sslTrustAll = true

  2. Save the file you have created, renaming it agent.config in the focalist-agent / config folder.

  3. Don't forget to remove the .txt extension if it has been added by default.

Using a service account

If the Internet gateway does not allow the agent to access the FOCALIST server, it may be because it is unable to authenticate the requesting computer. In this case, you need to run the agent under a service account known to the Active Directory.

 

Launch the Services administration module by typing services.msc in the desktop search field. Scroll down the list of services to the focal-agent line, right-click to display the Service Properties. In the Connection tab, uncheck the Local system account option and enter the account and password to be used in the This account option:

Une image contenant texte Description générée automatiquement

 

The settings will be provided by the customer's system administrator. In the meantime, you can use the Windows identifiers used to connect to this computer, but this is not recommended, as if the assignment or password is changed, the connection will no longer work.

Other installation in progress

If the installation procedure fails, check that you have not run several installations in parallel. The associated error code is 1603.