Change the path of your Bizagi project



Summary

By default Bizagi projects are created in a path located at 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 to move files and update references, to the new paths.

Applies to

Bizagi 10.x or higher

Steps

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

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.

  • 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.
  • 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


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.


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


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'
);


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

Use [master]
GO
Alter Database YourProject Set Online



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');


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


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)


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


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.


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


4.         Reconfigure Bizagi Studio

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

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.


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

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