Silent install of EAA Client

Silent install of EAA Client

You might want to install EAA Client in the background on many computers using software deployment solutions like KACE, JAMF, and SCCM. Execute the installation in command line mode. Command line installation for every software differs considerably. You can use this as a reference and update as required to suit your environment.

To perform a silent install you need to download the relevant files based on whether you want to deploy on 32 bit (Windows platform) or a 64 bit (Windows or Mac platform) computers.

If an existing version of the EAA Client is already installed (regardless of the version), the silent install first removes the existing installation before installing the new version.

Silent install of EAA Client in Windows

  1. Download the latest EAA Client packages for Windows from ​Akamai​ download links:

    https://eaaclientdownloads.akamai-access.com/eaaclientdistro/EAAClient-x64.exe
    
    https://eaaclientdownloads.akamai-access.com/eaaclientdistro/EAAClient-i386.exe
    
  2. Enter the command to start the silent installation with the IdP portal URL:

    <EAA Client package directory>\EAAClient-x64.exe" --mode unattended --unattendedmodeui none --url 
    <idp_portal_url> --autostart no
    

For example, to do a silent install for EAA Client for Windows 64 bit computer with an IdP_portal_URL https://myidpportal.mycompany.com:

".\EAAClient-x64.exe" --mode unattended 
--unattendedmodeui none --url https://myidpportal.mycompany.com --autostart no

The --url option is optional. Use this option when you want EAA Client to authenticate with a pre-configured IdP in the URL location.

The default value for --autostart is yes. This enables EAA Client to start immediately after successful installation. When doing silent install with SYSTEM user, it is recommended to use the no option. This prevents deployment solutions without administrative privileges to automatically start the EAA Client. Instead, it allows the users to manually start the EAA Client on their computers.

The installation starts and runs in the background. Nothing is visible on the screen. It takes a few minutes, and is longer if there is an existing client. After the installation is finished, the IdP.ini file in the EAA Client installation folder is updated with IdP_portal_URL giving in the --url parameter of the silent installation command. When EAA Client starts it is in Not Configured state. The EAA Client automatically opens the browser tab and launches the IdP_portal_URL. After users authenticate, the configuration process automatically finishes. A web page opens to confirm successful configuration. Then, if you open the EAA Client, it is in Authenticated state.

Silent install of EAA Client in MacOS

  1. Download the latest EAA Client packages for MacOS from ​Akamai​ download links:

    https://eaaclientdownloads.akamai-access.com/eaaclientdistro/EAAClient.app.zip
    
  2. Unzip the EAAClient*.zip file with the command tar -xvf EAAClient.app.zip.
    A new Contents folder is created in the path the tar command was invoked from.

  3. Enter this command to start silent installation with the IdP portal URL:

    sudo ./Contents/MacOS/installbuilder.sh --mode unattended
              --unattendedmodeui none --url <idp_portal_url> --autostart no
    

For example, for the IdP_portal_URL https://myidpportal.mycompany.com:

sudo ./Contents/MacOS/installbuilder.sh
-mode unattended --unattendedmodeui none --url
https://myidpportal.mycompany.com --autostart no

The --url option is optional. Use this option when you want EAA Client to authenticate with a pre-configured IdP in the URL location.

The default value for --autostart is yes. This enables EAA Client to start immediately after successful installation. When doing silent install with SYSTEM user, it is recommended to use the no option. This prevents deployment solutions without administrative privileges to automatically start the EAA Client. Instead, it allows the users to manually start the EAA Client on their computers.

The installation starts and runs in the background. Nothing is visible on the screen. It takes a few minutes, and is longer if there is an existing client. After the installation is finished, the IdP.ini file in the EAA Client installation folder is updated with IdP_portal_URL giving in the --url parameter of the silent installation command. When EAA Client starts it is in Not Configured state. The EAA Client automatically opens the browser tab and launches the IdP_portal_URL. After users authenticate, the configuration process automatically finishes. A web page opens to confirm successful configuration. Then, if you open the EAA Client, it is in Authenticated state.

Switch EAA Client to a different identity provider after doing a silent install

Silent installation of EAA Client creates an idp.ini in the software installation folder. Update the idp.ini file with the new identity provider (IdP) URL and configure the EAA Client to this identity provider.

idp.ini file location:

  • Windows OS: C:\ProgramFiles\EAAClient\idp.ini

  • MacOS: /Applications/EAAClient.app/Contents/MacOS/idp.ini

If you installed EAA Client in other location, search for idp.ini inside */EAAClient/ folder.

The idp.ini file has the URL of the identity provider portal.

For the silent install command, for the --url option, if you provide https://myidpportal.mycompany.com as the IdP_portal_URL, the idp.ini file contains this string:

url = https://myidpportal.mycompany.com

A user with admin privileges, should follow this procedure to allow EAA Client to configure to another identity provider portal. For example, to configure to https://myidpportal2.mycompany.com:

  1. Open the idp.ini file, replace the old URL with the new URL, and save it. For example update as:url = https://myidpportal2.mycompany.com and save the file.

  2. Do a reset.

  3. Start the EAA Client. Click EAA Client icon > Open EAA Client.

  4. Configure EAA Client.
    This configures EAA Client to the new identity provider.