You are viewing the documentation for Blueriq 13. Documentation for other versions is available in our documentation directory.
- Created by Terry van der Griend, last modified by Tijmen Daatselaar on Sept 15, 2021
The tool is distributed as standalone jar which should be run from the command line:
java -jar studio-migration-tool-1.1.2.jar > migration.log
Java Version
Java 11 is required to run this tool
Configuration
Configuration properties may be specified in an application.yml file in the same directory as the blueriq-studio-migration.jar. That file is used by default when running the tool.
Studio Connection
The tool uses the Management Service of Blueriq Studio so you should configure a Studio connection with authentication details:
migration: studio: url: http://localhost:93/Studio/Server/Services/ManagementService auth-type: basic | ntlm | kerberos username: admin password: welcome domain: (only used with ntlm authentication)
Studio Version
At least Studio version 12.12.3/12.13 is required. Upon running the tool it will check the Studio version to verify it is compatible.
Migration scope
You may specify for which repository/branch/project the migrations should be run. It is allowed to omit the list of projects, branches and even repositories in which case the tool iterates over all projects/branches/repositories. A complete example is provided:
migration: repositories: - name: Repo branches: - name: Trunk projects: - Project1 - Project2
Migrating Formats to Presentation Styles
This migration creates presentation styles for all used formats on the AQ_CaseList, AQ_WorkList, AQ_InstanceLinker containers and replaces all usages of formats with usages of presentation styles instead.
Target Project
All presentation styles are created in a dedicated project which is intended to be distributed as library. The details of this project should be configured as follows:
migration: r13: formats: target-project: repository: Library branch: Trunk project: Styles
If you leave out the properties above, the migration for formats will be skipped.
The migration tool does not automatically ensure that each project has a library include of this target-project, so you may see validation errors for missing presentation styles. If this is the case, ensure that the target-project is configured as library include such that its presentation styles are available.
Format splitting behavior
By default, each format is considered as a single presentation style. If you have used a convention of using spaces, commas or other characters as a delimiter for multiple styles, the migration tool can be configured with such delimiters:
migration: r13: formats: delimiters: - ","
Using the above configuration, each format is first split by a comma to obtain the individual presentation styles that will be created.
Example application.yml
Above, only snippets of the application.yml are shown. A complete application.yml file may look like this:
migration: studio: url: http://localhost:93/Studio/Server/Services/ManagementService auth-type: basic username: admin password: welcome r13: formats: target-project: repository: Kinderbijslag branch: trunk project: Kinderbijslag
An example of the log file of a successful run:
. ____ _ __ _ _ /\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \ ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \ \\/ ___)| |_)| | | | | || (_| | ) ) ) ) ' |____| .__|_| |_|_| |_\__, | / / / / =========|_|==============|___/=/_/_/_/ :: Spring Boot :: (v2.2.10.RELEASE) 2021-09-15 15:49:02.527 INFO 30032 --- [ main] c.blueriq.studio.migration.Application : Starting Application on LAP-3029 with PID 30032 (C:\studio-migration-tool-1.1.2.jar started by t.daatselaar in C:\) 2021-09-15 15:49:02.530 INFO 30032 --- [ main] c.blueriq.studio.migration.Application : No active profile set, falling back to default profiles: default 2021-09-15 15:49:05.867 INFO 30032 --- [ main] o.s.ws.soap.saaj.SaajSoapMessageFactory : Creating SAAJ 1.3 MessageFactory with SOAP 1.1 Protocol 2021-09-15 15:49:06.636 INFO 30032 --- [ main] c.b.s.m.datasources.StudioVersion : Running against Studio version 12.13.29.3705 2021-09-15 15:49:06.642 INFO 30032 --- [ main] c.blueriq.studio.migration.Application : Started Application in 5.023 seconds (JVM running for 5.816) 2021-09-15 15:49:06.644 INFO 30032 --- [ main] c.b.studio.migration.MigrationWorkflow : Running migration 'formats to presentation styles' 2021-09-15 15:49:06.669 INFO 30032 --- [ main] c.b.studio.migration.MigrationWorkflow : Migrating Repository Kinderbijslag (1 of 1 repositories) 2021-09-15 15:49:06.684 INFO 30032 --- [ main] c.b.studio.migration.MigrationWorkflow : Migrating Branch Kinderbijslag/Trunk (1 of 1 branches) 2021-09-15 15:49:06.710 INFO 30032 --- [ main] c.b.studio.migration.MigrationWorkflow : Migrating Project Kinderbijslag/Trunk/Kinderbijslag (1 of 8 projects) 2021-09-15 15:49:06.755 INFO 30032 --- [ main] c.b.s.m.r13.formats.FormatsMigration : Processing module: Interaction Module Kinderbijslag/Trunk/Kinderbijslag/Kinderbijslag 2021-09-15 15:49:07.093 INFO 30032 --- [ main] c.b.s.m.r13.formats.FormatsMigration : No formats found 2021-09-15 15:49:07.093 INFO 30032 --- [ main] c.b.studio.migration.MigrationWorkflow : Migrating Project Kinderbijslag/Trunk/Aggregate (2 of 8 projects) 2021-09-15 15:49:07.103 INFO 30032 --- [ main] c.b.s.m.r13.formats.FormatsMigration : No formats found 2021-09-15 15:49:07.103 INFO 30032 --- [ main] c.b.studio.migration.MigrationWorkflow : Migrating Project Kinderbijslag/Trunk/AquimaLibrary (3 of 8 projects) 2021-09-15 15:49:07.113 INFO 30032 --- [ main] c.b.s.m.r13.formats.FormatsMigration : No formats found 2021-09-15 15:49:07.113 INFO 30032 --- [ main] c.b.studio.migration.MigrationWorkflow : Migrating Project Kinderbijslag/Trunk/AquimaPresentationStyles (4 of 8 projects) 2021-09-15 15:49:07.124 INFO 30032 --- [ main] c.b.s.m.r13.formats.FormatsMigration : No formats found 2021-09-15 15:49:07.124 INFO 30032 --- [ main] c.b.studio.migration.MigrationWorkflow : Migrating Project Kinderbijslag/Trunk/Dashboard (5 of 8 projects) 2021-09-15 15:49:07.132 INFO 30032 --- [ main] c.b.s.m.r13.formats.FormatsMigration : No formats found 2021-09-15 15:49:07.132 INFO 30032 --- [ main] c.b.studio.migration.MigrationWorkflow : Migrating Project Kinderbijslag/Trunk/BlueriqTheme (6 of 8 projects) 2021-09-15 15:49:07.144 INFO 30032 --- [ main] c.b.s.m.r13.formats.FormatsMigration : No formats found 2021-09-15 15:49:07.144 INFO 30032 --- [ main] c.b.studio.migration.MigrationWorkflow : Migrating Project Kinderbijslag/Trunk/DCM (7 of 8 projects) 2021-09-15 15:49:07.153 INFO 30032 --- [ main] c.b.s.m.r13.formats.FormatsMigration : No formats found 2021-09-15 15:49:07.153 INFO 30032 --- [ main] c.b.studio.migration.MigrationWorkflow : Migrating Project Kinderbijslag/Trunk/AquimaTheme (8 of 8 projects) 2021-09-15 15:49:07.165 INFO 30032 --- [ main] c.b.s.m.r13.formats.FormatsMigration : No formats found 2021-09-15 15:49:07.165 INFO 30032 --- [ main] c.b.studio.migration.MigrationWorkflow : Finished running migration 'formats to presentation styles'
Want to use it?
Release notes
1.1.2 -
Bug fix:
Identifier | Issue | Solution |
---|---|---|
CSD-3835 | In some cases the migration tool clears the Selection parameter in AQ_InstanceLinker containers. | The Blueriq management service module, which is used, had an outdated model of the Studio management service. This resulted in that the AQ_InstanceLinker Selection parameter would be cleared. The model is updated such that the Selection parameter is not cleared anymore. |
1.1.1 -
- Initial public release of r12 → r13 Studio migration tool
Memory and performance
We advise to run this tool on the same server as Blueriq Studio to avoid network overhead, which may have a severe impact on the performance. For very large projects we also advise to run the tool for each repository separately and restart the Studio service in between runs, otherwise the Studio server may run out of memory causing the migration tool to fail.
- No labels
Didn't find the answer you were looking for? Try the advanced search!
1 Comment
Daniel Venema
Troubleshooting info: Studio Migration tool