Create an AgilePoint Server instance

This topic shows how to create an AgilePoint Server instance.

Prerequisites

Good to Know

  • You must complete the procedures in this topic in order.

Create Folders for a New AgilePoint Server Instance

To set up folders for a new AgilePoint Server instance, do the procedure in this topic.

Procedure

  1. On your AgilePoint Server machine, create these folders:
    • (Folder for an additional AgilePoint Server instance) C:\Program Files\AgilePoint\[YourAgilePointServerInstanceName] - This folder contains all the files and folders related to AgilePoint Sever instance. You can customize the name.
    • (New AgilePoint web application folder) C:\Program Files\AgilePoint\[YourAgilePointInstanceWebsiteName] - This folder contains the web sites for the AgilePoint NX AgilePoint Server and Report Center. You can customize the name.
      • YourPortalWebsiteName - This folder contains all the files and folders related to the Portal.
      • YourReportCenterWebsiteName - You can create this folder if you have a license for Report Center. This folder contains all the files and folders related to the Report Center.
        Note: The current version of Report Center (sometimes referred to as AgileReports) can only be used by customers who purchased this component before April 1, 2020. This version is no longer available for purchase, including by current and previous purchasers of AgilePoint NX or the Report Center component. AgilePoint plans to release the new version of Report Center in Q3 2020.

Set up Databases for a New AgilePoint Server Instance

AgilePoint requires one or more databases, depending upon the AgilePoint components you install. You must create these databases on your database server.

To set up databases for a new AgilePoint Server instance, do the procedure in this topic.

How to Start

  1. Make sure your SQL Server is up and running.
  2. Open the SQL Server Management Studio:
    1. On your AgilePoint Server machine, click Start, and type Run.
    2. Click Run.
    3. On the Run screen, in the Open field, enter SSMS.exe.
    4. Click OK.

Good to Know

  • It is only necessary to create the database. The database tables are created automatically during installation.

Procedure

Repeat the following instructions to create the databases listed in the AgilePoint Databases section.

  1. In SQL Server Management Studio, Right-click on Databases and select New Database.
  2. On the New Database screen, enter a database name.

AgilePoint Databases

Component Database Name (Suggested but Optional) Function

Workflow Database

YourWorkflowDBName

Stores application data in AgilePoint NX. This is the main AgilePoint NX database.

Portal Master

YourApPortalDbName

Stores overall information for all NX Portal tenants.

Portal Tenant

YourApPortalTenantDBName

Stores non-workflow data for an AgilePoint portal tenant.

Report Center

YourReportCenterMetaDbName

The database for Report Center data.

Create a New Website in IIS for an AgilePoint Server Instance

To create a new website in IIS for an AgilePoint Server instance, do the procedure in this topic.

How to Start

  1. On the AgilePoint Server machine, open IIS Manager.

Procedure

  1. In IIS Manager, In the Connections pane, right-click the Application Pools.
  2. Click Add Application Pool.
  3. On the Add Application Pool screen, in the Name field, enter the name of the application pool.
  4. On the Actions pane, click Advanced Settings.
  5. On the Generate Process Model Event Log Entry, in the Identity field, click the Ellipses (...) button.
  6. On the Application Pool Identity screen, in the Custom account, click Set.
  7. On the Set Credentials screen, in the User name field, enter the user name for the AgilePoint Service Account.

    Format:

    domain\username

    Example:

    MYDOMAIN\APServiceUser

  8. In the Password field, enter the password for the AgilePoint Service Account.
  9. In the Conform password field, reenter the password for the authentication account.
  10. In the IIS Manager, in the Connections pane, right-click the Sites.
  11. Click Add Website....
  12. On the Add Website screen, in the Site name field, enter the name of the web site.
  13. In the Application pool, click Select.
  14. Browse (New AgilePoint web application folder) C:\Program Files\AgilePoint\[YourAgilePointInstanceWebsiteName] \YourPortalWebsiteName.
  15. Click Connect As.
  16. On the Connect As screen, in the Specific user, click Set.
  17. On the Set Credentials screen, in the User name field, enter the user name for the AgilePoint Service Account.

    Format:

    domain\username

    Example:

    MYDOMAIN\APServiceUser

  18. In the Password field, enter the password for the AgilePoint Service Account.
  19. In the Conform password field, reenter the password for the authentication account.
  20. In the Port field, specify a unique port number.

    The port number must be higher than 10000.

Create an AgilePoint Server Instance

To create a new AgilePoint Server instance, do the procedure in this topic.

Figure: AgilePoint Server Manager screen

AgilePoint Server Manager screen

How to Start

  1. On the AgilePoint Server machine, in Windows Explorer, right-click the file (AgilePoint Server installation folder) C:\Program Files\AgilePoint\AgilePoint Server \WCFConfigurationUtility.exe, and click Run as Administrator.
  2. On the AgilePoint Server Manager, click Add Add icon.

Procedure

  1. In the Service Name field, enter the name to use to identify the Windows service associated with the AgilePoint Server instance.
  2. In the Display Name field, enter the name to display to show in AgilePoint Server Manager.
  3. In the Location field, click Browse.
  4. Select the (Folder for an additional AgilePoint Server instance) C:\Program Files\AgilePoint\[YourAgilePointServerInstanceName] .

    This folder contains all the files and folders related to AgilePoint Sever instance.

  5. Complete these fields. The port numbers must be unique and higher than 10000.
    Field Name Definition

    WSHttp Port

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

    This field is required.

    Accepted Values:
    A port number on your machine for WSHttp binding.
    Default Value:
    13487

    TCP Port

    Function:
    A free, unique port AgilePoint Server can use for TCP binding.

    This field is required.

    Accepted Values:
    A port number on your machine for TCP binding.
    Default Value:
    13488

    BasicHttp Port

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

    This field is required.

    Accepted Values:
    A port number on your machine for BasicHttp binding.
    Default Value:
    13489
  6. Click Check Availability of Ports to make sure the ports are free.
  7. In the User Name field, enter the user name for the AgilePoint Service Account.
  8. In the Password field, enter the password for the AgilePoint Service Account.
  9. In the Portal Site list, select the name of the web site you created for NX Portal.

    For more information, refer to Create a New Website in IIS for an AgilePoint Server Instance.

  10. In the Application Pool list, select the name of the application pool you created.

    For more information, refer to Create a New Website in IIS for an AgilePoint Server Instance.

  11. In the Master Database, select the name of your Portal database.

    For more information, refer to Set up Databases for a New AgilePoint Server Instance.

  12. In the Default Database, select the name of your tenant database.

    For more information, refer to Set up Databases for a New AgilePoint Server Instance.

  13. (Optional) If you have a license for Report Center, do this procedure.
    Note: The current version of Report Center (sometimes referred to as AgileReports) can only be used by customers who purchased this component before April 1, 2020. This version is no longer available for purchase, including by current and previous purchasers of AgilePoint NX or the Report Center component. AgilePoint plans to release the new version of Report Center in Q3 2020.
    1. Click Report Center tab.
    2. In the Report Site, select the web site you created for Report Center.

      For more information, refer to Create a New Website in IIS for an AgilePoint Server Instance.

    3. In the Report Center Database, select the name of the database that you created for Report Center.

      For more information, refer to Set up Databases for a New AgilePoint Server Instance.

  14. Click Update.