Dohtur: Created page with "The regen-codebook.php script is used to re-create the codebook contained in the script. When you run this script, it will also..."

2015-07-14T13:13:58Z

Created page with "The regen-codebook.php script is used to re-create the codebook contained in the <tt><lib/XPay/Model/Codebook.php></tt> script. When you run this script, it will also..."

New page

The regen-codebook.php script is used to re-create the codebook contained in the <tt><lib/XPay/Model/Codebook.php></tt> script.

When you run this script, it will also change:

* the PIN-codes table,
* cardholder data encryption keys,
* online store keys,
* the 'force to change password' flag for all user accounts (including the Administrator).

since this information is encrypted using the codebook.

{{Note1| Note: Before using the script, make sure that SSH and CLI SAPI are available on your server. Contact your hosting provider regarding the matter.}}

To re-generate the codebook please follow the below steps (do it carefully in order to avoid losing data):

# Copy the file <tt><lib/XPay/Model/Codebook.php></tt> to the file <tt><lib/XPay/Model/Codebook.prev.php></tt>
# Create your X-Payments' database dump.
# Log in to the server via SSH.
# Go to the X-Payments installation directory, for example<pre>$ cd /home/www/xpayments</pre>
# Run the regen-codebook.php script with two parameters -run and <xpayments_dir>, where <xpayments_dir> is the full path to the directory where your X-Payments intallation is located, for example: <pre>$ php regen-codebook.php -run /home/www/xpayments</pre>
# If the script failed, copy the file <tt><lib/XPay/Model/Codebook.prev.php></tt> to the file <tt><lib/XPay/Model/Codebook.php></tt>, restore the database from the saved dump and repeat step 3.
# If the script completed successfully delete the database dump file and the <tt><lib/XPay/Model/Codebook.prev.php></tt> file.

[[Category:X-Payments User Manual]]

X-Payments:Codebook regeneration - Revision history

Dohtur: Created page with "The regen-codebook.php script is used to re-create the codebook contained in the script. When you run this script, it will also..."