Saturday, March 13, 2010
   
Text Size

Chapter 4. Miscellaneous information

Rate this item
(0 votes)

Chapter 4. Miscellaneous information

Frequently asked questions

Please note that this simplified F.A.Q. list may not be always up-to-date.

1.1. Will this component work with my Joomla! 1.0.x site?
1.2. As soon as I start a backup, the display is frozen and no step changes color forever. No archive is produced, no log is produced. What am I supposed to do?
1.3. Whenever I try to modify the filters' settings (for example, excluding a directory) nothing happens.
1.4. I am getting an HTTP 500 Internal Server Error message
1.5. During the database restoration step, I get a message about not being able to connect to the database.
1.6. There are files missing from the backup!
1.7. I downloaded the ZIP archive but my archiver software says it's broken. What's this all about? Can't JoomlaPack produce valid ZIP archives?
1.8. The downloaded backup archive is corrupt! I can not restore my site! What is going on?!
1.9. I am on GoDaddy hosting (or other server cluster hosts) and this component keeps failing during the Creating Archive step. What's wrong?
1.10. I get a MySQL error stating that I have exceeded my queries quota! Now what? My site is down.
1.11. I think I have found a bug. The documentation was of no help to me. What should I do next?
1.12. I want to contribute to this project. What are my options?
1.1. Will this component work with my Joomla! 1.0.x site?
1.2. As soon as I start a backup, the display is frozen and no step changes color forever. No archive is produced, no log is produced. What am I supposed to do?
1.3. Whenever I try to modify the filters' settings (for example, excluding a directory) nothing happens.
1.4. I am getting an HTTP 500 Internal Server Error message
1.5. During the database restoration step, I get a message about not being able to connect to the database.
1.6. There are files missing from the backup!
1.7. I downloaded the ZIP archive but my archiver software says it's broken. What's this all about? Can't JoomlaPack produce valid ZIP archives?
1.8. The downloaded backup archive is corrupt! I can not restore my site! What is going on?!
1.9. I am on GoDaddy hosting (or other server cluster hosts) and this component keeps failing during the Creating Archive step. What's wrong?
1.10. I get a MySQL error stating that I have exceeded my queries quota! Now what? My site is down.
1.11. I think I have found a bug. The documentation was of no help to me. What should I do next?
1.12. I want to contribute to this project. What are my options?

1.1.

Will this component work with my Joomla! 1.0.x site?

JoomlaPack version 2 onwards is not compatible with Joomla! 1.0.x anymore. In order to use JoomlaPack on those sites you'll have to install the earlier JoomlaPack versions in the 1.2.x range. At the time of this writing the latest published version was 1.2.3.

As long as the Joomla! team continues to officialy support Joomla! 1.0.x so will we for JoomlaPack 1.2.x. Do not expect any new features being implemented on that version, though. The JoomlaPack 1.2.x branch is now in maintenance mode and only severe bugs and security issues will be resolved and rolled out as new versions.

Update - July 2009: Joomla! 1.0.x is no longer officially supported by the Joomla! team. Therefore, we cease active support (bug fixing) on JoomlaPack 1.2.x. You are welcome to report any issues you may have, but a solution is not guaranteed.

1.2.

As soon as I start a backup, the display is frozen and no step changes color forever. No archive is produced, no log is produced. What am I supposed to do?

By default, JoomlaPack uses AJAX to process the backup steps. There are some instances, though, where AJAX doesn't work as intended. Such cases might be:

  • PHP warnings mess AJAX result parsing. In this case, try setting Joomla!'s Error Reporting to None (this option is located in Joomla!'s General Configuration under the Server tab).

  • Free hosts which force pop-up ads on the pages do that on AJAX reponses, too. In a nutshell, they ruin the AJAX output and JoomlaPack's AJAX library chokes on those ads.

  • Your browser does not support (or only partially supports) AJAX. Confirmed working browsers are Internet Explorer 6+, Konqueror 3.5.9+, Firefox 1.5+, Google Chrome. If you use older versions of Konqueror, Safari or any other WebKit-powered browser, you will get errors (this is due to the way those browsers parse Javascript). No other browsers have been tested. In any case, try using one of the supported browsers.

  • You have an unstable network link or your server is non responsive. This can easily happen with crowded shared hosting servers (most notably, the free ones) or over a low signal Wi-Fi internet connection. Even if the network gets disconnected for a second or so, it can cause the AJAX call to fail, as the response never comes back to the browser.

In order to resolve this, you should try using the JavaScript Redirects mode.

If you are sure this is not one of the aforementioned cases, first check out the support forums at http://forum.joomlapack.net. If you do not find a relevant entry in the forum, then start a new thread. We will answer to you as soon as we can (usually, it takes 1-3 days, at most a week).

1.3.

Whenever I try to modify the filters' settings (for example, excluding a directory) nothing happens.

This is, again, a matter of AJAX compatibility. Take a look at the previous question.

[Tip]Tip

The JavaScript Redirects mode is not only applied to the backup process. If you select it, the filters pages will also work in the (slower but compatible) JavaScript redirects mode.

