Installing

I downloaded the latest beta source from squiz.net/download to ~/TWS/CMSs/My_Source/ and then unpacked the file
   $ cd ~/TWS/CMSs/My_Source/
   $ tar zxvf mysource-2.3.9.tgz
Then had a look at the install file.
   $ cd mysource-2.3.9
   $ less INSTALL

The install file gives a list of what is required to run My Source. My Source runs on the LAMP platform (Linux, Apache, MySQL and PHP). These are all available as debian packages so it had just been a matter of apt-get install package_name and answer a couple of questions to get these working. This is all documented

Insert links to documentation here

and the config requirements for My Source are met by what is required by the other php based CMSs.

To install My Source we have to run the configure script
   $ sudo ./configure
This involves answering a few questions all of which are pretty much straight forward

john@habbers:~/TWS/CMSs/My_Source/mysource-2.3.9$ ./configure
Thank you for choosing MySource.

Finding MySQL..
Checking version of MySQL... OK.
Checking version of PHP...Couldn't find the version file for PHP.
Please type in the PHP version you are using (the full version number, no patch levels) [4.1.2]: 4.2.3
OK.
Please enter a system name [john's system]: my_source
Please enter the System Root Directory for MySource [/home/john/TWS/CMSs/My_Source/mysource-2.3.9]:

Now setting up MySQL.
The database(s) that you enter here will automatically be created.

Please enter a Web Database Name [mysource-2.3.9]: mysource
Please enter your MySQL Web Database Host: [localhost]:
Please enter your MySQL Web Database Username: [root]: cmsuser
Please enter your MySQL Web Database Password: []:password

Please enter a User Database Name (This can be the same as the Web Database) [mysource]:
Please enter your MySQL User Database Host: [localhost]:
Please enter your MySQL User Database Username: [cmsuser]:
Please enter your MySQL User Database Password: []: password

Please enter a MySource Web Master Email Address [john@habbers]:
MySource uses its own user database. The first user account 'root' has been created.
You will use this to log in intially. Please enter a MySource password to use [habbers]: password

Finished setting up MySource. Now setting up Web Server.
Please enter the user your webserver runs as [htdocs]: www-data
Please enter the group your webserver runs as [htdocs]: www-data
Please enter your server name [habbers]: www.habbers.com

Please wait...

Checking database(s)... OK.
Creating the database(s)... OK.

Importing Data..Cleaning Up..

Setting up system directories... Done.
Fixing file permissions... OK.

I can't reset the file ownerships. You are currently not logged in as root.
Please log in as root, then run the command:
chown -R www-data.www-data /home/john/TWS/CMSs/My_Source/mysource-2.3.9
Thanks.
Now configuring extensions (if available)...
Extensions plugged in.

Generating necessary Apache Configuration Section..

Please add this section to your apache configuration file.
It has also been saved as Apache.conf in the /home/john/TWS/CMSs/My_Source/mysource-2.3.9 directory for further reference.
----- Start -----

<VirtualHost 10.35.1.7>
Port 80
ServerAdmin john@habbers
DocumentRoot /home/john/TWS/CMSs/My_Source/mysource-2.3.9/web
ServerName www.habbers.com

<Directory /home/john/TWS/CMSs/My_Source/mysource-2.3.9/web>
AllowOverride All
Order allow,deny
Allow from all
</Directory>

<Directory /home/john/TWS/CMSs/My_Source/mysource-2.3.9/squizlib>
AllowOverride All
Order allow,deny
Allow from all
</Directory>

<Directory /home/john/TWS/CMSs/My_Source/mysource-2.3.9/data/unrestricted>
AllowOverride All
Order allow,deny
Allow from all
</Directory>

AliasMatch "^(/.*)?/__lib(.*)$" "/home/john/TWS/CMSs/My_Source/mysource-2.3.9/web/__lib$2"
AliasMatch "^(/.*)?/__squizlib(.*)$" "/home/john/TWS/CMSs/My_Source/mysource-2.3.9/squizlib$2"
AliasMatch "^(/.*)?/__data(.*)$" "/home/john/TWS/CMSs/My_Source/mysource-2.3.9/data/unrestricted$2"

# Any HTTP request made at this domain followed by '/_edit'
# will open the editing interface for that site, page etc.
AliasMatch "^(/.*)?/_edit(.*)$" "/home/john/TWS/CMSs/My_Source/mysource-2.3.9/web/edit$2"

# Any *other* HTTP request made at this domain gets handled
# by the MySource web frontend controller script.
AliasMatch "^(/.*)?$" "/home/john/TWS/CMSs/My_Source/mysource-2.3.9/web/index.php"

# Example alternative at a particular subdirecory of this domain:
#AliasMatch "^/path/to/mysource/section(/.*)?/__lib(.*)$" "/home/john/TWS/CMSs/My_Source/mysource-2.3.9/web/__lib$2"
#AliasMatch "^/path/to/mysource/section(/.*)?/__squizlib(.*)$" "/home/john/TWS/CMSs/My_Source/mysource-2.3.9/squizlib$2"
#AliasMatch "^/path/to/mysource/section(/.*)?/__data(.*)$" "/home/john/TWS/CMSs/My_Source/mysource-2.3.9/data/unrestricted$2"
#AliasMatch "^/path/to/mysource/section(/.*)?/_edit(.*)$" "/home/john/TWS/CMSs/My_Source/mysource-2.3.9/web/edit$2"
#AliasMatch "^/path/to/mysource/section(/.*)?$" "/home/john/TWS/CMSs/My_Source/mysource-2.3.9/web/index.php"
</VirtualHost>

------ End ------
We have now finished configuring MySource.
After adding the above configuration to your Apache configuration file, restart apache and check it works.
Check you have a line in your apache configuration, with these entries (at a minimum):
DirectoryIndex index.html index.php
To log in, open a web-browser, and go to www.habbers.com/_edit (unless you changed our default Apache config).
Your username is root, your password is p3mbmp.
Thank you for choosing MySource!
Your MySource Team,
http://mysource.squiz.net/

Ok I decided to move the mysource folder to /var/www/ just to make it easier with permissions. Therefore when I copied the Apache config stuff into /etc/apache/httpd.conf I had to change /home/john/TWS/CMSs/My_Source/ to /var/www/ which can be done quite easily in an editor with a find and replace capability.

I then had to adjust my virtualhost configuration as becauses I was running multiple CMSs of the same server for evalutation purposes things had got a bit complicated.
I was going to connect to My Source through port 8112 so I had to tell apache to listen on that port. To do that add

Listen 8112
NameVirtualHost *:8112

to httpd.conf and change the settings in the My Source config section to reflect the new port settings.

Then restart apache
   $ sudo /etc/init.d/apache restart

Then log in to servername:8112/_edit with root and whatever password that you set when the config script asked you for a password for the root user.

This logs you into the My Source User System and you can add a new user.