Below are the steps for configuring a computer to be a PR-Tracker Web Server under Windows Server 2008.
- Install PR-Tracker on the computer.
- Start PR-Tracker and go through the initial configuration.
- If you choose to configure the computer as a client during the initial configuration, make sure it can connect to the PR-Tracker server. If the connection to the PR-Tracker server doesn't work, the Web service won't work either.
Create a virtual directory for PrtrackerWebService.
- In Administrative Tools | Internet Information Services (IIS) Manager, from the IIS console tree, right click on the Website that will be hosting PrtrackerWebService and choose Add Virtual Directory... from the popup menu.
- Enter PrtrackerWebService for the Alias.
- To set the Physical path, click the ellipsis (...) to the right of the text box, browse to the location where PR-Tracker 6.0 is installed, select the folder PrtrackerWebService and click OK in the Browse For Folder dialog.
- Ignore Connect as… and Testing Settings…, for now. Click OK.
Create a local or domain user account named prtracker6wsa [PR-Tracker Web Service Account] for the PrtrackerWebService to run under.
- Open Server Manager. To add a local account, navigate in the tree to Configuration | Local Users and Groups | Users. To add a domain user account, navigate to Roles | Active Directory Domain Services | Active Directory User and Computers | <selected domain> | Users.
- Right-click on the folder Users in the console tree, and select New User... from the popup menu.
- In the dialog, set the User name to prtracker6wsa.
- Set the Full name to PR-Tracker 6.0 Web Service Account.
- You may leave the Description blank.
- Enter the Password and Confirm password and (keeping track of the string you entered).
- Uncheck User must change password at next logon and check only Password never expires.
- Click Create and then Close.
Assign ASP.NET permissions to prtracker6wsa.
- Open a command line window and navigate to a folder that contains aspnet_regiis.exe, for example C:\Windows\Microsoft.NET\Framework\v2.0.50727.
- Run the command aspnet_regiis -ga Prtracker6wsa.
Create an IIS application pool named Prtracker6Pool.
- In the IIS console tree, right click on Application Pools and select menu item Add Application Pool....
- In the Add Application Pool… dialog, set the Name to Prtracker6Pool. Do not change the other settings. Click OK.
- Right-click on the newly-created application pool in the Features View and select menu item Advanced Settings….
- In the dialog, under the (General) category, change Enable 32-bit Applications to True.
- Under the Process Model category, click on the Identity setting to reveal an ellipsis (...) button. Click on that button to change the Application Pool Identity. Select Custom account, click Set... and enter the User name, Password, and Confirm password settings for prtracker6wsa you added a local account in step 5 or \prtracker6wsa you entered a domain user account in step 5. Finally, click OK.
Configure the PrtrackerWebService to run under the Prtracker6Pool.
- In the console tree, right-click on PrtrackerWebService and select menu item Convert to application.
- Next to Application pool, click Select…. Choose Prtracker6Pool from the dropdown in the ensuing dialog and click OK.
- Click on Test Settings.... Authentication and Authorization should both pass the applied tests. Click OK and OK to exit the dialog.
- From the IIS console tree, select the PrtrackerWebService and if you do not see Prtracker.asmx in the right panel, right-click and select Switch to Content View from the popup context menu.
- Right-click on Prtracker.asmx in the right panel and select Browse from the context menu. This should open a browser which displays all of the web service operations. (Troubleshooting note: If you receive the message "Service Unavailable," in IIS Manager, right-click on Prtracker6Pool and select Start; then refresh the browser window. Normally, the Application Pool will have been started automatically when you created it.)
- Click on the operation VerifyConnection and then press the Invoke button. You should get a response that includes "OK" as the message.
- Click on the operation IncrementViolationCount and then press the Invoke button. You should get a response that includes an integer as the message.
- From another computer, enter the web address of the prtracker.asmx in the PrtrackerWebService. You should get a list displaying all the web services operations just like you did in (1).
- If (4) works, start PR-Tracker and choose Connect Web Client on the Connect dialog. Enter the same Internet Address of prtracker.asmx that worked in (4).
- Check the box to Connect without using login name and password.
- Press the Connect Web Client button. PR-Tracker should connect and display a problem list.
Secure the web connection and redo step (9).
If you receive an error message, search for help in the PR-Tracker Knowledge Base using exact wording from the error message.