Installation Wizard

Starting the PReS Connect installer

The PReS Connect installer may be supplied as an ISO image or on a DVD.

  • If an ISO image, either burn the ISO onto a DVD or unzip the contents to a folder (keeping the folder structure)
  • If on a DVD, either insert the DVD and initiate the installation from there or copy the contents to a folder (keeping the folder structure)

Navigate to the PReS_Connect_Setup_x64.exe or  and double-click on it. After a short while the Setup Wizard will appear as a guide through the installation steps.

PReS Connect requires prior installation of Microsoft .NET Framework 3.5.

Please refer to https://www.microsoft.com/en-us/download/details.aspx?id=21 for more details on how to install Microsoft .NET Framework 3.5, if this is not already done.
If the same version of PReS Connect is already installed on the target machine, you will be presented with options to either Uninstall or Modify the existing instance.

If Modify is selected, the standard installation Wizard sequence will be followed, but with all options from the existing installation selected.

Selecting the required components

After clicking the Next button, the component selection page appears, where the different components of PReS Connect can be selected for installation. Currently, the following are available:

  • PReS Connect Designer: The Designer module (see The Designer). It may be used as a standalone with no other installed modules, but it will not have certain capabilities such as automation and commingling.
  • PReS Connect Print Manager: The Print Manager module (see Print Manager) required for handling IPDS print output, as also available for managing PCL and PostScript output.

  • PReS Connect Server: The Server back-end giving capabilities such as automation, commingling, picking. It saves all entities generated from the Automation module into a database for future use.
  • PReS Connect Server Extension: A slave server for a PReS Connect Server module. When an extension is installed, it communicates with the master server and shares tasks.
    Only one Server or Server Extension can be installed per machine, not both.

  • MySQL Product: Install the supplied MySQL database used by PReS Connect. The database is used for referencing shared and temporary Connect files, as well as for sorting temporarily extracted data, and the like.
    A pre-existing MySQL or Microsoft SQL server (referred to as an external database, in this documentation) could be used for the same purpose, however.
    The external database could reside on either the same computer or on a separate server.
    If you wish to make use of an external database, please make sure the MySQL Product option is not selected.
    If you chose not to install the supplied MySQL database, and instead opt for using a pre-existing external database then you must ensure that your external database is accessible to Connect, yourself. Objectif Lune Inc. will take no responsibility for database connections to any but the supplied MySQL database.
    See Database Considerations for more information about setting up external databases.
    All instances of PReS Connect Server and PReS Connect Server Extension must use the same instance of MySQL. Although it is possible for each separate Server installation to have its own MySQL instance, doing so will prevent the Servers from functioning together within a Server Clustering environment. The instance can be on any Server, however, whether it be the Server (master) or Server Extension (slave) machine.
  • Installation Path: This is the location where modules are to be installed.
    To cater for MySQL requirements, the installation path cannot contain any non ASCII characters (such as Asian language Unicode characters). Nor can it contain characters that Windows disallows in filenames (such as '?', ''>' or trailing spaces).
    If an invalid character is entered, the Installation Path entry box will turn red and a description of the error will be displayed in the information area.


The installer can also calculate how much disk space is required for installing the selected components as well as how much space is available:

  • Disk space required: Displays the amount of space required on the disk by the selected components.
  • Disk space available on drive: Displays the amount of space available for installation on the drive currently in the Installation Path.
  • Recalculate disk space: Click to re-check available disk space. This is useful if space has been made available for the installation while the installer was open.
  • Source repository location: Displays the path where the installation files are located. This can be a local drive, installation media, or a network path.

Selection Confirmation

The next page confirms the installation selections made. Click Next to start the installation itself.

End User License Agreement

The next page displays the End User License Agreement, which needs to be read and accepted before clicking Next.

Configuring Supplied Database Connection

The Default Database Configuration page appears if the supplied MySQL Product module was selected for installation in the Product Selection screen. It defines the administrative password for the MySQL server as well as which port it uses for communication.

The installer will automatically configure the Connect Server to use the supplied password and port.

  • MySQL user 'root' Password: Enter the password for the 'root', or administration account, for the MySQL server. The password must be at least 8 characters long and contain at least one of each of the following:
    • a lower case character (a, b, c ... )
    • an upper case character (A, B, C ...)
    • a numeric digit (1, 2, 3 ...)
    • a punctuation character  (@, $, ~ ...)

    For example: "This1s@K"

    When updating from an earlier Connect version, the appropriate MySQL password must be entered or the update will fail.

    If the password is subsequently forgotten, then the MySQL product must be uninstalled and its database deleted from disk before attempting to reinstall.

  • Confirm 'root' Password: Re-enter to confirm the password. Both passwords must match for installation to continue.
  • TCP/IP Port Number: The port on which MySQL will expect, and respond to, requests. A check is run to confirm whether the specified TCP\IP Port Number is available on the local machine. If it is already being used by another service (generally, an existing MySQL installation), the number is highlighted in red and a warning message is displayed at the top of the dialog.

    The MySQL Product controlled by the OLConnect_MySQL service communicates through port 3306 by default.

  • Allow MySQL Server to accept non-local TCP connections: Click to enable external access to the MySQL server.

    This option is required if setting up clustering, or if MySQL Server will need to be accessed from any other machine.
    It is also required if the MySQL database is on a separate machine to PReS Connect.

    This option may represent a security risk if the machine is open to the internet.
    It is heavily recommended that your firewall is set to block access to port 3306 from external requests.

Configuring External Database Connection

The Database Connection page appears if the supplied MySQL Product module was not selected for installation. This page is for setting up the connection to the existing External database.

  • Database Configuration: Select the database type to use for the PReS Connect Engine. Currently only MySQL and Microsoft SQL Server are supported.
  • Administrator Username: Enter the username for a user with administrative rights on the database. Administrative rights are required since tables need to be created in the database.
    If accessing a database on a different machine, the server must also be able to accept non-local TCP connections, and the username must also be configured to accept remote connection. For example, the "root" MySQL user entered as root@localhost is not allowed to connect from any other machine than the one where MySQL is installed.
  • Administrator Password: Enter the password for the above user. The appropriate MySQL password must be entered or the Connect installation will fail.
  • TCP/IP Port Number: Enter the port on which the database server expects connections.
    For MySQL, this is 3306 by default.
    For MS SQL it is 1433 by default.
  • Database Host Name: Enter the existing database server's IP or host name.
  • Server Schema/Table: Enter the name of the MySQL database into which the tables will be created. The Connect standard name is "objectiflune".
  • Test Connection button: Click to verify that the information provide into previous fields is valid by connecting to the database.
    This test does not check whether the remote user has READ and WRITE permissions to the tables under the objectiflune schema. It is solely a test of database connectivity.

PReS Connect Server/Server Extension Configuration


The Server Configuration page is where either the Connect Server or Connect Server Extension component is configured, depending upon whether the Connect Server (Master) or Connect Server Extension (Slave) option was selected as part of the installation.

The Connect Server (Master) settings are as follows:.

  • Run Server as: Defines the machine username and password that the PReS Connect Server module's service uses.

    The Server Security Settings dialog can only ever be executed from the user specified here.

    • Username: The account that the service uses to login. If the machine is on a domain, use the format domain\username.
      This account must be an existing Windows profile with local administrator rights.
    • Password: The password associated with the selected user.
    • Validate user button: Click to verify that the entered username and password combination is correct and that the service is able to login.
      This button must be clicked and the user validated before the Next button becomes available.

The Server Extension Configuration (Slave) options appear when the Connect Server Extension module has been selected in the installation, rather than the Connect Server option.

Such an installation assumes that the Connect Server (the Connect Master Server) has previously been setup on another machine, and that the option "Allow MySQL Server to accept non-local TCP connections” option were selected during that installation.

Before installing the software, make sure that both TCP/IP ports 3306 and 9340 are open on the Connect Master Server and Connect Extension Server, in both the Inbound and Outbound Firewall Rules. Access within the Private and Domain profiles is sufficient.

It is recommended your firewall blocks access to port 3306 from external requests as it may represent a security risk if the machine is open to the internet!
Before installing the Connect Extension Server it is considered best practice to first setup the Connect Master Server. To do so, follow the Binding and Root access on the Master server instructions in Server Clustering.

This page defines the settings which are to be used to connect to that Connect Master Server.
  • Username: The account that the service uses to login. If the machine is on a domain, use the format domain\username.
    This account must be an existing Windows profile with local administrator rights.
    This should ideally be the same as the logon domain user account for the OLConnect_Server service on the Connect Master Server.

    This account must be a local admin account with existing Windows profile on both servers.
  • Password: The password associated with the selected user.
  • Hostname: Enter the machine name or IP Address where the Connect Master Server resides.
    There is no requirement for the Master and Extension servers to belong to the same IP subnet. IP subnetting is beyond the scope of this documentation, but more information can be found here: https://en.wikipedia.org/wiki/Subnetwork
  • Port: Enter the port to use to communicate with the Connect Server. The Connect Server controlled by the OLConnect_Server service communicates through port 9340 by default.
  • Use Server authentication checkbox: Check this option and enter appropriate User details, if the Server expects authentication.
  • Validate Connection button: Click to verify that the entered username and password is correct and the service is able to login. This button must be clicked and the user validated for the Next button to become available.

Click Next to start the actual installation process. This process can take several minutes.

Completing the installation

This screen describes a summary of the components that have been installed.

  • Configure Update Check checkbox: This option is enabled by default. It causes the Product Update Manager to run after the installation is complete. This allows configuring PReS Connect to regularly check for entitled updates.
    Note: this checkbox may not be available in the event that an issue was encountered during the installation.
  • Show Log... : If an issue was encountered during the installation, click this button to obtain details. This information can then be provided to Objectif Lune for troubleshooting.
  • When ready, click the Finish button to close the installation wizard, and initialize the Product Update Manager, if it was selected.

The Product Update Manager

If the Configure Update Check option has been selected, the following message will be displayed after clicking “Finish” in the setup:

Click “Yes” to install or open the Product Update Manager where the frequency with which the updates can be checked and a proxy server (if required) can be specified.
Note: if the Product Update Manager was already installed by another Objectif Lune application, it will be updated to the latest version and will retain the settings previously specified.

Select the desired options and then click OK to query the server and obtain a list of any updates that are available for your software.

  • Note that the Product Update Manager can also be called from the “Objectif Lune Update Client” option in the Start menu.
  • It can be uninstalled via Control Panel | Programs | Programs and Features.

Product Activation

After installation, it is necessary to activate the software. See Activating your license for more information.

Before activating the software, please wait 5 minutes for the database to initialize. If the software is activated and the services rebooted too quickly, the database can become corrupted and require a re-installation.

 
  • Last Topic Update: 18, January, 2018 06:24 AM
  • Last Published: 23, May, 2019 01:55 PM