Difference between revisions of "Using a terminal session"

From Joomla! Documentation

(Several markup changes. URL corrections. Removed 'needs' tag.)
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
==Opening a Secure Shell (Unix Command Line)==
+
SSH (''Secure SHell'') is a means of establishing a secure command-line shell interface on a remote system.
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 <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 to which you want to connect.
+
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>
  
 
==Joomla Packages==
 
==Joomla Packages==
 
Joomla Release Packages come in two varieties:
 
Joomla Release Packages come in two varieties:
* Full Release Packages, which contain a complete set of Joomla files, and
+
* Full Release Packages that contain a complete set of Joomla files, and
* Joomla Patch Packages, which contain only those files that must be replaced to update a site
+
* 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:
+
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">wget http://joomlacode.org/gf/download/frsrelease/11395/45647/Joomla_1.5.7_to_1.5.15-Stable-Patch_Package.tar.bz2</source>
+
<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>
  
 
==Where to Unpack a Package==
 
==Where to Unpack a Package==
Both upgrade and full release packages are meant to be unpacked in the top-level directory of your Joomla web site distribution. Before unpacking the package, change directory to the top level of your http site. For example, if your top level Joomla files are located in /var/www/htdocs, use the following Unix command to change to that directory first.
+
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:
  
<source lang="bash">cd /var/www/htdocs</source>
+
<syntaxhighlight lang="bash">cd /var/www/htdocs</syntaxhighlight>
  
 
==Unpacking Packages==
 
==Unpacking Packages==
You can then extract new version files over your old joomla files:
+
You can then extract new version files over your old Joomla files:
<source lang="bash">tar xjvf Joomla_1.5.15-Stable-Full_Package.tar.bz2</source>
+
<syntaxhighlight lang="bash">tar xjvf Joomla_1.5.15-Stable-Full_Package.tar.bz2</syntaxhighlight>
  
 
==Using MySQL from the Command Line==
 
==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 used for, <b>please be careful</b>! You may want to read the mysql documentation at [http://www.mysql.org/ http://www.mysql.org/] before proceeding.
+
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:
+
Some sample MySQL commands from the command line:
  
 
<nowiki># upgrade sql via MYSQL for RC1 to RC2</nowiki>
 
<nowiki># upgrade sql via MYSQL for RC1 to RC2</nowiki>
<source lang="bash">mysql -utodd -Djoomladbname -p < diff_rc1_to_rc2.sql</source>
+
<syntaxhighlight lang="bash">mysql -utodd -Djoomladbname -p < diff_rc1_to_rc2.sql</syntaxhighlight>
  
 
<nowiki># no changes from rc2 to rc3</nowiki>
 
<nowiki># no changes from rc2 to rc3</nowiki>
<source lang="bash"></source>
+
<syntaxhighlight lang="bash"></syntaxhighlight>
  
 
<nowiki># upgrade from rc3 to rc4</nowiki>
 
<nowiki># upgrade from rc3 to rc4</nowiki>
<source lang="bash">mysql -utodd -Djoomladbname -p < diff_rc3_to_rc4.sql</source>
+
<syntaxhighlight lang="bash">mysql -utodd -Djoomladbname -p < diff_rc3_to_rc4.sql</syntaxhighlight>
  
 
<nowiki># no changes from rc4 to live release</nowiki>
 
<nowiki># no changes from rc4 to live release</nowiki>
<source lang="bash"></source>
+
<syntaxhighlight lang="bash"></syntaxhighlight>
  
 
==Other Downloaded Packages==
 
==Other Downloaded Packages==
If you have downloaded one of the other zipped types from Joomla, check out [http://www.accessdataservices.com/blog/unix-101-unzipping-files/ http://www.accessdataservices.com/blog/unix-101-unzipping-files/ ] for different ways to unzip different types of files.  Note that the <b>Unix tar</b> command can unzip and unpack most file types in a single step. Also note that <b>.zip files</b> are not recommended for use on Unix (or Linux) systems, because they lose much information about file ownership and permissions.
+
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]]
 
[[Category:Installation]]

Latest revision as of 14: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[edit]

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[edit]

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[edit]

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[edit]

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[edit]

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.