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.