EAA Client operations

In EAA Client you can do different operations like configuration, diagnostics, sending logs, getting alert messages, and other advanced functions like synchronization, factory reset, update of the EAA Client to the latest version.

Run diagnostics inside EAA Client

The Run Diagnostics function examines the status of the installation, connectivity, components, and configuration downloads from the Enterprise Application Access (EAA) solution. Green icon () indicates success and red icon () indicates failure.

  1. Right-click the EAA Client icon on the Windows desktop toolbar or the Mac menu bar.

  2. Click EAA Client icon > Open EAA Client.

  3. Click Diagnostics > Run Diagnostics.
    If the installation is okay, all of the configurations are downloaded from Enterprise Application Access, and components are okay, green icon () appears.

  4. If any of the diagnostic results are unsuccessful, or marked with a red icon () do the following:

    1. For only a configuration failure, perform a sync operation.
      If this does not fix the issue or if all checks fail, continue to troubleshoot:

    2. Take a screenshot and provide it to your EAA administrator.

    3. Capture logs, device ID, EAA Client version and send to ​Akamai​. Contact support.

Copy device ID, user name, IdP, and version of EAA Client

Device ID, IdP and version are useful to debug issues and provide information to the help desk. Admin might also note down the user's name.

  1. Right-click the EAA Client icon on the Windows desktop toolbar or the Mac menu bar.

  2. Click EAA Client icon > Open EAA Client.

  3. Click Diagnostics.

  4. Hover over the icon next to Troubleshoot your device and click Click to copy device id.

  5. In the EAA Client settings section, hover over the icon next to Version, and click Click to copy version.

  6. Save the IdP name and user name.

Save and send logs inside EAA Client

EAA Client logs are useful to debug issues and provide information to the help desk. Users can access logs downloaded to their computer. They can send a zipped version of the logs to the EAA administrator. This is useful when the administrator contact's support.

  1. Right-click the EAA Client icon on the Windows desktop toolbar or the Mac menu bar.

  2. Click EAA Client icon > Open EAA Client.

  3. Click Options.

  4. In Logs select the verbosity level of the logs depending on how much information is required:

    • High. Sends debug information about EAA Client and connectivity to native applications. This option can slow down the performance of the EAA Client, since the logs can be long. It is intended for troubleshooting purposes for ​Akamai​ support and engineering.

    • Medium. Sends information messages to support about EAA Client.

    • Low. Default setting. Sends only the error logs to eaaclient.log for troubleshooting purposes. It could be errors in the EAA Client itself or connectivity between the native applications and the EAA Client on the computer.

  5. You can continue with the following actions:

    • To send the logs to the EAA administrator, click Click to send logs. In the backend, these logs are zipped.

    • To save the logs to your machine, click Click to save. This saves a zip file on your machine that includes the activity.log, akamai_dpclient.log, eaaclient.log, stderr.log, and stdout.log files.

You can choose another folder or directory to save the five log files as a zip file. The logs are readable. You can open them in a text reader of your choice to view them.

By default, the EAA Client logs are stored here on the user's computer.

Synchronize the client inside EAA Client

Perform an explicit sync. This forces the configuration information from Enterprise Application Access to the EAA Client.
The EAA Client synchronizes to the EAA Login Portal every five minutes for any configuration changes in an application or identity provider. To immediately synchronize the EAA Client with Enterprise Application Access you can force an explicit synchronization. If you have any issues with running diagnostics, try to sync.

  1. Right-click the EAA Client icon on the Windows desktop toolbar or the Mac menu bar.

  2. Click EAA Client icon > Open EAA Client.

  3. Click Options.

  4. Click Click to synchronize.

Reset the EAA Client

You can reset the EAA Client to the original factory settings of the software. It does a database reset and removes all of the configuration information. A complete configuration update is required after doing a reset.

  1. Right-click the EAA Client icon on the Windows desktop toolbar or the Mac menu bar.

  2. Click EAA Client icon > Open EAA Client.

  3. Click Options.

  4. Click Click to reset.

📘

A complete configuration is required after a reset operation. You need to configure EAA Client.

Check alerts inside EAA Client

You can check different types of alerts inside EAA Client and use them to troubleshoot.

  1. Right-click the EAA Client icon on the Windows desktop toolbar or the Mac menu bar.

  2. Click EAA Client icon > Open EAA Client.

  3. Click Alerts.

Example:

You add an IP address while configuring tunnel applications to access local a IP within your organization. If it is already present in the routing table, there is a route collision. You get a message:

IP based access may not be working,
reason: Existing specific route: 172.16.0.0 IP gw On-link
Contact Administrator 

Here, 172.16.0.0 IP address is already present in the routing table of the gateway and cannot be used for IP based access by 172.16.0.0 IP.