Tips on installing 3.6.x

If you are trying to install My Source Matrix 3.6.0 and are a little lost with the instructions at the top of the post, these notes may help. The web based installer doesn't work for 3.6.x yet, so you need to follow these instructions


My Source Matrix people - It would have helped me a great deal if you had included some of these points in your post "CLI Install" as it took several hours longer than it should have. Maybe you could update it with some of these notes. All of this information is spread around the forum.


  1. Read the installation instructions at http://matrix.squiz.net/download/installation. They are for the web based installer, however they will help you understand some of the settings needed. You should also read the requirements: http://matrix.squiz.net/download/installation if you haven’t already.


  2. You need to have a CLI version of php installed. Check by typing “php -v” it should report php 4.X.X (CLI). It should not say (CGI). If you don’t have it read this post http://matrix.squiz.net/download/installation


  3. PostgreSQL database. You need 7.4 or later. It must have trust relationships for local access - even though you specify a username and password in the installer? I guess you can install into an existing database, however you will probably want to create one.
  4. Created a database name like: matrix
  5. Create a db user, something like: matrix
  6. Check you have a the pgSQL language installed in the database. Use the following command in postgres.
        createlang plpgsql database_name



  7. Get the mysource matrix source file unzip it into somewhere like /usr/local or /home/. Do not unzip it into the web directory. Later you will set up some apache aliases to it so it doesn't matter where you install it. Hopefully you know the commands to get and extract (wget gunzip and tar xvf).


  8. PHP CLI Install - follow the installation instructions located here: http://matrix.squiz.net/download/installation Note there is a dot (.) at the end of each line which indicates the current directory.


  9. Apache configuration. Add the following lines to your apache conf and restart the web server.


    Alias "/__fudge" /path/to/mysource_matrix/fudge
    Alias "/__data" /path/to/mysource_matrix/data/public
    Alias "/__lib" /path/to/mysource_matrix/core/lib
    Alias "/" /path/to/mysource_matrix/core/web/index.php/


And yes you need the trailing slash after index.php/

7. Check installation
The installation should have created a bunch of tables in the database. You should be able to visit the site and enter _admin in the url. Login with username / password: root, root. If when you log in, the left hand tree doesn't work or your browser freezes, you will need to get the latest Java Virtual Machine http://matrix.squiz.net/download/installation or for gecko based browsers, maybe you should read this post, though I am unsure if it still applies. http://matrix.squiz.net/download/installation

8. Change the password to something more secure. It's time to read the manuals: http://matrix.squiz.net/download/installation

9. Now follow the steps here to try and get your first basic site going. http://matrix.squiz.net/download/installation

If you have problems, you are going to have to read around the forum as their have been lot's of different things pop up.

If you try the install several times (like me) I think you can clean your install using the ./clean.sh script in the mysource_matrix_3.6.x directory. I don't recommend you run this - but don't know enough about it. If you do, you will need to:
    cd /path/to/mysourcematrix/data/private/; mkdir logs; mkdir db;mkdir asset_map; mkdir events;
as the script wipes these needed directories out. MSM people - perhaps you could fix this.

Well I hope this helps a few people. And I hope the forum people incorporate some of these notes in their instructions or pin this at the top.

Dave

Great post DAVE!