Objectif Lune PrintShop Mail Web - 7.0 Installation Manual

PrintShop Mail Web

Installation Guide

No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any other language or computer language in whole or in part, in any form or by any means, whether it be electronic, mechanical, magnetic, optical, manual or otherwise, without prior written consent of Objectif Lune Inc.

Objectif Lune Inc. disclaims all warranties as to this software, whether expressed or implied, including without limitation any implied warranties of merchantability, fitness for a particular purpose, functionality, data integrity or protection.

PlanetPress and PrintShop Mail are registered trademarks of Objectif Lune Inc.

PostScript and Acrobat are registered trademarks of Adobe Systems Inc.

Pentium is a registered trademark of Intel Corporation.

Windows is a registered trademark of Microsoft Corporation.

Adobe, Adobe PDF Library, Adobe Acrobat, Adobe Distiller, Adobe Reader, Adobe Illustrator, Adobe Photoshop, Optimized Postcript Stream, the Adobe logo, the Adobe PDF logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries.

Trademarks of other companies mentioned in this documentation appear for identification purposes only and are the property of their respective companies.

Title PrintShop Mail Web - Installation Guide

Revision 2010/01/04

Table of contents

1 Introduction ..................................................................................................................................................................................................... 1

1.1 Steps to install ................................................................................................................................................................................................... 2

1.1.1 Upgrading PrintShop Mail Web .................................................................................................................................................................. 2

2 Installing the software..................................................................................................................................................................................... 3

2.1 System requirements ......................................................................................................................................................................................... 4

2.1.1 Prerequisites ........................................................................................................................................................................................... 4

2.1.2 Minimum Hardware Requirements ............................................................................................................................................................. 4

2.1.3 Supported Operating Systems ................................................................................................................................................................... 4

2.1.4 Suggested requirements ........................................................................................................................................................................... 4

2.1.5 Notes....................................................................................................................................................................................................... 5

2.2 Running the installer .......................................................................................................................................................................................... 6

2.3 Configuring the database and web site .............................................................................................................................................................. 10

3 PrintShop Server service ................................................................................................................................................................................ 14

3.1 Creating a User Account for the PSS service....................................................................................................................................................... 15

3.2 Set the security privileges (local account) .......................................................................................................................................................... 18

3.3 Managing printers for PrintShop Server.............................................................................................................................................................. 21

3.4 Setting the PrintShop Server Service account ..................................................................................................................................................... 22

4 Important update notes ................................................................................................................................................................................. 27

4.1 Create backups................................................................................................................................................................................................ 28

4.1.1 Backup your database............................................................................................................................................................................. 28

4.1.2 Backup production files ........................................................................................................................................................................... 29

4.1.3 Backup skin files..................................................................................................................................................................................... 30

4.1.4 Backup configuration files ....................................................................................................................................................................... 30

4.2 Orders and Documents..................................................................................................................................................................................... 31

4.3 Skin changes ................................................................................................................................................................................................... 32

5 HTTP over SSL (HTTPS).................................................................................................................................................................................. 33

5.1 PrintShop Mail Web and HTTPS......................................................................................................................................................................... 34

5.1.1 SSL certificates....................................................................................................................................................................................... 34

5.1.2 Server installation................................................................................................................................................................................... 35

5.1.3 Client installation .................................................................................................................................................................................... 35

1 Introduction

The instructions in this document describe how to install, set up, and initialize PrintShop Mail Web. After you have finished installing the software components and configured them properly, you are ready to use your PrintShop Mail Web system. Refer to the PrintShop Mail Web documentation for information about using the various software components.

Before you begin installing PrintShop Mail Web and its associated files, make sure that the computers on which you plan to install the software meet the minimum hardware and software requirements, and that you have sufficient hard disk space to install the PrintShop Web software.

1.1 Steps to install

