Version: 10
restore

Contents

To install ActiveEfficiency:

  1. Run the ActiveEfficiencyServer.msiIf you are running the installer on a server where UAC is enabled, start it from a command-prompt with elevated permissions.

  2. On the Welcome screen, click Next.
  3. On the License Agreement screen, accept the license agreement and click Next.
  4. On the Prerequisite Checks screen, the installer runs checks to see if the following are installed before it continues:

    • MSMQ is a prerequisite for the Nomad dashboard, so if that fails the 1E ActiveEfficiency service component will not be installed
  5. On the Destination Folder screen, choose the folder where you want ActiveEfficiency installed. By default, it installs to C:\Program Files (x86)\1E\ActiveEfficiency\. You can choose a different location by clicking Change... Click Next to continue.
  6. On the Database Server screen, enter the name of the server where you want the ActiveEfficiency database installed and click Next. Checks are made to see if the specified machine is an SQL server.

    If you have an existing ActiveEfficiency database you can optionally delete the existing data by checking the Drop any existing ActiveEfficiency database checkbox - if you select this option the existing data will be lost. ActiveEfficiency does not support database mirroring.

    You can use a named instance with: <ServerName>\<InstanceName>. For example, if there is an SQL named instance called Admin on the server SMS01, set the SQL Server Name: field to SMS01\Admin.

    When installing the ActiveEfficiency database to a remote SQL Server instance you will need to take TLS into account. If TLS 1.0 is disabled in your environment you must ensure that the SQL Server Native Client 11.0 (also known as SQL Server 2012 Native Client) has been installed locally and then check the TLS 1.0 disabled - install using TLS 1.1/1.2 checkbox, for more details please refer to Prerequisites-Web servers heading.
  7. On the ActiveEfficiency Website Settings screen, accept the defaults and Click Next or modify the default settings for the ActiveEfficiency Website by ticking the Use Custom IIS Setting checkbox. Exercise caution when doing this and ensure that any changes you make are reflected in the DNS, router and firewall. If you want to customize the settings, check Use Custom IIS settings and update:
    Using custom IIS settings in the ActiveEfficiency installer

    • IIS Port – port used by the ActiveEfficiency Web API
    • IP Address – IP Address for the ActiveEfficiency Web API
    • Host Header – host reader for the ActiveEfficiency Web API. This is the server name used to locate the ActiveEfficiency Web API.

    Any customizations to the ActiveEfficiency Web API will need to be used in all the consumers of data from the ActiveEfficiency Server when configuring the connection to ActiveEfficiency server.

    In order to use a customized host header name, ensure the changes are reflected in your DNS settings.
  8. On the Nomad Sync screen:
    Synchronizing Nomad with Configuration Manager
    1. Tick the Enable Nomad Sync checkbox.
    2. In CM Database Server, enter the name of the server hosting your Configuration Manager database.

      If you are installing ActiveEfficiency on the same server as the Configuration Manager database, do not use its Fully Qualified Domain Name. Use local or the name of the server instead.

    3. In CM Database Name, enter the name of your Configuration Manager database.
    4. Set the synchronization interval. The default is 30 minutes.
    5. Click Next.
  9. On the Ready to Install the Program screen, click Install.
Post-installation, you may want to consider securing the ActiveEfficiency Website.

Upgrading ActiveEfficiency

You should upgrade both the ActiveEfficiency Server and the ActiveEfficiency Scout at the same time.

  • To upgrade the ActiveEfficiency Server, follow its installation procedure and do not drop the existing database

    To support more secure environments with TLS 1.0 disabled, the ActiveEfficiency 1.10 Installer uses a different OLE DB driver compared to older versions. This requires the SQL Server Native Client 11.0 to be present on the ActiveEfficiency application and database servers. Before upgrading, ensure the SQL Server Native Client 11.0 is installed on the ActiveEfficiency application and database server. Refer to Prerequisites for further information and a link to download the SQL Server Native Client 11.0.

  • To upgrade the ActiveEfficiency Scout, follow its installation procedure.

If you made customisations to site bindings, the ActiveEfficiency service account, the servicehost.exe.config file or recreating the ActiveEfficiency cloud certificate you must back these up and restore them after the upgrade.

Note that upgrading ActiveEfficiency Server