Objectif Lune PrintShop Web - 2.2 Installation Manual

PrintShop Web

Installation Guide

PrintShop Web Installation Guide

Document version: PSW 2.2 R4300 Date: May, 2008

Objectif Lune - Contact Information

Objectif Lune Inc. 2030 Pie IX, Suite 500 Montréal, QC Canada H1V 2C8 Tel.: 514-875-5863 Fax: 514-342-5294

www.objectiflune.com

To find an Objectif Lune office near you and for more information on our products and services, visit:

www.objectiflune.com

Table of Contents

Introduction.................................................................................................................................................4

Steps to install.............................................................................................................................................4

Upgrading PSW...........................................................................................................................................4

System requirements..............................................................................................................................5

Minimum requirements................................................................................................................................5

Suggested requirements..............................................................................................................................5

Notes............................................................................................................................................................6

Installing PrintShop Web......................................................................................................................7

Running the installer....................................................................................................................................7

Setting up the database and web server.................................................................................... 12

First Run wizard........................................................................................................................................ 12

PrintShop Server service....................................................................................................................16

Creating a User Account for the PSS service.......................................................................................... 17

Set the security privileges (local account)................................................................................................ 19

Managing printers for PrintShop Server....................................................................................................22

Setting the PrintShop Server Service account..........................................................................................23

Modify, repair or remove this product.........................................................................................28

Modify.........................................................................................................................................................29

Repair.........................................................................................................................................................29

Remove......................................................................................................................................................29

Known issues.............................................................................................................................................29

Important update notes.......................................................................................................................30

Creating a backup.....................................................................................................................................30

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

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

Manual installation.................................................................................................................................33

PrintShop Web components......................................................................................................................33

PHP Hypertext Preprocessor....................................................................................................................34

The PHP configuration file........................................................................................................................ 36

PEAR Package..........................................................................................................................................37

Zend OptimizerTM.....................................................................................................................................37

Apache.......................................................................................................................................................37

HTTP over SSL (HTTPS).....................................................................................................................41

PrintShop Web and HTTPS...................................................................................................................... 41

Server installation......................................................................................................................................42

Client installation........................................................................................................................................43

PrintShop Web Installation Guide | 3

Introduction

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

Before you begin installing PrintShop 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.

Steps to install

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

The following steps are required to install PrintShop Web:

1 Install the software components using the PrintShop Web installer (setup.exe) 2 Initialize the PrintShop Web website and database 3 Optionally configure the PrintShop Server service and set up printers

Upgrading PSW

When upgrading PrintShop Web we strongly advise to read the Important update notes chapter and create backups of your current PrintShop Web installation.

PrintShop Web Installation Guide | 4

System requirements

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

Please ensure that the following requirements have been met before you run the PrintShop Webinstaller:

•

Be sure to have an internet connection during the installation!

•

PrintShop Web requires the following system components to be installed on your computer prior to

•

installing the product:

Microsoft .Net Framework 2.0

•

MSXML 4.0 SP2 Parser and SDK

•

VCRedist (Run-time components for Visual C++ applications)

•

The PrintShop Web-installer 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.

Minimum requirements

Microsoft Windows 2000, Windows XP Professional or Windows 2003 Server

•

1 GHz 32-bit (x86)

•

1024 MB of system memory

•

40 GB hard drive

•

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 (at least 1048 MB).

Microsoft Windows 2000, Windows XP Professional or Windows 2003 Server

•

3 GHz 32-bit (x86)

•

2048 MB of system memory

•

300 GB hard drive

•

PrintShop Web Installation Guide | 5

Notes

Make sure that port 80 and/or port 443 are available for the Apache web server that comes with

•

PrintShop 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 Web server should be directly connected to the RIP or Printer. This means that

•

the PrintShop Web server should be located on your local network (same subnet), on your premises, and 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. In some occasions, it is not possible to install PrintShop Web on an existing web server. Network

•

Administrators will find more information on this topic in the Installation Guide. The PrintShop 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)

PrintShop Web Installation Guide | 6

Installing PrintShop Web

Following the instructions in this chapter will enable you to successfully install PrintShop Web and its components.

Running the installer

1 Navigate to the PSW Setup.exe file you downloaded from the Internet or locate the file on the

PrintShop Web product CD. Once located double click its icon to launch the installation program. The following dialog appears:

Welcome to the InstallShield Wizard for PrintShop Web

2 Click Next to proceed to the License Agreement.

PrintShop Web Installation Guide | 7

3 Read the license agremeent. If the terms of the agreement are acceptable, click on Accept and

Next to continue the installation process. The Customer Information dialog appears. Fill in the appropriate fields.

The Customer Information dialog

4 Click Next to proceed.

The Setup Type dialog box will appear asking what type of installation you wish to perform:

The Setup Type dialog

