Printshop Mail Connect Installation and Activation Guide
Total Page:16
File Type:pdf, Size:1020Kb
Installation and Activation Guide Version: 1.8 Installation and Activation Guide Version 1.8 Last Revision: 2019-05-23 Objectif Lune, Inc. 2030 Pie-IX, Suite 500 Montréal, QC, Canada, H1V 2C8 +1 (514) 875-5863 www.objectiflune.com All trademarks displayed are the property of their respective owners. © Objectif Lune, Inc. 1994-2019. All rights reserved. No part of this documentation may be reproduced, transmitted or distributed outside of Objectif Lune Inc. by any means whatsoever without the express written permission of Objectif Lune Inc. disclaims responsibility for any errors and omissions in this documentation and accepts no responsibility for damages arising from such inconsistencies or their further consequences of any kind. Objectif Lune Inc. reserves the right to alter the information contained in this documentation without notice. Table of Contents Table of Contents 4 System and Hardware Considerations 7 Antivirus Exclusions 7 Directories and folders 7 Database Considerations 9 Using the MySQL Instance from the Installer 9 Installing / Updating Connect Using an existing local MySQL instance 10 Installing Connect using an existing Microsoft SQL Server instance 11 Updating With No Local MySQL Product 12 When modifying Connect 12 Important 13 Environment Considerations 14 Virtual Machine Support 14 Terminal Server/Service 14 Remote Desktop 15 64-bit Operating Systems 15 Antivirus Considerations 15 Windows Search Indexing Service 15 Commandline switches and .ini entries 16 Language and Encoding Considerations 16 Network Considerations 17 Firewall/Port considerations 17 Performance Considerations 17 Engine configuration 18 Template optimization 20 Hardware configuration 20 System Requirements 22 Operating System (64-bit only) 22 Minimum Hardware Requirements 22 Installation and Activation 23 Where to obtain the installers 23 Installation - important information 23 Installation - "How to" guides 23 Page 4 Activation 24 Installation Prerequisites 24 User accounts and security 24 The Importance of User Credentials on Installing and Running PrintShop Mail Connect 25 Installation 25 User Account 26 Connect Components 26 Installing PrintShop Mail Connect on Machines without Internet Access 27 GoDaddy Root Certificate Authority needs to be installed. 27 Windows certificate validation - Certificate Revocation List retrieval should be switched off 28 Installation Wizard 28 Starting the PrintShop Mail Connect installer 28 Selecting the required components 29 Selection Confirmation 30 End User License Agreement 30 Completing the installation 30 The Product Update Manager 31 Product Activation 31 Running connect installer in Silent Mode 31 Required and optional properties 32 Getting the exit code of a silent installation 38 Activating a License 39 Obtaining the PrintShop Mail Connect Magic Number 39 Requesting a license 41 Activating PrintShop Mail Connect 41 Migrating to a new workstation 42 Before installing the software 42 Downloading and Installing the Software 42 Backing up files from the current workstation 43 Known Issues 48 Installation Paths with Multi-Byte Characters 48 Switching Languages 48 GoDaddy Certificates 48 Available Printer Models 49 Colour Model in Stylesheets 49 Image Preview in Designer 49 Page 5 VIPP Output 49 Uninstalling 50 Important Note: Stop any active Anti-Virus software before uninstalling Connect. 50 Impacts upon other Applications and Services 50 Uninstallation Wizard 51 Legal Notices and Acknowledgements 52 Page 6 System and Hardware Considerations There are a variety of considerations to be aware of. These are documented in the following pages: l "Antivirus Exclusions" below l "Database Considerations" on page 9 l "Environment Considerations" on page 14 l "Language and Encoding Considerations" on page 16 l "Network Considerations" on page 17 l "Performance Considerations" on page 17 l "System Requirements" on page 22 Antivirus Exclusions The information on this page is designed to assist IT managers and IT professionals decide what anti-virus strategy to follow with consideration to PrintShop Mail Connect and their internal requirements and needs. This page describes the mode of operation and the files and folders used by PrintShop Mail Connect as well as the files, folders and executables that are recommended to be ignored for best possible performance and to avoid issues caused by antivirus file locks. IT managers and IT professionals then may decide the anti-virus strategy to follow for their internal requirements and needs depending on the statements outlined herein. Directories and folders Main installation folder All Connect applications are installed under an arbitrarily selectable main folder. We will refer to it as the "Installation Target" hereafter. The installation target will hold the executables and files and sub-folders required for the operation of the whole product suite. All these files and folders are static after installation. It depends upon the company virus protection strategy, if such files and folders are to be Page 7 monitored or not. Running virus protection on these files and folders should not have a big - if even any - impact on the performance of the Connect suite. With some exceptions, which are listed below. Connect Service The Connect Service is run via the executable file Service.exe. This file has been reported as causing issues with some antivirus packages, so we recommend adding this file to the antivirus exclusion list, if possible. The executable will be installed to the installation target "Connect Server" sub-folder. If the default folder was selected during the installation process the file is likely to be as follows: C:\Program Files\Objectif Lune\OL Connect\Connect Server\Service.exe Working folders Working folders for Connect are created and used on a per-user-basis under the respective user's profile folder, accessible on Windows with the standardized system variable %USERPROFILE% in the sub-folder "Connect". Applying virus protection to these working folders will have differing levels of impact. These impacts are as follows: l %USERPROFILE%\Connect\filestore: This folder will hold non-intermediate files for the operation of Connect. Files in this folder will be used frequently, but not with a high frequency. Virus protection on this folder and contents should not have too much of an impact on the speed of the whole Connect suite. l %USERPROFILE%\Connect\logs: As the name implies, log files are created and updated here. These log files are plain text files. Virus protection on this folder and contents may have an impact on the speed of the whole Connect suite. l %USERPROFILE%\Connect\temp: Storage folder for temporary data, usually intermittent files in multiple folders. Virus protection on this folder and contents might have a serious impact on the performance of Connect. l %USERPROFILE%\Connect\workspace: Usually containing settings and helper files and folders. Page 8 Virus protection on this folder and contents should not have too much of an impact on the speed of the whole Connect suite. Database 1 Depending on the components installed, a database instance is created in a folder called "connect.database" under the Windows system temp folder. The temp folder is accessible via the standardized system variable %TMP%. Usually, folders holding temporary files and folders should be excluded from a virus protection, because this influences the overall performance of the whole system at all. However the responsible person for the computer protection has to decide about the monitoring of such temporary folders following the company guidelines. Database 2 Another database instance is used by Connect. This is the Connect back-end database. The path to this folder is stored in the standardized system variable %PROGRAMDATA%. The Connect back-end database is located in the subfolder "Connect\MySQL". As this database will be in constant use when Connect is running, virus protection on this folder and its sub-folders may have a serious impact on the performance of Connect. Database Considerations This page describes the different considerations and pre-requisites for the database back-end used by PrintShop Mail Connect, whether using the MySQL instance provided by the installer, or pre-existing (external) instance. Using the MySQL Instance from the Installer The MySQL Instance provided in the Installation Wizard is already pre-configured with options to provide the most stable back-end setup. These are the specific options that have been changed in our version of "my.ini": l max_connections = 200 : PrintShop Mail Connect uses a lot of database connections. This number ensures that even in high volume environments, enough connections will be available. Page 9 l max_allowed_packet = 500M : In some implementations, especially when using Capture OnTheGo, large packet sizes are required to allow transferring binary files. This substantial packet size maximum setting ensures that the data received by PrintShop Mail Connect will be able to be stored within the database. l character-set-server = utf8 , collation-server = utf8_unicode_ci , default-character- set=utf8 : These indicate database support for UTF-8/Unicode. Installing / Updating Connect Using an existing local MySQL instance If MySQL Server is already present and you wish to use it, the following should be taken into consideration: l The MySQL account must have access to all permissions using the GRANT Command, including creating databases. l The database configuration must include the options detailed