Software602 Print2PDF X
Installation Guide
Created: 7.11.2012
Updated: 4.4.2013
© 2012 Software602, Inc.
Software602
Print2PDF X
Contents
Required software ............................................................................................ 3
Installation of Web Server IIS ............................................................................... 3
Installation of Print2PDF X Web Service application ................................................... 4
License certificate installation ............................................................................. 5
Temporary directory settings ............................................................................. 10
LTV Service Configuration, Certificate Registration .................................................. 11
Functionality Test for the LTV Service .................................................................. 12
Functionality Test for the Web Service ................................................................. 13
Configuration Procedure for DCOM Object ............................................................. 14
Installation and settings of OpenOffice for Print2PDF X ............................................. 18
Use and implementation of Convert Web page function ............................................. 19
2
Software602 a.s., Hornokrčská 15, 140 00 Praha 4, www.602.cz
Tel: 222 011 602, Fax: 222 011 218, E-mail: [email protected]
IČO: 63078236, DIČ: CZ63078236, OR: MS Praha, oddíl B, vložka 3044
Software602
Print2PDF X
Installation guide for Print2PDF X
Required software

Windows server

.NET 2.0

IIS

Corresponding application for files you need to convert (Word for .doc, Excel for .xls etc.)
o Only Microsoft Office 2007 and newer is supported
o If using Office 2007, you will need this Microsoft PDF add-in
o (http://www.microsoft.com/en-us/download/details.aspx?id=9943)
o Converting MS Office formats is available using free OpenOffice license or using MS Office
with according license.
o It's recommended to install these applications as dedicated software for Print2PDF X.
Installation of Web Server IIS
3

Press Start.

Click on Control Panel.

Open up Programs. If you don't see programs as an option, select in top right corner "Show as
Categories".

Click on Programs and Features.

Click on Turn Windows features on and off.

In the left panel choose Roles.

In the right panel, click on Add Roles.

If you see an disclaimer, click Next.

Check option Web Server IIS and click Next twice.

Check option ASP.NET.

A window will open, asking you If you want to add services for ASP.NET Functions and Technology,
click on Add selected roles.

Check IIS 6 Management Compatibility.

Keep the nested options checked, they will be checked automatically as they are required.

Click Next.

Click Install.

After installation, close the dialog.
Software602 a.s., Hornokrčská 15, 140 00 Praha 4, www.602.cz
Tel: 222 011 602, Fax: 222 011 218, E-mail: [email protected]
IČO: 63078236, DIČ: CZ63078236, OR: MS Praha, oddíl B, vložka 3044
Software602
Print2PDF X
Installation of Print2PDF X Web Service application
1. Install application from .msi file, standard path is C:\Program Files\Software 602\Print2PDF X.
1b. This step is optional - Copy directory Print2PDF_service from Program Files\Print2PDF X directory to
your chosen destination. For example, you can use c:\inetpub\wwwroot\Print2PDF_service as this
is the default folder for web pages set up by IIS.
Note: This step is optional, as you can map the application in IIS to any directory on hard-drive (see
point 4b).
2. Configuration of specific extensions is saved in configuration file in directory
Print2PDF\Engine\Print2PDF.config
3. In IIS administration create new application pool Print2PDF or modify existing application pool.
Note : if you modify existing app pool, the behavior of existing applications may change.
o
o
o
o
o
o
Click Start -> Control Panel -> Administrative Tools -> Internet Information Services (IIS)
Manager
In the left panel, click on [+] and open Computer node
Click on Application Pools
In right panel, click on Add Application Pool (or you can edit existing app pool)
Select name, for example Print2PDF and in .NET Framework version choose .NET
Framework v2.0.xxxxx. It's recommended to use Integrated managed pipeline mode, but
application runs in both classic or integrated. Check "Start immediately" option and click
OK.
This pool will be used for our application.
4. There are two ways to set up web application. Pick one of the following, but solution b) is
recommended as the wwwroot directory has pre-set the reading, writing and executing rights for
web applications.
a) Adding new application " Print2PDF_service " (Virtual Directory in Windows 2003)
o
o
o
o
o
o
4
In the right panel, click on [+] Sites to open the node.
Right click the Default Web Site and select Add application. (Virtual Directory in Windows
2003)
Fill in Alias, for example as Print2PDF_service.
In application pool, enter the prepared application pool from earlier.
Enter physical path from step 2).
Press OK.
Software602 a.s., Hornokrčská 15, 140 00 Praha 4, www.602.cz
Tel: 222 011 602, Fax: 222 011 218, E-mail: [email protected]
IČO: 63078236, DIČ: CZ63078236, OR: MS Praha, oddíl B, vložka 3044
Software602
Print2PDF X
b) Converting to application
o
o
o
In the right panel, click on [+] Sites to open the node.
Right click the Print2PDF_service directory (this option is available only if you copy chose
the example directory in step 2.
Choose Convert to Application (Virtual Directory in Windows 2003)
In both scenarios, after creating application, right click it, choose Properties -> Default Document -> Add file
-> and add file "Default.asmx". On some systems, it might already be in the list.
License certificate installation
To ensure that you have a valid Print2PDF X license, you need to correctly install and set up the License
Certificate. For using SecuStamp services you need another LTV Certificate.
Print2PDF X is accessing certificates both in web service and windows application form, the certificate must
be installed in the Local Computer store, not user or service store. The same method is used for installing
License and LTV Certificates.
None of these can be installed by double-clicking the certificate file.
a) Microsoft Windows Server 2008 R2
5

