How Do I Configure AgilePoint Server Manager?

The AgilePoint Server Manager is a sever administration component you can use to to start, stop, add, delete, configure, and manage AgilePoint Server instances.

Background and Setup

Examples

Prerequisites

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.

    Open AgilePoint Server Manager file

General tab

Specifies the basic configuration to identify the AgilePoint Server instance.

Figure: General tab

General tab
Field NameDefinition

Service Name

Function:
Specifies the name you want to use to identify the Windows service associated with the AgilePoint Server instance.
Accepted Values:
One line of text (a string).
Default Value:
None

Display Name

Function:
Specifies the name you want to display to users to identify the AgilePoint Server instance.
Accepted Values:
One line of text (a string).
Default Value:
None

Location

Function:
Specifies the path to the AgilePoint Server instance.
Accepted Values:
A valid absolute file path.
Default Value:
None

User Name (Domain\User Name)

Function:
Specifies the user name of the AgilePoint Service Account.
Accepted Values:
A registered Windows user on the AgilePoint Server machine that has the correct permissions for the AgilePoint Service Account.

For more information, refer to AgilePoint Service Account.

Default Value:
The user name that is specified for the AgilePoint Service Account during AgilePoint Server installation.
Limitations:
Example:
MYDOMAIN\APServiceUser

Password

Function:
The password for the AgilePoint Service Account.
Accepted Values:
An alphanumeric string that represents a password.
Default Value:
The password that is specified for the AgilePoint Service Account during AgilePoint Server installation.
Limitations:
  • The password for this user must match the password for the Windows user account that is associated with the AgilePoint Service Account.
  • If you change this password, you must change it in Windows, and then change the password here.

Add New Service Instance Add icon

Creates a new AgilePoint Server instance.

Start Service Start icon

Function:
Starts the Windows service for the selected AgilePoint Server instance.
Example:

Stop Service Stop icon

Function:
Stops the Windows service for the selected AgilePoint Server instance.
Example:

Delete Service Delete icon

Function:
Deletes the selected AgilePoint Server instance.

Refresh Refresh icon

Function:
Refreshes the selected AgilePoint Server instance.

Open Server Configuration Open Server Configuration icon

Function:
AgilePoint Server Configuration Utility
Function of this Screen:
This utility is a user-friendly editor for the main AgilePoint Server configuration file, netflow.cfg.

Update

Function:
Saves changes to an AgilePoint Windows Service instance configuration.

SVC Utility Windows Service Client Utility Tool icon

Function:
Runs the Windows Service Client Utility Tool .

Activity Removal Utility Activity Removal Utility icon

Opens this Screen:
Activity Removal Utility
Function of this Screen:
Deletes a custom process activity from AgilePoint NX.

Activity Deployment Utility AgilePoint Deployment Utility icon

Opens this Screen:
AgilePoint Activity Deployment Utility
Function of this Screen:
Deploys a custom process activity created with AgilePoint NX Developer to AgilePoint Server

Networking tab

Configures the network connection for AgilePoint Server instance.

Figure: Networking tab

Networking tab
Field NameDefinition

WSHttp Port

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

This field is required.

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

The port number must be unique (not used for any other purpose) and higher than 10000.

Default Value:
13487

TCP Port

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

This field is required.

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

The port number must be unique (not used for any other purpose) and higher than 10000.

Default Value:
13488

BasicHttp Port

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

This field is required.

Accepted Values:
A port number on your machine for BasicHttp binding.

The port number must be unique (not used for any other purpose) and higher than 10000.

Default Value:
13489

Web HTTP Port

Function:
A free, unique port AgilePoint Server instance can use for Web HTTP binding.

This field is required.

Accepted Values:
A port number on your machine for Web HTTP binding.

The port number must be unique (not used for any other purpose) and higher than 10000.

Default Value:
13490

Check Port Availability

Function:
Tests the specified ports to make sure they are free.

Service Factory Binding

Opens this Screen:
Global Extended Module screen.
Function of this Screen:
Specifies the authentication scheme for your REST endpoint for the AgilePoint Server instance.

Domain

Function:
The common name (CN) or domain name or fully qualified domain name associated with your SSL certificate.
To Open this Field:
Click the SSL Settings tab.
Accepted Values:
An appSettings key in the following format:

One line of text (a string) representing your common name or domain name.

Default Value:
None
Example:
mydomain.com

Use Secure Connection (SSL)

Function:
The common name (CN) or domain name or fully qualified domain name associated with your SSL certificate.

For more information, refer to Configure AgilePoint Server to use SSL.

To Open this Field:
Click the SSL Settings tab.
Accepted Values:
An appSettings key in the following format:
  • Selected - SSL encryption is enabled.
  • Deselected - SSL encryption is disabled.
Default Value:
Deselected

Add New Service Instance Add icon

Creates a new AgilePoint Server instance.

Start Service Start icon

