DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

EXT: mmsynchro

Author:Kasper Skårhøj
Created:2002-11-01T00:32:00
Changed:2009-04-28T13:11:25.700000000
Classification:mmsynchro
Keywords:forAdmins, synchronisation, backup
Author:Timo Webler, Patrick Käller
Email:kaeller@mediaman.de;
Info 4:mediaman Gesellschaft für Kommunikation mbH
Language:en

img-1 img-2 EXT: mmsynchro - mmsynchro

EXT: mmsynchro

Extension Key: mmsynchro

Language: en

Keywords: forAdmins, synchronisation, backup

Copyright 2000-2008, Timo Webler, Patrick Käller, <kaeller@mediaman.de; >

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

- a GNU/GPL CMS/Framework available from www.typo3.org

Table of Contents

EXT: mmsynchro 1

`Introduction 3 <#1.1.Introduction|outline>`_

What makes the extension? 3

`Administration 4 <#1.2.Administration|outline>`_

Remote-Verbindung. 4

CLI Funktionalität 4

`Configuration 5 <#1.3.Configuration|outline>`_

`User manual 6 <#1.4.User%20manual|outline>`_

Synchronization: Configuration 6

Execute synchronization 8

Backup 8

`Tutorial 9 <#1.5.Tutorial|outline>`_

SSH2 9

Introduction

What makes the extension?

  • The extension is a synchronization and backup solution.
  • All database table could be synchronized
  • All files in the directories fileadmin, uploads and typo3conf/ext could be synchronized
  • Synchronisation of the page tree
  • Local or remote synchronization
  • The extensions offers a Typo3 Module CLI and allows synchronization with a cronjob
  • Creation and restoration of database dumps
  • Only admin users have access to the configuration interface
  • All other backend users could start the synchronization and backup process

Administration

Remote-Verbindung.

Requires: SSH2 for PHP

Introduction:

CLI Funktionalität

For the CLI functionality you needthe user "_CLI_user“.

Parameters:

  • 1. Parameter:the configuration UID (ID of the record - see Synchronization: configuration) or"backup" (for "backup" 2nd parameter is not required)
  • 2. Parameter:definition of the synchronization process on bit (Tables: 1, Files 2, Pages: 4)
  • Ex: /server/www/typo3/cli_dispatch.phpsh mmsynchro 1 7 or/server/www/typo3/cli_dispatch.phpsh mmsynchro backup

Configuration

In the Extension Manager the path to the backup folder can be specified.

img-3

User manual

Synchronization: Configuration

For synchronization a configuration can be created. A configuration can only created or deleted by an admin.

img-4

Required fields: title, path to the log folder and the destination folder

img-5

When creating the configuration, it is possible that a database and / or a remote connection can be specified. To synchronize database tables and the page tree a database connection is required.

img-6

img-7

Remote synchronization via SSH:

Please make the appropriate configurations.

img-8 img-9

Following is the individual choice to synchronize the database tables, files and Typo3 pages on the corresponding tabs.

img-10

img-11

img-12

Execute synchronization

Therefore, choose the appropriate synchronization sources.

img-13

Backup

A non-existent configuration leads automatically to a TYPO3 error message

img-14

Creation and restoration of database dumps.It can only be imported dumps, the extension of these were created.

img-15

Tutorial

SSH2

::

Fix SSH2

LIBSSH2_APINO was removed from the public header file. You need to patch ssh2.c to work with new libssh2 versions.

ssh2.c patch:

LINE 480:
search and change following line:
#if LIBSSH2_APINO < 200412301450
...
#else

to:
#if (defined(LIBSSH2_APINO) && LIBSSH2_APINO < 200412301450)
...
#else /* if LIBSSH2_APINO is not defined its v0.14 or higher. no problem! */

LINE 1216:
search and change following line:
#if (LIBSSH2_APINO > 200503221619)

to:
#if (defined(LIBSSH2_APINO) && (LIBSSH2_APINO > 200503221619)) || (defined(LIBSSH2_VERSION_NUM) && LIBSSH2_VERSION_NUM >= 0x001000)

Compile again!

9