Upgrading to version 2

MachForm version 2 requires MySQL 4.1.0 or higher. If your MySQL server is older than that please upgrade MySQL before continuing.

In a brief overview, to upgrade to version 2, we're going to install another instance of MachForm in a new folder and then import all your old data to the new installation. No need to create another database for this, since MachForm upgrade script will use and adjust your current database as needed.

For these instructions below, it is assumed that your current MachForm URL is http://www.example.com/machform/

Upgrade Steps:


1. Backup

It's strongly recommended that you backup your MachForm database and files before upgrading. It's especially important to backup your data folder and all files under that folder.

The upgrade script will make database changes during an upgrade. If something goes wrong the only way to roll back the changes is if you have an up to date backup.

2. Configuration File

Extract the new MachForm archive (machform-2.0.zip) with WinZip or a similar program. In the base directory of your installation you'll find a file called config-empty.php. Open this file and fill in the required database and host variables from your old config.php file.

After all details are filled in you must rename the file config.php before continuing.

3. Upload to the server

Rename the folder into machform-new and upload the whole folder and files into your site folder.

So you will have two installation of MachForm:
1) http://www.example.com/machform/ - your old installation (version 1)
2) http://www.example.com/machform-new/ - your new installation (version 2)

4. Copy data folder

Copy the whole content of your old machform/data folder to your new machform-new/data folder.

Set the permission of your machform-new/data folder and all files under that folder to 777 (CHMOD 777).

5. Run the upgrade script

The upgrade script is located in the root of your new MachForm directory (http://www.example.com/machform-new/upgrade.php).

Run the upgrade script via your browser and follow the instructions on screen.
Delete upgrade.php and installer.php script when upgrade process is complete.

6. Test your new MachForm

Your new MachForm should be up and running now.
Login to your new MachForm (http://www.example.com/machform-new/) and take a few moments to go through your installation and confirm it is running correctly.

7. Delete your old MachForm

If everything seems to be running correctly, delete your old MachForm folder and then rename your new MachForm folder to be your actual machform.

That's it! The upgrade is now complete. Your MachForm installation is successfully upgraded. Enjoy!