Migration

this section describes how to migrate automation assets from aiops automation service (as) to bridge automation service (bas) and validate the migrated content initiate the as to bas migration prerequisites before starting the migration, ensure that dedicated cacf credentials have been created and configured in connections management as described in pre migration automation service access groups have been migrated to bridge iam, and the corresponding bas roles have been assigned to maintain the same level of access automation service role bridge automation service role administrator orchestration administrator editor orchestration editor operator orchestration operator viewer orchestration viewer migrate catalogs, schedules, and events from as to bas prerequisite ensure that the user performing the migration has the orchestration administrator or bridge administrator role from the main menu , go to catalogs → orchestration catalog → operations in the aiops automation services convergence section, select aiops automation services migration catalog item run the catalog item to migrate the following as assets to bas public catalogs private catalogs schedules events monitor the workflow execution and verify that the migration completes successfully do not run multiple migration jobs simultaneously wait for the current migration job to complete before starting another migration run the migration catalog item select more actions menu ( ) from the aiops automation services migration catalog item and select run select the appropriate version and connection select the connection that was created using the dedicated cacf credentials in bridge connections manager on the parameters page, click next without entering any values on the target & hosts page, click next without selecting targets or hosts on the review & submit page, click run verify migration status from the main menu , go to services → platform services → bridge automation → workflow executions locate the aiops automation services migration workflow, review the status column to determine whether the migration is completed, running and failed to view execution details, select the more actions menu ( ) and then select view details review the list view to view the status of migration steps the activities tab helps identify completed, in progress, and failed migration tasks if a migration activity fails, see troubleshooting and faq after the migration workflow completes successfully, the supported automation assets are available in bas public catalogs public catalogs from as are migrated to bas, and catalogs enabled in as are automatically enabled in bas all associated catalog configurations are migrated migrated public catalogs appear in orchestration catalog with the global label to activate a catalog, select the more actions menu ( ) and then select activate private catalogs private catalogs from as are migrated to bas and enabled by default, and all associated catalog configurations are migrated migrated catalogs are placed in the advanced delivery – single owner asset category catalogs are available from orchestration administration schedules schedules from as are migrated to bas and are disabled by default after migration from the main menu , go to bridge automation services → schedules review the migrated schedule configuration validate execution details, parameters, and target information enable schedules only after validation is complete to view schedule details, select the more actions menu ( ) and then select view events event triggers from as are migrated to bas and are disabled by default after migration review each event configuration verify trigger conditions validate associated workflows and catalog mappings enable events only after validation is complete migration behavior and limitations subsequent migration executions skip previously migrated items and migrate only newly added or changed assets from as if a migrated catalog must be recreated, retire the catalog before rerunning the migration all content and user authorizations that exist in the as tenant are considered approved by the delivery platform engineer (dpe) only gemu based automation content is migrated to bas the following items are not migrated legacy aiops automation service content ghes based content schedules associated with excluded content events associated with excluded content this behavior is part of the content sanitization process defined by the delivery coe verify migrated content after migration, verify that all expected assets are available and function correctly verify catalogs after migration, verify that all expected public and private catalogs have been migrated correctly and are available in bridge automation service (bas) validation helps ensure that catalog configurations were migrated successfully and that catalog items can be executed as expected compare catalog counts from the main menu , go to my automations, record the number of private catalogs and public (certified) catalogs in bridge automation service, go to orchestration catalog and record the number of catalogs in advanced delivery – single owner asset (private catalogs) and catalogs in components with the global enforced label (public catalogs) verify that the bas catalog counts match the as catalog counts test migrated catalogs open a migrated catalog select run select the appropriate connection provide credentials and inventory information as required review any migrated parameter values select run to verify execution from the main menu , go to services → platform services → bridge automation → workflow executions select the more actions menu ( ) and then select view details open the output parameters tab verify that all activities completed successfully and produced the expected results verify schedules after migration, verify that all schedules have been migrated successfully and retain their expected configuration validation helps confirm that schedule counts, frequencies, and execution settings in bas match those in aiops automation services before schedules are enabled from the main menu , go to bridge automation services → schedules , record schedule count and schedule frequency compare schedule count and schedule frequency verify that schedule counts and frequencies match migrated schedules remain disabled until validated and approved verify events after migration, verify that all event driven automations have been migrated correctly to bas validation helps ensure that event rules, trigger conditions, workflow mappings, and input configurations are preserved and function as intended before event rules are enabled in the aiops automation service main menu , go to settings open the event settings section to review the dss topics configured for event processing from the main menu , go to my automations locate an automation that contains event based execution settings, and then select set up open the automated execution section review the event configuration and record the following information trigger conditions associated automation input mappings event processing configuration from the main menu , go to bridge automation services → event rules locate the migrated event rule select view to review the event rule configuration verify that all expected event configurations have been migrated the trigger conditions match the original configuration in as the associated workflow or catalog is correct input mappings have been migrated correctly migrated event rules are in the disabled state, where applicable do not enable migrated event rules until the corresponding event driven automation in aiops automation service has been retired enabling event processing in both platforms can result in duplicate automation executions if any expected event rules are missing or configuration discrepancies are identified, document the details and notify the migration support team for further investigation before enabling the event rules for production use for more information, see support migration reports account eligibility and executive summary report the migration service validates each automation service account and its associated cacf instance to determine migration eligibility the report includes account information such as field description account name account registered in kyndryl bridge kyndryl bridge id unique kyndryl bridge account identifier aiops id unique aiops account identifier automation gsma code gsma code associated with the account bac id bac code associated with the account country name country or region associated with the account aiops active runner set (y/n) indicates whether an execution platform is configured convergence eligibility (y/n) indicates whether the account meets migration requirements convergence catalog item creation (y/n) indicates whether the migration catalog item was created migration execution results the migration execution results table provides a summary of migration and convergence activities it includes details about execution history, workflow identifiers, request information, migration status, and the results of migrated assets such as access groups, catalogs, schedules, and events field description total executions number of migration execution attempts last convergence workflow id most recent convergence workflow identifier request date date and time of the latest convergence request requested by user who initiated the convergence status current or final migration status converged item details results for access groups, public catalogs, private catalogs, schedules, and events for each migrated asset type, the report provides total success skipped error cut off workflow results the cut off workflow results table provides information about the most recent cut off workflow execution it includes request details, workflow status, and the status of actions performed during the cut off process, such as disabling automation service event settings and schedules, and enabling corresponding bridge automation event rules and schedules field description last cut off workflow id most recent cut off workflow execution request date date and time of the request requested by user who initiated the request status current or final status event settings disabled in as (y/n) indicates whether all as event settings were disabled schedules disabled in as (y/n) indicates whether all as schedules were disabled event rules enabled in bas (y/n) indicates whether bas event rules were enabled schedules enabled in bas (y/n) indicates whether bas schedules were enabled this report helps delivery teams and leadership validate migration readiness and track progress across migration phases view detailed migration results detailed migration results are available in the output parameters tab of the latest aiops automation services migration workflow execution from the main menu , go to services → platform services → bridge automation → workflow executions open the latest migration workflow select view details open the output parameters tab users can copy the output directly from the interface for further analysis or reporting migration result statuses for detailed information about migrated items, review the migration results in the following table the table describes the migration status values and error conditions that can appear in the converged items details section of the migration report status description total total number of migration eligible items obsolete ghes based private and/or public catalog are excluded success the item was successfully created in bas skipped the item already exists and was not recreated during the current migration execution examples "reason" "catalog item already exists" "reason" "schedule already exists" error the item could not be migrated due to an error detailed error information is retained for troubleshooting examples outcome failure public catalog item "catalog item name" not found it may not have synced down from kpc yet outcome failure catalog item "catalog item name" not found for automation "catalog item name" "reason" "unknown"