Installation Wizard

Starting the PlanetPress Connect installer

The PlanetPress 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 PlanetPress_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.

PlanetPress 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).

Selecting the required components

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

  • PlanetPress Connect Designer: The Designer module. It may be used as a standalone with no other installed modules, but it will not have certain capabilities such as automation and commingling.
  • PlanetPress 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.
  • MySQL Product: The database used by the PlanetPress Connect Engine to save its items. This item is optional if an existing MySQL server, either on the same computer or a separate server, is to be used.
  • Installation Path: This is the location where modules are to be installed.


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.

MySQL Configuration

The Default Database Configuration page only appears if the MySQL Product module was selected in the Product Selection screen. It defines the administrative password for the MySQL server as well as which port it uses for communication. Note that the installer will automatically configure the 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: "Th1sIs@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 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 PlanetPress 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.

The Database Connection page appears if the MySQL Product module was not selected. It defines the necessary information required to connect to an existing database.

  • Database Configuration: Select the database type to use for the PlanetPress Connect Engine. Currently only MySQL is 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.
  • 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.

PlanetPress Connect Server Configuration

The Server Configuration page is where the Connect Server component is configured.

The Connect Server settings are as follows:.

  • Run Server as: Defines the machine username and password that thePlanetPress 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.

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 PlanetPress 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: 24/01/2017 09:32
  • Last Published: 7/6/2017 : 9:48 AM