Migration process for Remedyforce to BMC Helix Innovation Suite Cloud

Starting from version 21.x, the converged platform environments which are activated in Helix cloud consist of the following applications, which are now a part of BMC Helix Innovation Suite of products:

  • BMC Helix ITSM
  • Smart IT
  • BMC Helix Digital Workplace
  • BMC Helix Digital Workplace Catalog
  • BMC Helix Dashboards

The migration of Remedyforce system to a BMC Helix Innovation Suite Cloud (BMC Helix ITSM SaaS) system involves several tasks that must be performed in phases. After BMC completes the provisioning of the development, QA, and production environments, the major tasks involved in the migration process include:  

  • Activation tasks
  • (Optional) Development activities, such as any new development work and working on integrations
  • Data Loading/Onboarding

    • The forms involved for mapping and loading the data are mentioned in Stage 5: Create mappings section. You can review the Mapping Foundation and CMDB data topic before you continue with this process.

      Important

      As part of this process, onboarding and/or data loading of CMDB and ITSM Foundation data is supported.
      Loading of Transactional data is not supported and is not in scope.

  • User Acceptance Tests (UAT)
  • Go Live


Prerequisite

We recommend that you have an understanding of the following technologies and tools to successfully perform the migration:

  1. Remedyforce knowledge to extract data.
    For more information, see  Data Export Service Page Open link .
  2. Data Management Console (DMT) knowledge to populate the spreadsheets and load/onboard the data.
    For more information, see Stage 4: Preparing for data load.


Planning the migration

Complete the following tasks before the start of the migration process:


Prepare documents required for planning your migration project

  • Make sure that you have an implementation planning document that includes details of the development work you are planning to do. The document must also include the Foundation and CMDB data onboarding details.
  • Make sure you have a project plan that includes all the tasks and activities to be performed by you and the BMC team.


Stage 1: Activation - Environments provisioning

No.

Task

Action

1.

Activate required systems and BMC Helix installations.

BMC initiates the activations for the following systems and services required for your migration after your ordering process is complete:

  • Systems
    BMC activates the following environments with the updated versions of BMC Helix ITSM and the BMC Helix applications purchased by the customer.
    • Development (with Admin access)
    • QA
    • Production
  • Email services
    • BMC configures one inbound and one outbound email server for each environment.
    • After the activation is complete, BMC sends you an email with the environment and access details for the products you purchased.
    • To view a sample of the email sent after activation of the environments, save and view the Activation Email. The email you receive includes the system details for your activated environments.
  • Permanent FTP
    • BMC provides a permanent FTP setup or location for you to place files related to integrations.
      For more information, see File transfer process.

Important:

  • Partners must review the complete list of the BMC Helix products purchased by the customer and validate that these applications are available in the activated systems.
  • Ensure that you complete the registration on BMC Support Central after completing your ordering process.

2.

Install Developer Studio, and other client tools on the Remedyforce system as needed.

While your BMC Helix environments are being activated, download and install the latest version of Developer Studio on your Remedyforce system:

3.

Create realm entries and configure your SAML and Active Directory (AD) authentications.

Configuring SAML:

We recommend that you create a realm for SAML authentication, and configure the general details for the realm. Obtain the necessary information from the IdP administrator and then configure SAML authentication.

For more information, see  Importing configuration from an identity provider and configuring SAML Open link .

Configuring Active Directory:

After you configure BMC Helix SSO as a service provider and Active Data Federation Services (AD FS) as the remote identity provider (IdP) in BMC Helix SSO Admin Console, you can configure SAML for AD FS.

For more information, see  Configuring Active Directory Federation Services as a SAML identity provider Open link .


Stage 2: Activation - Lifecycle requests

No.

Task

Action

1.

