Difference between revisions of "X-Payments:Upgrading"
(Created page with "<noinclude>{{XP manual TOC}}</noinclude> Upgrading is done with the help of a special upgrade pack. If you are using a downloadable version of X-Payments, and your license all...") |
m |
||
| Line 1: | Line 1: | ||
| − | <noinclude>{{XP manual TOC}}</noinclude> | + | <noinclude>{{Template:XP manual TOC}}</noinclude> |
| − | Upgrading is done with the help of a special upgrade pack. If you are using a downloadable version of X-Payments, and your license allows you to upgrade to later versions, you will find this pack in the <u>File area</u> section of your {{QA}} (Look for a file named like '''upgrade.pack.xp.2. | + | Upgrading is done with the help of a special upgrade pack. If you are using a downloadable version of X-Payments, and your license allows you to upgrade to later versions, you will find this pack in the <u>File area</u> section of your {{QA}} (Look for a file named like '''upgrade.pack.xp.2.2.0.zip''' (ZIP-archive) or '''upgrade.pack.xp.2.2.0.tgz''' (TGZ-archive)). |
<br /><br /> | <br /><br /> | ||
'''To upgrade X-Payments, complete the following steps:''' | '''To upgrade X-Payments, complete the following steps:''' | ||
# Download the X-Payments upgrade pack. | # Download the X-Payments upgrade pack. | ||
# Connect to your X-Payments server via SSH. | # Connect to your X-Payments server via SSH. | ||
| − | + | # Extract the X-Payments upgrade pack that you downloaded and upload the extracted pack contents to the root of your X-Payments installation. | |
| − | # Extract the X-Payments upgrade pack that you downloaded and upload the extracted pack contents to the | + | # Run the script '''<xpay-dir>/upgrade/upgrade.php''' via the command line as follows:<br /> '''php upgrade.php'''<br />The upgrade script will detect your current version automatically and will offer an upgrade to the latest X-Payments version available to you. You will only need to confirm your request by entering "y" (Use "n" to cancel the operation).<br />If necessary, the following parameters may be specified:<br /> |
| − | + | #* -vX.X.X - the version to which you want to upgrade; for example, "-v2.2.0"; | |
| − | + | #* -oY.Y.Y - the version from which you are upgrading; for example, "-o2.1.3" (This parameter should be used if, for example, the version in the config/config.ini.php file of your X-Payments installation is specified incorrectly); | |
| − | + | #* -y - specify this to skip the step where you need to confirm your intention to upgrade (where you need to enter y/n).<br />For example, to upgrade from version 1.0.4 to 1.0.6, you will need to use the command<br /> '''php upgrade.php -o1.0.4 -v1.0.6'''<br />The upgrade script will recognize the following X-Payments versions: 1.0.3, 1.0.4, 1.0.5, 1.0.6, 2.0.0, 2.0.1, 2.1.0, 2.1.1, 2.1.2, 2.1.3, 2.2.0.<br />Note that for X-Payments versions 1.0.3 and 1.0.4 you ''must'' specify the version from which you are upgrading using the -o parameter, since the config/config.ini.php file of these versions does not contain the version information upgrade.php expects to find there.<br /> | |
| − | + | Once the script is run, it will create a backup of your X-Payments installation and carry out the upgrade for you. | |
| − | + | After upgrading has been completed, be sure to remove the directory '''<xpay-dir>/upgrade/''' (That is done for security purposes; remember that X-Payments must be a stand alone service on a separate server, so you must not keep other applications - including the upgrade script - on the same server while using it). | |
| − | |||
In case of any issues, you can find your backup in the directory '''<xpay-dir>/var/backup/'''. | In case of any issues, you can find your backup in the directory '''<xpay-dir>/var/backup/'''. | ||
| Line 18: | Line 17: | ||
<noinclude>{{pdf_single}}</noinclude> | <noinclude>{{pdf_single}}</noinclude> | ||
| + | |||
[[Category:X-Payments User Manual]] | [[Category:X-Payments User Manual]] | ||
Revision as of 17:35, 7 August 2015
- X-Payments:General information
- What's New
- System requirements
- Installation
- Two-factor user authentication
- Configuring X-Payments
- Managing users
- Customizing the interface
- Managing payments
- Unistalling X-Payments
- Upgrading
- Moving X-Payments from one host to another
- Viewing X-Payments logs
- FAQ
- Troubleshooting
- Glossary
- Supported payment gateways
- Popular Payment Methods Configuration Instructions
Upgrading is done with the help of a special upgrade pack. If you are using a downloadable version of X-Payments, and your license allows you to upgrade to later versions, you will find this pack in the File area section of your X-Cart Account (Look for a file named like upgrade.pack.xp.2.2.0.zip (ZIP-archive) or upgrade.pack.xp.2.2.0.tgz (TGZ-archive)).
To upgrade X-Payments, complete the following steps:
- Download the X-Payments upgrade pack.
- Connect to your X-Payments server via SSH.
- Extract the X-Payments upgrade pack that you downloaded and upload the extracted pack contents to the root of your X-Payments installation.
- Run the script <xpay-dir>/upgrade/upgrade.php via the command line as follows:
php upgrade.php
The upgrade script will detect your current version automatically and will offer an upgrade to the latest X-Payments version available to you. You will only need to confirm your request by entering "y" (Use "n" to cancel the operation).
If necessary, the following parameters may be specified:
- -vX.X.X - the version to which you want to upgrade; for example, "-v2.2.0";
- -oY.Y.Y - the version from which you are upgrading; for example, "-o2.1.3" (This parameter should be used if, for example, the version in the config/config.ini.php file of your X-Payments installation is specified incorrectly);
- -y - specify this to skip the step where you need to confirm your intention to upgrade (where you need to enter y/n).
For example, to upgrade from version 1.0.4 to 1.0.6, you will need to use the command
php upgrade.php -o1.0.4 -v1.0.6
The upgrade script will recognize the following X-Payments versions: 1.0.3, 1.0.4, 1.0.5, 1.0.6, 2.0.0, 2.0.1, 2.1.0, 2.1.1, 2.1.2, 2.1.3, 2.2.0.
Note that for X-Payments versions 1.0.3 and 1.0.4 you must specify the version from which you are upgrading using the -o parameter, since the config/config.ini.php file of these versions does not contain the version information upgrade.php expects to find there.
Once the script is run, it will create a backup of your X-Payments installation and carry out the upgrade for you. After upgrading has been completed, be sure to remove the directory <xpay-dir>/upgrade/ (That is done for security purposes; remember that X-Payments must be a stand alone service on a separate server, so you must not keep other applications - including the upgrade script - on the same server while using it).
In case of any issues, you can find your backup in the directory <xpay-dir>/var/backup/.
|
