X-Cart:System Fingerprints - Revision history

Vladimir Gurinenko: /* Comparing system fingerprints */

2011-11-23T13:00:40Z

‎Comparing system fingerprints

Vladimir Gurinenko: /* Comparing system fingerprints */

2011-11-23T12:58:46Z

‎Comparing system fingerprints

Vladimir Gurinenko: Actualized the article

2011-11-23T12:54:21Z

Actualized the article

Vladimir Gurinenko: /* Generating system fingerprints */

2011-11-23T11:41:45Z

‎Generating system fingerprints

Admin at 10:16, 22 January 2010

2010-01-22T10:16:18Z

Admin at 10:15, 22 January 2010

2010-01-22T10:15:45Z

Admin at 10:15, 22 January 2010

2010-01-22T10:15:15Z

Admin: Created page with '==MD5 checksums== X-Cart uses MD5 (Message-Digest algorithm 5) for data integrity control. It provides a tool which allows you to create lists of MD5 checksums of all the files …'

2010-01-22T09:58:58Z

Created page with '==MD5 checksums== X-Cart uses MD5 (Message-Digest algorithm 5) for data integrity control. It provides a tool which allows you to create lists of MD5 checksums of all the files …'

New page

==MD5 checksums==

X-Cart uses MD5 (Message-Digest algorithm 5) for data integrity control. It provides a tool which allows you to create lists of MD5 checksums of all the files in X-Cart installation directory and to compare checksum lists generated at different periods of time to verify the integrity of X-Cart files.

In X-Cart, a list of MD5 checksums of all the files in the system is called a system fingerprint. The first system fingerprint in your store is generated automatically at the time of [[X-Cart:Installing X-Cart Using the Installation Wizard|X-Cart installation]]. This system fingerprint reflects the original unmodified state of the system. Later, you can get X-Cart to generate more system fingerprints.

Any system fingerprint can be compared with the current state of the store or with any other fingerprint. Comparing fingerprints allows X-Cart to detect any changes in /xcart directory. As a result of comparing fingerprints, you get a list of files which have been modified, added or lost (removed from the system or renamed so they cannot be identified).

== Generating system fingerprints ==

To get X-Cart to generate a system fingerprint:

1. Open the 'System fingerprints' section of X-Cart Admin area.
2. Go to the 'Summary' section (Administration menu->Summary).
3. In the 'Summary' section menu, click the link System fingerprints.

You should see a dialog box titled 'System fingerprints':

[[Image:fingerprints1.gif|522px]]

4. (Optional) In the 'Generate system fingerprint' subsection of the 'System fingerprints' dialog box, enter a description for the system fingerprint you are going to create.
5. Click the '''Generate''' button. X-Cart should launch the generation of the fingerprint. The process may take as long as several minutes. As soon as the fingerprint gets generated, you should see an Information box with a confirmation message.

The fingerprint should be added to the list of available system fingerprints:

[[Image:fingerprints2.gif|522px]]

== Deleting system fingerprints ==

System fingerprints which you no longer need can be deleted directly from the 'System fingerprints' section of X-Cart Admin area.

To delete a system fingerprint:

1. Open the 'System fingerprints' section of X-Cart Admin area.

2. Go to the 'Summary' section (Administration menu->Summary).
3. In the 'Summary' section menu, click the link System fingerprints.

You should see a list of available system fingerprints in the 'System fingerprints' dialog box.

4. Select the DELETE check boxes opposite the system fingerprints that you wish to delete.
5. Click the '''Delete selected''' button below the list. The selected fingerprints should be removed. You should see an Information box with a confirmation message.

==Uploading system fingerprints==

X-Cart saves generated system fingerprints to the directory /xcart/var/log (a system fingerprint filename looks something like md5_1139908092log.php). If you do not wish to permanently keep system fingerprints in the directory /xcart/var/log, but wish to be able to use them in the future, you may want to move your fingerprint files to some place else - for example, you can download them to your local computer. Later, when you need to compare a downloaded system fingerprint with the current state of your store or with another system fingerprint, you will only need to upload this system fingerprint back onto X-Cart server so it becomes available in the directory /xcart/var/log. This can be done directly from the 'System fingerprints' section of X-Cart Admin area.

To upload a system fingerprint to the directory /xcart/var/log:

1. Open the 'System fingerprints' section of X-Cart Admin area:

2. Go to the 'Summary' section (Administration menu->Summary).
3. In the 'Summary' section menu, click the link System fingerprints.

You should see a dialog box titled 'System fingerprints'.

4. Scroll down to the 'Upload system fingerprint' subsection of the 'System fingerprints' dialog box.
5. (Optional) Use the 'System fingerprint description' field in this subsection to enter a description for the system fingerprint you are going to upload.
6. Click the '''Browse''' button and use the 'File Upload' window to locate the necessary system fingerprint file. Select the file.
7. When the filename of the selected fingerprint appears in the appropriate field in the 'System fingerprints' dialog box, click the '''Upload''' button. The fingerprint file should be uploaded to the directory /xcart/var/log.

As soon as the uploaded fingerprint appears in the list of available fingerprints in the 'System fingerprints' dialog box, you can use it as any other system fingerprint stored in the directory /xcart/var/log.

