Moving Document Processors to a Secondary Server (head / tail configuration)

Support for full text search, thumbnail images, and file property display requires a number of processors to be running on the ProjectWise Design Integration Server that extract the appropriate data from files managed by ProjectWise and store that data in the ProjectWise database (or in the full text index catalog, in the case of full text indexing). These processors can be somewhat resource intensive, and depending on the amount of documents that are changing and how current the user wants to keep the extracted data, this could potentially affect the overall performance of the ProjectWise Design Integration Server (and therefore the perceived performance of ProjectWise in general).

To reduce the load put on the ProjectWise Design Integration Server, you can install a second ProjectWise Design Integration Server on another computer can offload the document processors to a second computer. These two computers would then coordinate through ProjectWise Orchestration Framework Service and the Orchestration Framework database.

On the main computer, install and configure ProjectWise Orchestration Framework Service and ProjectWise Design Integration Server as usual, along with the automated file processing features (document processors).
On the second computer, install and configure ProjectWise Orchestration Framework Service and ProjectWise Design Integration Server, again with the automated file processing features, with the following considerations when installing ProjectWise Orchestration Framework Service:
- when you get to the Configure Shepherd Credentials dialog, make sure you use the same Windows account that is being used to run the ProjectWise Orchestration Framework Service on the main ProjectWise Design Integration Server.
- when asked for the database to be used by the ProjectWise Orchestration Framework Service, select the same Orchestration Framework database that is being used by the main ProjectWise Design Integration Server. It is also possible at this time to designate a new Orchestration Framework database on the second server and reconfigure the ProjectWise Orchestration Framework Service on the main ProjectWise Design Integration Server to point to this new Orchestration Framework database.
On the second computer where ProjectWise Design Integration Server is now installed, in order to have this server not require a ProjectWise Design Integration Server license, edit the DMSKRNL.CFG file and add the line FullTextIndexSrv=1 to the [TeamMate] section. This will prevent this secondary ProjectWise Design Integration Server from performing any of the main ProjectWise Design Integration Server functionality.
Install Orchestration Framework Administrator (option on the ProjectWise Administrator installer) on the main ProjectWise Design Integration Server computer. Open Orchestration Framework Administrator and connect the Orchestration Framework Browser to the Orchestration Framework database instance that is being used by both servers. You should notice that there are now Dispatchers and Processors running on both servers. Looking at the monitor for one of the document processor instances you will notice that there are now two parallel sets of dispatchers and processors for that instance that are not connected. Close Orchestration Framework Administrator. Your next step is to connect those parallel paths.
On the main ProjectWise Design Integration Server computer, open a command prompt and navigate to the ...\ProjectWise\bin folder and enter:
```
Dmsafpengine.exe -makeHead
```
This entry is case-sensitive, so make sure you enter an uppercase H as shown above.
On the second ProjectWise Design Integration Server computer, open a command prompt and navigate to the ...\ProjectWise\bin folder and enter:
```
Dmsafpengine.exe -makeTail
```
This entry is also case-sensitive, so make sure you enter an uppercase T as shown above.
Open Orchestration Framework Administrator again and reconnect to the Orchestration Framework Browser and select to monitor one of the instances. You should notice that the parallel paths are now connected, and the processors have been removed from the main ProjectWise Design Integration Server, and the dispatcher from the main ProjectWise Design Integration Server is now connected to processors running on the second computer.
In ProjectWise Administrator:
1. Select Registered Full Text Index Servers and make sure that the second ProjectWise Design Integration Server computer shows up in the list. If not, use the New > Index Server to add it. Log in to each datasource and select Document Processors > Full Text Indexing > Properties and make sure that the Index Server field shows the name of the second computer, if not select it from the list and click Register Server.
2. Select one of the document processors and select a folder for reprocessing and force processing now.
Using Orchestration Framework Administrator, validate that the queues of the processors on the second computer are populated with documents for processing.