Product DocsMenu

Installing or Updating CES Silently

Advanced users can use the Coveo Enterprise Search (CES) install kit, which is a standard Windows Installer package (.msi file) wrapped in a self-extracting archive, to install or update CES without having to go through dialogs. The install kit is launched using msiexec, the Windows installer executable that comes with all Windows installations.

Note: This feature is useful in a large scale deployment in which you need to install or update CES on different machines with the same or mostly the same parameters.

Important: The Coveo Support team will not provide any assistance regarding this procedure.

To install CES silently

  1. With an administrator account, log in to the target machine.

  2. Ensure the machine meets the following requirements:

  3. Disable User Access Control for both an install or an update (see Turn User Account Control on or off).

  4. When your machine runs on Windows Server 2012/Windows 8 and subsequent, set the EnableLUA registry key to 0:

    1. Click the Windows Start button, and then type and select Run.

    2. In the Run window, in the Open box, enter regedit.exe and then click OK.

    3. In the Registry Editor window, access the System folder (HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System).

    4. In the System folder, open EnableLUA, and then change the value in the Value data box to 0.

    5. Restart the machine.

  5. Once the machine is restarted, open a text editor.

  6. In the text editor, build a command line:

    1. Since the installation is launched using msiexec.exe, start your command line with msiexec (see Msiexec (command-line options)).

    2. The parameter to install or update the software is /i, followed by the installer package file path and the parameter for a silent installation is /qn.

      Note: After these two sub-steps, your command line should look like the following:

      msiexec/i "C:[FilePath]\Coveo Enterprise Search 7.0 x64 (nnnn).msi" /qn

    3. For installation only, depending on your setup:

      Notes:

      • The syntax to respect is the following: [VARIABLE]=[Value].

      • Values are separated by commas.

      • Variables are separated by spaces.

      • Variable names are case sensitive.

      1. Using the ADDLOCAL variable, ensure the command line contains the required CES features:

        Tip: A typical installation includes the following features: CESService, CESConsole, Admin, AdminService (only for Sitecore integrations), DiagnosticTool, BaseFeature and VCRedist.

        Features Description Is required
        Admin Web application used to configure Coveo Enterprise Search No (but recommended)
        AdminService The Coveo Admin Service Only in Sitecore Integration setups
        DiagnosticTool The Coveo Diagnostic Tool No
        CESService The master Coveo Enterprise Search service No (if CESMirror is installed)
        CESMirror

        The mirror Coveo Enterprise Search service

        No (if CESService is installed)
        CESConverter Converts documents for the Coveo Enterprise Search Server No
        CESConsole Tool to monitor the Coveo Enterprise Search Server No (but recommended)
        BaseFeature Set of files required for the installation Yes
        VCRedist Microsoft Visual C++ Redistributable 2012 Yes
      2. Add the required options that have no default value (LOGONACCOUNT_DOMAIN, LOGONACCOUNT_USERNAME and LOGONACCOUNT_PASSWORD) and optionally add others, or modify default option value(s):

        Note: When options are not included in the command line, their default value is taken into account.

        Important: It is recommended to only use or modify options that you are familiar with. A misuse of options can make CES unusable, and some options can even impact your target machine environment.

        Variable Default Description Is required
        ISSITECORE 0 Set this parameter to 1 to install RabbitMQ along with CES. No
        INSTALLLOCATION " C:\Program Files\Coveo Enterprise Search 7" Installation folder for the application Yes
        NEW_WEBSITE_NAME "Coveo Enterprise Search 7 Admin" The name of the web site that will be automatically created Yes
        NEW_WEBSITE_PORT 8080 The port used for the new web site Yes
        NEW_WEBSITE_IP * IP address of the new website (* stands for "All Unassigned") Yes
        LOGONTYPE account

        The type of logon used for the service

        Yes
        LOGONACCOUNT_DOMAIN   The domain of the account Yes
        LOGONACCOUNT_USERNAME   The user name used to log on Yes
        LOGONACCOUNT_PASSWORD   The password of the account Yes
        SERVICES_PORT 52800 The port used by the CES service (or the slice or mirror depending on the installation) Yes

        SKIP_CHK_CES_READY_FOR_UPGRADE

        CES 7.0.6339+ (January 2014)

        false Use this flag to skip the check for mirrors availability when performing an upgrade. Yes

        USE_ADMIN_SERVICE_SECURITY

        CES 7.0.6547+ (March 2014)

          (For a Sitecore integration only) Define this property and the two following ones to activate Admin Service security. No

        ADMINSERVICELOGON_USERNAME

        CES 7.0.6547+ (March 2014)

          (For a Sitecore integration only) If using Admin Service security, set the username to use. Will be inserted in the security configuration file. No

        ADMINSERVICELOGON_PASSWORD

        CES 7.0.6547+ (March 2014)

          (For a Sitecore integration only) If using Admin Service security, set the password to use. Will be hashed and inserted in the security configuration file. No

        ADMIN_SERVICE_PORT

        CES 7.0.6547+ (March 2014)

          (For a Sitecore integration only) If using Admin Service security, set the port to use. Will be inserted in the security configuration file. The service usually uses port 443. Yes

        ADMIN_SERVICE_CERTIFICATE_EXPORT_PATH

        CES 7.0.6547+ (March 2014)

        Typically C:\Program Files\Coveo Enterprise Search 7 Use this parameter to set the Admin Service certificate path to a specific output folder. No

        ADMIN_SERVICE_CES_SERVER_NAME

        CES 7.0.6547+ (March 2014)

        [YOUR HOST NAME] Use this parameter to set a specific name for the certificate pfx file. No

        ADMIN_SERVICE_PRIVATE_KEY_PASSWORD

        CES 7.0.6547+ (March 2014)

          Use this parameter to set a password to secure the certificate private key. It can be an empty string. No

        SKIP_SERVICES_CHECK

        CES 7.0.6767+ (June 2014)

          When defined, will not fail the installation if the CES service fails to start. No
    4. Once done, copy the command line.

      Note:

      • A typical installation command line:

        msiexec /i "C:\[FilePath]\Coveo Enterprise Search 7.0 x64 (nnnn).msi" /qn ADDLOCAL=BaseFeature,VCRedist,CESService,Admin,AdminService,CESConsole LOGONTYPE=account LOGONACCOUNT_DOMAIN=[domain] LOGONACCOUNT_USERNAME=[username] LOGONACCOUNT_PASSWORD=[password]

      • A typical update command line:

        msiexec /i "C:\[FilePath]\Coveo Enterprise Search 7.0 x64 (nnnn).msi" /qn

      Example: When you are installing CES in a Coveo for Sitecore setup, the certificate creation for the admin service is mandatory. The typical installation command line looks like the following:

      msiexec /i "C:\[FilePath]\Coveo Enterprise Search 7.0 x64 (nnnn).msi" /qn ADDLOCAL=BaseFeature,VCRedist,CESService,Admin,AdminService,CESConsole ISSITECORE=1 LOGONTYPE=account LOGONACCOUNT_DOMAIN=[domain] LOGONACCOUNT_USERNAME=[username] LOGONACCOUNT_PASSWORD=[password] USE_ADMIN_SERVICE_SECURITY=Yes ADMIN_SERVICE_PORT=443 ADMINSERVICELOGON_USERNAME=coveoservice ADMINSERVICELOGON_PASSWORD=[password]

  7. Once your command line is done, open Command Prompt as an administrator.

  8. In the Command Prompt, paste and execute the command line.

  9. Ensure Coveo Enterprise Search (CES) is correctly installed.

People who viewed this topic also viewed