Installing AgilePoint Deployment Service for .NET 4.0

To install the AgilePoint Deployment Service component, do the following.

Prerequisites

Navigation

  1. Open the AgilePoint installation package.
  2. On the Software License Agreement window, review the license agreement, and click Accept.
  3. On the Destination Folder window, select the folder where you want to extract the installation files.
  4. Click Install.
  5. On the Welcome window, create your custom Preparing for Installation guide, if required.

Instructions

  1. On the AgilePoint installer, click Utilities and Other Support Files.
  2. Click AgilePoint Deployment Service.
  3. On the Welcome window, click Next.
  4. On the Verify System Requirements window:
    • If there are any errors, correct them. Once you have resolved the issue, click Recheck.
      Issue Resolution

      Supported Operating system is installed

      Install a supported operating system on this machine.

      For more information, see AgilePoint Server Requirements.

      Current user has administrator privilege

      Log on to this machine as a user with administrator privileges.

      User Account Control (UAC) is turned off

      Turn user access control (UAC) off.

      For more information, see Turning Off User Account Control (UAC).

      Supported version of the .NET Framework is installed

      Install .NET Framework 4.0 on this machine.

      For more information, see AgilePoint Server Requirements.

      Port 8917 is available.

      This port is required for this component. Before you install, ensure no other applications are using this port.

    • If there are no errors, click Next.
  5. In the Install Location section, enter the following information:
    Field Name Definition

    Install location

    The folder where you want to install the AgilePoint component.

  6. Click Next.
  7. Once the installation has completed, click Next.
  8. On theDeployment Service Configuration window, enter the following information:
    Field Name Definition

    Domain

    Definition:
    The authentication domain for the AgilePoint service account.
    Allowed Values:
    A valid domain.

    Username

    Definition:
    Specifies the user name for your AgilePoint service account. This account serves as your AgilePoint service account, your AgilePoint administrator account, and the account that AgilePoint uses to communicate with SharePoint.

    This account must be set up before entering the account information here. The AgilePoint installer cannot create this account for you.

    Allowed Values:
    A valid user name for an account with the required privileges detailed in Setting Up the AgilePoint Service Account.

    Password

    Definition:
    The password for the AgilePoint service account.
    Allowed Values:
    A valid password.

    AgilePoint Service URL

    Specifies the AgilePoint Service URL for your AgilePoint BPMS environment.

    For more information, see Finding Your AgilePoint Service URL on Premises.

  9. Click Next.
  10. Once the installation has completed, click Next.
  11. Once the Installation Complete message is displayed, click Finish.
  12. Restart the machine.

    This is optional, but recommended. Rarely AgilePoint users have reported an issue with shortcuts not displaying if the machine is not restarted. There are no other known issues if you do not restart the machine. Windows sometimes prompts to restart, and sometimes not. This is determined by the operating system.

Note: If the following message appears, run the Client Utility Tool from the AgilePoint installation program: "Failed to add Service model information in [path]\web.config. Please use SVCClient Utility tool to update it before using." For more information, see Run the Windows Service Client Utility Tool.