Unless you have specific setup requirements, we recommend using the Complete setup option. The Custom setup is for systems which already have certain components installed (such as the Apache

web server or the MySQL database server) or to change the installation location. Please refer to the Manual Installation chapter for settings that will have to be changed manually.

Note: Note that, typically, the Custom setup type may entail more risks of malfunction of the product after installation.

5 Click Next to proceed to the Apache Options dialog.

PrintShop Web Installation Guide | 8

Apache options

PrintShop Web uses the Apache web server. The Apache options allow PrintShop Web to be configured to support regular (HTTP) and secured (HTTPS) types of connections. HTTP is required for the communication between PrintShop Server and Printshop web. HTTPS enables 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 Web only accepts HTTP connections from the local machine, from all other systems PrintShop Web accepts only HTTPS connections.

Installation options for Apache web server

6 Select the protocol(s) you wish to use and click Next to proceed. The PrintShop Server Service

logon credentials dialog appears.

Note: If the ports for these protocals are in use a warning appears. This may occur when an existing web server like Apache or Internet Information Server (IIS) 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 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 Manager application.

PrintShop Server service

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

PrintShop Web Installation Guide | 9

Logon credentials for Printshop Server service

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

7 Type the Password from the displayed user and click Next to proceed. The Ready to Install the

Program dialog appears. The Ready to Install the Program dialog is the last dialog before the product is installed. Click Back

in case you need to change settings, click Cancel in case you want to cancel the installation of the product.

The Ready to Install the Program dialog

8 Click Install to begin the installating PrintShop Web.

PrintShop Web Installation Guide | 10

During the installation the status bar shows the progress of the installation. When the installation has been successful, the following dialog appears:

Installation complete

9 Click Finish to complete the installation of PrintShop Web. You must restart your system for the

configuration changes made for PrintShop Web to take effect. Further configuration is still needed and is explained in the following sections.

Installation complete

PrintShop Web Installation Guide | 11

Setting up the database and web server

After PrintShop Server has been setup you can launch your web browser and navigate to the PrintShop 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 Web web site and database and guides you through this process step by step.

First Run wizard

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

Provide the host name of your database server and enter the login and password. If both the web server and database server (typical installation) are running on the same machine, you can use localhost as the host and use root as the user name.

PrintShop Web Installation Guide | 12

During the installation of the MySQL database software a user is created with the name root, with no password. To modify the password you can use an application like MySQL Administrator afterwards. The MySQL Administrator is part of the MySQL GUI Tools suite which you can download for free from the MySQL website: http://dev.mysql.com/downloads/gui-tools/

Note that the incDBLink.php file (located in the Functions folder of the PSW Website folder) should be changed accordingly.

3 Leave all the server connections options set to the default value unless you need to make a specific

change. Click Next to proceed.

Database exists

When PrintShop Web find a database wich the name psw, the Database Exists page may appear:

The Database Exists page

This page allows you to use the existing database or to overwrite it. If an older version of the system is found you will be able to update the database keeping the existing orders, templates, etc. Once the installation procedure is finished you should check that the companies, templates and other information in the system has default values set for items like the pricing settings.

Important: When upgrading PrintShop Web we strongly advise to read the Important update notes chapter and create backups of your current PrintShop Web installation. You can use the MySQL Administrator tool described before to create a backup of your psw database.

PrintShop Web Installation Guide | 13

4 Once the database is created several system defaults need to be set. These settings can be

modified and expanded in PrintShop Web once the first run wizard is completed.

Specify the name for the initial company and set system defaults

The system default settings page requires input for the following system defaults:

Company Name: The name of the initial company. This field is not visible when upgrading a

•

previous version of PSW.

Currency: The selected currency will be presented in Checkout and Order Manager sections of

•

the system.

Taxation System: The standard Taxation system.

•

Tax Rate: The percentage of the standard taxation system.

•

Setup Cost: The surcharge for setting up your production environment and workstations.

•

Rush Order Surcharge: The surcharge for urgency printing (if applicable).

•

Weight Unit: The weight unit used to define the total weight of the documents/jobs in the

•

checkout. PSW supports kg and lb.

Standard Production Time: The number of days to produce documents.

•

Rush Order Production Time: The number of production days for rush orders.

•

Enter a name for the initial company and verify the remaining parameters. Refer to the Administrative Guide for more information about these parameters. Click Next to proceed to the Registration page.

PrintShop Web Installation Guide | 14

5 We encourage you to register your PrintShop Web product in order to have the benefit of free

product information, new release information, and security updates.

Enter your details and click Send registration or Register later to continue.

6 The website and database initialization process is now completed and you are ready to use the

system. Click Go to enter the login page of PrintShop Web:

The Login page

For both the login name and password use administrator to enter the system and you are ready to setup the system for your clients.

PrintShop Web Installation Guide | 15

+ 32 hidden pages