Uniprint 8.3 Secure Release Service Application data folder

Print jobs waiting to be released by the user are no longer held in a Windows printer object.  They are transferred from the Windows spooler to the Uniprint Secure Release Service.  Therefore, print jobs are no longer stored in the Windows spooler directory (\Windows\system32\spool\printers).  During the installation of Uniprint 8.3 Print Services, the installer prompts for the location of the application data folder for the Secure Release Service.  After the installation, the given location will be used to store the application data for Secure Release Service, including all print jobs.

Certain configurations may result in a large amount of space being used to store pending print jobs.  It may be desirable to separate this area from operating system workspace, which can be done either during installation or subsequently.

Folder Limitations

The following restrictions apply for the Application Data folder:

  • The folder cannot reside on a network share.  This includes both direct UNC paths and mapped network drives.
  • The full path must contain only ASCII characters.

The Installer might not detect the above situations and if this is the case, the installer may fail to install the product.

How to change the print job storage location (Application Data folder) after installation

The location of the application data folder (including storage of print jobs) can be altered by performing the following manual steps:

  1. Locate the PharosSystems folder structure in the current install location.
  2. Copy and paste the PharosSystems app data folder structure to the new location.
  3. Edit the Secure Release Service config file to point to the new folder location.
  4. Delete and recreate the Symbolic Link for the JobPlugins folder.
  5. Restart the Secure Release Service.

Each step is described in more detail below.

  1. Locate the PharosSystems appdata folder.

    Find the application data folder information from the configuration file under install directory of the application (e.g. "C:\Program Files\Pharos\SecureRelease").

    Locate the file:

    PharosSystems.SecureRelease.SecureReleaseService.exe.config

    Open the file, find the <appSettings> xml tag at the start of the file and note the location of the Application Data Path.

  2. Copy and paste the PharosSystems application data folder and subfolders to the new location.

    Locate the PharosSystems directory and copy the full folder structure to the new location.  (i.e. \PharosSystems\SecureRelease and all subfolders).

  3. Edit the Secure Release Service config file to point to the new appdatafolder location.

    Under the install folder of the application (e.g.  "C:\Program Files\Pharos\SecureRelease") locate the file:

    PharosSystems.SecureRelease.SecureReleaseService.exe.config

    Open the file, find the following xml tag at the start of the file and change the value to the new location of the Application Data.

    <appSettings>
    <add key="ApplicationDataPath" value="NewLocation\PharosSystems\SecureRelease\"/>
    </appSettings>
    
  4. Delete and recreate the Symbolic Link for the JobOperations folder.

    Download Junction.exe, a Microsoft Sysinternals tool: http://technet.microsoft.com/en-us/sysinternals/bb896768.

    Copy the file locally to the Print Server machine and open a Command Prompt window in the path of the Junction executable.  Type:

    Junction -d "<programinstallpath>\Pharos\SecureRelease\Plugins\JobOperations"

    (where <programinstallpath> is the full path of the Pharos program files installation, e.g. C:\Program Files\)

    This will delete the existing symbolic link so that a new one can be created.  Then type:

    Junction "<programinstallpath>\Pharos\SecureRelease\Plugins\JobOperations" "<appdatapath>\PharosSystems\SecureRelease\JobOperationPlugins"

    (where <programinstallpath> is as described above, and <appdatapath> is the new path for the application data folders as described in step b).

    This will create a new symbolic link, pointing to the new application data location.

    Note: Windows Server 2008 provides a built-in utility 'mklink' for managing symbolic links. This can be used instead of Junction to alter the symbolic link.

  5. Restart the Pharos Systems Secure Release Service.

    In the Windows Services window, restart the Pharos Systems Secure Release Service in order to use the new setting.

At this point it is possible to delete the SecureRelease folder in the original application data location.

Note: If the MobilePrint solution is also installed, it is important not to delete the \PharosSystems\MobilePrint directory in the default application data location.

Application Data Folder Structure

There are four folders under the Application Data location.

  • Database

    The Secure Release Server uses an SQLite database to store print job information.  The database can be viewed using SQLite compatible tools, but it is not recommended for end users to access this database.

  • JobOperationPlugins

    This folder is used to store plug-in files. For example, if MobilePrint is installed then its relevant files will be installed in this folder.

  • Job Store

    This folder is used to store print jobs.  Print jobs will be owned by the user who is logged on to the workstation.  Print jobs will always be stored under the Windows username rather than the username entered in the popup question.

  • PageCounting

    The spool files in this directory are print jobs that have failed to be page counted by the PageCounter component.  The registry value \PharosSystems\PageCounting\StoreFiles can be set to following values to control the saving of spool files to this directory:

    • 0 = don't save
    • 1 = always save
    • 2 = on failure only