Saurus CMS version converter 3 to 4

By Saurus www.saurus.info

About

This is README file for Saurus CMS version converter script. Script converts Saurus CMS based website between two version generations - from version 3.5.x to 4.x.
Please read these instructions carefully before starting a conversion process.
You may run conversion only if you have a valid software assurance agreement.

Requirements

  1. Old website with Saurus CMS version 3.5.0 or later - source site.
  2. New freshly installed website with the latest Saurus CMS version target site. You may use Saurus CMS Trial license for setting up a new default installation.
  3. Conversion scripts convert.php, addprefix2dump.sh, addprefix2dump.exe
  4. Default 4.2.0 database file default_db_4.2.0.sql

How To Convert

Step 1 - export database of the source site

Source site: create database dump file:
$ mysqldump -u<username> -p --default-character-set=latin1 --skip-opt -Q <ver3db> > ver3.dump
Note: Use parameter "--skip-opt" only in MySQL 4.1 and later, otherwise remove it.


Step 2 - import database into the target site

2A If created dump file size is > 50 MB and you have linux shell access to server
  1. Run shell command that creates a new dump file "new_ver3.dump":
    $ bash ./addprefix2dump.sh ver3.dump
  2. Import dump file "new_ver3.dump" into the target site database:
    $ mysql -u<user> -p --default-character-set=latin1 <ver4db> < new_ver3.dump
2B If created dump file size is > 50 MB and you don't have shell access
  1. Run windows executable addprefix2dump.exe and convert your database dump.
2C If created dump file size is <= 50 MB (exact limit depends on your server settings)

Proceed with Step 3


Step 3 - copy files

  1. create a new folder "ver3" under target website root folder
    $ mkdir ver3
  2. copy database dump file and the following folders from source site to the target site:
  3. Source siteTarget site
    ver3.dump=> ver3/ver3.dump (skip it if you passed step 2A)
    failid/=> ver3/failid/
    classes/smarty/templates/=> ver3/templates/
    px_custom/*=> px_custom/*
    Sample: $ cp -a /path/to/sourcesite/failid/ /path/to/targetsite/ver3/
  4. copy conversion script "convert.php" to the target website root folder
  5. copy database dump "default_db_4.2.0.sql" to the target website "admin/updates" folder


Step 4 - run conversion

  1. Open "convert.php" in the browser, eg http://www.yoursite.com/convert.php. Follow instructions on the screen.
    NB! Check also system information displayed in the Step 1, you may need to increase PHP settings.
  2. When viewing conversion results in Step 3, search for string "error" to be sure in conversion accuracy.


Step 5 (optional) - site encoding conversion

In case your website encoding is not UTF-8, we suggest to convert site content to the UTF-8 encoding.


Step 6 - delete conversion files

  1. Delete file "convert.php"
  2. Delete file "admin/update/default_db_4.2.0.sql"
  3. Delete folder "ver3/"


Step 7 - enter a license

Log in to the admin/ environment and enter a correct site license key.





Notes

Deprecated or missing features in version 4

Version history

Version 1.0 / 30.11.2006

Initial beta release

Version 1.1 / 14.12.2006

Version 1.2 / 15.12.2007

Version 1.3 / 14.07.2008

Version 1.4 / 17.12.2008

Version 1.5 / 31.10.2008

Version 2.0 / 30.07.2009

Known bugs