== Comparing system fingerprints ==

At any moment, you can compare any existing system fingerprint with the current state of your store. If you have more than one system fingerprints, you can also compare them with one another.

To compare fingerprints:

1. Open the 'System fingerprints' section of X-Cart Admin area:

2. Go to the 'Summary' section (Administration menu->Summary).
3. In the 'Summary' section menu, click the link System fingerprints.

4. In the 'System fingerprints' section menu, click the link Compare system fingerprints. You should see a dialog box titled ' Compare system fingerprints':

[[Image:fingerprints3.gif|522px]]

{{Note1|Note: The subsection allowing you to compare two fingerprints may not be present on your screen, as you need to have at least two system fingerprints in /xcart/var/log to be able to access this function.}}

5. Select whether you wish to compare the current status with a system fingerprint or to compare two system fingerprints (select the appropriate radio button).
6. Use the 'System fingerprint' drop-down box(es) to select the system fingerprint(s) that will be used for comparing.
7. Select a file range that you wish to be displayed in the comparison results:

* Templates only / PHP scripts only / All files;
* Changed files / New files / Missing files / Unreadable files.

8. Click the '''Compare''' button.

X-Cart should perform the comparison and output the results in the 'Comparison results' form below.

@@ Line 99: / Line 99: @@
 . Click the '''Compare''' button.
-X-Cart should perform the comparison and output the results in the '<u>Comparison results</u>' form below.
+X-Cart will now compare the selected fingerprints and display the results in the '<u>Comparison results</u>' form on the same page.
 [[Category:X-Cart user manual]]
 [[Category:X-Cart modules]]

@@ Line 86: / Line 86: @@
 : [[Image:fingerprint_compare.png]]
-{{Note1|Note: The subsection allowing you to compare two fingerprints may not be present on your screen, as you need to have at least two system fingerprints in /xcart/var/log to be able to access this function.}}
+{{Note1|Note: The '<u>Compare system fingerprints</u>' page may be unavailable while you have less than two system fingerprints stored in the /xcart/var/log directory.}}
 . Choose whether you want to compare the current status with a system fingerprint or to compare two system fingerprints.

@@ Line 15: / Line 15: @@
 . On the '<u>Tools</u>' menu, select '<u>Maintenance</u>'; then click on the '<u>See also</u>' tab and then click on the '<u>System Fingerprints</u>' link.
-This opens the '<u>System fingerprints</u>' form, where you can generate and further manage your system's fingerprints.
+This opens the '<u>System fingerprints</u>' page, where you can generate and further manage your system's fingerprints.
@@ Line 36: / Line 36: @@
 System fingerprints which you no longer need can be deleted directly from the '<u>System fingerprints</u>' section of X-Cart Admin area.
-To delete a system fingerprint:
+'''To delete a system fingerprint:'''
-. Open the '<u>System fingerprints</u>' section of X-Cart Admin area.
+. Sign in to your X-Cart admin area.
-. Go to the '<u>Summary</u>' section (<u>Administration menu->Summary</u>).
+. On the '<u>Tools</u>' menu, select '<u>Maintenance</u>'; then click on the '<u>See also</u>' tab and then click on the '<u>System Fingerprints</u>' link.
-You should see a list of available system fingerprints in the '<u>System fingerprints</u>' dialog box.
+This opens the '<u>System fingerprints</u>' page, where you can generate and further manage your system's fingerprints.
-. Select the DELETE check boxes opposite the system fingerprints that you wish to delete.
+. Select the DELETE check box by the system fingerprints to be deleted.
-. Click the '''Delete selected''' button below the list. The selected fingerprints should be removed. You should see an Information box with a confirmation message.
 ==Uploading system fingerprints==
-X-Cart saves generated system fingerprints to the directory /xcart/var/log (a system fingerprint filename looks something like md5_1139908092log.php). If you do not wish to permanently keep system fingerprints in the directory <u>/xcart/var/log</u>, but wish to be able to use them in the future, you may want to move your fingerprint files to some place else - for example, you can download them to your local computer. Later, when you need to compare a downloaded system fingerprint with the current state of your store or with another system fingerprint, you will only need to upload this system fingerprint back onto X-Cart server so it becomes available in the directory <u>/xcart/var/log</u>. This can be done directly from the '<u>System fingerprints</u>' section of X-Cart Admin area.
+X-Cart saves generated system fingerprints to the <u>/xcart/var/log</u> directory (a system fingerprint filename looks something like md5_1139908092log.php). If you do not wish to permanently keep your system fingerprints on the server <u>/xcart/var/log</u> but would like to be able to use them in the future, you can move your fingerprint files somewhere else; e.g., download them to your local computer. When you need to compare a downloaded system fingerprint with the current state of your online store or to other system fingerprint, you will only need to upload the fingerprint to be compared back to the X-Cart server and have it stored in the <u>/xcart/var/log</u> directory. This can be done directly from the '<u>System fingerprints</u>' section of X-Cart Admin area.
-To upload a system fingerprint to the directory <u>/xcart/var/log</u>:
+This opens the '<u>System fingerprints</u>' page, where you can generate and further manage your system's fingerprints.
-. Open the '<u>System fingerprints</u>' section of X-Cart Admin area:
+. Scroll down to the '<u>Upload system fingerprint</u>' section of the '<u>System fingerprints</u>' page.
-. Go to the '<u>Summary</u>' section (<u>Administration menu->Summary</u>).
+: [[Image:fingerprint_upload.png]]
-You should see a dialog box titled '<u>System fingerprints</u>'.
+. In the '<u>System fingerprint description</u>' field, enter a description for the system fingerprint to be uploaded.
-. Scroll down to the '<u>Upload system fingerprint</u>' subsection of the '<u>System fingerprints</u>' dialog box.
+. Click the '''Browse''' button, select the system fingerprint file to be uploaded and then click the '''Upload''' button.
-As soon as the uploaded fingerprint appears in the list of available fingerprints in the '<u>System fingerprints</u>' dialog box, you can use it as any other system fingerprint stored in the directory <u>/xcart/var/log</u>.
+As soon as the uploaded fingerprint appears on the list of available fingerprints on the '<u>System fingerprints</u>' page, you can use it as any other system fingerprint stored on the server.
 == Comparing system fingerprints ==
