Upgrading from easyPDF SDK 5.0/5.1 to 6.2 

Upgrading from easyPDF SDK 5.0/5.1 to 6.2 consists of four simple steps in all cases.  There is a fifth step 

for server based customers: 

(1) Remove references to the easyPDF SDK 5.0/5.1 type libraries from your project. 

(2) Uninstall easyPDF SDK 5.0/5.1. 

(3) Install easyPDF SDK 6.2. 

(4) Add the easyPDF SDK 6.2 type libraries to your project and check for required code updates 

(some minor code updates are usually required when upgrading from 5.0/5.1 to 6.2). 

(5) If your application is server based, you must reconfigure the Loader service to run under an 

administrator account since this setting is reset during an upgrade. 

 

Step 1:  Remove references to the easyPDF SDK 5.0/5.1 type libraries from your project. 

Go to the “References” section of your Visual Project, highlight any easyPDF SDK 5.0/5.1 type libraries 

that are included, and remove them: 

 

Step 2.  Uninstall easyPDF SDK 5.0/5.1. 

Uninstall easyPDF SDK 5.0/5.1 via Add/Remove Programs (Programs And Features if you’re under a Vista 

or higher version of Windows). 

During uninstall, you will be prompted to deactivate your existing license: 

 

Click OK, and when the License Manager interface appears, go to the “Internet Deactivate” tab and click 

the “Deactivate” button (if you have not yet licensed 5.0/5.1 and are running it in trial mode then you 

may skip this and simply dismiss the License Manager).  You will receive confirmation of successful 

license deactivation: 

 

Step 3:  Install easyPDF SDK 6.2. 

Run the easyPDF SDK 6.2 setup package: 

 

Once easyPDF SDK 6.2 has finished installing, open the License Manager by going to Start  Programs 

 BCL easyPDF SDK 6  Product Activation  License Manager.exe.  Then visit the “Internet Activate” 

tab, make sure your license number has been entered, and hit the “Activate” button.  You will receive 

confirmation of successful activation: 

 

Step 4.  Add the easyPDF SDK 6.2 type libraries to your project and check for required code updates. 

Go to Visual Studio’s “Add Reference” dialog and add the new easyPDF SDK 6.2 type libraries to your 

project: 

 

Now you will want to check for what, if any, updates to your code are required.  Some minor code 

changes are often necessary. 

If you have referenced easyPDF SDK’s interop namespaces in your code, you will want to change them.  

For example, the namespace “BCL.easyPDF.Interop.EasyPDFPrinter” from version 5.0/5.1 would be 

“BCL.easyPDF6.Interop.EasyPDFPrinter” (note the additional number 6) in 6.2. 

ProgIDs have changed similarly.  For example, if you are instantiating your objects by passing the ProgID 

“easyPDF.Printer.5” in version 5.0/5.1, you will want to pass “easyPDF.Printer.6” (again note the 6) in 

version 6.2. 

Finally, some enumerated type values have changed between 5.0/5.1.  These surround some enums, for 

example prnWmarkHPosition, that were shared between the Printer API module and the Processor API 

module in version 5.0/5.1.  In version 6.2, enums are no longer shared between modules.  Instead, those 

in the Printer API module all begin with the prefix prn, whereas those in the Processor API module all 

begin with the prefix prc.  Thus, in 6.2, you would use prnWmarkHPosition when applying a watermark 

using the Printer API module, whereas you would use prcWmarkHPosition when applying a watermark 

using the Processor API module.  Your compiler or interpreter should give errors in cases where this kind 

of code update needs to occur, so please let us know should you have questions about any specific 

instances. 

If your application is server based, be sure to complete the fifth step below as well. 

Step 5.  Reconfiguring the Loader service to run under an administrator account. 

Following the upgrade to easyPDF SDK 6.2, server based customers will need to reconfigure the Loader 

service to run as an administrator, since this setting will revert back to the default during the upgrade 

process.  For steps on doing this, please refer to the “Configure Windows Service setting” section of the 

user manual topic under Preparing Your Server  For Printer Object  Step 1. easyPDF SDK Loader 

Setup.  The same topic is also attached to this document for your convenience.  No other server 

configuration steps need to be redone aside from this one. 

About easyPDF SDK Loader Object

What is the easyPDF SDK Loader Object?

The easyPDF SDK Loader Object is a helper object to enable easyPDF SDK on server-side environment.

If easyPDF SDK is used in server environment (either directly or indirectly), you need to access easyPDF SDK through this object, instead of accessing them directly. The Loader object eliminates many of the server-side configuration that you would otherwise have to deal with.

Instead of this way:

Set oPrinter = Server.CreateObject("easyPDF.Printer.6") Set oPrintJob = oPrinter.PrintJob

Do it this way:

Set oLoader = Server.CreateObject("easyPDF.Loader.6") Set oPrinter = oLoader.LoadObject("easyPDF.Printer.6") Set oPrintJob = oPrinter.PrintJob

easyPDF SDK Loader Setup

Before using the easyPDF SDK Loader object, you need to take a few easy steps described below to configure Windows Service setting.

Create and initialize an easyPDF SDK user account:

1. Log on to the computer as the Administrator and create a new user account that will automate easyPDF SDK. In our example, this account is named easyPDF6User. Create a password for this user account, and select Never expire so that the password does not have to be changed.

2. Add the easyPDF6User account to the Administrators group. IMPORTANT!

YOU MUST log on to the easyPDF6User at least once to initialize the account, including printer driver setting, or easyPDF SDK will not run properly.

If you decide to use an exising account rather than creating a new account as described above, make sure to also log on to that user account at least once after easyPDF SDK is installed for the first time, or printer driver information will not be initialized properly.

Configure Windows Service setting:

1. Log on to the computer as the Administrator.

2. From Control Panel, launch Administrative Tools.

3. From Administrative Tools, launch Services.

4. Select and double-click on BCL easyPDF SDK 6 Loader to bring up the BCL easyPDF SDK 6 Loader Properties dialog. Note: If you do not see it in the list, please run the easyPDF SDK installer again and perform repair.

5. Click the Log On tab. Select This account and type the username and password for easyPDF6User .

6. Click OK to close the property dialog box and return to the main Services window.

7. Start the BCL easyPDF SDK 6 Loader .

8. Close the Services window. IMPORTANT NOTE IF YOU ARE REINSTALLING OR UPGRADING EASYPDF SDK!

If you reinstall or upgrade easyPDF SDK, it is CRITICAL that you redo the eight preceding "Configure Windows Service setting" steps following the reinstall or upgrade. Failure to do so could cause the BCL easyPDF SDK 6 Loader to run under incorrect settings and lead to problems.