Need help?

Our experts have had an average response time of 11.36 minutes in January 2024 to fix urgent issues.

We will keep your servers stable, secure, and fast at all times for one fixed price.

‘Down for Maintenance’ error in WHMCS? Here’s how to fix it

by | Dec 3, 2018

Maintaining business systems can be really hard.

When it comes to Billing software like WHMCS, periodic reviews and upgrades are required to integrate new feature enhancements, advanced security updates, etc.

Upgrades work well in most cases. Sometimes, the WHMCS database version conflicts with the release files version and result in errors like “Down for Maintenance“.

At Bobcares, we often resolve such errors as part of our Outsourced Technical Support for web hosts.

Today, let’s see the top 2 reasons for the WHMCS error “Down for Maintenance” and how we fix them.

 

What’s WHMCS error ‘Down for Maintenance’?

When the WHMCS software is updated, the message “Down for Maintenance” is displayed.

This prevents changes to the data during the upgrade process.

WHMCS compares the version of PHP files with the WHMCS version in the database.

If any mismatch is noted, it assumes that an upgrade is in progress and the maintenance message is displayed.

Down for Maintenance” – This status message is helpful during an upgrade process. But, what if you see this message all the time? It’s quite annoying.

What can be the problem? Let’s take a quick look.

‘Down for Maintenance’ error in WHMCS – Causes & Fixes!

Based on our experience in managing servers and providing support to web hosts, let’s see the common reasons for this error and how our Support Engineers fix them.

1) Maintenance mode enabled in WHMCS

We’ve seen cases where web hosts enable Maintenance mode during WHMCS upgrade process.

This prevents users from accessing the client area and displays the custom maintenance message set by the web host.

 

How we fix?

Our Support Engineers disable the Maintenance mode from WHMCS panel using the below steps.

Setup > General settings > General > Uncheck the ‘Maintenance mode’ check box

 

down-for-maintenance-whmcs

How to disable Maintenance mode?

 

2)Version conflicts

This error can occur if the version of the WHMCS database doesn’t match the version of its release files.

For example, the files uploaded might be for version 4.4, but database hasn’t been updated and is still in version 4.3.

The files to perform database upgrade are present in the WHMCS “install” directory.

We’ve seen customers upgrade WHMCS without running the “install.php” script in the install directory.

As a result WHMCS database hasn’t been fully upgraded or not upgraded at all.

Result is “Down for Maintenance” error all the time.

 

How we fix?

i) First, we look at the WHMCS core files like init.php and cart.php and check the version number.

ii) We, then compare the version number to the WHMCS database version from the tblconfiguration table using the below command.

SELECT value FROM tblconfiguration WHERE setting = 'version'";

 

iii) If the database is from a newer version than the PHP files, we’ll download and upload the full release files of the newer version from WHMCS official site.

iv) If the PHP files are from a newer version than the database, we’ll upload the /install folder and run the upgrade process once again.

v) Once the upgrade is complete, we remove the /install folder from the server.

That’s it. Everything should be working now!!

 

Conclusion

WHMCS upgrades are necessary to keep the system secure. Sometimes, the WHMCS database version conflicts with the release files version and result in errors like “Down for Maintenance“. Today, we’ve discussed how our Support Engineers fix this problem.

PREVENT YOUR SERVER FROM CRASHING!

Never again lose customers to poor server speed! Let us help you.

Our server experts will monitor & maintain your server 24/7 so that it remains lightning fast and secure.

SEE SERVER ADMIN PLANS

var google_conversion_label = "owonCMyG5nEQ0aD71QM";

5 Comments

  1. Carlos Alberto Figueredo Quevedo

    No me había funcionado así, pero realicé un UPDATE directamente en la base de datos.

    Mi base de datos era anterior a los archivos php.

    Gracias!!!

    Translate:
    My database was earlier than php files.

    It had not worked that way, but I did a UPDATE directly in the database.

    Thank you!!!

    Reply
    • ghayath

      thanks you are the best it is working as per steps

      Reply
      • Hiba Razak

        Hi,
        Thanks for the feedback. We are glad to know that our article was helpful for you 🙂 .

        Reply
  2. Saeed Al Hasan

    lifesaving post. thanks a lot, man ❤️❤️❤️❤️

    Reply

Submit a Comment

Your email address will not be published. Required fields are marked *

Categories

Tags

Privacy Preference Center

Necessary

Necessary cookies help make a website usable by enabling basic functions like page navigation and access to secure areas of the website. The website cannot function properly without these cookies.

PHPSESSID - Preserves user session state across page requests.

gdpr[consent_types] - Used to store user consents.

gdpr[allowed_cookies] - Used to store user allowed cookies.

PHPSESSID, gdpr[consent_types], gdpr[allowed_cookies]
PHPSESSID
WHMCSpKDlPzh2chML

Statistics

Statistic cookies help website owners to understand how visitors interact with websites by collecting and reporting information anonymously.

_ga - Preserves user session state across page requests.

_gat - Used by Google Analytics to throttle request rate

_gid - Registers a unique ID that is used to generate statistical data on how you use the website.

smartlookCookie - Used to collect user device and location information of the site visitors to improve the websites User Experience.

_ga, _gat, _gid
_ga, _gat, _gid
smartlookCookie
_clck, _clsk, CLID, ANONCHK, MR, MUID, SM

Marketing

Marketing cookies are used to track visitors across websites. The intention is to display ads that are relevant and engaging for the individual user and thereby more valuable for publishers and third party advertisers.

IDE - Used by Google DoubleClick to register and report the website user's actions after viewing or clicking one of the advertiser's ads with the purpose of measuring the efficacy of an ad and to present targeted ads to the user.

test_cookie - Used to check if the user's browser supports cookies.

1P_JAR - Google cookie. These cookies are used to collect website statistics and track conversion rates.

NID - Registers a unique ID that identifies a returning user's device. The ID is used for serving ads that are most relevant to the user.

DV - Google ad personalisation

IDE, test_cookie, 1P_JAR, NID, DV, NID
IDE, test_cookie
1P_JAR, NID, DV
NID
hblid

Security

These are essential site cookies, used by the google reCAPTCHA. These cookies use an unique identifier to verify if a visitor is human or a bot.

SID, APISID, HSID, NID, PREF
SID, APISID, HSID, NID, PREF