Migrating to a new workstation

The purpose of this document is to provide a strategy for transferring a Connect installation to a new workstation. The following guide applies to OLConnect v1.x and Workflow v8.x.

Before installing the software

Before upgrading to a new version, even on a new workstation, consult the product's release note to find out about new features, bug fixes, system requirements, known issues and much more. Simply go to the product page and look for "Release notes" in the Downloads area.

You should also consult the following pages for some technical considerations before installing:

Downloading and Installing the Software

In order to migrate to a new workstation, the software must already be installed on the new workstation. Follow the Installation and Activation Guide to download and install the newest version of PlanetPress Connect on the new workstation.

Backing Up files from the current workstation

The first step in migrating to a new workstation would be to make sure all necessary production files and resources are backed up and copied over to the new system.

Although it is not necessary to convert all of your documents when upgrading to the latest version, we strongly recommended doing so. It is considered "Best Practise" to convert the documents to the version installed and then re-send them to the Workflow Tools.

Backing up Workflow files

To save all Workflow-related files, backup the entire working directory:

 C:\ProgramData\Objectif Lune\PlanetPress Workflow 8

Here are a few important points when transferring these files:

  • If you are upgrading to the latest version of Connect, it is recommended to open each template in Designer, produce a proof making sure the output is correct. Then send the template with its data mapper, job and output preset files to Workflow by clicking on File -> Send to Workflow…
  • If you still use PlanetPress 7 legacy documents, PTK files can be imported by clicking on the Workflow tool button at the top left corner of the Workflow tool interface. If copying the PlanetPress Workflow 8 folder directly, it's important to delete any file with the .ps7 extension so as to refresh the postscript file for the new workstation.
  • The Workflow configuration file itself is named ppwatch.cfg, and is backed up with the folders. However, it needs to be re-sent to the Service to be used. To do this, rename the file to .OL-Workflow, open the file with the Workflow tool, and send the configuration.
  • Locate Custom Plugins (.dll) from the below folder on the old workstation and import them onto the new workstation
    C:\Program Files (x86)\Common Files\Objectif Lune\PlanetPress Workflow 8\Plugins
    To import the plugins:
    • Start the Workflow Configuration Tool
    • Click on the Plug-in Bar
    • Click on the down pointing triangle under the Uncategorized group
    • Select Import Plug-in and select the .dll file.
  • Import external scripts used by the Run Script plugin, making sure they reflect the same paths as on the previous workstation
  • Install any external application, executable and configuration files used by the External Program plugin, making sure they reflect the same paths as on the previous workstation
  • Reconfigure local ODBC connections. (i.e. create local copies of databases or recreate required DSN entries)
  • Backup and import other custom configuration files, Microsoft Excel Lookup files, making sure they reflect the same paths as previously.
  • Reinstall required external printer driver and recreate all Windows printer queues and TCPIP ports
  • On the new workstation if the "TCP/IP Print Server" service is running in Windows, it is requested to disable that service so that it does not interfere with the Workflow LPD/LPR services.
  • Configure the Workflow services account as in the previous installation. If accessing, reading and writing to network shares; it is recommended to use a domain user account and make it a member of the local Administrators group on the new workstation. Once the user account has been chosen:
    • Click on Tools in the Workflow Configuration menu bar
    • Click Configure Services
    • Select the user account
  • If required, grant permissions to other machines (Designer clients and other servers) to send documents and jobs to the new server.
    • Click on Tools in the Workflow Configuration menu bar
    • Click on Access Manager
    • Grant necessary permissions to remote machines
    • Restart the Workflow Messenger service
  • Reconfigure the Workflow Preferences as previously by clicking on the Workflow button on top left corner and clicking on Preferences:
    • Reconfigure the Server Connection Settings under Behavior > OL Connect
    • For PlanetPress Capture users, reconfigure the PlanetPress Capture options under Behavior > PlanetPress Capture
    • Reconfigure each of the plugin, where necessary, under Plug-in as previously.
      Capture OnTheGo users may want to enable the Use PHP Arrays option under Plug-in > HTTP Server Input 1
    • Send the configuration to local Workflow service

Backing up Connect Resources

The following resources are used by Connect and can be backed up from their respective folders:

  • Job Presets (.OL-jobpreset):
    C:\Users\<UserName>\Connect\workspace\configurations\JobCreationConfig
  • Output Presets (.OL-outputpreset):
    C:\Users\<UserName>\Connect\workspace\configurations\PrinterDefinitionConfig
  • OL Connect Print Manager Configuration files (.OL-ipdsprinter)
    C:\Users\<UserName>\Connect\workspace\configurations\PrinterConfig
  • OL Printer Definition Files (.OL-printerdef)
    C:\Users\<UserName>\Connect\workspace\configurations\PrinterDefinitionConfig
  • OMR Marks Configuration Files (.hcf)
    C:\Users\<UserName>\Connect\workspace\configurations\HCFFiles

Other Resources

  • OL Connect Designer Templates , Data Mapper or Package files, copied from the folder where they reside.
  • All Postscript, TrueType, Open Type and other host based fonts used in templates must be reinstalled on the new workstation.
  • Import all dynamic images and make sure their paths match those in the old server.
  • Make sure the new workstation can also access network or remote images, JavaScript, CSS, JSON, and HTML resources referenced in the Connect templates.

