[Legacy] Upgrading PaperCut ChargeBack

KB Home   |   [Legacy] Upgrading PaperCut ChargeBack

Main.UpgradingChargeBack History

Hide minor edits - Show changes to output

Changed line 1 from:
(:title Upgrading PaperCut ChargeBack:)
to:
(:title [Legacy] Upgrading PaperCut ChargeBack:)
Changed lines 3-4 from:
'^The functionality provided by PaperCut ChargeBack has now been rolled into PaperCut NG with a new licensing option for professional organizations (PaperCut NG professional client billing). All existing functionality provided by PaperCut ChargeBack, plus much more, is now offered in PaperCut NG version 11+. This move to a single online edition of PaperCut has been done to reduce the engineering and testing time around releases freeing up development resources so we can add more features faster. PaperCut ChargeBack users can upgrade by simply installing PaperCut NG over-the-top of their current install using the standard upgrade procedure. Your ChargeBack license will be detected and automatically converted to a PaperCut NG license with professional client billing enabled.^'
to:
The functionality provided by PaperCut ChargeBack has now been rolled into PaperCut NG with a new licensing option for professional organizations (PaperCut NG professional client billing). All existing functionality provided by PaperCut ChargeBack, plus much more, is now offered in PaperCut NG version 11+. This move to a single online edition of PaperCut has been done to reduce the engineering and testing time around releases freeing up development resources so we can add more features faster. PaperCut ChargeBack users can upgrade by simply installing PaperCut NG over-the-top of their current install using the standard upgrade procedure. Your ChargeBack license will be detected and automatically converted to a PaperCut NG license with professional client billing enabled.
Changed lines 7-8 from:
->https://www.papercut.com/products/ng/download/
to:
->https://www.papercut.com/download/ng/
Changed lines 30-31 from:
->'''5.''' [[https://www.papercut.com/products/chargeback/download/ | Download]] the latest version of PaperCut ChargeBack.
to:
->'''5.''' [[https://www.papercut.com/download/ng/ | Download]] the latest version of PaperCut.
January 20, 2011, at 12:10 AM by 202.129.124.120 -
Added lines 3-4:
'^The functionality provided by PaperCut ChargeBack has now been rolled into PaperCut NG with a new licensing option for professional organizations (PaperCut NG professional client billing). All existing functionality provided by PaperCut ChargeBack, plus much more, is now offered in PaperCut NG version 11+. This move to a single online edition of PaperCut has been done to reduce the engineering and testing time around releases freeing up development resources so we can add more features faster. PaperCut ChargeBack users can upgrade by simply installing PaperCut NG over-the-top of their current install using the standard upgrade procedure. Your ChargeBack license will be detected and automatically converted to a PaperCut NG license with professional client billing enabled.^'
Changed lines 16-17 from:
'''IMPORTANT: While the upgrade process utilises the PaperCut NG Pro software, the instructions below are still applicable.'''
to:
'''IMPORTANT: While the upgrade process utilises the PaperCut NG software, the instructions below are still applicable.'''
January 19, 2011, at 11:38 PM by 202.129.124.120 -
Deleted line 2:
Changed lines 14-15 from:
to:
'''IMPORTANT: While the upgrade process utilises the PaperCut NG Pro software, the instructions below are still applicable.'''
January 19, 2011, at 06:01 AM by 202.129.124.120 -
Changed lines 4-7 from:
PaperCut ChargeBack is designed to support "install over the top" upgrades.  The latest version of PaperCut ChargeBack is always available from the download page at:

->https://www.papercut.com/products/chargeback/download/
to:
PaperCut ChargeBack is designed to support "install over the top" upgrades.  The latest version of PaperCut is always available from the download page at:

->https://www.papercut.com/products/ng/download/
Changed lines 36-37 from:
->'''9'''. '''IMPORTANT: Version 9 is not compatible with old versions of the PaperCut Payment Gateway. If you are using  [=PayPal=] or other banking gateway via the Payment Gateway add-on, you should upgrade the gateway to the [[https://www.papercut.com/anonftp/pub/pcng/ext/payment-gateway/|latest version]] immediately after installing version 9.'''
to:
->'''9'''. '''IMPORTANT: Version 9, 10 and 11 are not compatible with old versions of the PaperCut Payment Gateway. If you are using  [=PayPal=] or other banking gateway via the Payment Gateway add-on, you should upgrade the gateway to the [[https://www.papercut.com/anonftp/pub/pcng/ext/payment-gateway/|latest version]] immediately after installing version 11.'''
June 16, 2010, at 05:38 PM by Rick - confusing reference to version 7 and 8 changed to '7 and above'
Changed lines 16-19 from:
The recommended upgrade procedure when running version 8.0 or later is:

->'''1.''' If upgrading from version 7 or earlier, first [[UpgradePolicy | check your eligibility to upgrade]].
to:
The recommended upgrade procedure when running version 7.0 or later is:

->'''1.''' First [[UpgradePolicy | check your eligibility to upgrade]].
February 03, 2009, at 12:08 AM by 218.214.136.161 -
Changed lines 36-37 from:
->'''9'''. '''IMPORTANT: Version 9 is not compatible with old versions of the PaperCut Payment Gateway. If you are using Pay Pal or other banking gateway via the Payment Gateway add-on, you should upgrade the gateway to the [[https://www.papercut.com/anonftp/pub/pcng/ext/payment-gateway/|latest version]] immediately after installing version 9.'''
to:
->'''9'''. '''IMPORTANT: Version 9 is not compatible with old versions of the PaperCut Payment Gateway. If you are using  [=PayPal=] or other banking gateway via the Payment Gateway add-on, you should upgrade the gateway to the [[https://www.papercut.com/anonftp/pub/pcng/ext/payment-gateway/|latest version]] immediately after installing version 9.'''
February 03, 2009, at 12:07 AM by 218.214.136.161 -
Changed lines 36-37 from:
->'''9'''. '''IMPORTANT: Version 9 is not compatible with old versions of the PaperCut Payment Gateway. If you are using PayPalskskks or other banking gateway via the Payment Gateway add-on, you should upgrade the gateway to the [[https://www.papercut.com/anonftp/pub/pcng/ext/payment-gateway/|latest version]] immediately after installing version 9.'''
to:
->'''9'''. '''IMPORTANT: Version 9 is not compatible with old versions of the PaperCut Payment Gateway. If you are using Pay Pal or other banking gateway via the Payment Gateway add-on, you should upgrade the gateway to the [[https://www.papercut.com/anonftp/pub/pcng/ext/payment-gateway/|latest version]] immediately after installing version 9.'''
February 03, 2009, at 12:06 AM by 218.214.136.161 -
Changed lines 36-37 from:
->'''9'''. '''IMPORTANT: Version 9 is not compatible with old versions of the PaperCut Payment Gateway. If you are using PayPal or other banking gateway via the Payment Gateway add-on, you should upgrade the gateway to the [[https://www.papercut.com/anonftp/pub/pcng/ext/payment-gateway/|latest version]] immediately after installing version 9.'''
to:
->'''9'''. '''IMPORTANT: Version 9 is not compatible with old versions of the PaperCut Payment Gateway. If you are using PayPalskskks or other banking gateway via the Payment Gateway add-on, you should upgrade the gateway to the [[https://www.papercut.com/anonftp/pub/pcng/ext/payment-gateway/|latest version]] immediately after installing version 9.'''
February 03, 2009, at 12:06 AM by 218.214.136.161 -
Changed lines 36-37 from:
->'''9'''. '''IMPORTANT: Version 9 is not compatible with old versions of the PaperCut Payment Gateway. If you are using Pay Pal or other banking gateway via the Payment Gateway add-on, you should upgrade the gateway to the [[https://www.papercut.com/anonftp/pub/pcng/ext/payment-gateway/|latest version]] immediately after installing version 9.'''
to:
->'''9'''. '''IMPORTANT: Version 9 is not compatible with old versions of the PaperCut Payment Gateway. If you are using PayPal or other banking gateway via the Payment Gateway add-on, you should upgrade the gateway to the [[https://www.papercut.com/anonftp/pub/pcng/ext/payment-gateway/|latest version]] immediately after installing version 9.'''
February 03, 2009, at 12:06 AM by 218.214.136.161 -
Added lines 36-37:
->'''9'''. '''IMPORTANT: Version 9 is not compatible with old versions of the PaperCut Payment Gateway. If you are using Pay Pal or other banking gateway via the Payment Gateway add-on, you should upgrade the gateway to the [[https://www.papercut.com/anonftp/pub/pcng/ext/payment-gateway/|latest version]] immediately after installing version 9.'''
Changed lines 16-23 from:
The recommended upgrade procedure when running version 7.0 or later is:

->'''1.''' If upgrading from version 6 or earlier, please read the important notes detailed at [[UpgradingToChargeBack7 | +]].

->'''2.''' Schedule approximately 10 minutes downtime. It is suggested to choose a time of day with minimal network activity. If there is a large volume of data in the system (for example if the system has been running for more than a year, or there are more than 5,000 users) the upgrade may take longer. With very large installations it may be appropriate to schedule an hour or more of downtime.

->'''3.''' As a precaution, we recommend backing up the whole PaperCut directory before beginning.  Existing overnight backups may have taken care of this task, however take a few moments to grab an up-to-date backup now.  For example, create a zip archive of the directory:
to:
The recommended upgrade procedure when running version 8.0 or later is:

->'''1.''' If upgrading from version 7 or earlier, first [[UpgradePolicy | check your eligibility to upgrade]].

->'''2.''' If upgrading from version 6 or earlier, please read the important notes detailed at [[UpgradingToChargeBack7 | +]].

->'''3.''' Schedule approximately 10 minutes downtime. It is suggested to choose a time of day with minimal network activity. If there is
a large volume of data in the system (for example if the system has been running for more than a year, or there are more than 5,000 users) the upgrade may take longer. With very large installations it may be appropriate to schedule an hour or more of downtime.

->'''4.''' As a precaution, we recommend backing up the whole PaperCut directory before beginning.  Existing overnight backups may have taken care of this task, however take a few moments to grab an up-to-date backup now.  For example, create a zip archive of the directory:
Changed lines 28-35 from:
->'''4.''' [[https://www.papercut.com/products/chargeback/download/ | Download]] the latest version of PaperCut ChargeBack.

->'''5.''' Run the installer and install into the '''same''' location as the existing install.

->'''6.''' After the install has completed allow a few minutes before accessing the system.  The system may need to perform a database upgrade and this will be performed in the background.  If you try to access the application while a database upgrade is in progress a message displaying the upgrade status will be displayed.  '''IMPORTANT: Do not shutdown the application while an upgrade is in progress.  Wait for the upgrade to complete.'''

->'''7.''' After the install is complete, log into the system and perform some tests to ensure all is working as expected and the system is monitoring user activity as expected. Administrators may find the [[PostUpgradeTestPlan | post upgrade test plan]] useful.
to:
->'''5.''' [[https://www.papercut.com/products/chargeback/download/ | Download]] the latest version of PaperCut ChargeBack.

->'''6.''' Run the installer and install into the '''same''' location as the existing install.

->'''7.''' After the install has completed allow a few minutes before accessing the system.  The system may need to perform a database upgrade and this will be performed in the background.  If you try to access the application while a database upgrade is in progress a message displaying the upgrade status will be displayed.  '''IMPORTANT: Do not shutdown the application while an upgrade is in progress.  Wait for the upgrade to complete.'''

->'''8.''' After the install is complete, log into the system and perform some tests to ensure all is working as expected and the system is monitoring user activity as expected. Administrators may find the [[PostUpgradeTestPlan | post upgrade test plan]] useful.
August 10, 2007, at 07:33 AM by 218.214.136.161 -
Changed lines 20-21 from:
->'''2.''' Schedule approximately 10 minutes downtime.  It is suggested to choose a time of day with minimal network activity.
to:
->'''2.''' Schedule approximately 10 minutes downtime. It is suggested to choose a time of day with minimal network activity. If there is a large volume of data in the system (for example if the system has been running for more than a year, or there are more than 5,000 users) the upgrade may take longer. With very large installations it may be appropriate to schedule an hour or more of downtime.
Changed lines 10-11 from:
* If you are running version 6.x or earlier use the [[UpgradingChargeBackTo6 |6.x upgrade instructions]]
to:
* If you are running version 6.x or earlier use the [[UpgradingToChargeBack7 | from 6.x upgrade instructions]]
Changed lines 10-11 from:
* If you are running version 6.x or earlier use the [[#UpgradingToChargeBack7 |6.x upgrade instructions]]
to:
* If you are running version 6.x or earlier use the [[UpgradingChargeBackTo6 |6.x upgrade instructions]]
Added lines 12-15:
* If you are running version 7.x or later use the instructions below.

----

Changed lines 19-20 from:
-->[@C:\Program Files\PaperCut NG\@]
to:

-->[@C:\Program Files\PaperCut ChargeBack\@]
Changed lines 21-22 from:
->'''4.''' [[http://papercut.biz/products/ng/download/ | Download]] the latest version of PaperCut NG.
to:
->'''4.''' [[http://papercut.biz/products/chargeback/download/ | Download]] the latest version of PaperCut ChargeBack.
Changed lines 3-6 from:
''Categories:'' [[!PaperCutChargeBack]], [[!Administration]], [[!Upgrading]]

The PaperCut installer is designed to allow
"install over the top" upgrades, however we advise against this in a production environment.  Unlike desktop applications, servers are multi-user environments and often DLLís or components can be locked by other applications or users preventing complete upgrade.  Hence we recommend an ''uninstall -> reinstall'' procedure as outlined below.
to:

PaperCut ChargeBack is designed to support "install over the top" upgrades.  The latest version of PaperCut ChargeBack is always available from the download page at:

->http://papercut.biz/products/chargeback/download/
Changed lines 10-117 from:
* If you are running version 4.x or earlier use the [[#UpgradeFrom4x |4.x upgrade instructions]]
* If you are running version 5.0 or later use the [[#UpgradeFrom5x |5.0+ upgrade instructions]]

[[#UpgradeFrom5x]]
! Upgrading from PaperCut ChargeBack Version 5.0 (or later)

[-Note: If you are upgrading from version 4.x or earlier, follow the [[#UpgradeFrom4x |Upgrading 3.x or 4.x to Version 5.x]] instructions below.-]

->'''1.''' Schedule approximately 20 minutes downtime

->'''2.''' To retain existing user, account and log data, copy the files:

        @@C:\Program Files\PaperCut\Database\pcuserdb.mdb@@
        @@C:\Program Files\PaperCut\Database\printerdb.mdb@@
        @@C:\Program Files\PaperCut\Logs\*.mdb@@
        @@C:\Program Files\PaperCut\pcedata\*.*@@
        @@C:\Program Files\PaperCut\pceprefs\*.*@@



->to a safe place on the hard-drive (As a precaution, we recommend backing up the whole PaperCut directory as other files such as your custom reports may need to be preserved over the upgrade)

->'''3.''' If running the PaperCut [[WebTools | +]] interface, then you will need to [[ShutDownTheWebToolsInterface | +]]. This will ensure that IIS is not locking any PaperCut files.

->'''4.''' Uninstall PaperCut via Add/Remove Programs

->'''5.''' Restart the server. (Unlike a desktop application, PaperCut could still be in use when uninstalling, which can cause files to be locked during uninstallation.  Rebooting will allow these files to be released.)

->'''6.''' Manually delete any files remaining in:

        @@C:\Program Files\PaperCut\*@@

-->(note: this step is optional and often not required)

->'''7.''' Install the latest release of PaperCut ChargeBack

->'''8.''' Copy the pcuserdb.mdb file and other files backed-up in step 2 over the empty ones ('''Note''': do this ''before'' running PaperCut for the first time):

        @@C:\Program Files\PaperCut\Database\pcuserdb.mdb@@
        @@C:\Program Files\PaperCut\Database\printerdb.mdb@@
        @@C:\Program Files\PaperCut\Logs\*.mdb@@
        @@C:\Program Files\PaperCut\pcedata\*.*@@
        @@C:\Program Files\PaperCut\pceprefs\*.*@@

->'''9.''' Run PaperCut and complete the setup wizard. Your users, printers and accounts will be upgraded.  Update the other PaperCut options to meet your requirements.

->'''10.''' Add a test account called "Upgrade Test" to your account list.  (It can be deleted later)

->'''11.''' Enter your registration key under the "About" section

->'''12.''' Uninstall and reinstall the new PaperCut ChargeBack Clients on '''ALL''' workstations.  The installation program is automatically placed in the [=PCSetup=] share configured on the server.

Test printing from a client, and make sure PaperCut works as expected and the job prints.


[[#UpgradeFrom4x]]
! Upgrading from PaperCut ChargeBack Version 3.x or 4.x to Version 5.x

We recommend the following procedure for upgrading from PaperCut ChargeBack 4.x (or 3.x) to 5.x.  (PaperCut ChargeBack was previously known as PaperCut Enterprise)

'''Note: Ensure you are running PaperCut Enterprise 4.x before starting. Check the 'About' section in the PaperCut admin console.'''

->'''1.''' Schedule about 30 minutes downtime

->'''2.''' For safe keeping, please backup and archive (i.e. zip) the whole PaperCut directory located at:

@@C:\Program Files\PaperCut\@@

->'''3.''' Copy the following files to a safe place on the harddrive.  [-(Recommend creating a new folder called [=C:\PaperCutBackup=]).-]

@@[=C:\Program Files\PaperCut\Database\pcuserdb.mdb=]@@
@@[=C:\Program Files\PaperCut\Logs\PrintJobLog.mdb=]@@
@@[=C:\Program Files\PaperCut\PCEData\PCEActTrk.mdb=]@@

->'''4.''' Download [[Attach:PCCBUpgrade5.zip |PCCBUpgrade5.zip]] and unzip file and copy [=PCCBUpgrade5.vbs=] into the directory you backed up the 3 databases

->'''5.''' Double click the file [=PCCBUpgrade5.vbs=] that you copied into the directory in step 3.  You should receive two messages that two databases have been upgraded.

->'''6.''' Uninstall PaperCut

->'''7.''' Restart the server

->'''8.''' Manually delete any files remaining in:

@@C:\Program Files\PaperCut\*@@
-->(note:  this step is optional and often not required)

->'''9.''' Install the latest release of PaperCut Chargeback. You can download this from:
-->http://papercut.biz/products/chargeback/download/
-->Note: do not run PaperCut after install (wait to step 11)

->'''10.''' Copy the files upgraded in step 5 over the empty ones in:

@@[=C:\Program Files\PaperCut\Database\pcuserdb.mdb=]@@
@@[=C:\Program Files\PaperCut\Logs\PrintJobLog.mdb=]@@
@@[=C:\Program Files\PaperCut\PCEData\PCEActTrk.mdb=]@@

->'''11.''' Run PaperCut and complete the setup wizard and re-add your printers and assign appropriate costs.

->'''12.''' Add a test account called "Upgrade Test" to your account list.  (It can be deleted later)

->'''13.''' Enter the registration key provided for your version under the "About" section

->'''14.''' Uninstall and reinstall the new PaperCut ChargeBack Clients on '''ALL''' workstations.  The installation program is automatically placed in the [=PCSetup=] share configured on the server.

Test printing from a client, and make sure PaperCut works as expected and the job prints.

to:
* If you are running version 6.x or earlier use the [[#UpgradingToChargeBack7  |6.x upgrade instructions]]

The recommended upgrade procedure when running version 7.0 or later is:

->'''1.''' If upgrading from version 6 or earlier, please read the important notes detailed at [[UpgradingToChargeBack7 | +]].

->'''2.''' Schedule approximately 10 minutes downtime.  It is suggested to choose a time of day with minimal network activity.

->'''3.''' As a precaution, we recommend backing up the whole PaperCut directory before beginning.  Existing overnight backups may have taken care of this task, however take a few moments to grab an up-to-date backup now.  For example, create a zip archive of the directory:
-->[@C:\Program Files\PaperCut NG\@]

->'''4.''' [[http://papercut.biz/products/ng/download/ | Download]] the latest version of PaperCut NG.

->'''5.''' Run the installer and install into the '''same''' location as the existing install.

->'''6.''' After the install has completed allow a few minutes before accessing the system.  The system may need to perform a database upgrade and this will be performed in the background.  If you try to access the application while a database upgrade is in progress a message displaying the upgrade status will be displayed.  '''IMPORTANT: Do not shutdown the application while an upgrade is in progress.  Wait for the upgrade to complete.'''

->'''7.''' After the install is complete, log into the system and perform some tests to ensure all is working as expected and the system is monitoring user activity as expected. Administrators may find the [[PostUpgradeTestPlan | post upgrade test plan]] useful.

'''Note:''' Sites running on Microsoft Cluster servers should consult the documentation in [[UpgradeNGInACluster | cluster upgrade]].

!! Old Upgrade Instructions:

* If you are upgrading from version 3.x or 4.x to version 6.x, please read [[UpgradingChargeBackTo6 | +]]

----
''Categories:'' [[!PaperCutChargeBack]], [[!Administration]], [[!Upgrading]]
----

Comments

Share your findings and experience with other PaperCut users. Feel free to add comments and suggestions about this Knowledge Base article. Please don't use this for support requests.

Article last modified on March 06, 2019, at 03:00 AM
Printable View   |   Article History   |   Edit Article