Skip to content
This repository has been archived by the owner on Jul 29, 2024. It is now read-only.

SwitchVersionSh

Jump to bottom
Oliver Salzburg edited this page Mar 14, 2013 · 3 revisions

Introduction

The main purpose of switchVersion.sh is to allow for quick up-/downgrades of your TYPO3 core.

Arguments

$ ./switchVersion.sh --help
  Usage: ./switchVersion.sh [OPTIONS]

  Core:
  --help              Display this help and exit.
  --verbose           Display more detailed messages.
  --quiet             Do not display anything.
  --force             Perform actions that would otherwise abort the script.
  --update            Tries to update the script to the latest version.
  --update-check      Checks if a newer version of the script is available.
  --export-config     Prints the default configuration of this script.
  --extract-config    Extracts configuration parameters from TYPO3.
  --base=PATH         The name of the base path where TYPO3 is
                      installed. If no base is supplied, "typo3" is used.

  Options:
  --version=VERSION   The version to switch to.
  --store=PATH        Where your TYPO3 packages are stored

Overview

For general information regarding the configuration of scripts in the typo3scripts suite, please see the article about Configuration.

Command Line Parameters

  • --help

    Prints the output seen above, giving an overview of available command line parameters.

  • --verbose

    Enable verbose (more detailed) output.

  • --quiet

    Reduced verbosity (less detailed) output.

  • --force

    Perform actions that would otherwise stop execution.

  • --update

    Invokes the self-updating mechanism in this script. This will download the latest release version from the official source code repository and replace your current script.

    Note: To perform a quick check if a new version is available, run switchVersion.sh with the --update-check parameter. If a new version is found online, the following message will be printed to the standard output:

    NOTE: New version available!

    In previous versions, this check would be performed every time you run the script.

  • --export-config

    Print the default configuration of the script to the standard output.

    This allows for easy generation of a default config file, like so:

      $ ./switchVersion.sh --export-config > typo3scripts.conf

  • --extract-config

    Tries to read the database-related parameters out of the TYPO3 configuration file.

    This allows for easy generation of a base config file for other typo3scripts after you have completed your TYPO3 installation.

      $ ./switchVersion.sh --extract-config > typo3scripts.conf

    In case you're using a non-default TYPO3 installation directory, make sure to supply the --base parameter before the --extract-config parameter.

      $ ./switchVersion.sh --base=myt3site --extract-config > typo3scripts.conf

    Note: This functionality is currently not compatible with TYPO3 6.0 configuration file format.

  • --base / BASE

    By default, it is assumed that the TYPO3 installation is located in a sub-folder relative to the current working directory, named typo3. Use --base if the installation is placed in a differently named sub-folder.

      $ ./switchVersion.sh --base=myt3site 4.7.7

  • --version / VERSION

    The version of TYPO3 we should switch to.

  • --store / STORE

    The path where TYPO3 packages should be stored. By default, downloaded TYPO3 packages are placed inside the BASE directory. However, you can define a separate directory where all packages should be placed. This allows you to share the packages between multiple TYPO3 installations.

      $ ./switchVersion.sh --store=../typo3 4.7.7

Examples

Installation

/var/www$ cd t3site/
/var/www/t3site$ wget https://raw.github.com/oliversalzburg/typo3scripts/master/switchVersion.sh
/var/www/t3site$ chmod 700 switchVersion.sh

Switching to a different version

/var/www/t3site$ ./switchVersion.sh 4.6.3
Sourcing script configuration from typo3scripts.conf...Done.
Checking dependencies...Succeeded.
Looking for TYPO3 source package at typo3/typo3_src-4.6.3/...NOT found! Downloading.
Downloading http://prdownloads.sourceforge.net/typo3/typo3_src-4.6.3.tar.gz...Done.
Extracting source package typo3/typo3_src-4.6.3.tar.gz...Done.
Switching TYPO3 source symlink to typo3/typo3_src-4.6.3/...Done.
Checking if index.php needs to be updated...Done.
Deleting temp_CACHED_* files from typo3conf...Done!
Version switched to 4.6.3.

This example assumes that you previously created a configuration file typo3scripts.conf to share between scripts. Please see the article about Configuration for more information.

Clone this wiki locally