IT Administrators‎ > ‎Installation‎ > ‎

Configuring the Process Library

 This article is suitable for an IT Adminstrator
 
Last edited: 28th September 2011

Introduction

This document aims to provide an IT engineer with the knowledge required to configure the Triaster Process Library.  It is assumed that your server meets the minimum system requirements for the Triaster Server as specified here.  Please contact Professional Services before performing any of the below tasks.
 
Note:
During these procedures, if prompted to activate the Browser Toolkit, then do so by launching the Activation Server and following the on-screen instructions.

Setting the Administration passwords and the Publication Queue location

Procedure

The Triaster Process Library's publication, clone and site admin tools are all password protected.  These user names and password are unrelated to Windows users, although they could be matched with the user name and password of a user on a domain.  For more information on setting the passwords of the Administration tool, using the Triaster Admin Tool Configuration Utility, please see HERE.  That utility can also set the Publication Queue directory reference, which if the default Queue location was used needs to be set to look in the Publication Server installation directory under "PublicationWrapper\Queue".

Validation

  1. Open Internet Explorer.
     
  2. Test the admin passwords.
     
    1. Go to your process library Live site (by default http://localhost/processlibraries/processlibrary/Live) > Library Administration menu > Publication Services.
       
      1. Test the user name and password that you configured for the process library Live site.
         
    2. Go to your process library Prelive site (by default http://localhost/processlibraries/processlibrary/Prelive) > Library Administration menu > Publication Services.
       
      1. Test the user name and password that you configured for the process library Prelive site.
         
    3. Go to your process library Sandpit site (by default http://localhost/processlibraries/processlibrary/Sandpit) > Library Administration menu > Publication Services.
       
      1. Test the user name and password that you configured for the process library Sandpit site.
         
         
  3. Test the publication Queue location.
     
    1. Stop the 'PN Publication Wrapper' service to prevent publications from running.
       
      1. Start > Administrative Tools > Services.
         
      2. Right-click 'PN Publication Wrapper' > Stop.
         
    2. In Windows Explorer, open the Queue folder, typically "C:\Program Files\Triaster\PublicationServer\PublicationWrapper\Queue".
       
    3. Go to your process library Live site (by default http://localhost/processlibraries/processlibrary/Live) > Library Administration menu > Publication Services.
       
      1. Log on to the Administration Tool using the user name and password that you configured for the process library Live site.
         
      2. Go to the Publication menu.
         
      3. Click Publish.
         
      4. In Windows Explorer, check the Queue folder for a PNTASK file. The name of the PNTASK file should correspond to the site being published, e.g. ProcessLibrary_Live.pntask.
         
      5. Delete the PNTASK file.
         
    4. Repeat the above procedure for the process library Prelive site (by default http://localhost/processlibraries/processlibrary/Prelive).
       
    5. Repeat the above procedure for the process library Sandpit site (by default http://localhost/processlibraries/processlibrary/Sandpit).
       
    6. Ensure there are no PNTASK files in the Queue folder.
       
    7. Restart the 'PN Publication Wrapper' service.
    8.  

Configure the sites to use the Triaster 404 error

A 404 error is a website error that tells the user that a file that they are looking for has not been found.  By setting this to show Triaster's custom 404 error we can show the user a more meaningful error that will forward the user to the Library Administration tool.
 

Procedure

Windows Server 2003

  1. Start > Administrative Tools > Computer Management.
       
  2. Expand 'Services and Applications' > Internet Information Services (IIS) Manager > Web Sites > Default Web Site.
      
  3. Right-click 'ProcessLibraries' > Properties.
     
  4. Select the 'Custom Errors' tab.
     
  5. Select 403;14 and press Edit.
     
  6. Select Message Type 'File'.
     
  7. Browse to the file 'wpli404.html'.
     
    NOTE: This should be in the 'ProcessLibraries' folder (e.g. 'C:\Triaster\ProcessLibraries\wpli404.html'). However, it may have been installed to the 'ProcessLibraries\ProcessLibrary' folder, in which case it should be moved the 'ProcessLibraries' folder. The configuration will then be valid for all libraries within 'ProcessLibraries', extra ones of which may be created through cloning.
     
  8. Press OK.
     
  9. Select 404 and press Edit.
     
  10. Browse to the file 'wpli404.html'.
     
  11. Press OK.
     
  12. Press OK.
     

Windows Server 2008

  1. Start > Administrative Tools > Server Manager.
     
  2. Expand Roles > Web Server (IIS), and select 'Internet Information Services (IIS)'.
     
  3. Expand [Computer Name] > Sites > Default Web Site, and select ProcessLibraries.
     
  4. Double-click on the 'Error Pages' feature in the IIS section of the Features view.
     
  5. Double-click on 404.
     
  6. Select the 'Execute a URL on this site' radio button.
     
  7. Enter the URL '/ProcessLibraries/wpli404.html' (without quotes).
     
    NOTE: 'wpli404.html' should be in the 'ProcessLibraries' folder (e.g. 'C:\Triaster\ProcessLibraries\wpli404.html'). However, it may have been installed to the 'ProcessLibraries\ProcessLibrary' folder, in which case it should be moved the 'ProcessLibraries' folder. The configuration will then be valid for all libraries within 'ProcessLibraries', extra ones of which may be created through cloning.
     
  8. Click OK.
     
  9. On the right-hand side of the window press 'Add..'.
     
  10. In the 'Status code' field, write '403.14' (without quotes).
     
  11. Select the 'Execute a URL on this site' radio button.
     
  12. Enter the URL '/ProcessLibraries/wpli404.html' (without quotes).
     
  13. Press OK.
     

Validation

For each site in every library:
 
  1. Open the site at its home page.
     
  2. In the address bar, amend the name of the HTML file to something you know doesn't exist, e.g. 'homepagexx.html', and press ENTER.
 
Does a page containing the following text appear?:
Page Not Found
The requested page could not be found. It either doesn't exist, or if you recently uploaded the file, it may be that you require a site publish before you can access this page.
 
Ensure you have the correct address and try again. Alternatively, a site publish can be performed by logging onto the Web Powered Library Interface's Publication Services tool and clicking on the Publish button.
 
Note:
The server itself may not be configured to display such custom errors. If the custom webpage isn't displayed when viewing the site in a browser running directly on the server, try the above test on a different PC.

Configuring IIS to accept the "+" character in Windows Server 2008

By default, IIS in Windows Server 2008 is configured to reject URLs that contain a double escape sequence. This behaviour will break links to pages with URLs that contain characters such as '+' (including, for example, the 'library search + reports' page).

Procedure

The following steps describe how to allow these characters to be used in a URL.
  1. Click Start > All Programs > Accessories > right-click 'Command Prompt' > Run as administrator.
     
  2. At the Command Prompt, type:
     
    cd %windir%\system32\inetsrv
     
  3. and press ENTER.
     
  4. Type:
     
    appcmd set config /section:requestfiltering /allowdoubleescaping:true
     
  5. and press ENTER.
 
More information is available here.
 

Validation

  1. Open a process library website.
     
  2. Click on 'Library Search & Reports'.
     
The address of this page would be expected to contain 'library%20search%20+%20reports.html'. With this configuration, the page should be displayed without error.
 

Branding the Process Library

Please click here for information on branding the Process Library.
 
 

Need further help? Contact the Triaster Support team by e-mailing support@triaster.co.uk or by calling us on +44 (0)870 402 1234.
 
Do you have any feedback or suggestions that you would like to share with Triaster? We would love to hear from you! Please e-mail feedback@triaster.co.uk 
Comments