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. 

Sign up to vote on this title
UsefulNot useful