Install AgilePoint Data Services

To install AgilePoint Data Services, do the procedure in this topic.

Prerequisites

Good to Know

  • The installer UI is optimized for system resolutions 1366x768 or 1920x1080 with 100% scaling. If you use other screen resolutions, the installer UI may not display correctly, which can cause installation errors.

How to Start

  1. On your AgilePoint Server machine, open the folder C:\AgilePoint\8.0-Full\AgilePoint\DataService.
  2. Right-click the Setup.exe file, and click Run as Administrator.

    Setup dot exe file

Procedure

  1. On the Welcome to AgilePoint Data Service Installation screen, click Next.

    Welcome to AgilePoint Data Service Installation screen
  2. On the Verifying System Requirements screen:
    • If there are any errors, correct them. Once you have resolved the issue, click Recheck.

      Verifying System Requirements Error screen AgilePoint Data Services
      Issue Resolution

      Supported Operating system is installed

      Install a supported operating system on this machine.

      For more information, refer to System Requirements for AgilePoint Server.

      Current user has Administrative privileges

      Sign in 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, refer to Turn Off User Account Control (UAC).

      Supported Version of .NET Framework is installed

      Install a supported version of .NET Framework on this machine.

      For more information, refer to System Requirements for AgilePoint Server.

    • If there are no errors, click Next.

      Verifying System Requirements screen AgilePoint Data Services
  3. In the Install Location field, complete this field.

    AgilePoint Data Services Install Location screen
    Field Name Definition

    Install Location

    Function:
    The folder where you want to install the AgilePoint component.
  4. Click Next.

    The AgilePoint Data Services installation starts.


    AgilePoint Data Services Installation Start screen
  5. After the installation completes, click Next.

    AgilePoint Data Services Installation Completed screen
  6. On the AgilePoint Data Services Configuration screen, enter the following information:

    AgilePoint Data Services Configuration screen
    Field Name Definition

    Domain Name

    Function:
    The authentication domain for the AgilePoint Service Account.
    Accepted Values:
    An alphanumeric string with no spaces that represents an authentication domain in your environment.

    User Name

    Function:
    Specifies the user name for your AgilePoint Service Account. This account serves as your AgilePoint Service Account, your AgilePoint System Account, and the account that AgilePoint uses to communicate with SharePoint, called the SharePoint impersonator.

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

    For more information, refer to Administrator Types and Permission Groups.

    Accepted Values:
    A user name for an account with the required privileges detailed in Set Up the AgilePoint Service Account.

    Password

    Function:
    The password for the AgilePoint Service Account.
    Accepted Values:
    An alphanumeric string that represents a password.
  7. To make sure the user credentials are valid, click Test.

    AgilePoint Data Services Configuration screen

    If the user credentials are valid, this screen opens. On this screen, click OK.


    AgilePoint Data Services Authentication Successful Message screen
  8. Click Next.
  9. Complete these fields:

    AgilePoint Data Services Configuration screen
    Field Name Definition

    Time Interval

    Function:
    The timer interval, in seconds, used by Data Services to check for new entries in the database.

    To improve performance, on a production system, this value is often set to 3600 seconds, or 1 hour.

    Accepted Values:
    An integer, representing a number of seconds.
    Default Value:
    150

    AgilePoint Service URL

    Specifies the AgilePoint Service URL for your AgilePoint BPMS environment.

    For more information, refer to Find Your AgilePoint Service URL in AgilePoint NX.

    Enable Data Population

    Function:
    Turns on the data population feature, which lets application data to be written to the database.
    Accepted Values:
    • Selected - Turns on the Data Population feature.
    • Deselected - Turns off the Data Population feature.
    Default Value:
    Selected

    Enable Data Tracking

    Function:
    Turns on the data tracking feature, which lets application data to be tracked across processes and components.
    Accepted Values:
    • Selected - Turns on the Data Tracking feature.
    • Deselected - Turns off the Data Tracking feature.
    Default Value:
    Selected
  10. In the Database Authentication section, enter the following information for your Data Services database.

    AgilePoint Data Services Configuration Database Authentication screen
    Field Name Definition

    Database Type

    Function:
    Specifies the database technology to store your data.
    Accepted Values:
    Microsoft SQL Server.
    Default Value:
    Microsoft SQL Server

    Windows Authentication

    Function:
    Specifies whether the database connection uses Windows authentication.
    Accepted Values:
    • Selected - The database connection uses Windows Authentication, and the machine's authenticated user connects to the database server.

      If this option is selected, the User and Password fields are not required.

    • Deselected - The database connection does not use Windows authentication.

    User Name

    Function:
    The user name for the account AgilePoint Server uses to connect to the database.
    Accepted Values:
    An alphanumeric string that contains a user name for the database.
    Default Value:
    sa

    Password

    Function:
    The password for the authentication account.
    Accepted Values:
    An alphanumeric string that represents a password.
    Default Value:
    None

    Database Server

    Function:
    The database used for data tracking.
    Accepted Values:
    An alphanumeric string with no spaces that represents a database server name.
    Default Value:
    localhost
    Example:
    • mydatabase
    • mydatabase/sharepoint
  11. Once you enter the Database Server, click Connect to authenticate the database user account and populate the names of the databases on your database server.
  12. In the Database Location section, enter the following information for your AgilePoint database.

    AgilePoint Data Services Configuration Database Location screen
    Field Name Definition

    Use Existing Database

    Function:
    Specifies the name of an existing database you want to use for AgilePoint Server workflow.

    Click Connect to populate the list.

    Accepted Values:
    A database name from the list.

    Create New Database

    Function:
    Specifies the name of a new database you want to create as your AgilePoint workflow database.

    This option is only available if your database is installed on the same machine where you are installing this component.

    Accepted Values:
    One line of text with no spaces.
  13. Click Next.

    The AgilePoint Data Services installation runs. If any error messages show on the screen, you can use the log to troubleshoot the errors. If an error exists, contact AgilePoint Customer Support.


    AgilePoint Data Services Installation screen
  14. After the installation completes, click Next.

    AgilePoint Data Services Installation Completed screen
  15. After the Congratulations message shows, click Finish.

    AgilePoint Data Services Installation Completed Message screen
  16. 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, refer to Run the Windows Service Client Utility Tool.