-At any moment, you can compare any existing system fingerprint with the current state of your store. If you have more than one system fingerprints, you can also compare them with one another.
+At any moment, you can compare any existing system fingerprint with the current state of your store. If you have more than one system fingerprint, you can also compare them with one another.
-To compare fingerprints:
+. Sign in to your X-Cart admin area.
-. Open the '<u>System fingerprints</u>' section of X-Cart Admin area:
+. On the '<u>Tools</u>' menu, select '<u>Maintenance</u>'; then click on the '<u>In this section</u>' tab click on the '<u>Compare system fingerprints</u>' link.
-. Go to the 'Summary' section (<u>Administration menu->Summary</u>).
+This opens the '<u>System fingerprints</u>' page, where you can any of the available system fingerprints.
-. In the '<u>System fingerprints</u>' section menu, click the link <u>Compare system fingerprints</u>. You should see a dialog box titled ' <u>Compare system fingerprints</u>':
+: [[Image:fingerprint_compare.png]]
-[[Image:fingerprints3.gif|522px|center]]
+. Choose whether you want to compare the current status with a system fingerprint or to compare two system fingerprints.
-{{Note1|Note: The subsection allowing you to compare two fingerprints may not be present on your screen, as you need to have at least two system fingerprints in /xcart/var/log to be able to access this function.}}
+. Use the '<u>System fingerprint</u>' drop-down box(es) to select the system fingerprints to be compared.
-. Select whether you wish to compare the current status with a system fingerprint or to compare two system fingerprints (select the appropriate radio button).
+. Select the files to be displayed in the comparison results:
 * Templates only / PHP scripts only / All files;
 * Changed files / New files / Missing files / Unreadable files.
 . Click the '''Compare''' button.
 X-Cart should perform the comparison and output the results in the '<u>Comparison results</u>' form below.

@@ Line 9: / Line 9: @@
 == Generating system fingerprints ==
-To get X-Cart to generate a system fingerprint:
+'''To have X-Cart generate a system fingerprint:'''
-. Open the '<u>System fingerprints</u>' section of X-Cart Admin area.
+. Sign in to your X-Cart admin area.
-You should see a dialog box titled '<u>System fingerprints</u>':
+. On the '<u>Tools</u>' menu, select '<u>Maintenance</u>'; then click on the '<u>See also</u>' tab and then click on the '<u>System Fingerprints</u>' link.
-. (Optional) In the '<u>Generate system fingerprint</u>' subsection of the '<u>System fingerprints</u>' dialog box, enter a description for the system fingerprint you are going to create.
+: [[Image:fingerprint_page.png]]
-The fingerprint should be added to the list of available system fingerprints:
+. In the '<u>Generate system fingerprint</u>' section of the '<u>System fingerprints</u>' page, enter a description for the system fingerprint you are going to create.
-[[Image:fingerprints2.gif|522px|center]]
+. Click the '''Generate''' button.
 == Deleting system fingerprints ==

@@ Line 16: / Line 16: @@
 You should see a dialog box titled '<u>System fingerprints</u>':
 [[Image:fingerprints1.gif|522px|center]]
@@ Line 23: / Line 24: @@
 The fingerprint should be added to the list of available system fingerprints:
 [[Image:fingerprints2.gif|522px|center]]
@@ Line 74: / Line 76: @@
 . In the '<u>System fingerprints</u>' section menu, click the link <u>Compare system fingerprints</u>. You should see a dialog box titled ' <u>Compare system fingerprints</u>':
 [[Image:fingerprints3.gif|522px|center]]

← Older revision		Revision as of 10:15, 22 January 2010
Line 89:		Line 89:

	X-Cart should perform the comparison and output the results in the '<u>Comparison results</u>' form below.		X-Cart should perform the comparison and output the results in the '<u>Comparison results</u>' form below.
		+
		+	[[Category:X-Cart user manual]]
		+	[[Category:X-Cart modules]]