Lifecycle request: Create Configure the client gateway

  1. Create a lifecycle request and support tickets to configure the client gateway required for the following scenarios:

    1. Initial client gateway setup
      Create a BMC Client Management Gateway Connectivity lifecycle request and attach the completed BMC Helix Client Gateway request form to the request.
      This includes:
      • The BMC team configuring the Client Gateway server by using details provided in the client gateway request form provided with the request.
      • Installing the client gateway software on your Remedyforce systems.
        For more information about installing the client gateway software, download the BMC Helix Client Gateway Installation Guide available at BMC Helix Client Gateway connectivity.

    2. Client tool connectivity configuration
      The BMC team configures the connectivity between client tools Remedyforce and your BMC Helix SaaS systems. You should be able to verify your connectivity by using the client tools.

For more information, see the following topics:

2.

Lifecycle request: Request for Authentication Integration configuration (Single-Sign On configuration) 

Create a lifecycle request to have the external authentication configured with one of your preferred authentication sources:

  • Security Assertion Markup Language (SAML) V2.0 using Active Directory Federation Services (ADFS) 2.0 or 3.0
  • SAML V2.0 using a third-party product (for example, Ping Identity, Shibboleth, and so on).

For more information, see the following links in the BMC Helix Subscriber documentation:

3.

Lifecycle request: Set up permanent FTP set up for integrations 

Create a lifecycle request for an additional permanent FTP setup to transfer data related to integrations.

For the lifecycle request for File Transfer Directory, select your environment from the list.

For more information, see the following links in the BMC Helix Subscriber documentation:


(Optional) Stage 3: Development activities

Perform the activities mentioned in this stage only if you want to develop custom applications or integrate third-party or other BMC applications.

Important

Package and deploy all configuration, environment changes or fixes applied on the development server during any phase of the migration to all your BMC Helix environments. 

  • Perform this activity after every database restore, unit testing, UAT, and your final UAT.
  • If you do not apply these changes to all environments, create a request to reapply these changes after every database restore. Track these requests so that data from existing requests can be used as a reference for the changes to be applied.


No.

Task

Action

1.

Perform custom development changes for the BMC Helix applications

Perform custom development work needed for:

  • AR System Server Open link
  • BMC Helix ITSM Open link
  • BMC Helix Digital Workplace Open link
  • BMC Helix Digital Workplace Catalog Open link
  • BMC Helix ITSM: Smart IT Open link
  • BMC Helix Dashboards Open link

2.

Configure third-party or other BMC applications integrations

You can integrate the BMC Helix ITSM system with your existing Remedyforce integrations that are supported in BMC Helix version 21.3. These integrations can include BMC TrueSight Operations Management, BMC Helix Discovery, and so on.

  • For integrations that require client gateway (Support tickets)
    Create a support ticket to configure the ports for your integrations. You can create single or multiple tickets depending on the integration information available. The BMC team configures the ports for your integrations.
  • To configure the BMC Change and Configuration Management (CCM) integration, use Atrium integrated jobs. 
  • Integrate BMC Helix Discovery with BMC Helix by using the BMC gateway, or purchase BMC Helix Discovery and integrate it with BMC Helix.
    For more information about integrating BMC Helix Discovery, see BMC Helix Discovery activation.
  • Other BMC Helix applications
    • BMC Helix products are available for customers to purchase. These services can be integrated with BMC Helix Innovation Suite.
      For more information see:
      • BMC Virutal Chat Open link
      • Installing BMC Service Resolution for TrueSight Infrastructure Management or ProactiveNet Open link
      • Installing BMC Atrium Core Web Services components Open link
      • BMC Atrium CMDB extensions overview Open link
      • BMC Atrium CMDB SCCM Adapter guide Open link
      • BMC Helix Client Management service Open link

For more information about the available products, see Integrations. 

3.

Create deployment packages and request database backup with customizations and integrations

Create a support ticket to have Golden Backup 1: Customizations/Fixes No Data.

This backup is your Golden Backup #1 with the base data and customizations and integration information.

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 Open link in AR System documentation.

Stage 4: Preparing for data load

No.

Task

Action

1.

Review the documentation of Data Management to get an overview and understand the required configurations and steps to perform the data loading



