Reconfigure AgilePoint Products when a Server's URL Changes

Applies To

AgilePoint Suite
AgilePoint Server
AgilePoint Enterprise Manager
AgilePoint SharePoint Integration

Objective

This article shows how to reconfigure the settings of installed AgilePoint products when a server's URL changes (e.g. because of a domain name or port number change, or because SSL has been enabled).

Summary

Depending on the changes made, you may need to make configuration changes to your server(s)'s registry and or some web.config files.

Resolution

Depending on the changes made, you may need to make configuration changes to your server(s)'s registry and or some web.config files.

If the URL of your SharePoint server has changed, do the following:

On the SharePoint server, update the following registry key:
```
HKEY_LOCAL_MACHINE\SOFTWARE\Ascentn\SPSIntegration\SharePointUrl
```
The value should be changed to the new URL of the SharePoint server (i.e. the URL that end-users use).

NOTE: Changing the URL or Port number of a SharePoint virtual server can corrupt the server if done improperly. E.g. see http://www.bluedoglimited.com/SharePointThoughts/ViewPost.aspx?ID=212. Therefore, Ascentn recommends that "changes" to a SharePoint server's URL be accomplished by adding additional host header's to the site through the IIS console, rather than by actually changing the original URL and/or port number.

If the URL of your AgilePoint server has changed, do the following:

On the SharePoint server, update the web.config file in the root of your SharePoint web site as shown in the fragment below:

  <appSettings>
    <add key="AgilePointUrl" value="http://VSERVER7:81/AgilePointServer" />
    <add key="AgilePointDomain" value="VSERVER7" />

On the AgilePoint server, update the web.config file in the root of your AgilePointEnterpriseManager web application as shown in the fragment below:
```
  <appSettings>
    <add key="ServerUrl" value="http://localhost:81/AgilePointServer" />
```
On the AgilePoint server, update the web.config file in the root of the Tusca sample web application (if you have installed the AgilePoint Sample Application) as shown in the fragment below:
```
  <appSettings>
    <add key="ServerUrl" value="http://localhost:81/AgilePointServer" />
```

After making the above changes, you may need to restart IIS on the modified server(s).