Secondary Software and Licenses

The following only apply for specific secondary products and licenses that interacts or is integrated into the main product.

Image, Fax and Search Modules

  • Reconfigure the Image and Fax outputs with the new host information.
  • Import the Search Profile and rebuild the database in order to generate the database structure required by the Workflow.

Capture

  • Download the latest version of the Anoto PenDirector.
  • Before installing the PenDirector, make sure the pen’s docking station isn’t plugged into the server. Then install the PenDirector.
  • Stop the Messenger 8 service on old and new server from the Workflow menu bar > Tools > Service Console > Messenger > right-click and select Stop.
  • Import the following files and folders from the old server into their equivalent location on the new server:
    C:\ProgramData\Objectif Lune\PlanetPress Workflow 8\PlanetPress Watch\capture\PPCaptureDefault.mdb
    C:\ProgramData\Objectif Lune\PlanetPress Workflow 8\PlanetPress Watch\DocumentManager
    C:\ProgramData\Objectif Lune\PlanetPress Workflow 8\PlanetPress Watch\PGC
  • If Capture was previously using an external MySQL or Microsoft SQL Server, reconfigure the ODBC connection details as previously from the Workflow Preferences by clicking on the Workflow button on top left corner and clicking on Preferences, then reconfigure the PlanetPress Capture options under Behavior >PlanetPress Capture > Use ODBC Database
  • Start the Messenger 8 service on new server from the Workflow menu bar > Tools > Service Console > Messenger > right-click and select Start.

OL Connect Send

• Re-install OL Connect Send on the new Workstation. This should reinstall the OL Connect Send plugins in the Workflow Tool

• Reconfigure the Server URL and port during the OL Connect Send Printer Driver setup

• Re-run the OL Connect Send printer driver setup on client system and select the Repair option to point the clients to the new Server URL.

Configuring the Connect Engines

Any changes made to the Server preferences required the OLConnect_Server service to be restarted to take effect.

  • Stop the OLConnect_Server service from Control Panel > Administrative Tools > Services > OLConnect_Server > Stop
  • Configure the Merge and Weaver Engines scheduling preferences as in the previous installation
    • Open the Server Configuration from :
      C:\Program Files\Objectif Lune\OL Connect\Connect Server\Server.exe
    • Configure the Merge and Weaver engines preferences under Scheduling
    • Configure any other options for the Clean-up Service
  • Configure the minimum (Xms) and maximum (Xmx) memory utilization for the Server, Merge and Weaver engines as previously or better:
    • Edit the following Xms and Xmx fields in the following configuration files:
      • C:\Program Files\Objectif Lune\OL Connect\Connect Server\Server.ini
      • C:\Program Files\Objectif Lune\OL Connect\MergeEngine\Mergeengine.ini
      • C:\Program Files\Objectif Lune\OL Connect\weaverengine\weaverengine.ini
  • Now start the OLConnect_Server service

Configuring the Server Extensions

In the case where the OLConnect MySQL is installed on the new Master Server, it is important to reconnect all Server Extension systems to the new Master Server.

Perform the following action on each Server Extension:

  • Stop the OLConnect_ServerExtension service from Control Panel > Administrative Tools > Services > OLConnect_ServerExtension > Stop
  • Open the Server Extension Configuration from:
    C:\Program Files\Objectif Lune\OL Connect\Connect Server Extension\ServerExtension.exe
  • Click on Database Connection and configure the JDBC Database connection settings so that the hostname points to the new Master server
  • Click on Scheduling and type in the location of the new Master server
  • Start the OLConnect_ServerExtension service

Transferring Software Licenses

Once all the above resources have been transferred over to the new server, it is recommended to thoroughly test the new system with sample files under normal production load to identify points of improvement and make sure the output match the user’s expectation. Output generated at this point will normally bear a watermark which can be removed by transferring licenses from the old server to the new one.

  • To transfer Connect and Workflow licenses, the user is usually required to complete a License Transfer Agreement which can be obtained from their local Customer Care department
  • Upgrades cannot be activated using the automated Activation Manager. Contact your local Customer Care department.

To apply the license file received from the Activation Team:

  • Start the PReS Connect, PlanetPress Connect or PrintShopMail Connect Software Activation module:
    C:\Program Files\Objectif Lune\OL Connect\Connect Software Activation\ SoftwareActivation.exe
  • Click on Load License File to import the license.OLConnectLicense
  • Start the Software Activation module on the Extension servers, where applicable
  • Click on Load License File to import the above same license.OLConnectLicense
  • Restart the OLConnect_Server service and restart the OLConnectServer_Extension service on the Extension servers, where applicable
  • The number of Expected Remote Merge and Weaver engines should now be configurable in the Connect Server Configuration module (C:\Program Files\Objectif Lune\OL Connect\Connect Server Configuration\ ServerConfig.exe)

To apply the PlanetPress Capture License

  • Open the Workflow Configuration
  • Click on Help on the Menu Bar and click on PlanetPress Capture License manager to import your license.

Uninstalling PlanetPress Connect from the previous workstation

It is recommended to keep the previous install for a few days until everything is completed. However, once your transition is successful and complete, the OL Connect software must be uninstalled from the original server.

  
  • Last Topic Update: 05, July, 2017 09:22 AM
  • Last Published: 2019-05-23 : 3:18 PM