See the following links for the overview and configuration of the Data Management console:

  • DMT Overview (End to End Steps)
    • Overview of the data load process Open link
  • DMT Configuration
    • Configuring Data Management Open link
    • Error rendering macro 'link-window'

      Failed to transform the HTML macro template for display. Nested message: The XML content could not be parsed. There is a problem at line 4, column 55. Parser message: Unexpected character '=' (code 61) (expected a name start character) at [row,col {unknown-source}]: [4,55]

    • Configuring Data Management application preferences Open link

2.

Download the data load spreadsheets

Locate and download the dataload spreadsheets.
For the steps, see Locating and managing the dataload spreadsheets Open link .

For the Foundation data, download the following spreadsheets:

  1. Company.xlsx
  2. PeopleOrg.xlsx
  3. Location.xlsx
  4. Operational Catalog.xlsx
  5. SupportGroup.xlsx
  6. People.xlsx
    For more information, see Foundation data mapping Open link .

For the CMDB data, download the following spreadsheets:

  1. Transactional_CI_Express.xlsx
  2. Transactional_Asset.xlsx


Stage 5: Create mappings

No.

Task

Action

1.

Populate the dataload spreadsheets with the mapping data

You must populate the downloaded dataload spreadsheets with the mapping information.

Export the data from the Remedyforce system and map the exported data into the dataload spreadsheets according to the correct forms.

For steps on populating the dataload spreadsheets, see Mapping Foundation and CMDB data.


Stage 6: Data load/onboarding

No.

Task

Action

1.

Onboard and load data by using the Data Management Console

Load the data from the dataload spreadsheets into the BMC Helix Innovation Suite Cloud system by using the Data Management Console:

  1. Open the Data Management Console.
  2. Create a new job.
  3. Select the company.
  4. Select the OOTB templates.
  5. In the Load step, attach the dataload spreadsheets created in Stage 5.
  6. In the Validate step, enable the Create Only flag for all the Foundation and CMDB data.
  7. Save the job.
  8. On the Promote step for dataload job, enable the Enable Wait option.

    Warning

    • After you load all the Foundation data into the target forms, you cannot modify the data.
    • You must enable the Enable Wait option on the Promote step of the data load job. This option loads the data into the load forms and not directly to the target forms. You can review and validate the data by using this option. After you modify or confirm the data, disable the Enable Wait option to promote the data to the target forms. 
    • If you want to modify the Foundation data and you have not enabled the Enable Wait option, and the data is pushed to target, and then you have to delete the data and run the dataload job again.
    • You can modify the People data in the People spreadsheets. However, to modify the people record, create a new spreadsheet with new details, and run the dataload job.

  9. Perform these steps for each dataload spreadsheet.
  10. Run the job.

We recommendation to run a job with Enable Wait set on the promote step and to validate the data in the load form. This helps you review the data in the load form so you can determine the data you want to  promote to the target form.

If the data is not accurate, then you can simply fix the spreadsheets and  run a new job to load the data the same way to the load form and the data will not be duplicated as each data loaded will have a job ID reference. Therefore, you can run multiple jobs to load corrected data to the same form multiple times without worrying about duplicate data and/or cleaning up the data. This is only possible if you run the job with the Enable Wait set to promote step.

After you have done a few revisions as needed with the above approach and the data for that form in your spreadsheet is accurate then that is considered as your Golden Spreadsheet for that form and now you will create a new job to load that data to the target form without setting Enable Wait on the promote step.

We recommend creating Golden Spreadsheet for all your forms.

Use the Golden Spreadsheets to run jobs and load data to the QA and/or production environments as needed. This is also helpful if you revert your database to an earlier state.


Important:

If you run a job without setting the Enable Wait parameter on the Promote step and the data is already in the target forms, then if you need to correct the data, revert back to Golden backup 1 described in the Step 3 of Stage 3.

For detailed steps about crating and running the dataload jobs, see Data creation and updates using a dataload job Open link .

2.

