Aurigma updates Customer's Canvas on a regular basis. Once a new version is released, it appears in your account in My Licenses & Downloads. You may want to test new features of the Design Editor and see how they can improve your project. This topic will help you ensure a smooth transition to the new version of the editor.
When you need to run both old and new versions of the Design Editor, run them in separate application pools.
If you customized a UI theme for earlier versions, it may become incompatible with new versions of the Design Editor.
When there are no breaking changes between the old and new versions, the upgrade process includes the following steps:
D:\inetpub\CustomersCanvas\
.cc-<new-version-number>
from the package CustomersCanvasServer.zip
to this folder.\cc-<old-version-number>\Configuration
folder:
clientConfig.json
AppSettings.config
, Aurigma.DesignAtoms.config
, FileCache.config
, and Converters.config
TemplateConfigShortcuts.json
translations.json
D:\inetpub\CustomersCanvas\cc-<new-version-number>
).Since the Design Editor introduced significant changes in versions 4.4.0, 5.0.0, 5.1.0, 5.5.0, and 6.0.0, you must perform additional steps to upgrade to these versions:
Design Editor 6.0 has stopped using systems fonts. Now, you must store all the fonts available to your users in the asset folder defined in the FontDirectory configuration parameter. In the distribution package, you can find the Font Migration Tool that helps you analyze state files, templates, and mockups and copy the system fonts used in those files to the asset folder.
To ensure that print files use the correct fonts, it's recommended to disable the font substitution feature.
FontMigrationTool
from the distribution package.App.config
file, find <appSettings> and replace the default settings with the folder paths where you store the assets.FontMigrationTool.exe
and follow the instructions.D:\inetpub\CustomersCanvas\cc-<new-version-number>
, and start your application again.To upgrade the Design Editor from 5.4 to 5.5 or more recent versions:
\Configuration\AuthSettings.config
, find:
<route name="Color convertor API" *path="api/ColorConvertor/{action}/{color}/{id}" methods="POST" authRequired="false" unsafeHttpMode ="enabled" />
<route name="Color convertor API" *path="api/ColorConvertor/{action}/{color}" methods="POST" authRequired="false" unsafeHttpMode ="enabled" />
D:\inetpub\CustomersCanvas\cc-<new-version-number>
, and start your application again.%WINDIR%\System32\inetsrv\config\applicationHost.config
with:
<serviceAutoStartProviders> <add name="CcAutoStartProvider" type="Aurigma.DesignEditor.CustomersCanvasInitialization, Aurigma.DesignEditor" /> </serviceAutoStartProviders>
D:\inetpub\CustomersCanvas\cc-<new-version-number>
, and start your application again.In Design Editor 5, assets were moved from the editor's folder to ..\assets\
. You can move them from ~\ProductTemplates
, ~\PublicGalleryFolder
, ~\UserDataFolder
, and ~\Fonts
to their new location and update asset paths in the config files. However, you can leave them where they are until further upgrades.
In Design Editor 5, the format of configuration files has changed. To upgrade earlier versions of the Design Editor to 5.0, you must either copy and paste parameters you have changed in .config
files or modify section names in your configuration files. The following instruction describes the latter way.
~\App_Data
~\ProductTemplates
, ~\PublicGalleryFolder
, ~\UserDataFolder
~\Fonts
~\bin\Aurigma.GraphicsMill.lic
~\Configuration
folder:
clientConfig.json
AppSettings.config
, VectorObjects.config
, FileCache.config
, and Converters.config
TemplateConfigShortcuts.json
translations.json
.config
files if you recovered them in the old format:
VectorObjects.config
: rename this file to Aurigma.DesignAtoms.config
and rename the root node to:
<Aurigma.DesignAtoms> ... </Aurigma.DesignAtoms>
FileCache.config
:
<Aurigma.DesignAtoms.FileCacheConfiguration> ... </Aurigma.DesignAtoms.FileCacheConfiguration>
Converters.config
:
<Aurigma.DesignAtoms.Converters> ... </Aurigma.DesignAtoms.Converters>
Web.config
if you recovered this file in the old format:
<section name="Aurigma.GraphicsMill.AjaxControls.VectorObjects" type="System.Configuration.NameValueSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" /> <section name="Aurigma.GraphicsMill.AjaxControls.VectorObjects.FileCacheConfiguration" type="System.Configuration.NameValueSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" /> <section name="Aurigma.GraphicsMill.AjaxControls.VectorObjects.Converters" type="Aurigma.GraphicsMill.AjaxControls.VectorObjects.Config.ConvertersConfigSection, Aurigma.GraphicsMill.AjaxControls.VectorObjects" />
<section name="Aurigma.DesignAtoms" type="System.Configuration.NameValueSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" /> <section name="Aurigma.DesignAtoms.FileCacheConfiguration" type="System.Configuration.NameValueSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" /> <section name="Aurigma.DesignAtoms.Converters" type="Aurigma.DesignAtoms.Configuration.ConvertersConfig.ConvertersConfigSection, Aurigma.DesignAtoms" />
<logger name="Aurigma.GraphicsMill.AjaxControls.VectorObjects.ExternalConverter" minlevel="Warn" writeTo="ExternalConverter" /> <logger name="CustomersCanvas.Licensing.License" minlevel="Info" writeTo="LicenseLogTarget" />
<logger name="Aurigma.DesignAtoms.Common.ExternalConverter.ExternalConverter" minlevel="Warn" writeTo="ExternalConverter" /> <logger name="Aurigma.DesignAtoms.Licensing.License" minlevel="Info" writeTo="LicenseLogTarget" />
<Aurigma.GraphicsMill.AjaxControls.VectorObjects configSource=".\Configuration\VectorObjects.config" /> <Aurigma.GraphicsMill.AjaxControls.VectorObjects.Converters configSource=".\Configuration\Converters.config" /> <Aurigma.GraphicsMill.AjaxControls.VectorObjects.FileCacheConfiguration configSource=".\Configuration\FileCache.config" />
<Aurigma.DesignAtoms configSource=".\Configuration\Aurigma.DesignAtoms.config" /> <Aurigma.DesignAtoms.Converters configSource=".\Configuration\Converters.config" /> <Aurigma.DesignAtoms.FileCacheConfiguration configSource=".\Configuration\FileCache.config" />
Design Editor 4.4.0 introduced the new licensing engine. You must get a new license key in your account to upgrade earlier versions of the Design Editor to 4.4.
~\App_Data
~\ProductTemplates
, ~\PublicGalleryFolder
, ~\UserDataFolder
~\Fonts
\GraphicsMill.Core\
subfolder from ~\App_Data
, if any.~\Configuration
folder:
clientConfig.json
AppSettings.config
, VectorObjects.config
, FileCache.config
, and Converters.config
(former Web.config
)TemplateConfigShortcuts.json
translations.json