Upgrade Instructions

New Requirements for version 6.1

Please be aware that ADXSTUDIO CMS version 6.1 has upgraded system requirements. Microsoft .Net Framework 3.5 runtime is required to be installed on the web server. Microsoft SQL Server 2005 (or 2008) is required for the database. Previous versions of the .NET framework and SQL Server are no longer supported for use with ADXSTUDIO CMS version 6.1.

Upgrading From Previous Versions of ADXSTUDIO (versions 5.x)

If you are upgrading from version 5.x of ADXSTUDIO CMS directly to version 6.1, you must first perform the upgrade process and development changes required for version 6.0. Please see the upgrade instructions for version 6.0 then proceed with an upgrade from version 6.0 to version 6.1 using the following instructions.

Upgrading From Previous Versions of ADXSTUDIO (versions 6.0)

What You Will Need:

Microsoft .NET Framework v3.5
Copy of your License Key. This has been provided to your company upon purchase in the License Certificate

Before proceding, please ensure that all Server Requirements have been met. http://docs.adxstudio.com/adxstudio-cms-6/installation-guide

The ADXSTUDIO installer includes the newest .NET assemblies, adx virtual directory, Active Directory Extensions files, database script files, and utility applications. The default installation directory for these files is C:\Program Files\ADXSTUDIO\CMS\<version>.

Upgrading a server that is hosting ADXSTUDIO websites to the newest version of ADXSTUDIO is done by performing the following steps:

Run the ADXSTUDIO MSI installer.
- The installer will ask for your Serial Number which is your License Key. This can be found in the License Certificate sent to your company.
- The installer will by default install ADXSTUDIO to C:\Program Files\ADXSTUDIO\CMS\<version>.
- Existing websites using previous versions of ADXSTUDIO will be unaffected by running the installer for this version.
Upgrade any websites that you want to use the new version using the following instructions.

Upgrading an ADXSTUDIO website is done by performing the following steps:

It is recoomended that a complete site backup be performed simply to allow the site to be reverted back to the previous version in the unlikely event of an unsuccessful upgrade. Backup the website's SQL Server database and backup the corresponding Active Directory container. Please refer to Site Backup for instructions on how to backup the Active Directory container.
Run the database upgrade script on the SQL Server database of the website you would like to upgrade. By default, the upgrade script is installed by the ADXSTUDIO MSI installer to C:\Program Files\ADXSTUDIO\CMS\<version>\SqlScripts\. If you are upgrading from version 6.0.x, please run the Upgrade-6.0-to-6.1.sql script. If you are upgrading from a previous build of version 6.1, please run the Upgrade-6-1.sql script.
Change the website's adx virtual directory to point to the newest adx virtual directory. By default, the adx folder is installed by the ADXSTUDIO MSI installer to C:\Program Files\ADXSTUDIO\CMS\<version>\Inetpub\adx.
Replace the old ADXSTUDIO .NET assemblies (.dll files) in the website's Bin folder with copies of the new ADXSTUDIO .NET assemblies. By default, the new ADXSTUDIO framework assemblies are installed by the ADXSTUDIO MSI installer to C:\Program Files\ADXSTUDIO\CMS\<version>\Framework.
If you are upgrading from version 6.0, run the DocumentConverter utility to process the changes required in your content database to use the new version. Please note that this utility only has to be run once per CMS database. It is not necessary to run this utility on any databases that have previously been upgraded to version 6.1.

The DocumentConverter is a command line tool and needs to be run from a Command Prompt window. From the command window navigate to C:\Program Files\ADXSTUDIO\CMS\<version>\Utilities. From there, your command will look something like this:

documentconverter /server:yoursqlservername /database:yourdatabasename /siteRootDN:yoursiteDN

If you wish to see the additional command options for the document converter, simply run documentconverter from the command line without specifiying any settings. It will bring up a list of the different options.

If for some reason you run the document converter with a wrong setting, merely correct the setting and add the /clearData to the end of the command and run the document converter again.
For other breaking changes, please see the product's Release Notes.

Using the Web Console After Upgrading

It is recommended that users delete their temporary internet files prior to logging into the web console. Updated supporting files in the console that are designated as cacheable will not be downloaded until the temporary internet files are deleted. This will ensure that the next time that the web console is used, the browser will download the latest version of the files from the web server. If a user forgets to delete their temporary internet files, they will most likely see a pop up error window and the console will not be initialized. In Internet Explorer, this can be done by selecting Tools | Internet Options from the Internet Explorer menu, and clicking on the Delete Files button in the Temporary Internet files section.

Upgrading From Current Versions of ADXSTUDIO (versions 6.1.x)

Run the new MSI.
If required in the release notes, run the SQL script (Default is: C:\Program Files\ADXSTUDIO\CMS\<version>\SqlScripts\Upgrade-6.1-6.1.x.sql). Be sure to backup the databases prior to running the script. Please note that if there is a requirement to run the SQL upgrade script in a version between your current version and the one you are upgrading to, you will need to run the latest script.
Replace the old files in the site’s bin folder with the files from the new Framework folder (Default is: C:\Program Files\ADXSTUDIO\CMS\<version>\Framework)
Re-point the adx virtual directory to the new one (Default is: C:\Program Files (x86)\ADXSTUDIO\CMS\<version>\inetpub\adx)
Follow the directions above for using the Web Console After Upgrading