Run mmc console. For this, press Start.

Click Run and in the text field write mmc.

In the Console windows, press File -> Add/Remove Snap-in.
Software602 a.s., Hornokrčská 15, 140 00 Praha 4, www.602.cz
Tel: 222 011 602, Fax: 222 011 218, E-mail: [email protected]
IČO: 63078236, DIČ: CZ63078236, OR: MS Praha, oddíl B, vložka 3044
Software602
Print2PDF X

In the left field choose Certificates and click Add > and then OK.

In the newly opened dialog select Computer account options and press Next.
In the next dialog, leave chosen Local Computer and click Finish.
6
Software602 a.s., Hornokrčská 15, 140 00 Praha 4, www.602.cz
Tel: 222 011 602, Fax: 222 011 218, E-mail: [email protected]
IČO: 63078236, DIČ: CZ63078236, OR: MS Praha, oddíl B, vložka 3044
Software602
Print2PDF X
7

The Certificates entry should appear in the right panel. If so, click OK.

In the left panel, open Certificates node, right click the Personal directory and choose All Tasks ->
Import...

In the new dialog, click Next, choose the certificate file, enter password and accept import to
Personal Store.

Next, The private key management of this certificate must be set up.

Right click the newly imported certificate, click All Tasks -> Manage Private Keys...
Software602 a.s., Hornokrčská 15, 140 00 Praha 4, www.602.cz
Tel: 222 011 602, Fax: 222 011 218, E-mail: [email protected]
IČO: 63078236, DIČ: CZ63078236, OR: MS Praha, oddíl B, vložka 3044
Software602
Print2PDF X
In the newly opened dialog, click Add and you need to add IIS AppPool\{Your App Pool name}, in our case
IIS AppPool\Print2PDF.
8
Software602 a.s., Hornokrčská 15, 140 00 Praha 4, www.602.cz
Tel: 222 011 602, Fax: 222 011 218, E-mail: [email protected]
IČO: 63078236, DIČ: CZ63078236, OR: MS Praha, oddíl B, vložka 3044
Software602
Print2PDF X
b) Microsoft Windows Server 2003 / 2008 (not R2 version)
On these systems, you need to import certificate using Microsoft's winhttpcertcfg.exe application found
here : http://www.microsoft.com/downloads/en/details.aspx?familyid=C42E27AC-3409-40E9-8667C748E422833F&displaylang=en(http://www.microsoft.com/downloads/en/details.aspx?familyid=C42E27A
C-3409-40E9-8667-C748E422833F&displaylang=en).
After installing the application, run command line (with administrator rights) and run this command:
winhttpcertcfg -i PFXFile - c LOCAL_MACHINE\My - a IWAM_TESTMACHINE -p PFXPassword
Note: PFXFile is the certificate file path, Password is plaintext password for certificate. If the certificate is
without password, leave the -p option out. If the filename contains spaces, enter it within " " marks.
Note: Command line with administrator rights can be run by going to C:/Windows/system32/cmd.exe ->
right click -> Run as Administrator.
You need to give rights to ASPNET, IUSR_xxx , IWAM_xxx a IIS_WPG accounts, where xxx stands for
computer name. The WinHttpCertCfg.exe is usually placed in C:\Program Files\Windows Resource
Kits\Tools\ . If you place the certificate file here, the command is easier to use, see example.
Complete guide to this application can be found here :
http://msdn.microsoft.com/en-us/library/aa384088%28v=vs.85%29.aspx.
An example how to import certificate from file "cert.p12" with password "123456"

9
Note: If you are setting up Windows Service, you need to add the same account as the one you
chose for Window Service in the Print2PDF Service Manager.
Software602 a.s., Hornokrčská 15, 140 00 Praha 4, www.602.cz
Tel: 222 011 602, Fax: 222 011 218, E-mail: [email protected]
IČO: 63078236, DIČ: CZ63078236, OR: MS Praha, oddíl B, vložka 3044
Software602
Print2PDF X
Temporary directory settings
1. Add access rules to directory C:\Windows\temp for IUSR and IIS_IUSRS accounts. On some systems,
these accounts are not present and you need to add IUSR_xxx , IWAM_xxx a IIS_WPG accounts,
where xxx stands for computer name.
2. Restart IIs (optional):
10

