Upgrading your project in Studio

<< Click to Display Table of Contents >>

Navigation:  Bizagi Studio > Bizagi Projects >

Upgrading your project in Studio

Overview

Bizagi generates new versions periodically which include important improvements along with great new features, as described at Bizagi versions.

We strongly recommend that you upgrade your projects to the newest release, so that you can enjoy all the benefits of new Bizagi features, enhancements, major improvements and bug fixes (maintenance).

This section details how to carry out a software upgrade of your Bizagi version.

This procedure is applicable only when upgrading to the newest minor version (while in the same major release).

 

note_pin

You must upgrade to this release from a Bizagi project already using a 11.2.0 version or higher.

If you have a lower version please contact Support.

 

This article describes how to upgrade your project in a development environment (through Bizagi Studio).

However, if you already have an operating testing and production environment, then you will need to upgrade those environments as well eventually.

It is recommended that you upgrade other environments after having upgraded the development environment and having ensured that your implementation behaves as expected.

 

Procedure

To upgrade your project to the newest release, first upgrade your Bizagi Studio installation.

If the project is configured for multiple users (in a teamwork collaboration setup), perform the Bizagi Studio and project upgrade in the central development Bizagi Server where the project is hosted.

 

note_pin

If your project was created using Windows Authentication, take into account that your user must have the same permissions explained in Creating a project using Windows Authentication.

 

1.Uninstall Bizagi Studio, using your computer's control panel option:

 

Uninstall4

 

At this point your server may ask for a reboot.

 

2. Download and install the newest version of Bizagi Studio.

 

install01

 

After the upgrade completes, reboot the server.

 

3. Upgrade your development environment project:

 

Open Bizagi Studio and open the project.

Select it from the list of projects displayed in the window:

 

OpenProject_preferences

 

If the project is not listed, select the All Projects option:

 

OpenExisting01

 

Confirm by clicking Yes when prompted about the project's upgrade:

 

UpgradePrompt

 

Coordinate with team members and alert them in advance that you will be upgrading the project.

In this way you also make sure that no other team member is currently working on the project or has Bizagi Studio opened.

 

When the upgrade is finished your project opens in Bizagi Studio.

At this point your project has been upgraded to the new version.

 

UpgradeProgress

 

Have all team members upgrade their Bizagi Studio installation.

 

At this point, you may proceed to run tests on the processes you have implemented in the development environment.

 

Review the .NET framework

Bizagi uses a .NET framework, as mentioned in the Bizagi Studio system requirements. After upgrading, you can change the framework in the web.config file, To do so, go to the project folder, usually located at:

 

C:\Bizagi\Projects\[ProjectName]\WebApplication

 

Open the web.config file, and within the <system.web> node, find the following tag:

 

<httpRuntime maxRequestLength="50000" maxUrlLength="1024" targetFramework="4.8" requestValidationMode="2.0" />

 

Make sure that the target framework is the same mentioned in the system requirements.