iono Documentation - Upgrading iono 2.x to iono 2.y

The upgrade process runs in exactly the same way as the installation process. The setup system will guide you through the entire process and this section of the documentation will explain each option.

Downloading iono

You need to download the latest version of iono 2.y - go to the Customer System to access your license. When you are logged in, click on the Licenses option on the sub menu to list your licenses. Find your iono license and click View.

The download packages are listed at the bottom of the page. iono is encoded to prevent piracy so you have the choice of three packages, but for the upgrade you can only choose two.

When choosing whether to use the ionCube or Zend encoded files, you need to know whether the appropriate extensions are available on your server/hosting. The ionCube Loaders will be required for the ionCube encoded files whilst the Zend Optimizer will be required for the Zend encoded files. Both the loaders and the optimizer are free and easy to install but should you have any questions, you should contact your web hosting company.

We recommend choosing the ionCube Encoded version to ensure maximum performance and compatibility.

Download Options

Uploading iono

Once you have downloaded the iono package, you need to upload the files to your web hosting account overwriting all existing files. Do not overwrite your existing includes/config.php file. Extract the downloaded archive to your local system and upload the directory using your favourite FTP client. We recommend the free SmartFTP.

Note: If you chose the Zend Encoded package, you need to upload files in binary mode in your FTP client. It does not matter which mode you upload files with if you downloaded the ionCube package.

Web Based Setup Process

To access the web based setup, use your web browser to navigate to the location where you uploaded iono. For example, if your website address is http://www.example.com and you uploaded iono into the directory called customers/, you would go to http://www.example.com/customers. You will automatically be redirected to the setup system.

If any part of this process fails or you quit, your data will be remembered and next time you access the setup, you will be returned to where you last were.

Step 1: License Agreement

iono is a commercial application and as such, you must agree to the license agreement before using the product. The agreement itself is revised and updated every so often and the latest version can always be found online. Please be sure that you have read it before choosing the I Agree option in the setup process.

Step 2: System Requirements

There are certain minimum requirements for you to use iono. These are checked during the setup procedure and you will be advised if your system does not meet those requirements. If your system meets all the requirements, click the continue link. Otherwise, you may need to speak to your web host to resolve any incompatibilities.

Step 3: Product Key

Every installation of iono requires a product key so we can verify that you do indeed have a license. This is used primarily to differentiate between free and paid licenses. Enter your license key into the field, and click Continue. Your key can be found on the View page when viewing your license details in the Customer System as explained in the section above.

Step 4: Database Settings

Here you must provide access details to your existing iono database server and the name of the existing iono database. The setup system will automatically detect the existing iono installation and inform you that it is proceeding with an upgrade when you click Continue.

Step 6: Pre-upgrade Summary

Before iono is actually upgraded, you will be provided with a summary so you can double check everything. When you are happy, click the Continue button to perform the upgrade.

Step 7: Installation Complete

If everything went fine, you will be told that setup was successful and that you now have to:

as well as being provided with links to access your upgraded iono installation.