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
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.
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
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 MyProject 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:
|
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.
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:
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 Automation Server.