Path

7x / documentation / ez publish / technical manual / 4.3 / installation / extensions / extracting the files


Caution: This documentation is for eZ Publish legacy, from version 3.x to 6.x.
For 5.x documentation covering Platform see eZ Documentation Center, for difference between legacy and Platform see 5.x Architecture overview.

Extracting the files

Each extension is distributed as a compressed archive. The name of the archive file includes the name of the extension and its release version. Furthermore, the compression type is indicated by the file ending, either "tgz", "tar.gz", "bz2", or "zip". For example:

  • ezfoo-extension-1.0.tgz
  • ezfoo-extension-1.0.tar.gz
  • ezfoo-extension-1.0.bz2
  • ezfoo-extension-1.0.zip

Windows users should download the "zip" archive. Linux/UNIX users may download any archive format as long as the necessary unpacking tools are available.

Extension base directory

Copy the downloaded archive into the "extension" directory of your eZ Publish installation. If this directory does not exist yet, then create it. (Do not create the directory with the plural naming "extensions" - this is a common error.)

The following shell commands can be used to create the "extension" directory and copy the archive on a Linux/UNIX system:

mkdir /opt/ezp/extension/
cp /home/myuser/download/ezfoo-extension-1.0.tar.gz /opt/ezp/extension/

Replace "/opt/ezp/" with the actual path to your eZ Publish installation and "/home/myuser/download/ezfoo-extension-1.0.tar.gz" with the actual path to the downloaded archive.

Unpack the archive

The archive should be unpacked inside the "extension" directory. When done correctly, an "ezfoo" directory will be created inside the "extension" directory.

See the following table for the correct shell command to use on a Linux/UNIX system, depending on the compression type:

Archive type

Command to extract

tar.gz or tgz

tar -zxvf ezfoo-extension-1.0.tar.gz

or

tar -zxvf ezfoo-extension-1.0.tgz

bz2

tar -jxvf ezfoo-extension-1.0.bz2

zip

unzip ezfoo-extension-1.0.zip

On Windows, you can just unzip the "zip" file using the built-in zip features.

At this point, the unpacked files should be available under "extension/ezfoo".

Sandro Groganz (14/09/2010 7:43 am)

Geir Arne Waaler (24/09/2010 9:27 am)

Sandro Groganz, Svitlana Shatokhina, Geir Arne Waaler


Comments

There are no comments.