How Do I Change the Credentials for AgilePoint Administrator Accounts?

This topic shows how to change the authentication credentials for AgilePoint NX administrator accounts.

Prerequisites

Good to Know

Change AgilePoint Service Account Credentials in AgilePoint Server

To change AgilePoint Service Account credentials in AgilePoint Server, 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.

    Open AgilePoint Server Manager file

Procedure

  1. On the AgilePoint Server Manager screen, complete these fields.
    Field NameDefinition

    User Name (Domain\User Name)

    Description:
    Specifies the user name of the AgilePoint Service Account.
    Allowed 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 Administrator Types.

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

    Password

    Description:
    The password for the AgilePoint Service Account.
    Allowed 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.
  2. Click Update.

Change AgilePoint Service Account Credentials in Data Services

To change the AgilePoint Service Account credentials in Data Services, do the procedure in this topic.

Figure: AgilePoint Data Services Configuration screen

AgilePoint Data Services Configuration screen

Good to Know

  • Like AgilePoint Server, Data Services uses 2 administrator accounts:
    • AgilePoint System Account - Data Services uses the same authentication credentials as the AgilePoint Server Configuration Utility. When you change the System Account credentials in the AgilePoint Server Configuration Utility, the account credentials are automatically changed for Data Services.
    • AgilePoint Service Account - Like the AgilePoint Windows Service, the Data Services Windows service uses the "headless" credentials for the AgilePoint Service Account. These credentials are not updated through the AgilePoint Server Configuration Utility, and they are not stored in any AgilePoint configruation files.

      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

How to Start

  1. On the AgilePoint Server machine, click Start > Run.
  2. On the Run screen, in the Open field, enter services.msc.
  3. On the Services screen, right-click AgilePointDataServices.
  4. Click Stop.
  5. Open the configuration utility, (AgilePoint Data Services installation folder) C:\Program Files\AgilePoint\AgilePoint Data Services\DataServiceConfiguration.exe.

Procedure

  1. On the AgilePoint Data Services Configuration screen, ​complete these fields:
    Field NameDefinition

    User Name (Impersonation)

    Description:
    Specifies the user name of the AgilePoint Service Account.
    Allowed 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 Administrator Types.

    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 user name in this field, this changes the user name for the AgilePoint Service Account in AgilePoint Data Services.
    Example:
    MYDOMAIN\APServiceUser

    Password (Impersonation)

    Description:
    The password for the AgilePoint Service Account.
    Allowed 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.

Change the Credentials for the AgilePoint System Account in AgilePoint Server

To change the credentials for the AgilePoint System Account in the AgilePoint Server Configuration Utility, do the procedure in this topic.

Figure: AgilePoint Server Configuration > System tab

AgilePoint Server Configuration System tab

Good to Know

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.

    Configuration Utility Run As Administrator Screen
  2. On the AgilePoint Server Manager screen, in the left pane, select your AgilePoint Server instance.

    Select AgilePoint Server Intance
  3. Click Open Server Configuration Open Server Configuration icon.

    Click Open Server Configuration
  4. On the AgilePoint Server Configuration screen, click the System tab.

Procedure

  1. On the System tab, change the System Username and Password fields as necessary.

Change the Credentials for the AgilePoint System Account in NX Portal

To change the credentials for the AgilePoint System Account in AgilePoint NX Portal, do the procedure in this topic.

Figure: Manage AgilePoint NX Portal Configuration screen

Manage AgilePoint NX Portal Configuration screen

Prerequisites

Good to Know

How to Start

  1. On the Portal installation machine, open this folder:

    (NX Portal installation folder - v9.0 and higher) C:\Program Files\AgilePoint\AgilePointPortalInstance\tools

  2. Right-click the file AgilePoint.Portal.Management.exe, and click Run as Administrator.

Procedure

  1. On the Manage AgilePoint NX Portal Configuration screen, in the Domain Name field, enter the domain name for the AgilePoint System Account.
  2. In the Admin User Name field, enter the user name for the AgilePoint System Account.
  3. In the Admin Password field, enter the password for the AgilePoint System Account.

    The password for the AgilePoint System Account is configured on the AgilePoint Server Configuration Utility. For more information, refer to Change the Credentials for the AgilePoint System Account in AgilePoint Server.

  4. Click Update.

Change the Impersonator Credentials in IIS

To change the impersonator credentials in IIS, do the procedure in this topic.

Prerequisites

How to Start

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

Procedure

  1. Navigate to the AgilePoint application pool.
  2. Right-click the AgilePoint application pool name, and click Properties.
  3. On the Properties screen, click the Identity tab.
  4. On the Identity tab, enter the impersonator credentials in the User name and Password fields.
  5. Reset IIS.

Change the Impersonator Credentials in SharePoint

To change the impersonator credentials in the AgilePoint Configuration List in SharePoint, do the procedure in this topic.

Prerequisites

Good to Know

How to Start

  1. Open a SharePoint site collection where the AgilePoint App Part or Web Part is installed.
  2. Click Settings Settings icon > Site Contents.
  3. Click AgilePoint Configuration.

Procedure

  1. On the AgilePoint Configuration list, click Edit Item.
  2. In the ImpernatorUser and ImpersonatorPass fields, change the values as necessary.