1.4.

I am getting an HTTP 500 Internal Server Error message

This error masks a system or PHP-level error. We can't be certain what it is, but there are a few ideas you can try:

  • Try using the Balanced settings mode (you have to enable the Easy Mode first, then go to Configuration in order to select this option).

  • Try using our split ZIP/JPA archive feature. Some hosts impose a maximum file size limit, usually in the order of 10Mb or so. Go to JoomlaPack's Configuration, expand the Advanced pane and set Part size for archive splitting to 5242880 (that is 5Mb expressed in bytes). Make sure you have set up JoomlaPack to produce ZIP or JPA files, this feature does not work with the other archiver engines. This should create a backup spanning several archive files.

If this doesn't work for you, ask your host for access to your server's error log. Do note that most hosts give you access to the access log, which is a completely different and - for our purpose - not useful thing. Please start a new thread on our support forum and a. copy & paste the last ten lines of the host's error log b. put in a ZIP file and attach JoomlaPack's log (downloadable from the View Log page, see the flashing link on the top of it) c. write a clear and concise descriptions of what you've done so far and what the problem is exactly. If you have to attach screenshots to help us understand, by all means do so.

1.5.

During the database restoration step, I get a message about not being able to connect to the database.

There are two possible causes:

  • The user name or password that you provided are not correct.

  • You have given an inexistent database name and JoomlaPack was unable to create a new database. On most commercial hosts, you must manually create the database before you start the restore. Part of the process of creating the database will be to create the user and password to supply to the JoomlaPack Installer you use.

    [Important]Important

    If the database doesn't exist, JPI tries to create it. This will only work if the database user whose credentials you've given has the privilege to create new databases. This is usually restricted to the "root" user. If JoomlaPack fails to create the database, it will ultimately reply that it can't connect to the database.

1.6.

There are files missing from the backup!

In the rare event that you have files with permission settings that do not enable your web server to read them, JoomlaPack can't access them and therefore can't pack them either. This might happen if you upload your files with FTP and don't change the permissions manually. In this case, you should also experience malfunctions on your Joomla! site prior to using JoomlaPack. Sometimes, you can have directories with wrong permissions and files with correct permissions, which makes things a little more complicated, because Joomla! works fine but JoomlaPack doesn't. As a general rule of thumb, the minimum permissions to be on the safe side are:

  • Directories: Readable by user, group and other, executable (browsable) by user, group and other (0755)

  • Files: Readable by user, group and other (0666)

There will also be missing file when the backup fails.

Sometimes, your archive may appear to be missing files but in fact all files are in there. Read the next entry for details.

1.7.

I downloaded the ZIP archive but my archiver software says it's broken. What's this all about? Can't JoomlaPack produce valid ZIP archives?

This is not a yes or no question. The situation is somewhat complex and requires a little bit of technical explanation. If you want the executive summary, JoomlaPack is unable to produce valid-looking ZIP files under certain configurations. However, the data is intact and you can extract the archive if your archiver software can be set up to ignore CRC errors in the archive. Alternatively, you can use the unzip.php script from the JPA Utils package.

And here goes the technical explanation. The ZIP archive format specifies that a CRC32 checksum must be stored for each file included in the archive. PHP before version 5.1.2, only had a CRC32 calculation function for in-memory data. As a result, JoomlaPack had to read the entire file to memory to calculate its CRC32 hash. However, due to memory consumption limitations imposed by PHP configuration, this is usually not possible for large files. "Large files" for PHP usually means anything over around 1Mb. A workaround was attempted but it was not successful, since PHP is a typeless language and the required bitwise arithmetic could not be performed.

The effect of all of this is that a dummy CRC32 value is stored for those files. Archiver software, adhering to the ZIP standard, check the CRC32 for each file they try to extract and when they come to such a file with a dummy CRC32 they think that the archive is broken and omit the extraction of the offending file. In fact, the file data is correct, the CRC32 is wrong. Some archiver software can be configured to ignore CRC errors and the ZIP will extract just fine.

Since PHP 5.1.2 there was the hash extension available. This PHP extension provides a method for quickly and accurately calculating any file's CRC32 without having to read all of it in memory. In systems with PHP 5.1.2 or better with the hash extension available, JoomlaPack will produce correct ZIP files, adhering to the ZIP standard.

Please note that this is a PHP limitation, beyond our control. We are not irresponsible, releasing a software which doesn't work. The current behaviour is a compromise between required features and technical possibility.

If you really want to extract your ZIP archive you can use our unzip.php command-line script, or the desktop application JoomlaPack eXtract, available for Windows only.

1.8.

The downloaded backup archive is corrupt! I can not restore my site! What is going on?!

If you used the Download button / links in the component's backend to download your file, it is possible that your browser corrupted the file. For example, all versions of Internet Explorer up to and including 6.0 (before SP1) corrupt the downloads, against all web standards and best practices. If you used FTP to download your backup archive, it is possible that your FTP client was set up to download files in ASCII or AUTO file transfer modes, eventually corrupting your backup archive.

