install quickssh
This guide is specific to installing Melody using SSH to transfer and edit files on the server.
First, check Getting Ready to Install for needed tools and preparatory steps.
For the purpose of this guide we'll assume the following variables, substitute as necessary.
- web root directory:
/var/www/html/ - cgi-bin directory:
/var/www/cgi-bin/ - database: MySQL (and that you have the database details)
Compared to the Install via FTP instructions, these instructions have a slightly more abstracted setup (using symlinks, keeping the mt-static dir in the application directory, etc.) to provide simpler future maintenance and upgrades. Refer to the Detailed Step-by-Step Installation Guide for more info and the installation troubleshooting guide for common roadblocks.
In a terminal, SSH to the server and change to the cgi-bin directory:
$ ssh melody@domain.com
$ cd /var/www/cgi-bin
Get the latest version of Melody:
Login to the cgi-bin directory and download get the wget the latest version of Melody:
$ wget http://github.com/openmelody/melody/zipball/master
Or, if already downloaded to your local computer, copy it to the server. From your local computer:
$ scp melody-v1.x.zip user@domain.com:/www/var/cgi-bin/
Unzip the application archive:
$ unzip melody-v1.x.zip
Create a symlink from "melody" to version of the application directory in the cgi-bin so that Melody can be accessed without the version number in the URL:
$ ln -s melody-v1.x melody
Change directory to the application directory:
$ cd melody-v1.x
Update file permissions.
Update mt-static/support (static support directory) to be writable:
$ chmod 777 mt-static/support
Update the themes directory to be writable:
$ chmod 777 mt-static/themes
Tip: the mt-static/support and mt-static/themes directories can be 775 if the web server user is in the directories' group or 755 if the web server user owns the directories. Read more about File Permissions.
Create a symlink to the mt-static (static directory) in the web root:
cd ../../html
ln -s ../cgi-bin/melody/mt-static
Copy the default configuration file to create the configuration file:
$ cp config.cgi-original config.cgi
-
Open the configuration file in your preferred command line editor (such as "vi" or "emacs") and update the content to the following basic config. Insert the database details for your mysql database for the placeholders. Refer to the MySQL database configuration documentation if advanced database settings necssary):
CGIPath http://www.domain.com/cgi-bin/melody/ StaticWebPath http://www.domain.com/mt-static/ ObjectDriver DBI::mysql Database DATABASE_NAME DBUser DATABASE_USERNAME DBPassword DATABASE_PASSWORD DBHost localhost EmailAddressMain no-reply@domain.comThe StaticFilePath is not necessary because it was not moved out of the application directory.
-
Access the Melody application in a web browser. The URL will be similar to this:
http://www.domain.com/cgi-bin/melody/index.cgiTip: If there are any errors, view the check.cgi script which should be located at a URL similar to:
http://www.domain.com/cgi-bin/melody/check.cgi -
Create the administrator account. Click "Continue".
-
Create the first website. Click "Finish". Melody will then initialize the database with all the configuration options and settings specified.
-
Click "Sign into Melody" and start blogging!
Warning: because the check.cgi script displays server details which could be useful to a hacker, it is recommended that this script be removed or renamed. If renamed, use the CheckScript directive so that Melody knows where the script was moved.
- Create pages in the website
- Create a blog in the website
- Complete out your profile, etc.
Questions, comments, can't find something? Let us know at our community outpost on Get Satisfaction.
- Author: Six Apart Ltd, Violet Bliss Dietz
- Edited by: Violet Bliss Dietz