As a general rule, we recommend to install the PrintShop Mail Web and its accompanying modules on a clean machine using the supplied installer. A clean machine is any computer without preinstalled versions of PHP, MySQL, Apache webserver or Microsoft IIS (or at least turned off).

The following steps are required to install the software:

1. Install the software components using the PrintShop Mail Suite installer (setup.exe)

2. Initialize the PrintShop Mail Web website and database

3. Optionally configure the PrintShop Mail Server service and set up printers

1.1.1 Upgrading PrintShop Mail Web

When upgrading PrintShop Mail Web we strongly advise to read the Important update notes (Page 27) section and create backups of your current installation.

Note! Upgrading to PSM Web 7 cannot be undone, the PSM Web 7 database is not backwards

compatible with PSW 2.x.

2 Installing the software

Following the instructions in this chapter will enable you to successfully install PrintShop Mail Web and its components. After the installation the you will to setup the PSM Web database and web site. This section covers the following subjects:

• System requirements (Page 4)

• Running the installer (Page 6)

• Configuring the database and web site

2.1 System requirements

PrintShop Mail Web is a server software and is delivered as an executable installer with predefined configuration settings. We strongly recommend to install the software on a clean installed Windows computer.

2.1.1 Prerequisites

Please ensure that the following requirements have been met before you run the PrintShop Mail Suite installer:

• Login user must have administrator privileges

• Be sure to have an internet connection during the installation!

• PrintShop Mail Web requires the following system components to be installed on your computer prior to installing the product:

▪ Microsoft .Net Framework

▪ Version 2.0 SP1 (on Windows 2000, XP and 2003 Server) ▪ Version 3.5 SP1 (on Windows Vista and 2008 Server)

▪ MSXML 4.0 SP2 Parser and SDK ▪ VCRedist (Visual C++ 2008 vanilla) ▪ Access Database Engine

The PrintShop Mail Suite setup will automatically check these requirements, missing third party software packages will be downloaded from the internet and installed (but of course, not without your permission). The mentioned components can also be downloaded and installed manually. Installers for these packages can be downloaded from the Microsoft web site.

The software components are installed in the Program Files folder of the system drive. Normally this is drive C.

2.1.2 Minimum Hardware Requirements

• Pentium 4, 3 GHz 32-bit (x86)

• 2024 MB of system memory

• 80 GB hard drive

2.1.3 Supported Operating Systems

• Microsoft Windows 2000 (32-bit)

• Microsoft Windows XP Professional (32-bit and 64 bit)

• Microsoft Windows Vista (32-bit and 64 bit)

• Microsoft Windows 2003 Server (32-bit and 64 bit)

• Microsoft Windows 2008 Server (32-bit and 64 bit)

2.1.4 Suggested requirements

For production servers, it's recommended to invest in specific server hardware, such as large RAID hard disks, UPS (uninterrupted power supply) and enough RAM memory.

• Intel or AMD dual-core processor

• 4048 MB of system memory

• 300 GB hard drive

Installing the software - System requirements

2.1.5 Notes

• Make sure that port 80 and/or port 443 are available for the Apache web server that comes with PrintShop Mail Web.

• USB slot (not required for testing). Your server musts have a USB port to which the hardware key ('dongle') can be attached.

• Your network should be an Ethernet (TCP/IP) network, which is by far the most commonly used network today.

• You should have a high speed Internet connection, and a fixed outgoing IP address, which implies that you can run a web server.

• The PrintShop Mail Web server should be directly connected to the RIP or Printer. This means that the PrintShop Mail Web server should be located on your local network (same subnet), on your premises, and preferably not at your ISP's (Internet Service Provider, the company that provides your Internet connection).

• Your router should be configured to allow incoming HTTP connections over port 80. Your network administrator or your ISP should know how to enable this.

• The PrintShop Mail Web server has a built-in email server. This email server will send email notifications to you and your customers when the order status changes. You'll need to know your ISP's SMTP server address (usually something like smtp.yourprovider.com)

2.2 Running the installer

