How to change the path of your Bizagi project

<< Click to Display Table of Contents >>

Navigation:  Bizagi Studio > How To´s > Useful how-to's >

How to change the path of your Bizagi project

Overview

By default Bizagi projects are created in a path located as C:\BizAgi\...\Projects\.

In this path, all information regarding the processes, the data model, forms, rules, performers and integration is stored and referenced.

 

If you wish to change the default path of your project in the development environment (while in automation stages of the project), follow the next steps in which files are moved and references are updated to the new paths.

 

 

What you need to do

In order to change the location of your project, you will need to perform the following steps:

 

1.Move the project's folder

2.Update database references

3.Reconfigure the Work portal

4.Reconfigure Bizagi Studio.

 

Procedure

As an example, we will use the process created in My First Process to illustrate how the path of a project is changed.

 

1.Move the project's folder

The first step is to move the physical location of the project, but for this you will need to uninstall the Scheduler service which has an explicit reference to the original path.

For this, follow these steps:

 

1.1 Run a command prompt with administrator privileges.

 

1.2 Navigate to the %SystemDrive%\Bizagi\Projects\[YourProject]\Scheduler folder, and run

BizAgi_YourProject_Scheduler_Service_UnInstall.bat

 

UninstallScheduler_fix

 

1.3 Copy the entire folder (retaining its inner structure) of your project (located at path %SystemDrive%\Bizagi\Projects\), and paste it into the new path.

In our Example, this path will be at E:\BizagiProjects\, and it will be referred to as [NEW_PATH] from this point on.

Remember you need to have Administrator Privileges in order to perform this action.

 

CopyProject

 

note_pin

If you are using a local SQL Server instance, then your database files are stored in: .\Database\.

You will need to temporarily stop your database services in order to move files in this folder.

 

note_pin

It is a best practice to create backups of your project as a contingency measure (in order to be able to roll back if the procedure fails).

 

1.4 Once you have moved the entire folder, you may reinstall the Scheduler service.

To do this, open a command prompt and, in: [NEW_PATH]\[YourProject]\Scheduler, run

BizAgi_YourProject_Scheduler_Service_Install.bat

 

Started

 

2.Update the database references

This step is only mandatory if you are using a Microsoft SQL Server Database and if the .\Database\ folder inside your project path contains the following database files: [YourProject_dat].mdf and [YourProject_log].ldf.

If you are using Oracle or your database files are not located in this path, skip this step and proceed to Step 3.

 

ContainsDatabase

 

2.1 Run the following script to set your database offline (you may use Microsoft SQL Server Management Console to do this):

Use [master]

GO

Alter Database YourProject Set Offline

 

DatabaseOffline

 

2.2 Run the following script to reference your database files in their new path:

Alter Database YourProject

Modify File (

         Name='MyProject_dat'

         ,FILENAME='[NEW_PATH]\YourProject\Database\YourProject_dat.mdf'

);

 

Alter Database YourProject

 Modify File (

         Name='MyProject_log'

         ,FILENAME='[NEW_PATH]\YourProject\Database\YourProject_log.ldf'

);

 

ModifyDatAndLog

 

2.3 Run the following script to set your database back online:

Use [master]

GO

Alter Database MyProject Set Online

 

DatabaseOnline

 

You may verify that the database files are correctly referenced in their new path by running the following script:

USE YourProject

GO

Select name, physical_name, state_desc

From YourProject.sys.master_files

Where database_id = DB_ID(N'YourProject');

 

VerifyQuery

 

3.Reconfigure the Work portal

Reconfigure the Work portal by using the Internet Information Services Manager.

To do this, you may use the Run option. Type:

inetmgr

 

Run_inetmgr

 

3.1 Expand the tree located in the left panel and locate your project's web site.

Click on the Advanced Settings... (to navigate here, right click on your project's web site icon and select Manage Application):

 

AdvancedSettingsIIS

 

Note that this option is also available at the right panel after you click on your project's web site:

 

ActionsPanel

 

3.2 In the Advanced Settings dialog box, update the value of the Physical Path so that it references [NEW_PATH]\YourProject\WebApplication.

Click OK to save changes.

 

AdvancedSettingsWindow

 

3.3 Restart your IIS services.

Once reconfigured, restart the IIS and its services either from the options using the IIS Manager or by opening a command prompt (with administrator privileges) and running:

iisreset

 

iisreset

 

 

4.Reconfigure Bizagi Studio

Locate your project in its new path, and make sure you carry out the following:

 

note_pin

These steps apply as well to reconfigure the settings involved for Bizagi Management Console.

 

4.1 Update the projects configuration file located at %SystemDrive%\ProgramData\Bizagi\BizAgiProjects.xml.

Note that the SystemDrive folder might be hidden (by default) in your operative system. (To display it, make sure you enable the display hidden files option).

 

Find and replace the old path (%SystemDrive%\Bizagi\Projects\) with the [NEW_PATH] of your project.

 

ReplacePath

 

4.2 Finally, restart the service called Bizagi Server Operations service so that Bizagi Studio or the Management Console make the appropriate changes.

You may do this from the Windows' services console by locating this service and choosing the start or restart option:

 

BSSOService

 

Important

It is recommended always to test and verify that your project behaves as expected.

Once you have moved the project, run checks for the Work portal, Scheduler service and other features such as the Component library, localization, or traces.

If you need to move your production server or the path used by the production environment project, refer to the system administration chapter for Bizagi Engine.