Joomla! Documentation™

SSH (Secure SHell) is a means of establishing a secure command-line shell interface on a remote system.

On Unix/Linux you can open a secure shell with the command ssh -l <username> <host> where <username> should be replaced with your actual username and <host> by the domain name or IP address of the host to which you want to connect.

On Microsoft Windows you can use the PuTTY terminal emulator.

You will be prompted for the password associated with the username. If this is the first time you have attempted to connect to this host using SSH you will be asked to confirm the fingerprint of the host you are attempting to connect to. To exit an SSH session, type Control-D or exit. For example, to connect to host www.mydomain.com using username goliath you would enter:

ssh -l goliath www.mydomain.com

Joomla Packages

Joomla Release Packages come in two varieties:

• Full Release Packages that contain a complete set of Joomla files, and
• Joomla Patch Packages that contain only those files that must be replaced to update a site

Full Release Packages are much larger than Patches, but are easier and less error-prone for novice users to install. In order to use a Patch Package, you must find the correct upgrade from your current Joomla Version to the latest release of Joomla that you intend to install. E.g., if you are currently running Joomla-1.5.7 and want to upgrade to Joomla-1.5.15, then you must download this package file:

wget http://joomlacode.org/gf/download/frsrelease/11395/45647/Joomla_1.5.7_to_1.5.15-Stable-Patch_Package.tar.bz2

Where to Unpack a Package

Both upgrade and full release packages are meant to be unpacked in the top-level directory of your Joomla website distribution. Before unpacking the package, change the directory to the top level of your site. For example, if your top level Joomla files are located in /var/www/htdocs, use this command to change to that directory first:

cd /var/www/htdocs

Unpacking Packages

You can then extract new version files over your old Joomla files:

tar xjvf Joomla_1.5.15-Stable-Full_Package.tar.bz2

Using MySQL from the Command Line

Below are some examples of using MySQL from the Unix command line. If you do not understand what these commands are for, be careful! You may want to read the MySQL documentation at the MySQL website before proceeding.

Some sample MySQL commands from the command line:

# upgrade sql via MYSQL for RC1 to RC2

mysql -utodd -Djoomladbname -p < diff_rc1_to_rc2.sql

# no changes from rc2 to rc3

# upgrade from rc3 to rc4

mysql -utodd -Djoomladbname -p < diff_rc3_to_rc4.sql

# no changes from rc4 to live release

Other Downloaded Packages

Note that the Unix tar command can unzip and unpack most file types in a single step. Also note that .zip files are not recommended for use on Unix (or Linux) systems because they lose much information about file ownership and permissions.