To install the AgilePoint Data Services component
for Genesis for SharePoint 2013, do the following.
Prerequisites
- Your system meets the minimum
system requirements for this component. For more information,
see the System Requirements Guide.
- You have completed all of the pre-installation instructions
for this component.
- AgilePoint Server installed on the AgilePoint Server machine.
Navigation
- Open the AgilePoint installation package.
- On the Software License Agreement window, review the license agreement, and
click Accept.
- On the Destination Folder window, select the folder where you want to extract the
installation files.
- Click Install.
- On the Welcome window, create your custom Preparing
for Installation guide, if required.
Instructions
- On the AgilePoint installer, click Utilities and Other Support Files.
- Click AgilePoint Data Services.
- On the Welcome window, click Next.
- On the Verify System 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
System Requirements for AgilePoint Server.
|
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).
|
Supported version of the .NET Framework is installed
|
Install .NET Framework 4.0 on
this machine.
For more information, see
AgilePoint Server
Requirements.
|
- If there are no errors, click Next.
- In the Install Location section, enter the following information:
Field Name |
Definition |
Install location
|
The folder where you want to install the AgilePoint component.
|
- Click Next.
- Once the installation has completed, click Next.
- On theData Services Configuration window, enter the
following information:
Field Name |
Definition |
Domain
|
- Definition:
- The authentication domain for the AgilePoint service account.
- Allowed Values:
- A valid domain.
|
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.
|
Password
|
- Definition:
- The password for the AgilePoint service account.
- Allowed Values:
- A valid password.
|
AgilePoint Service URL
|
Specifies the AgilePoint
Service URL for your AgilePoint BPMS
environment.
For more information, see
Finding Your
AgilePoint Service URL on Premises.
|
Time Interval
|
- Definition:
- 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.
- Allowed Values:
- Any integer, representing a number of seconds.
- Default Value:
- 150
|
Enable Data Population
|
- Definition:
- Activates the Data Population feature,
which allows application data to be written
to the database.
- Allowed Values:
-
- Selected - Activates the Data Population feature.
- Deselected - Deactivates the Data Population feature.
- Default Value:
- Selected
|
Enable Data Tracking
|
- Definition:
- Activates the Data Tracking feature,
which allows application data to tracked across
processes and components.
- Allowed Values:
-
- Selected - Activates the Data Tracking feature.
- Deselected - Deactivates the Data Tracking feature.
- Default Value:
- Selected
|
- Click Next.
- In the Database Authentication window, enter the
following information for your Data Services database.
Field Name |
Definition |
Database Type
|
- Definition:
- Specifies the type of database for
the AgilePoint workflow.
- Allowed Values:
-
- Microsoft SQL Server
- Oracle
- Default Value:
- Microsoft SQL Server
|
User
|
- Definition:
- The user name for the database account AgilePoint Server uses
to connect to the database.
- Allowed Values:
- A valid user name for the database.
- Default Value:
- sa
|
Password
|
- Definition:
- The password for the authentication account.
- Allowed Values:
- A valid password.
- Default Value:
- None
|
Database Server
|
- Definition:
- The database used for data tracking by the
Data Services component.
- Allowed Values:
- A valid database server name (or service name in Oracle)
- Default Value:
- AP_Data_Svcs_DB
- Example:
-
- mydatabase
- mydatabase/sharepoint
|
- 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.
- In the Database section, enter the following information for your
AgilePoint database.
Field Name |
Definition |
Use an existing database
|
- Definition:
- Specifies the name of an existing database you want to
use for AgilePoint Server workflow.
Click Connect to populate the list.
- Allowed Values:
- A valid database name.
|
Create a new database
|
- Definition:
- 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.
- Allowed Values:
- A valid database name.
|
- Click Next.
- Once the installation has completed, click Next.
- Once the Installation Complete message is displayed,
click Finish.
- 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, see
Run the Windows Service Client Utility Tool.