(Optional) CMDB data correction or modification 

If you want to correct or modify the CMDB data after you have already loaded data in CMDB forms, we recommend you to run a purge reconciliation job first to delete the data and run a new job to load the corrected data.

For information about purging CIs that are not required in any dataset, see Deleting CIs from a dataset by using the Delete activity Open link in BMC Helix CMDB documentation.

3. 

Create a golden backup

Create a ticket to create Golden Backup #2 after the successful load of your Foundation and CMDB data.

You are now ready to unit test your migration.


Stage 7: Perform unit testing and fixes

No.

Task

Action

1.

Perform unit testing and fixes

Before you begin the unit testing, make sure the following tasks are completed:

  • All development tasks including:
    • Creation of deployable data packages with issue fixes and database backup with the migrated data
  • Initial data load/onboarding.

Complete the following steps to complete unit testing:

  1. Disable the Quiet mode on the development server.
  2. Perform unit testing on the development server.
  3. Fix any functional issues.
    Important: Make sure you maintain a record of the fixes made during the unit testing.
  4. For Action Request System (AR System) objects, use the Deployment console to export and create the packages. 
  5. After you complete unit testing, create a support ticket to restore to Golden Backup #2 in Quiet mode.
  6. Apply the fixes found during unit testing.
  7. Create a support ticket to replace the existing Golden Backup #2 and restart the system in Quiet mode.
  8. After completing the unit testing, create a support ticket to restore Golden Backup #2 to your BMC Helix QA and production environments.


Stage 8: User Acceptance Tests (UAT)

No.

Task

Action

1.

Perform UAT

Create a support ticket to deploy Golden Backup #2 with the fixes to your BMC Helix QA and Production environment.
Important: Make sure you include this activity in your project plan. 
It is recommended that you perform the following user acceptance tests:

  • QA environment
    • Functional UAT testing of all the applications, including all the key functional use cases for UAT sign-off
    • Define planned UAT cycles with customers or partners
  • Production environment
    • Functional UAT testing of all the applications
    • Integration testing
    • (Recommended ) Plan and execute load and performance tests
    • Create support tickets to enable monitoring services and capture all the logs from the respective teams. Share the findings on performance, latency, spikes, and other issues during this activity with BMC.
      Important: Make sure you include this activity in your project plan. Complete the tests and fix the issues found. 

2.

Complete UAT cycles, fixes, and sign-off

Fixing issues
Use one of the following options to fix the issues that you find during your UAT cycles:

  • Fix the issues on the development server and create packages of the fixes by using the Deployment Management Console. Then, import the packages to the BMC Helix QA and production environments to validate the fixes. For more information about using the Deployment Management Console to create a package, see Importing and exporting a package.
    You might need to add multiple cycles to your project plan to complete all the testing, fix all blocker issues, and get a sign-off for exiting Stage 8: User Acceptance Tests (UAT).

    UAT 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:
  • Include the required number of UAT cycles in the project plan to complete testing and fixing all issues. Customers or partners must sign off on the UAT phase before moving to go-live preparation activities. 
  • We recommend that you start Stage 9: Go-live activities only after a sign-off with an understanding that pending open issues will only be worked on after go-live.
  • Create packages and deploy all application or environment changes found or fixes applied during any phase of the migration on all your environments. If you do not apply these changes to all environments, requests need to be created to reapply these changes after every database restore. We recommend that you track these tasks so that data from existing requests can be used as a reference for the changes to be applied.
  • Create packages for all fixes developed by you or BMC.


Stage 9: Go-live

No.

Task

Action

1.

Go-live

Going Live tasks should include the following:

  1. Internal communication with cutover details
  2. Close down of your Remedyforce instance
  3. Health check assessment of the production database.
  4. Smoke tests of the environments and functionality validation
  5. Go-live

Seven to ten days before going live, create the Salesforce ticket for Health check assessment of all the BMC Helix Innovation Suite of products. 

Was this page helpful? Yes No Submitting... Thank you

Comments