1. Navigate to the PrintShop Mail Suite.exe file you downloaded from the Internet or locate the file on the PrintShop Mail Suite product CD. Once located double click its icon to launch the installation program. The Select Setup Language dialog appears.

2. Select your preferred language and click OK.

In case the prerequistes are not met, the following dialog is shown stating the missing items.

The stated components/libraries are missing

3. Click Next to download and install the required components. Once the installation of the components is completed the the installer Welcome screen displays.

4. Click Next. The License Agreement page is shown.

5. Read the license agremeent. If the terms of the agreement are acceptable, click on I accept the terms of

the license agreement.

Note: You must accept the terms of the license agreement to continue.

6. Click Next to continue the installation process. The Features page displays.

7. Select the PrintShop Mail Web option to install the web server, database server and PrintShop Mail Server components required for PrintShop Mail Web. The PrintShop Mail application is a required by PrintShop Mail Web and cannot be deselected. Unless you have specific setup requirements, we recommend using the default options for the PrintShop Mail application.

Installing the software - Running the installer

The features dialog

8. Click Next. The Apache Options screen appears.

PrintShop Mail Web uses the Apache web server, the software can be configures to support regular (HTTP) and secured (HTTPS) types of connections. HTTP is required for the communication between PrintShop Mail Server and PrintShop Mail Web. HTTPS enabls the secured transmission of web pages. Please refer to the HTTP over SSL (HTTPS) chapter for more information on this subject. When selecting Bind HTTP to localhost, PrintShop Mail Web only accpets HTTP connections from the local machine, from all other systems PrintShop Mail Web accepts only HTTPS connections.

The Apache Options dialog

Installing the software - Running the installer

9. Select the protocol(s) you wish to use.

Note: If the ports for these protocals are in use a warning appears. This may occur when an

existing web server like Apache, Internet Information Server (IIS) or applications like Skype is already running on the same machine. The application or service that uses port 80 or 443 (https) must be closed in order to use PrintShop Mail Web. If you proceed without closing the conflicting application, the installer application will not be able to start the Apache web server. Apache can be started manually using the PrintShop Server Managerapplication.

10. Click Next. The PriintShop Server Services screen appears.

PrintShop Mail Server is a Windows Service that runs in the background. Windows services by default run as a virtual user: Localsystem. As the Local System-account has some limitations the PrintShop Mail Suite installer assigns the currently logged on account to the PrintShop Mail Server service. For more information on this subject please refer to the PrintShop Mail Server service chapter.

Note: In order to start a Windows Service your account must have a password (not empty).

11. Type the password of the displayed user.

12. Click Next. The Destination Folder screen displays the drive and folder where PrintShop Mail Web will be installed. To install the software elsewhere, click Change... and navigate to the desired folder.

Select the destination folder

13. Click Next. The Program Folder page is shown.

14. Enter a name for the shortcuts folder in the Start menu.

15. Click Next. The Ready to install screen appears.

16. Click Next to install the program files. When the installation has been successful, the following dialog appears:

Installing the software - Running the installer

Setup completed dialog

17. Click Finish to complete the installation of PrintShop Mail Web. Further configuration is still needed and is explained in the following sections.

▪ Select the Check for Updates option to launch the Objectif Lune Update Manager service. It

contains a list of updates (if available) for the PSM Suite components that are installed on your system. Click the Install icon to downloaded and install the new versions.

2.3 Configuring the database and web site

After the installation you will need to launch your web browser and navigate to the PrintShop Mail Web web site. You can reach the web site using localhost in your web browser's address bar. The first time you visit the web site the First Run page will be shown. This web page will initialize the PrintShop Mail Web web site and database and guides you through this process step by step.

1. Open your web browser and enter localhost in the address bar. The First Run wizard appears.

Choose your language

The wizard will first allow you to select a language to use.

2. Select a language and click Next to proceed to the Database server connection page.

Specify your MySQL host, user name and password

+ 28 hidden pages