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.
Table of Contents Introduction................................................................................................................................................. 4 Steps to install............................................................................................................................................. 4 Upgrading PSW...........................................................................................................................................
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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. Register your version of Printshop Web in order to take advantage of free product information 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.
PrintShop Server service This section describes the configuration of a distinct local user-account for the PrintShop Server service. Important: This description focuses on procedures on Windows XP; on other platforms this procedure may be slightly different. PrintShop Server (PSS) is a Windows Service that runs in the background. Windows Services mostly run under a different Windows User Account than the one any end-user has used to log on to their system called Local System.
Creating a User Account for the PSS service 1 Click Control Panel in the Start menu in windows.
2 Open Administrative Tools: The Administrative Tools window 3 Open the Computer Management window and expand Local Users and Groups: The Computer Management window 4 Right-click Users and select New User… the New User window appears PrintShop Web Installation Guide | 18
5 Enter a User name, a Password and select the check boxes as shown below: The New User window 6 Click Create and after that click Close. The account is created; now the security privilege need to be set. Set the security privileges (local account) 1 Select the Groups in the Computer Management pane on the left side of the window. 2 Right-click Administrators in the right pane and select Properties in the menu that appears.
3 Click Add… The Select Users, Computers, or Groups window appears. In this window the From this location option is set to a domain, in this example atlas.local. The Select Users, Computers, or Groups window In case you would want to select another domain, or use a local account, click Locations…, which will lead to the following window: Select the location you want to serch for users.
6 Click Check Names to ensure that the account-name was entered correctly: The Select Users window 7 Click OK twice. The Administrators Properties window appears showing the new user.
Managing printers for PrintShop Server Installed printers differ per user in Windows, so we need to Log Off from Windows via the Start menu and Log On with the account that will be used for PrintShop Server. Important: PrintShop Server needs at least one PostScript printer to operate.
Setting the PrintShop Server Service account Now that we have set-up an account for PrintShop Server, PrintShop Server must be configured to use it. 1 Start PrintShop Server Manager from the Start menu.
3 Right-click PrintShop Server and select Properties in the menu that appears, which will lead to the following window: PrintShop Server service properties 4 Select the Log On tab, and select the This account:-option PrintShop Server service properties log on PrintShop Web Installation Guide | 24
5 Click Browse….
7 Click Check Names to be sure we entered it correctly, clicking OK after will lead to the following window: PrintShop Server service properties log on as PrintshopServer_User 8 The Password is an old and invalid value, so the Password field must be set to the password for the new account: The Locate PrintShop Server window 9 Click OK to proceed PrintShop Web Installation Guide | 26
Log on as service rights granted 10 Clicking OK will return you to the following window: Log on as PrintShopServer_User 11 Right-click PrintShop Server and select Restart in the menu that appears. Restart service Important: Wait for the restart to finish: (do not click Close, this dialog will disappear automatically).
Modify, repair or remove this product If PrintShop Web has been previously installed and you re-run the installer, the following dialog will be shown: The welcome dialog • Click Next to proceed (or click Cancel to exit the installer wizard) The Program Maintenance dialog appears with the following options: • Modify • Repair • Remove The modify, repair, or remove dialog PrintShop Web Installation Guide | 28
Modify This option is not recommended as removing individual components of the PrintShop Web system. May cause PrintShop Web to cease to function. Repair This option attempts to repair the installation by fixes missing or corrupt files, shortcuts and registry entries: • Click Next to proceed to the Ready to Repair the Program dialog and click Install to install.
Important update notes Before updating an existing PSW 2.x installation please read the following. Creating a backup • Backup all files and databases prior to migration. In case of problems during the update installation this will enable the contents of PrintShop Web to be restored.
The psw database folder A custom skin folder The Apache conf folder Orders and Documents • • In PSW 2.2 the relationship between orders and documents (print jobs) is changed. Orders now can contain multiple documents which is visualized using a tree view. To avoid misunderstanding by customers it is advised to change the status of orders in the Ordered and Approved status folders to In-plant.
Skin changes • As PrintShop Web 2.2 includes various user interface enhancements and new interface elements (e.g. modular dialogs) custom sskins should be checked and updated to support these new items. To test your existing skin(s) with PSW 2.2: • Install PSW 2.2 on a stand-alone machine. • Copy your skin(s) to the templates folder of the PSW 2.2 installation. • Test and modify your skin • Once completed create a backup of the modified skin and copy it to your production server.
Manual installation As a general rule, we recommend to install 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 and Microsoft IIS (or at least turned off). This part of the installation guide will help you to install PrintShop Web on a machine containing any of the modules mentioned above.
PHP The PHP Hypertext Preprocessor is a programming language that allows web developers to create dynamic content that interacts with databases. PHP is used for developing web based software applications. To further increase the speed of PHP and encrypt the source files, the Zend Optimizer is used. Optimization is achieved by running an optimization of the code created by the run-time compiler, before the code is executed.
The section name is in square braces at the top, followed by any number of name-value pairs, with each pair on a separate line. As with regular PHP code, variable names are case sensitive and cannot contain spaces, while the values may be numeric, string or Boolean. Semicolons placed at the beginning of a line serve as comment markers. This makes it easy to enable or disable PHP features; rather than deleting a line, you can comment it out so that it isn't parsed.
The PHP configuration file This section describes the configuration of specific PHP.ini options. The following options need to be checked and/or modified. • • • • • short_open_tag max_execution_time file_uploads upload_max_filesize post_max_size Short_open_tag boolean PHP scripts can be enclosed either within tags which is the long form or tags (short form). This directive should be turned to on.
include_path string Specifies a list of directories where the require(), include() and fopen_with_path() functions look for files. Below you'll see the path as used by the standard PrintShop Web installation (PrintShop Web installer): include_path="C:/Program Files/PrintShop Web/Apache/PHP/PEAR" PEAR Package PEAR provides PHP components in the form of so called "Packages". PrintShop Web make use of certain PEAR packages.
Documentroot This directive sets the directory from which files will be served. Unless matched by a directive like Alias, the server appends the path from the requested URL to the document root to make the path to the document. The PrintShop Web website runs on localhost and all files are placed directly in the documentroot folder.
Order Deny,Allow Deny from all Order Deny,Allow Allow from localhost Order Deny,Allow Allow from all Order Deny,Allow Allow from all Order Deny,Allow Allow from all
URL based skin switching With the introduction of PrintShop Web 2.0, the web site skin can be switched by stating the design name that can be specified per company (edit web design). By adding the design name to the URL of the system the skin will be activated. For example: http://www.yourdomain.com/companyname. In order to make this possible the Apache rewrite module should be loaded and a rewrite rule should be added to the virtualhost tag in the httpd.
HTTP over SSL (HTTPS) HTTPS (Hypertext Transfer Protocol over Secure Socket Layer, or HTTP over SSL) is a Web protocol used to encrypt and decrypt user page requests as well as the pages that are returned by the Web server. SSL is an open, non proprietary protocol that Netscape has proposed as a standard to the World Wide Consortium (W3C). HTTPS is not to be confused with S-HTTP, a security-enhanced version of HTTP developed and proposed as a standard by EIT.
5 Read the instructions and completed the information on screen (use YOUR details). You are about to be asked to enter information that will be incorporated into your certificate request. What you are about to enter is what is called a Distinguished Name or a DN. There are quite a few fields but you can leave some blank For some fields there will be a default value, If you enter '.', the field will be left blank.
Client installation Important: The supplied certificate only works on PrintShop Web servers that can be reached through the URL http://localhost. For any other URL the supplied certificate will generate security warnings when an user connects to the PrintShop Web server. 1 Close all opened web browser windows. 2 Open the an Internet Explorer web browser and go to https://localhost (notice that this is https, not http!).
Test Certificate by Web Browser 1 Open an internet browser and add the following URL to test the non-secure version: http://localhost 2 Open an internet browser and add the following URL to test the secure version: https://localhost Important: If you see the following window while visiting the secure version, the certificate isn't properly installed on your system (See Install Certificate). Please do not close the windows and repeat Install Certificate.
Test Certificate in PrintShop Mail 1 Open PrintShop Mail. In the PrintShop Web publishing preferences, please set the URL property to: https://localhost 2 Click on Test Connection...button. If you the following message, please re-check the URL and retest by webbrowser if the URL was set correctly.
ELECTRONIC END USER LICENSE AGREEMENT FOR PRINTSHOP WEB NOTICE TO USER: THIS IS A CONTRACT. BY INSTALLING THIS SOFTWARE YOU ACCEPT ALL THE TERMS AND CONDITIONS OF THIS AGREEMENT. This Objectif Lune End User License Agreement accompanies the PrintShop Web product and related explanatory materials ("Software"). The term "Software" also shall include any upgrades, modified versions or updates of the Software licensed to you by Objectif Lune. Please read this Agreement carefully.
5 Governing Law and General Provisions. This Agreement will be governed by the laws of the Netherlands, excluding the application of its conflicts of law rules. This Agreement will not be governed by the United Nations Convention on Contracts for the International Sale of Goods, the application of which is expressly excluded.
