We launched new forums in March 2019—join us there. In a hurry for help with your website? Get Help Now!
    • 46448
    • 98 Posts
    Hi MODX Evolution users!

    I'm brand new to MODX Evolution. I seem to need some very basic installation help.

    I have a new shared hosting server and have the nameservers pointing to it.

    Server info:
    Apache version 2.2.23
    PHP version 5.3.17
    MySQL version 5.5.27-cll
    Architecture x86_64
    Operating system linux
    (This server has cPanel as well.)

    I set up an FTP account and set up a mySQL database (for the Evolution.) Note that in cPanel, when you set up a database, the name gets prepended with an abbreviated form of the website URL and an underscore, so if my domain name was "MyNewDomain", the first 8 characters would be "mynewdom" and if I call my database "modxe", then cPanel shows
    mynewdom_modxe
    as the database name

    So, what is the database name, really? Is it mynewdom_modxe or modxe ?
    I am not sure if MODX wants "modxe" or "mynewdom_modxe" when it asks for the database name.
    Usernames also get prepended: JohnDoe becomes mynewdom_johndoe

    ----------------------

    I downloaded the latest Evolution zip file, unzipped it on my computer, and copied the files via FTP to what I thought was the root folder. (Instead, the files and folders got copied into the new folder that cPanel creates when you set up an FTP account. I may have something set up wrong.) So, I moved the files into the root folder which, if I have it correct, is public_html on the server

    So, MODX install asks for this:
    Database host: [ localhost ]
    Database login name: [_________________]
    Database password: [________________]

    I note that it doesn't ask for the database name itself, but rather "host." Is "localhost" correct?
    Is the correct login name the longer one, prepended?

    Is there a beginners tutorial, or can someone help me step through these very basic steps?

    Thanks!

    Dennis

      • 37042
      • 384 Posts
      Hi Dennis. Been a while sice I used Evo but the database names should be mynewdom_modxe

      On Revo ( the most recent MODX) if I get an install or database connection error, I try the database name with and without the prefix and even localhost. Actually, one of the hosting companies ( Heart Internet) insist that the database name and database user are the same so you have to consult the hosts FAQs too.

      Btw, as a new MODX user, have you tried Revo instead of Evo?
        ...
        • 46448
        • 98 Posts
        Hi eladnova, and thanks for the reply.

        I need to use Evo for a project that uses one of the Evo "Extras" that is not available for Revo.

        The logic of using "localhost" on a shared server to identify the database host escapes me. It makes sense on a dedicated server, to me. If the site uses several mySQL databases, there has to be a way to distinguish them, particularly if more than one person sharing the server names a database the same name (such as "customer.") Perhaps that's why the prepending is used on the database login name - to distinguish the various databases at localhost.

        I guess I can keep trying different combinations until I stumble onto the right one, but was hoping someone might know how a typical Evo install goes into a shared host with Linux, looking through the eyes of cPanel.

        Dennis

        • Most shared hosting (and most dedicated servers, for that matter) use the same server (localhost to the MySQL server) for the database server; hence the "localhost" as the server. This is so the client (php, in our case) knows server to query for the database engine.

          Your database name will be whatever the CPanel assigns; indeed it is usually some substring of your domain + the database name you chose.

          So you would indeed use mynewdom_modxe. The CPanel database wizard or the phpMyAdmin it offers will show the proper database name to use. Your login name may also be prepended by CPanel.
            Studying MODX in the desert - http://sottwell.com
            Tips and Tricks from the MODX Forums and Slack Channels - http://modxcookbook.com
            Join the Slack Community - http://modx.org
            • 46448
            • 98 Posts
            Thanks, Susan.

            I tried:

            localhost
            mynewdom_modxe
            mypassword

            and the install fails. (obviously "mynewdom" and "mypassword" are not literal, and I did check several times for typos.)

            The database exists, I can go to it (no tables yet, of course) using phpMyAdmin.

            Dennis
            • When you create a new database using the Cpanel database wizard, it will give you all of that information. You should be able to check through the "MySQL databases" app.

              My Bluehost is something like this:

              Server: localhost
              Username: sottwell_myname (the name I used)
              Database name: sottwell_myname (the name I used)


              So they prepended my domain name to the names I selected when creating the database.

              It is possible that your hosting uses a different server for the database, but it should say so in the "MySQL Databases" page. In fact, it will give the server name to use in case you want to access the database from a desktop client (if your host allows that). This is what a Justhost CPanel says on that page:

              When connecting to your database the hostname you will almost always use is localhost. The exception to this will be if the script or program you wish to connect to the database is running on a different system than the one hosted with Justhost, in which case the hostname will be justxx.justhost.com.
                Studying MODX in the desert - http://sottwell.com
                Tips and Tricks from the MODX Forums and Slack Channels - http://modxcookbook.com
                Join the Slack Community - http://modx.org
                • 46448
                • 98 Posts
                Thanks again, Susan.

                The step-by-step installation notes are here: http://wiki.modxcms.com/index.php/Installation_Guide

                If someone else reads this because they are stuck with the install of Evolution, do read the above linked instructions - you have a zero chance of success if you don't.

                Also, consider deleting any cookies related to MODX and your cPanel for your site. Finally, you may need to delete the database you created, and start over. Don't forget to add the user to the database and don't forget to set all the permissions for this user in this database.

                I did finally did get it installed.

                Thanks again to those that lent a hand!

                Dennis
                • Databases can be tricky to deal with.

                  I got dragged kicking and screaming into database administration and programming back in the days of dBase and FoxPro (I wanted to program games), but now I'm grateful for the blood, sweat and tears expended on dealing with different data storage systems. Computer Associates (previously Borland) Jasmine was a beauty, an object database rather than a relational database; used ODQL rather than SQL. Having beta tested it while still in the US, I almost got a job with CA as a rep when I first came to Israel. The /rdb flat-file data store that uses the UNIX shell commands (grep, sed, awk etc.) along with a handful of custom commands as a "query" language is interesting if one really wants blinding speed.
                    Studying MODX in the desert - http://sottwell.com
                    Tips and Tricks from the MODX Forums and Slack Channels - http://modxcookbook.com
                    Join the Slack Community - http://modx.org
                    • 46448
                    • 98 Posts
                    Quote from: sottwell at Nov 22, 2012, 06:52 AM
                    Databases can be tricky to deal with.

                    I got dragged kicking and screaming into database administration and programming back in the days of dBase and FoxPro (I wanted to program games), but now I'm grateful for the blood, sweat and tears expended on dealing with different data storage systems. Computer Associates (previously Borland) Jasmine was a beauty, an object database rather than a relational database...
                    I started with "RBase" which I think may have been the first attempt to sell a relational database commercially. I wrote a custom application using it, that tracked serial numbers on pianos for the largest piano dealer in Chicago. That had to be 25 to 30 years ago.

                    Above, I should have said:
                    When I first installed MODX, I saw it in cPanel on the new hosting site...and installed it. Of course, I immediately realized that I had installed Revo and not Evo. I deleted the install and deleted the database (but did not clear cookies or shut down the browser.) THEN I tried to install Evo. The install problems may have been somewhat related to that Revo install/deinstall, but without those instructions at the link in the above message, Evo would not be able to be installed.

                    Dennis [ed. note: last edited this post 11 years, 5 months ago.]