Using a terminal session: Difference between revisions

From Joomla! Documentation

Gare (talk | contribs)
No edit summary
Cmb (talk | contribs)
Several markup changes. URL corrections. Removed 'needs' tag.
 
(11 intermediate revisions by 4 users not shown)
Line 1: Line 1:
==Using SSH==
SSH (''Secure SHell'') is a means of establishing a secure command-line shell interface on a remote system.
SSH, which stands for "Secure SHell", is a means of obtaining a secure command-line interface on a remote server host.


On Linux you can open a terminal window then enter the command <tt>ssh -l <username> <host></tt> where <username> should be replaced with your actual username and <host> by the domain name or IP address of the host you want to connect to.
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 [http://www.chiark.greenend.org.uk/~sgtatham/putty/ PuTTY terminal emulator].
On Microsoft Windows you can use the [https://www.chiark.greenend.org.uk/~sgtatham/putty/ 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:
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:


<source lang="bash">ssh -l goliath www.mydomain.com</source>
<syntaxhighlight lang="bash">ssh -l goliath www.mydomain.com</syntaxhighlight>


Unzip the bz2 package:
==Joomla Packages==
<source lang="bash">bunzip2 Joomla_1.5.1-Stable-Full_Package.tar.bz2</source>
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


to get the tarball. To extract new version files over old joomla files:
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:
<source lang="bash">tar xvf Joomla_1.5.1-Stable-Full_Package.tar</source>


Some sample MYSQL commands from the command line:
<syntaxhighlight lang="bash">wget http://joomlacode.org/gf/download/frsrelease/11395/45647/Joomla_1.5.7_to_1.5.15-Stable-Patch_Package.tar.bz2</syntaxhighlight>
#upgrade sql via MYSQL for RC1 to RC2
> mysql -utodd -Djoomladbname  -p < diff_rc1_to_rc2.sql
#no changes 2 to rc3
>  
# rc3 to rc4
> mysql -utodd -Djoomladbname  -p <  diff_rc3_to_rc4.sql


# no changes 4 to live
==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:
 
<syntaxhighlight lang="bash">cd /var/www/htdocs</syntaxhighlight>
 
==Unpacking Packages==
You can then extract new version files over your old Joomla files:
<syntaxhighlight lang="bash">tar xjvf Joomla_1.5.15-Stable-Full_Package.tar.bz2</syntaxhighlight>
 
==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 [https://www.mysql.com/ MySQL website] before proceeding.
 
Some sample MySQL commands from the command line:
 
<nowiki># upgrade sql via MYSQL for RC1 to RC2</nowiki>
<syntaxhighlight lang="bash">mysql -utodd -Djoomladbname -p < diff_rc1_to_rc2.sql</syntaxhighlight>
 
<nowiki># no changes from rc2 to rc3</nowiki>
<syntaxhighlight lang="bash"></syntaxhighlight>
 
<nowiki># upgrade from rc3 to rc4</nowiki>
<syntaxhighlight lang="bash">mysql -utodd -Djoomladbname -p < diff_rc3_to_rc4.sql</syntaxhighlight>
 
<nowiki># no changes from rc4 to live release</nowiki>
<syntaxhighlight lang="bash"></syntaxhighlight>
 
==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.
 
[[Category:Installation]]

Latest revision as of 19:06, 30 November 2022

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.