READ THIS FIRST: Overview of changes in version 2.2

Read the breaking changes for the version 2.2 and then prepare an upgrade plan.

Then, do all the following - if it applies on your GN4 system - BEFORE you start the upgrade!

ON THE SERVERS AND CLIENTS

•Provide to install the .Net Framework 4.5.2 and run-time libraries for VS 2013 on all GN4 servers and workstations. Moreover, on the workstations of the users who maintain the scripts and compile them, install the Visual Studio Express 2013. The full list of prerequisites is in System Prerequisites, and the full list of the required downloads is in Download version 2.2 released for the server and in Download version 2.2 released for the client (if not using ClickOnce).

•Install the color profile ISOnewspaper26v4_gr.icc. For download, see http://forum.teradp.com/topic.asp?whichpage=0.58&TOPIC_ID=381&#3998.

ON THE SERVERS

•On the server, import a new categoryset::

srv4 config in config\Global\PermissionsSets.xml

You can do this also before updating database to 2.2.

Update your editorial_updateconfig.xml with this line (for the future updates to the same version):

<ConfigFile>Global\PermissionsSets.xml</ConfigFile>

•The workflow wf_CropImg.xml (which crops an editorial image) has been removed from the configuration files. This is because the standard wf_Crop.xml workflow is now able to manage both gn4:image (wire image) and gn4:img (editorial image). In the standard addins and configuration files, the calls to the old wf_CropImg.xml workflow have been replaced by calls to wf_Crop.xml. So, if you have custom methods which calls the old wf_CropImg.xml workflow, you can replace them with wf_Crop.xml. The standard addins that have been modified are: TedSystemAddIn and FredSystemAddIn. The configuration files that have been modified are: shell4_tabItems.xml, fred4_tabItems.xml and ted4_tabItems.xml.

•Install the color profile ISOnewspaper26v4_gr.icc. See http://forum.teradp.com/topic.asp?whichpage=0.58&TOPIC_ID=381&#3998.

•Compare your ServerConfig and your EditorialConfig with the respective files of the version 2.2. and add the missing keywords to enable the new functionalities.

•When installing I4 or GNPortal, make a backup of the BIN folder, and then empty it, except the spell-checker files. Copy the new 2.2. files in. This avoid the problem with article editor in I4, that can display the exception Cannot find a script or an extension object associated with namespace http://www.teradp.com/schemas/GN4/1/EditorialXslt', displayed in red letters in the article editor's status bar. This happens when the BIN folder was not emptied of the 2.1 files except the spell-checker files. It regards especially the files I4EditorialServer.dll and I4AdobePlugin.dll that have been removed.

ON THE CLIENT OR SERVER YOU USE TO COMPILE ADD-INS

To be able to compile add-ins, do the following:

oDownload and install the .NET Framework 4.5.2 multi-targetting pack (382Mb). Visual Studio Express 2013 will prompt you on the first access to download the .NET Framework 4.5.2 multi-targetting pack. The link is https://www.microsoft.com/en-us/download/details.aspx?id=42637

oIn all your custom add-ins change the version of the .NET Framework to 4.5.2. To do it, right click a project, click Properties, and on the Application tab, under Target framework, select the .NET Framework 4.5.2. Repeat the same for all custom projects.

oIn all VB files of your custom add-ins, make sure that the list of imports on the beginning of the file corresponds to the list of imports in the relative system add-in, e.g.