Migrating to a new workstation

The purpose of this document is to provide a strategy for transferring a OL Connect installation to a new workstation.

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 the "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 OL 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.

Note: 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 Practice" to convert the documents to the version installed.

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

Where [username] is replaced by the appropriate Windows user name.

Note: Also backup any Print Presets that are stored in different folders. As of version 2023.1 Job Presets and Output Presets are no longer automatically stored in OL Connect's workspace folder: C:\Users\[UserName]\Connect\workspace\configurations.

Tip: Actually, the path may not begin with 'C:\Users', as this is language-dependent. On a French system, for example, it would be 'C:\Utilisateurs'.

Type %userprofile% in a Windows File Explorer and press Enter to open the actual current user's home directory.

Other Resources

  • OL Connect Designer Templates 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 applies to specific secondary products and licenses that interact or are 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

  1. Download the latest version of the Anoto PenDirector.
  2. Before installing the PenDirector, make sure the pen’s docking station isn’t plugged into the server. Then install the PenDirector.
  3. Stop the Messenger 8 service on the old and new server from the Workflow menu bar: Tools > Service Console > Messenger > right-click and select Stop.
  4. 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
  5. 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 at the top left corner and clicking on Preferences, then reconfigure the PlanetPress Capture options under Behavior >PlanetPress Capture > Use ODBC Database.
  6. 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

  • As of version 8.6 the Connect Send plugins are installed automatically with Workflow. If you are using an older version, run the OL Connect Send Plug-in Installer on the new Workstation to re-install the Connect Send plugins.
  • 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 OL Connect

Configuring the Connect Engines

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

  1. Stop the OLConnect_Server service from Control Panel > Administrative Tools > Services > OLConnect_Server > Stop.
  2. 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 Configuration\ServerConfig.exe
    • Configure the DataMapper, Merge and Weaver engines preferences (see Parallel Processing preferences). As of version 2018.1 these preferences include the minimum (Xms) and maximum (Xmx) memory utilization for the Merge and Weaver engines.
    • Configure any other options for the Clean-up Service.
  3. 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:

  1. Stop the OLConnect_ServerExtension service from Control Panel > Administrative Tools > Services > OLConnect_ServerExtension > Stop.
  2. Open the Server Extension Configuration from:
    C:\Program Files\Objectif Lune\OL Connect\Connect Server Extension\ServerExtension.exe
  3. Click on Database Connection and configure the JDBC Database connection settings so that the hostname points to the new Master Server.
  4. Click on Scheduling and type in the location of the new Master Server.
  5. 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 - in demo mode - with sample files under normal production load to identify points of improvement and make sure the output matches 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.
  • If you want to transfer your licenses to the new machine right away, you may ask your local Customer Care department for a 30 day Transition activation code for your old machine.
  • 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:

  1. Ensure that all services are stopped on your old machine before activating and starting the services on the new machine. Attempting to run the software with the same license simultaneously will not only run into errors but it is a breach of our EULA.
  2. Start the OL Connect Software Activation module:
    C:\Program Files\Objectif Lune\OL Connect\Connect Software Activation\SoftwareActivation.exe
  3. Click on Load License File to import the license.OLConnectLicense.
  4. Start the Software Activation module on the Extension servers, where applicable.
  5. Click on Load License File to import the above same license.OLConnectLicense.
  6. Restart the OLConnect_Server service and restart the OLConnectServer_Extension service on the Extension servers, where applicable.
  7. 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:

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

Uninstalling OL 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. See Uninstalling.