Function:
Starts the Windows service for the selected AgilePoint Server instance.
Example:

Stop Service Stop icon

Function:
Stops the Windows service for the selected AgilePoint Server instance.
Example:

Delete Service Delete icon

Function:
Deletes the selected AgilePoint Server instance.

Refresh Refresh icon

Function:
Refreshes the selected AgilePoint Server instance.

Open Server Configuration Open Server Configuration icon

Function:
AgilePoint Server Configuration Utility
Function of this Screen:
This utility is a user-friendly editor for the main AgilePoint Server configuration file, netflow.cfg.

Update

Function:
Saves changes to an AgilePoint Windows Service instance configuration.

SVC Utility Windows Service Client Utility Tool icon

Function:
Runs the Windows Service Client Utility Tool .

Activity Removal Utility Activity Removal Utility icon

Opens this Screen:
Activity Removal Utility
Function of this Screen:
Deletes a custom process activity from AgilePoint NX.

Activity Deployment Utility AgilePoint Deployment Utility icon

Opens this Screen:
AgilePoint Activity Deployment Utility
Function of this Screen:
Deploys a custom process activity created with AgilePoint NX Developer to AgilePoint Server

Global Extended Module screen

Specifies the authentication scheme for your REST endpoint for the AgilePoint Server instance.

Figure: Global Extended Module screen

Global Extended Module screen

Fields

Field NameDefinition

Assembly

Function:
Specifies the .dll file that provides server side authentication for REST services. In some circumstances you must create a custom authentication module.

For more information, refer to Server Side Authentication Using WCF Endpoints for AgilePoint Server.

Accepted Values:
A valid assembly name.
Default Value:
None.

The default .dll is (AgilePoint Server installation folder) C:\Program Files\AgilePoint\AgilePoint Server\bin\AgilePoint.REST.ServiceBindingFactory.dll

Class

Function:
Specifies the implementation of the IWFServiceBindingFactory interface.
Accepted Values:
  • RESTNoAuthenticationFactory
  • RESTADAuthenticationFactoryNoCaching
  • RESTADAuthenticationFactory
  • RESTRemoteADAuthenticationFactoryNoCaching
  • RESTRemoteADAuthenticationFactory
  • RESTLocalAuthenticationFactoryNoCache
  • RESTLocalAuthenticationFactory
  • RESTNoAuthenticationFactory
  • RESTMultiADAuthenticationFactoryNoCaching
  • RESTMultiADAuthenticationFactory
Default Value:
RESTNoAuthenticationFactory

Portal tab

Configures the IIS web sites for AgilePoint NX Portal, and Analytics Center for the AgilePoint Server instance.

Figure: Portal tab

Portal tab
Field NameDefinition

Portal Site

Function:
Specifies the web site from the list you created for AgilePoint during pre-installation.
Accepted Values:
A valid web site name.
Default Value:
AgilePointWebsite

Portal - Application Pool

Function:
Specifies the IIS application pool for the AgilePoint NX Portal web application you want to run.
Accepted Values:
An application pool from the list.
Default Value:
DefaultAppPool

Portal Master Database

Function:
Specifies the portal master database.
Accepted Values:
The database name you select in the Portal Master Database Name list on the Connection String Builder screen.
Default Value:
None

Retrieve Database Retrieve Database icon

Opens this Screen:
Connection String Builder screen
Function of this Screen:
Specifies the connection to the AgilePoint portal master database to store the data for apps for the AgilePoint Server instance..

Portal Tenant Database

Function:
Specifies the name of the portal tenant database.
Accepted Values:
The database name you select in the Portal Tenant Database Name list on the Connection String Builder screen.
Default Value:
None

Report Site

Function:
Specifies the web site from the list you created for Analytics Center during pre-installation.
Accepted Values:
A web site name form the list.
Default Value:
None

Analytics Center - Application Pool

Function:
Specifies the IIS application pool for the Analytics Center web application to run.
Accepted Values:
An application pool from the list.
Default Value:
DefaultAppPool

Analytics Database

Function:
Specifies the database for Analytics Center.
Accepted Values:
The database name you select in the Analytics Database Name list on the Connection String Builder screen.

To open the Connection String Builder screen, in this field, click Retrieve Database Retrieve Database icon.

Default Value:
None

Add New Service Instance Add icon

Creates a new AgilePoint Server instance.

Start Service Start icon

Function:
Starts the Windows service for the selected AgilePoint Server instance.
Example:

Stop Service Stop icon

Function:
Stops the Windows service for the selected AgilePoint Server instance.
Example:

Delete Service Delete icon

Function:
Deletes the selected AgilePoint Server instance.

Refresh Refresh icon

Function:
Refreshes the selected AgilePoint Server instance.

Open Server Configuration Open Server Configuration icon

Function:
AgilePoint Server Configuration Utility
Function of this Screen:
This utility is a user-friendly editor for the main AgilePoint Server configuration file, netflow.cfg.