In IIS manager click the Computer Node.

In the right panel click on Restart.
Software602 a.s., Hornokrčská 15, 140 00 Praha 4, www.602.cz
Tel: 222 011 602, Fax: 222 011 218, E-mail: [email protected]
IČO: 63078236, DIČ: CZ63078236, OR: MS Praha, oddíl B, vložka 3044
Software602
Print2PDF X
LTV Service Configuration, Certificate Registration
Installation part taking place at the www.secustamp.com server:
1. Register an account (in the top right corner)
2. After logging in, select Your account / Váš účet (first time logging in, the site might be in Czech)
Note: If you haven't selected English in registration, select Změnit registrační údaje -> Jazyk and
choose Anglicky from dropdown box. Press OK and the site will stay in English.
3. Click on Ask for a Service Certificate, enter required fields and submit
4. After you get response from server with new certificate, click Manage Service Certificate (while on
Your Account page), enter certificate file and press Upload Certificate. This step activates the LongTerm validation & archiving services. After activation, you can use any qualified certificate for
communication with Print2PDF.
Second part, on your computer:
1. Open certificate file (double click on xxx.cer file) from first part and select properties.
2. Find the Thumbprint entry and copy it's value into LTV_CertHash key in the configuration file.
Configuration file can be found in Print2PDF/Engine/Print2PDF.config and is used for both Web
Service and Windows Service. However, if you want to set specific Web Service settings, you can
use web.config file in the Print2PDF_Service folder (this settings overwrite Print2PDF.config).
3. Import the certificate in the same way as the license certificate in previous step.
11
Software602 a.s., Hornokrčská 15, 140 00 Praha 4, www.602.cz
Tel: 222 011 602, Fax: 222 011 218, E-mail: [email protected]
IČO: 63078236, DIČ: CZ63078236, OR: MS Praha, oddíl B, vložka 3044
Software602
Print2PDF X
Functionality Test for the LTV Service
4. Open the web service, select "TestLTV" method and click Invoke.
The number of entries in the response is not relevant, the important result is receiving the string
“analyze returned…” and not an error message.
5. If the LTV service is not set up correctly, the response might look, for example, like the following
image:
12
Software602 a.s., Hornokrčská 15, 140 00 Praha 4, www.602.cz
Tel: 222 011 602, Fax: 222 011 218, E-mail: [email protected]
IČO: 63078236, DIČ: CZ63078236, OR: MS Praha, oddíl B, vložka 3044
Software602
Print2PDF X
Functionality Test for the Web Service
1.
2.
3.
4.
Open a web browser and enter the following address: "localhost\Print2PDF_service"
Select the method TestConvertFile.
Click the Invoke button.
See the output to find out which files can or cannot be converted.
If conversion for a file ends with PRN_CR_SUCCESS value, the particular file type could be converted. All
other results mean conversion error. More detailed description of the error can be found in document
Print2PDF X – (web service interface), technical documentation.
In the following example, Word and Excel are set up correctly while PowerPoint and Form Filler conversions
do not work.
13
Software602 a.s., Hornokrčská 15, 140 00 Praha 4, www.602.cz
Tel: 222 011 602, Fax: 222 011 218, E-mail: [email protected]
IČO: 63078236, DIČ: CZ63078236, OR: MS Praha, oddíl B, vložka 3044
Software602
Print2PDF X
Configuration Procedure for DCOM Object
Note: Details of the procedure may vary based on the operation system version used.
These objects include, for example, Microsoft Office Word 97-2003 Document, Microsoft Excel
Application, Microsoft Office PowerPoint Slide and others.
Open the component service console using the following steps:

start -> run -> dcomcnfg -> OK

open the Component Services menu -> Computers -> My computer and click on the DCOM Config
tab (do not open it, just select). Select the Details button on the toolbar and the right menu will
display a list as shown on the image above.

Select the application you want to configure.
If the program you want to set up is not displayed on the list, you can find it by the following method:
For 64bit programs on 64bit system or 32bit programs on 32bit system:
 start -> run -> mmc
For 32bit programs on 64bit system:
14

start -> run -> mmc -32

ctrl + m -> select Component Services item on the left -> Add -> OK

