Migrating Remedy on-premises to BMC Helix Service Management on-premises
You can migrate from Remedy on-premises to BMC Helix Service Management on-premises by performing a fresh installation of BMC Helix Service Management and migrating data. A fresh installation of BMC Helix Service Management and data migration involves several tasks that are performed in stages. The following major tasks are involved in the migration process:
- Planning activities
- Environment setup
- Platform and applications installation
- Developmental activities, such as migrating overlays and customizations, and working on integrations
- Data migration
- User Acceptance Tests (UAT)
- Emulated cutover activities and going live
Supported migration paths
The BMC Helix Digital Workplace supported version of which you can migrate data is 20.02 and later versions.
For information about the BMC Remedy ITSM, BMC Digital Workplace Catalog, Smart IT, and Smart Reporting supported versions from which you can migrate data, see Available migration packs in BMC Helix Data Manager documentation.
Learn about the tools required for migration
The following tools or utilities are required for migrating your data from Remedy on-premises to BMC Helix Service Management on-premises.
Use these tools at the relevant stages as specified in the process:
BMC Helix Data Manager:
This tool migrates the data for BMC Helix ITSM, Smart IT, and Smart Reporting from version 20.02 to 21.x/22.x.
For more information, see BMC Helix Data Manager.Use the BMC Helix Data Manager tool to get accustomed to the migration process.
All the data migration steps can be performed on your on-premises system, except the actual import of data, which requires transferring the exported data by copying it to the FTP location provided while activating the staging servers.DWP Data Migration Export and Import Utility:
This utility is used to migrate BMC Helix Digital Workplace data from version 20.02.x to version 23.3.04.
For more information, see Migrating data by using the Export-Import utility.Workflow Migration Utility:
This utility is used to support AR System and CMDB objects.
For more information, see Migrating customized objects to a new target system.Auto-Reconciliation Utility:
This utility is used for AR System objects.
For more information, see Analyzing the manual reconciliation effort by using the reconciliation report.License Conversion Utility:
This utility converts AR System Platform and Product licenses from Classic to Bundled licenses.
For more information, see Moving to the bundled license model by using the Bundled License Conversion utility.
Supported databases
You can migrate data from the following databases:
- PostgreSQL
- Microsoft SQL
- Oracle
For more information, see System requirements.
Installation and migration process overview
The following image provides an overview of the installation and migration process:
We recommend that you complete the following stages in each environment in the specified sequence:
Environment | Stage 1 | Stage 2 | Stage 3 | Stage 4 | Stage 5 | Stage 6 | Stage 7 | Stage 8 | Stage 9 | Stage 10 |
---|---|---|---|---|---|---|---|---|---|---|
Development | ✅️ | ✅️ | ✅️ | ✅️ | ✅️ | ✅️ | ❌️ | ❌️ | ❌️ | ❌️ |
Nonproduction | ✅️ | ✅️ | ✅️ Only import the customizations and issue fixes development package that you create in Stage 6 on the development environment. Do not perform any development activity. | ✅️ Perform full data migration with latest production environment copy. | ❌️ | ❌️ | ✅️ | ❌️ | ❌️ | ❌️ |
Production | ✅️ | ✅️ | ✅️ Only import the customizations and issue fixes development package you create in Stage 7 after UAT on the development environment. | ✅️ Perform full data migration with latest production environment copy. | ❌️ | ❌️ | ✅️ | ✅️ | ✅️ | ✅️ |
Stage 1: Planning and preparing the environment
Task | Task | Action |
---|---|---|
1 | Review the deployment architecture. | Get familiar with the BMC Helix Service Management deployment architecture. |
Plan the sizing of the container environment. |
| |
Plan and set up your Kubernetes cluster. |
| |
Set up load balancer and Ingress controller. |
Set up the load balancer and Ingress controller for your cluster. | |
Set up hardware requirements for BMC Deployment Engine. | Review the Jenkins server requirements to set up the BMC Deployment Engine. | |
Prepare your deployment planning document.
| Use the Deployment assessment questionnaire and Deployment requirements checklist to prepare and track your deployment tasks, such as environment sizing, Kubernetes cluster setup, and deployment pipelines. Important: Complete the questionnaire and checklist and create a deployment plan. Or work with your Partner or BMC Professional Services team to gather the information and create a deployment plan. After you complete the plan, if you have any questions on deployment, you can ask for a session to review with BMC. | |
Prepare your implementation planning document and data migration plans. | ||
Install BMC Helix Data Manager, Developer Studio, and other client tools. | ||
Run license compliance assessment and checks. |
Stage 2: Installing BMC Helix Innovation Suite and Service Management applications
Task | Task | Action |
---|---|---|
2 | Perform a fresh installation of BMC Helix Service Management in the environment. Important:
| Perform Tasks 2 to 4b in the Installing topic. |
Stage 3: Migrating customizations, reconciling customizations, and configuring integrations
Task | Task | Action |
---|---|---|
3 | Restore to Golden Backup #1 | Restore to Golden Backup #1. |
4 | Enable Admin-Only-Mode | |
5 | Export and import customizations and overlays |
Important:
|
6 | Reconcile customizations |
|
7 | Perform any custom development work for the applications
| Perform any custom development work required for the following applications:
|
8 | Deploy your custom plug-ins | |
9 | Integrate BMC products and third-party applications
| You can integrate BMC Helix Innovation Suite with the products that you integrated with your existing on-premises environment. BMC Helix products are available to you for purchase. You can integrate BMC Helix Innovation Suite with products such as BMC TrueSight Operations Management and BMC Helix Discovery. To integrate BMC Change and Configuration Management (CCM), use Atrium integrated jobs. To integrate BMC Helix Discovery with BMC Helix, use the BMC gateway, or purchase BMC Helix Discovery and integrate it with BMC Helix. See BMC Discovery in BMC Discovery documentation. See Integrating BMC Helix CMDB with Microsoft SCCM by using an adapter in BMC Helix CMDB documentation. Important: You must redesign third-party integrations that use integration methods that are not supported. The supported integration methods are:
|
10 | Set up reporting | BMC Helix Dashboards We recommend that you use BMC Helix Dashboards for reporting. To use BMC Helix Dashboards, make sure that you have installed BMC Helix Dashboards in Stage 2. Smart Reporting If you want to use Smart Reporting, make sure that you have installed Smart Reporting in Stage 2. The supported version of Smart Reporting is 21.3.05. You can migrate your reports data in the later stages by using BMC Helix Data Manager. |
11 | Create deployment packages and create a database backup with customizations and integrations |
Best Practice: We recommend that you create a package with all your customizations and fixes. For more information about using Developer Studio to create a package, see Defining and deploying data and object packages in BMC Helix Innovation Suite documentation. Important: Make sure you stop all services and then proceed to Stage 4. Stopping the services is a prerequisite for data migration. |
12 | (Optional) Validate the fixes | If you are not starting the data migration immediately after this stage, perform the following steps in your new development environment:
Important: Allocate additional time of minimum one week for this step in your project plan. |
Stage 4: Performing initial data migration
No. | Task | Action |
---|---|---|
13 | Configure BMC Helix Data Manager and prepare for migration | Complete the following tasks to prepare for migration:
|
14 | Perform the initial BMC Helix Data Manager data migration | Perform the initial data migration for the following applications by using BMC Helix Data Manager:
Important: Create Golden Backup #2 after successful migration of the initial BMC Helix ITSM data. Then, replace this backup after successful migration of each application. You are now ready to unit test your migration. |
15 | Run license assessment and conversion | Download and run the License Compliance Utility to convert the People profile data licenses. Important: Make sure you include this activity in your project plan. See Moving to the bundled license model by using the Bundled License Conversion Utility in BMC Helix Innovation Suite documentation. |
Stage 5: Performing unit testing and fixes
No. | Task | Action |
---|---|---|
16 | Perform unit testing and fixes | Before you begin the unit testing, make sure the following tasks are completed:
Perform the following steps to complete unit testing:
|
17 | Create deployment packages for fixes and customizations | Create the issue fixes package and customization package. Make sure that you have created separate package files for the following changes:
|
Stage 6: Performing delta data migration (Emulated cutover 1)
No. | Task | Action |
---|---|---|
18 | Perform delta data migration | In your new development environment, complete the following steps to perform a delta data migration:
The delta data migration or incremental run option is not available for BMC Helix Digital Workplace, Smart IT, and Smart Reporting. You do not have to migrate data for these applications at this stage, as you completed a full migration run prior to unit testing. Important: Keep the new development environment in Admin-Only-Mode until your UAT is completed, so you can fix any issues that might occur during the UAT cycles. |
19 | Run license conversion for delta data | Run the License Compliance Utility to convert the new People profile data licenses. Important: Make sure that you include this activity in your project plan. Run the utility for all available data, and only People profile data that has not yet been converted is updated. See Moving to the bundled license model by using the Bundled License Conversion Utility in BMC Helix Innovation Suite documentation. |
| (Optional) If you are using a PostgreSQL database, use the database refresh pipeline to restore data from the development environment to QA and production environments | Use the database refresh pipeline to restore the development database Golden Backup #3 from the development environment to the QA and production environments. See Replicating-configurations-from-a-source-environment-to-a-target-environments. Important: You can use the database refresh pipeline only for PostgreSQL databases. |
Stage 7: Performing User Acceptance Tests (UAT)
No | Task | Action |
---|---|---|
20 | Restore backup
| Restore Golden Backup #1 that you took after successful completion of BMC Helix Service Management installation. |
(Nonproduction and production environment only) Import the customizations and issue fixes | Import the customizations and issue fixes development package that you create in Stage 6 on the development environment. Important:
| |
(Nonproduction and production environment only) Perform full data migration | Perform full data migration with the latest production environment copy. | |
| Or if you are using a PostgreSQL database, restore backup by using the database refresh pipeline.
| If you are using a PostgreSQL database, perform the following steps:
|
21 | Start services in full mode | Start services in full mode before you start user acceptance testing. |
22 | Perform UAT | Perform the following user acceptance tests in the nonproduction environments except the development environment: Functional UAT testing of all the applications, including all the key functional use cases. Perform the following user acceptance tests in the production environment:
Important:
Complete the tests and fix the issues found. |
23 | UAT cycles and fixes | Fix the issues on the new development environment and create packages of the fixes by using the Deployment Management Console. Then, import the packages to the production environment to validate the fixes. Best practice: We recommend that you complete the UAT cycles in the nonproduction environments except the development environment and all blocker issue fixes before you complete the testing sign-off on the production environment. |
24 | Complete sign-off | Perform the required number of UAT cycles for the scenarios that apply to you, and make sure all blocker issues are resolved to get a successful UAT sign-off.Important:
|
25 | (Optional) Apply a hotfix | If you need to apply a hotfix in between of a UAT cycle, take Golden Backup #2, apply the hotfix, and create Golden Backup #3. If you find issues in the UAT testing, take Golden Backup #1, fix the issues, and create Golden Backup #3. |
Stage 8: Performing prefinal data migration and validation
Perform steps 26 and 27 in the development environment and production environment.
If you are using a PostgreSQL database, perform steps 26 and 27 in the development environment, and then restore the Golden Backup #3 in the production environment.
No. | Task | Action |
---|---|---|
26 | Apply freeze restrictions | After the UAT sign-off, prepare for the final data migration and validation. If you were not able to freeze the activities in Step 2 of Stage 3: Performing the development activities, enable freeze restrictions on your current production system. See the To freeze changes on the current production system section in Preparing the system before migration in BMC Helix Data Manager documentation. |
27 | Perform data migration and validation | If you have applied any form, field, and workflow changes in the new development environment between Stage 3: Performing the development activities and this stage, perform the following steps:
|
Stage 9: Performing emulated cutover 2
No. | Task | Action |
---|---|---|
28 |
| Important: Measure the time required to perform the following steps. Use the same steps to prepare your go-live plan and allocate same time for each activity. Best practice: We recommend that you perform this delta migration not earlier than 8 to 10 days before the go-live stage, as there will be no testing cycle after this activity until the go-live day, where you will test the environment before the actual go-live.
Postmigration
We recommend that you do not perform any further validations or testing in the production environment after completing these postmigration steps. |
Stage 10: Performing final data migration and going live
No. | Task | Action |
---|---|---|
29 | Perform the final go-live delta data migration | Repeat the procedure described in Stage 9: Emulated cutover 2. |
30 | Go-live | Going live activities are as follows:
|