Update

Function:
Saves changes to an AgilePoint Windows Service instance configuration.

SVC Utility Windows Service Client Utility Tool icon

Function:
Runs the Windows Service Client Utility Tool .

Activity Removal Utility Activity Removal Utility icon

Opens this Screen:
Activity Removal Utility
Function of this Screen:
Deletes a custom process activity from AgilePoint NX.

Activity Deployment Utility AgilePoint Deployment Utility icon

Opens this Screen:
AgilePoint Activity Deployment Utility
Function of this Screen:
Deploys a custom process activity created with AgilePoint NX Developer to AgilePoint Server

Connection String Builder screen

Specifies the connection to the AgilePoint portal master database to store the data for apps for the AgilePoint Server instance.

Figure: Connection String Builder screen

Connection String Builder screen
Field NameDefinition

Database Type

Function:
Specifies the database technology to store your data.
Accepted Values:
  • MSSQL
Default Value:
MSSQL

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:
None

Password

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

Integrated Security

Function:
Specifies whether the Windows account credentials for the runtime app user are used for authentication.
Accepted Values:
  • Selected - The Windows account credentials for the runtime app user are used to access the database.
  • Deselected - The user name and password fields are enabled for database authentication, and you must enter the database credentials.
Default Value:
Selected

Database Server

Function:
Specifies the server name and domain for the AgilePoint database.
Accepted Values:
An alphanumeric string with no spaces that represents a database server name.
Default Value:
localhost
Example:
  • mydatabase
  • mydatabase/WorkflowFolder

Portal Master Database

Function:
Specifies the portal master database.
Accepted Values:
A portal master database name from the list.

When you click Retrieve Database Retrieve Database icon, this field completes.

Default Value:
None

Portal Tenant Database

Function:
Specifies the portal tenant database.
Accepted Values:
A portal tenant database name from the list.
Default Value:
None

Connection Pool Size

Function:
Specifies the maximum number of simultaneous database connections for the workflow database.
Accepted Values:
An integer.

It is recommended to use a connection pool size that is >= 100, or 2 * the thread pool size.

Default Value:
100

Encrypt Connection String

Function:
Specifies whether to encrypt the stored database connection string.
Accepted Values:
  • On - Saves the database connection string in encrypted format.
  • Off - Saves the database connection string in plain text.
Default Value:
Off

Configuration tab

Configures general settings for the AgilePoint Server instance.

Figure: Configuration tab

Configuration tab
Field NameDefinition

Log File Max Size

Function:
Specifies the maximum file size for your log file in MB.

To manage storage space for log files, the AgilePoint Server creates a new log file when the current log file reaches the specified maximum file size.

Accepted Values:
An integer.
Default Value:
50

Log File Location

Function:
Specifies the location for your AgilePoint Server log file.
Accepted Values:
An absolute path to your log file folder.
Default Value:
(AgilePoint Server instance installation folder) C:\Program Files\AgilePoint\AgilePointServerInstance

Cleanup Temp Files on Server Starts

Function:
Specifies whether to delete the temp files from the AgilePoint Server machine when AgilePoint Server starts.
Accepted Values:
  • On - Deletes the temporary files to reduce disk storage space, including cache files.
  • Off - AgilePoint Server does not automatically delete temporary files.
Default Value:
Off

Enable JWT Authentication

Function:
Specifies whether to use JSON Web Token (JWT) for Active Directory authentication as an alternative to the basic authentication.
Accepted Values:
  • On - Uses JWT authentication for Active Directory.
  • Off - Uses basic authentication for Active Directory.
Default Value:
Off

Add New Service Instance Add icon

Creates a new AgilePoint Server instance.

Start Service Start icon

Function:
Starts the Windows service for the selected AgilePoint Server instance.
Example:

Stop Service Stop icon

Function:
Stops the Windows service for the selected AgilePoint Server instance.
Example:

Delete Service Delete icon

Function:
Deletes the selected AgilePoint Server instance.

Refresh Refresh icon

Function:
Refreshes the selected AgilePoint Server instance.

Open Server Configuration Open Server Configuration icon

Function:
AgilePoint Server Configuration Utility
Function of this Screen:
This utility is a user-friendly editor for the main AgilePoint Server configuration file, netflow.cfg.

Update

Function:
Saves changes to an AgilePoint Windows Service instance configuration.

SVC Utility Windows Service Client Utility Tool icon

Function:
Runs the Windows Service Client Utility Tool .

Activity Removal Utility Activity Removal Utility icon

Opens this Screen:
Activity Removal Utility
Function of this Screen:
Deletes a custom process activity from AgilePoint NX.

Activity Deployment Utility AgilePoint Deployment Utility icon

Opens this Screen:
AgilePoint Activity Deployment Utility
Function of this Screen:
Deploys a custom process activity created with AgilePoint NX Developer to AgilePoint Server