You can overcome this problem by downloading your backup archives using your favorite FTP client, set up to forcibly download files in BINARY mode. If you are looking for a decent FTP client, give FileZilla a try. It's our favored, cross-platform, Free Software FTP client. You can select the transfer mode either in the server connection settings or from the menu just before downloading a file.

1.9.

I am on GoDaddy hosting (or other server cluster hosts) and this component keeps failing during the Creating Archive step. What's wrong?

There is a compatibility issue with GoDaddy hosting and JoomlaPack, causing dropped database connections. You can enable the "Force database keep-alive during long operations" option to circumvent this behavior. You may also switch to creating JPA archives from the JoomlaPack Options page to further limit the strain put on the server and decrease the probability of failed backups.

Some hosts also proactively halt script execution if they suspect a DoS (Denial of Service) attack. The pattern of normal JoomlaPack operation “too many and frequent hits on the same webpage“ is similar to that of a typical DoS attack. Combined with the long time of the script execution, it might lead some hosts to believe that they are under attack and start blocking the script execution after a while. We have no solution to this problem, because it happens outside the realm of PHP where this software exists.

1.10.

I get a MySQL error stating that I have exceeded my queries quota! Now what? My site is down.

Your site is not down, it will come back online at most within an hour.

What happens is that most hosts expect you to run a lightweight CMS which performs a few queries per request and that your site is not too popular. Therefore, they impose a maximum number of SQL queries your site can execute within the hour. JoomlaPack needs to read and dump all of your database. If you are on a fast server, this will happen with a very small number of steps and queries. If you are on a dead slow host, however, this has to be done with more queries to the database server, eventually reaching your queries limit.

You can try to "fix" this by doing all of the following:

  • Set Maximum database rows dumped per step to 300

  • Increase Maximum operations per step to 100 or 1000. JoomlaPack 2.2 and later is smart enough to figure out if this value is too high to be usable under most server configurations.

  • You may want to exclude database tables holding log or other information which can be dynamically re-calculated (like banner tracking, site access statistics, SEO URL caches, etc). This requires the JoomlaPack Plus version, as you will need to make use of the Database Table Exclusion Filter feature.

1.11.

I think I have found a bug. The documentation was of no help to me. What should I do next?

Before asking this question, have you really tried all of the troubleshooting steps in the documentation of the Backup Now page? 9 out 10 times these are sufficient to resolve your problems. A certain degree of self-help is mandatory, otherwise you will be just wasting your time, as you might be eventually instructed to follow these steps.

First, check out the support forums at http://forum.joomlapack.net. If you do not find a relevant entry in the forum, start a new thread. Do not forget to attach a copy of the plain text JoomlaPack log (downloaded from the View Log page, clicking on the link - do not copy and paste from the text area in this page!). Please zip this file before attaching it to the forum. Support requests without a debug log will waste your time; if it comes down to needing developer's assistance I will ask you to attach it anyway and you'll have just lost a day's worth of response time. Also tell us the exact version of Joomla!, MySQL and PHP you are using. Yes, these are important values, I will have to ask you to provide them eventually.

We will get back to you as soon as we can (typically, it takes 1-3 days, at most a week; most posts are replied within the day, depending on our availability). Again, please make sure you have read the troubleshooting instructions given in the "Backup Now" page's documentation on this User's Guide and the support request submission notes posted as sticky notes in the forums pages. We do not want to seem picky about this, but following these simple rules helps us help you better and faster. Thank you!

1.12.

I want to contribute to this project. What are my options?

If you want to contribute to the project, you have many different options, depending on your skills:

  • You can contribute financially by donating a small amount. A secure donation link exists on the bottom of JoomlaPack's Control Panel page and on our site's frontpage. Donations are handled by PayPal, the leading on-line payment gateway. We do not get any sensitive information (like your CC number), just the money you send us.

  • If you've got an idea about a feature which could be helpful to the community, share your thoughts with us. Our forum has dedicated areas for feature requests. Try asking something crazy. I might be a bit negative at first, but if it's worth the trouble it will get implemented eventually.

  • You can translate JoomlaPack in your native language. Check out the forum to find out if nobody has translated JoomlaPack in your language yet and seek translation advice from the Translation Team Leader, Nikolaos (under the user alias jamfx). Depending on the amount of spare time you have, you could translate the component and / or the documentation.

  • If you are a skilled PHP coder and would like to contribute by developing new features or have found a bug and want to submit a patch, contact user nicholas at the support forum.

  • If you have some spare time and you are willing to regularly test development versions of JoomlaPack on your sites, you can apply for the JATS team. Just send a PM to user nicholas at the support forum.

  • Spread the word! Do your co-workers, friends and family know about JoomlaPack? Have they tried JoomlaPack Native Tools to automate their sites' backup? If not, tell them about this exciting software.

Last modified on Wednesday, 17 February 2010 14:39

Add comment


Go Professional!

Now, is the best time to go Professional!

go_pro_sidebar

Support Unavailability

Enhanced Support will experience reduced or no availability during the dates marked in red on the calendar below. If you file a support ticket during this period, we might take longer to get back to you.

Calendar shown in Athens timezone
See the full calendar