How Do I Configure AgilePoint Server Manager?

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:

• When you install AgilePoint Server, the AgilePoint Service Account and AgilePoint System Account are configured to use the same credentials. However, after installation, it is recommended to separate these accounts for security purposes. Changing the credentials for the AgilePoint Windows Service does not have an effect on the credentials for the AgilePoint System Account.
• To simplify maintenance and keep the AgilePoint Service Account credentials in sync, AgilePoint recommends you use the same Service Account credentials for the AgilePoint Windows Service and the Windows service for AgilePoint Data Services. However, this is not a technical requirement.
• If you change the Impersonation section credentails, it also changes the AgilePoint Service Account credentials for the AgilePoint Windows Service.

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

Creates a new AgilePoint Server instance.

Start Service

Function:

Starts the Windows service for the selected AgilePoint Server instance.

Example:

• (Example) Start an AgilePoint Server Instance

Stop Service

Function:

Stops the Windows service for the selected AgilePoint Server instance.

Example:

• (Example) Stop an AgilePoint Server Instance

Delete Service

Function:

Deletes the selected AgilePoint Server instance.

Refresh

Function:

Refreshes the selected AgilePoint Server instance.

Open Server Configuration

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

Function:

Runs the Windows Service Client Utility Tool .

Activity Removal Utility

Opens this Screen:

Activity Removal Utility

Function of this Screen:

Deletes a custom process activity from AgilePoint NX.

Activity Deployment Utility

Opens this Screen:

AgilePoint Activity Deployment Utility

Function of this Screen:

Deploys a custom process activity created with AgilePoint NX Developer to AgilePoint Server

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

Creates a new AgilePoint Server instance.

Start Service

Function:

Starts the Windows service for the selected AgilePoint Server instance.

Example:

• (Example) Start an AgilePoint Server Instance

Stop Service

Function:

Stops the Windows service for the selected AgilePoint Server instance.

Example:

• (Example) Stop an AgilePoint Server Instance

Delete Service

Function:

Deletes the selected AgilePoint Server instance.

Refresh

Function:

Refreshes the selected AgilePoint Server instance.

Open Server Configuration

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

Function:

Runs the Windows Service Client Utility Tool .

Activity Removal Utility

Opens this Screen:

Activity Removal Utility

Function of this Screen:

Deletes a custom process activity from AgilePoint NX.

Activity Deployment Utility

Opens this Screen:

AgilePoint Activity Deployment Utility

Function of this Screen:

Deploys a custom process activity created with AgilePoint NX Developer to AgilePoint Server

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

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 .

Default Value:

None

Add New Service Instance

Creates a new AgilePoint Server instance.

Start Service

Function:

Starts the Windows service for the selected AgilePoint Server instance.

Example:

• (Example) Start an AgilePoint Server Instance

Stop Service

Function:

Stops the Windows service for the selected AgilePoint Server instance.

Example:

• (Example) Stop an AgilePoint Server Instance

Delete Service

Function:

Deletes the selected AgilePoint Server instance.

Refresh

Function:

Refreshes the selected AgilePoint Server instance.

Open Server Configuration

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

Function:

Runs the Windows Service Client Utility Tool .

Activity Removal Utility

Opens this Screen:

Activity Removal Utility

Function of this Screen:

Deletes a custom process activity from AgilePoint NX.

Activity Deployment Utility

Opens this Screen:

AgilePoint Activity Deployment Utility

Function of this Screen:

Deploys a custom process activity created with AgilePoint NX Developer to AgilePoint Server

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 , 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

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

Creates a new AgilePoint Server instance.

Start Service

Function:

Starts the Windows service for the selected AgilePoint Server instance.

Example:

• (Example) Start an AgilePoint Server Instance

Stop Service

Function:

Stops the Windows service for the selected AgilePoint Server instance.

Example:

• (Example) Stop an AgilePoint Server Instance

Delete Service

Function:

Deletes the selected AgilePoint Server instance.

Refresh

Function:

Refreshes the selected AgilePoint Server instance.

Open Server Configuration

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

Function:

Runs the Windows Service Client Utility Tool .

Activity Removal Utility

Opens this Screen:

Activity Removal Utility

Function of this Screen:

Deletes a custom process activity from AgilePoint NX.

Activity Deployment Utility

Opens this Screen:

AgilePoint Activity Deployment Utility

Function of this Screen:

Deploys a custom process activity created with AgilePoint NX Developer to AgilePoint Server