Printshop Mail Connect Installation and Activation Guide
Total Page:16
File Type:pdf, Size:1020Kb
Installation and Activation Guide Version: 2018.1 Installation and Activation Guide Version 2018.1 Last Revision: 2019-12-20 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. 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 Terminal Server/Service Support 14 Virtual Machine Support 14 Remote Desktop Support 15 32-bit or 64-bit Operating Systems? 15 Antivirus Considerations 15 Windows Search Indexing Service 16 Commandline switches and .ini entries 16 Language and Encoding Considerations 16 Network Considerations 17 Firewall/Port considerations 17 Performance Considerations 18 Performance analysis details 18 Engine configuration 18 Template optimization 19 Hardware configuration 19 System requirements 20 Operating system (64-bit only) 20 Minimum hardware requirements 21 Installation and Activation 22 Where to obtain the installers 22 Installation - important information 22 Page 4 Installation - "How to" guides 22 Activation 23 Installation prerequisites 23 User accounts and security 23 Installing PrintShop Mail Connect on Machines without Internet Access 24 GoDaddy Root Certificate Authority needs to be installed. 24 Windows certificate validation - Certificate Revocation List retrieval should be switched off 25 Installation Wizard 26 Starting the PrintShop Mail Connect installer 26 Selecting the required components 26 Selection Confirmation 28 End User License Agreement 28 Configuring Supplied Database Connection 28 Completing the installation 29 The Product Update Manager 30 Product Activation 30 Running connect installer in Silent Mode 30 Required and optional properties 31 Getting the exit code of a silent installation 37 Activating a License 38 Obtaining the PrintShop Mail Connect Magic Number 38 Requesting a license 40 Activating PrintShop Mail Connect 40 Migrating to a new workstation 41 Before installing the software 41 Downloading and Installing the Software 42 Backing Up files from the current workstation 42 Preferences 47 COTG Servers preferences 47 Clean-up Service preferences 48 Database Connection preferences 52 Datamapper preferences 55 Editing preferences 56 Email Preferences 58 Emmet Preferences 59 Language Setting Preferences 63 Page 5 Logging Setting Preferences 63 Print Preferences 65 Saving Preferences 66 Scheduling Preferences 67 Scripting Preferences 68 Known Issues 69 Business Graphics: Backward Compatibility Issues 69 All charts 69 Pie charts 69 Minor differences in PCL, AFPDS and IPDS output introduced in 2018.1 69 Windows Server 2016 issue 70 No switch for case sensitivity in Dynamic Printer Rules editor 70 Limit of 100MB of image files within a single job 70 Print Output: Booklet Impositioning changes introduced in 2018.1 71 Installation Paths with Multi-Byte Characters 71 Switching Languages 71 GoDaddy Certificates 72 MySQL Compatibility 72 Available Printer Models 72 Colour Model in Stylesheets 72 Image Preview in Designer 73 VIPP Output 73 Uninstalling 74 Important Note: Stop any active Anti-Virus software before uninstalling Connect. 74 Impacts upon other Applications and Services 74 Uninstallation Wizard 75 Legal Notices and Acknowledgements 76 Page 6 System and Hardware Considerations There are a variety of considerations to be aware of. These are documented in the following pages: l "System requirements" on page 20 l "Database Considerations" on page 9 l "Environment considerations" on page 14 l "Known Issues" on page 69 l "Language and Encoding Considerations" on page 16 l "Antivirus Exclusions" below l "Performance Considerations" on page 18 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. 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. 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 Page 8 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. 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. Page 9 Installing / Updating Connect Using an existing local MySQL instance If MySQL Server is already present and you wish to use