follow the instructions above
Software602 a.s., Hornokrčská 15, 140 00 Praha 4, www.602.cz
Tel: 222 011 602, Fax: 222 011 218, E-mail: [email protected]
IČO: 63078236, DIČ: CZ63078236, OR: MS Praha, oddíl B, vložka 3044
Software602
Print2PDF X
The configuration will be shown on the example of Word Document object (the same procedure can be
used for other MS Office application, the examples shown here are valid for Microsoft Server 200x and for
OS MS Vista).
DCOM object of the Word application is called Microsoft Office Word 97-2003 Document. If this object is
not available, it has probably not been registered yet. Usually it suffices to run the MS Word application
and exit it, then restart the server. If the object is still not displayed then, another option is to look it up in
the registry using the CLSID of the Word application.
The setup then applies to a DCOM object with a similar CLSID.
Generally speaking, for the conversion service we need to set up properties of objects Launch and
Activation Permissions, Access Permissions and, if needed, also Configuration Permissions. They are
available in the Security tab of the Office Word 97-2003 Document -> right click -> properties dialog.
For the individual properties, add Internet Guest Account (usually IUSR_computer_name, IIS_IUSRS or
IUSR) and Launch IIS Process account (usually IWAM_computer_name) among authorized users, some
15
Software602 a.s., Hornokrčská 15, 140 00 Praha 4, www.602.cz
Tel: 222 011 602, Fax: 222 011 218, E-mail: [email protected]
IČO: 63078236, DIČ: CZ63078236, OR: MS Praha, oddíl B, vložka 3044
Software602
Print2PDF X
server systems also require to add the account of IIS Worker Process Group (IIS_WPG) group and allow
running and activating locally.
Access permissions – add the same user accounts as in the Launch access section. Set permissions for local
access to these accounts (only the Self users and Administrators group have the permissions for remote
management).
16
Software602 a.s., Hornokrčská 15, 140 00 Praha 4, www.602.cz
Tel: 222 011 602, Fax: 222 011 218, E-mail: [email protected]
IČO: 63078236, DIČ: CZ63078236, OR: MS Praha, oddíl B, vložka 3044
Software602
Print2PDF X
The last settings item is Identity of the account to run the application to Launching user. This account’s
permissions are used when manipulating the application. An administrator account is recommended.
17
Software602 a.s., Hornokrčská 15, 140 00 Praha 4, www.602.cz
Tel: 222 011 602, Fax: 222 011 218, E-mail: [email protected]
IČO: 63078236, DIČ: CZ63078236, OR: MS Praha, oddíl B, vložka 3044
Software602
Print2PDF X
Installation and settings of OpenOffice for Print2PDF X
OfficeSuite Apache/Libre Open Office are supported by Print2PDF X from version 10.1.0318.
Print2PDF X supports both Apache OpenOffice and Libre Office. Recommended is using LibreOffice for it's
greater stability and wider supported formats spectrum. However, as both are not developed primarily for
automatization and don't have automatization interface, only specific versions can be used. LibreOffice
supports automatization in version 3.6.5.2, version 4.0 doesn't have automatization interface. Apache
OpenOffice is supported in version 3.4.1
1.
2.
3.
4.
Choose Custom while installing
In extensions, choose Active X and Python-UNO
Choose application for filetypes you want to convert
Finish installation
After installation, you need to create temporary folders for file automatization and set writing, reading and
executing rights to these directories. For WebService, you need to set up IUSR and IIS_IUSRS accounts
(Windows 2008 R2) or IWAM_[name] and IIS_WPG on older systems.
For Windows Service you also need to give these rights to the same account as set in Print2PDF Windows
Service Manager.
LibreOffice

Create Directory C:\Windows\LibreOffice and set up rights
Apache OpenOffice

18
Create Directory C:\Windows\OpenOffice.org and set up rights
Software602 a.s., Hornokrčská 15, 140 00 Praha 4, www.602.cz
Tel: 222 011 602, Fax: 222 011 218, E-mail: [email protected]
IČO: 63078236, DIČ: CZ63078236, OR: MS Praha, oddíl B, vložka 3044
Software602
Print2PDF X
Use and implementation of Convert Web page function
Print2PDF X newer than version 10.1.0318 has the ability to convert any Web Page into PDF without using
any other software. Only thing you need to do is place link to ConvertPage.ashx file, which can be found in
the installation folder Print2PDF/Print2PDF_Service. This file must be placed in the same folder as your
running Print2PDF Web Service. You can link to this file from any site.
Example (link from SecuStamp.com to FormSigner.eu) :
Web Page source code:
<a title="Print2Pdf"
href="http://formsigner.eu/print2pdf_service_x/ConvertPage.ashx">
<img src= "icon.jpg">
</a>
Where the "href" value will be replace by link to your ConvertPage.ashx location.
19
Software602 a.s., Hornokrčská 15, 140 00 Praha 4, www.602.cz
Tel: 222 011 602, Fax: 222 011 218, E-mail: [email protected]
IČO: 63078236, DIČ: CZ63078236, OR: MS Praha, oddíl B, vložka 3044
Download

Software602 Print2PDF X - Installation Guide (PDF)