Installing AgilePoint Server, Genesis Edition

To install AgilePoint Server for AgilePoint BPMS Genesis Edition, 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 Install AgilePoint.
  2. Click AgilePoint Server.
  3. On the Welcome window, click Next.
  4. On the License Agreement window:
    1. Review the license agreement.
    2. Click I accept the terms of the license agreement.
    3. Click Next.
  5. On the Verify Manual Prerequisites window, review the items on the screen, and complete any required tasks. For more information, see the Pre-Installation guide.
  6. Click Next.
  7. On the Verify Installation 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.

      IIS is available

      Install and/or start IIS 6 or higher.

      IIS 6 Management Compatibility Role Service is active

      Activate Management Compatibility Role Service on IIS 6 or higher.

      For more information, see Verifying the IIS 6 Management Compatibility Role Service.

      Supported .NET Framework installed

      Install the .NET Framework version that is supported for your installation.

      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).

      Windows Identify Foundation is installed

      Install Windows Identity Foundation on this machine.

      For more information, see Windows Identity Foundation on the Microsoft Download Center.

    • If there are no errors, click Next.
  8. On the AgilePoint Server Installation window, complete the following fields:
    Field Name Definition

    Install location

    The folder where you want to install the AgilePoint component.

    Name

    Your first and last name.

    Organization

    The name of your organization, or company.

    License Key

    Your AgilePoint Server license key.

  9. Click Next.
  10. Once the installation completes, click Next.
  11. On the Server Configuration screen, enter the credentials for your AgilePoint Service account.
    Field Name Definition

    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.

    Domain

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

    Password

    Definition:
    The password for the AgilePoint service account.
    Allowed Values:
    A valid password.
  12. On the Server Configuration screen, enter the following information for your SMTP email server.
    Field Name Definition

    SMTP Server

    Definition:
    The URL for your SMTP email server.
    Allowed Values:
    A valid SMTP server URL.

    Administrator Email

    Definition:
    The email address for your SMTP server administrator.

    This email address will be used to send email notifications to participants in AgilePoint processes. You can change this email address after installation if desired.

    Allowed Values:
    A valid SMTP server administrator email address.
  13. On the Server Connections screen, enter the following information for your AgilePoint database.

    Once you enter the Database Server, click the Retrieve database name button to populate the names of the databases on your database server.

    Field Name Definition

    Database Server

    Definition:
    Specifies the server name and domain for the AgilePoint workflow database.
    Allowed Values:
    A valid database server name (or service name in Oracle)
    Example:
    • mydatabase
    • mydatabase/sharepoint

    Database Name

    Definition:
    Specifies the name of your AgilePoint workflow database.
    Allowed Values:
    A valid database name.
  14. On the Server Connections screen, if desired you can change the port numbers AgilePoint Server uses to communicate using various protocols. The default port numbers are verified as available for your system.
    Note: Once the installation is complete, you will need to create a firewall rule to allow AgilePoint Server to open these ports.
    Field Name Definition

    WSHttp Port

    Definition:
    A free, unique port AgilePoint Server can use for WSHttp binding.

    This field is required.

    Allowed Values:
    Specifies a valid WSHttpPort number.
    Default Value:
    None

    TCP Port

    Definition:
    Specifies a free, unique port AgilePoint Server can use for TCP binding.

    This field is required.

    Allowed Values:
    A valid TCP port number.
    Default Value:
    None

    BasicHttp Port

    Definition:
    A free, unique port AgilePoint Server can use for BasicHttp binding.

    This field is required.

    Allowed Values:
    A valid port number.
    Default Value:
    None
  15. Click Next.
  16. On the Installation Complete window, click Next.
  17. On the Completed window, take note of the important information about your environment. You will need this information later.
  18. Click Finish.
  19. A text file appears with the summary information for your installation. Save this file where you can find it. You will need this information later, especially when you install SharePoint Integration.
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.