We launched new forums in March 2019—join us there. In a hurry for help with your website? Get Help Now!
  • Hey MODX people,

    as some of you appear to hafe the same issues, i'd like to setup this threas about the "white screen of death". Which means: Fontend empty, manager just a white sscreen and setup will not continue to work after two or three steps (if you try to fix it that way).

    Reason 1:
    I moved a site from one server to another and in the end I had this "wsod". the reason was this:
    /core/config/config.inc.php
    <?php
    /**
     *  MODX Configuration file
     */
    $database_type = '{database_type}';
    $database_server = '{database_server}';
    $database_user = '{database_user}';
    $database_password = '{database_password}';
    $database_connection_charset = '{database_connection_charset}';
    $dbase = '{dbase}';
    $table_prefix = '{table_prefix}';
    $database_dsn = '{database_dsn}';
    $config_options = {config_options};
    $driver_options = {driver_options};
    
    $lastInstallTime = 1340783125;
    
    $site_id = 'modx4feaba156a1346.27261429';
    $site_sessionname = '{site_sessionname}';
    $https_port = '{https_port}';
    $uuid = '17f4944f-bf04-491e-9450-9f31c068ca13';
    


    I cant imagine how this happened. But it did and so might it happen to you as well.

    Reason 2:
    I uploaded 2.2.4 to upgrade a site from 2.2.2. After two steps of the setup (yes, I cleared the cache and reset all sessions), a encountered the "WSOD" again.

    This time I compared file sizes of my local machine ant the remote server and one file inside /core/xpdo/cache/xpdocachemanager.class.php was 0 bytes in size. I cant imagine why a) cache is spread all over the filesystem and b) this folder still contained files after clearing the cache, but it did. I overwrote it with my local 44kb version from the backup and the site was back immediately.

    I hope this might help some of you digging around, if the usual debugging fails.

    Cheers,

    Guido
    • This time I compared file sizes of my local machine ant the remote server and one file inside /core/xpdo/cache/xpdocachemanager.class.php was 0 bytes in size. I cant imagine why a) cache is spread all over the filesystem and b) this folder still contained files after clearing the cache, but it did. I overwrote it with my local 44kb version from the backup and the site was back immediately.

      That's not a cache file as in data that has been cached, that's the main file that handles writing and reading the cache. So if that file got screwed in an upload/migration, yes, you are very likely to get a screwed up install. All MODX cache is written to the core/cache folder by default.

      If you get a WSOD (I like that term to describe this), something went wrong that could not have been expected. This often boils down to either a missing or corrupt core file (like the cachemanager), a failure to run setup (or failed setup) after uploading and overwriting the new versions' files, or some kind of mystical combination.

      Either way, all these conditions will cause errors that are being logged. Either by the MODX core if it doesn't get killed right away (eg failed setup causing issues fetching the active user) in which case it logs to the core/cache/logs/error.log file, or by the server process that immediately gets killed, in which case there can be an error_log file near the index.php or manager dir, or the server error log accessible via a cPanel/DirectAdmin/ticket to host.
        Mark Hamstra • Developer spending his days working on Premium Extras and a MODX Site Dashboard with the ability to remotely upgrade MODX and extras to make the MODX world a little better.

        Tweet me @mark_hamstra, check my infrequent blog at markhamstra.com, my slightly more frequent ramblings at MODX.today or see code at Github.
      • Hey Mark,

        I will not ask why the logfile is stored in a temporary folder like /core/cache/logs - I just accept it smiley

        I never saw a logfile somewhere else in the filesystem. You mean really next to index.php or some other folder, right?

        As most of the time clients dont need big servers, its likely that I cant access apache logs. Which didn't say a word about the error by the way smiley

        I am just trying to giv hints to others, as this WSOD is not unusual to modx as I learned from google while searching for solutions. Mostly users will either be php or design people. So they have limited ideas where to start digging.
        • By the way: the first site (which I moved), its asasets folder was empty, too. Strange thing, because I migtrated about 8 other sites (all modx) the same way without problems.
            • 3749
            • 24,544 Posts
            Did you use FTP to transfer the individual files? That fails more often than you might think (besides being very slow).


            ------------------------------------------------------------------------------------------
            PLEASE, PLEASE specify the version of MODX you are using.
            MODX info for everyone: http://bobsguides.com/modx.html
              Did I help you? Buy me a beer
              Get my Book: MODX:The Official Guide
              MODX info for everyone: http://bobsguides.com/modx.html
              My MODX Extras
              Bob's Guides is now hosted at A2 MODX Hosting
            • Its mostly the only way to get files up to the server. How do you do it?
                • 3749
                • 24,544 Posts
                See this: http://bobsguides.com/modx-upgrade-faq.html

                It's about upgrading, but see the section on uploading and de-compressing the MODX .zip file. It's much faster and more reliable than transferring the individual files.


                ------------------------------------------------------------------------------------------
                PLEASE, PLEASE specify the version of MODX you are using.
                MODX info for everyone: http://bobsguides.com/modx.html
                  Did I help you? Buy me a beer
                  Get my Book: MODX:The Official Guide
                  MODX info for everyone: http://bobsguides.com/modx.html
                  My MODX Extras
                  Bob's Guides is now hosted at A2 MODX Hosting
                • Sure - If you have the opportunity to unzip files at the server, it would be quite easy. But as MODX does not support this feature by itself, its not rarely on small installations.
                    • 3749
                    • 24,544 Posts
                    Is there no cPanel access on your host? That's where I do it.


                    ------------------------------------------------------------------------------------------
                    PLEASE, PLEASE specify the version of MODX you are using.
                    MODX info for everyone: http://bobsguides.com/modx.html
                      Did I help you? Buy me a beer
                      Get my Book: MODX:The Official Guide
                      MODX info for everyone: http://bobsguides.com/modx.html
                      My MODX Extras
                      Bob's Guides is now hosted at A2 MODX Hosting
                    • If i recommend some hosting with cPanel or whatever, its mostly three times more expensive than a simple hosting. I cant justify that just for the upload.