OCI Migration MCP Server

​

Installation

uvx oracle.oci-migration-mcp-server

​

Running the Server

​

STDIO Transport Mode

uvx oracle.oci-migration-mcp-server

​

HTTP Streaming Transport Mode

ORACLE_MCP_HOST=<hostname/IP address> ORACLE_MCP_PORT=<port number> uvx oracle.oci-migration-mcp-server

​

Available Tools

​

Usage Examples

​

List Migrations

List all migrations in my tenancy

​

Get Migration Details

Show me details for migration ocid1.migration.oc1.phx.example

• Migration status and progress
• Source and target details
• Resource mappings
• Timeline and duration
• Error information if applicable

​

Understanding OCI Migration

​

What is OCI Migration?

• Assessment - Evaluate workloads for cloud readiness
• Planning - Design migration strategy and timeline
• Execution - Perform actual migration
• Validation - Verify successful migration
• Optimization - Tune for cloud performance

​

Migration Types

• Migrate virtual machines from on-premises or other clouds
• Support for VMware, Hyper-V, and others
• Application-consistent migration

• Migrate databases to OCI
• Supports Oracle, MySQL, PostgreSQL
• Minimal downtime migrations

• Migrate entire applications
• Preserve configurations
• Maintain dependencies

​

Migration Lifecycle

1. Discovery - Identify resources to migrate
2. Assessment - Evaluate migration readiness
3. Planning - Design migration approach
4. Replication - Copy data to target
5. Testing - Validate in target environment
6. Cutover - Switch to cloud resources
7. Optimization - Tune performance and costs

​

Migration States

• Creating - Migration is being set up
• Active - Migration is in progress
• Succeeded - Migration completed successfully
• Failed - Migration encountered errors
• Canceling - Migration is being canceled
• Canceled - Migration was canceled

​

Authentication

oci setup config

​

Required Permissions

Allow group MigrationReaders to read migration-family in compartment MyCompartment

Allow group MigrationAdmins to manage migration-family in compartment MyCompartment

Allow group MigrationAdmins to manage compute-family in compartment MyCompartment
Allow group MigrationAdmins to manage database-family in compartment MyCompartment
Allow group MigrationAdmins to manage virtual-network-family in compartment MyCompartment
Allow group MigrationAdmins to manage object-family in compartment MyCompartment

​

Common Use Cases

​

Migration Monitoring

• Track migration progress
• Monitor multiple migrations
• Identify stuck or failed migrations
• Report on migration status

​

Migration Planning

• List completed migrations for reference
• Review migration patterns
• Estimate migration timelines
• Plan resource requirements

​

Troubleshooting

• Investigate failed migrations
• Review error messages
• Identify bottlenecks
• Resolve migration issues

​

Compliance & Auditing

• Track what was migrated and when
• Document migration activities
• Verify migration completeness
• Maintain migration records

​

Post-Migration Validation

• Verify migrations completed successfully
• Check resource configurations
• Validate data integrity
• Confirm application functionality

​

Best Practices

​

Planning

• Assess workloads before migration
• Create detailed migration plans
• Identify dependencies
• Test migration process
• Plan for rollback scenarios

​

Execution

• Migrate during low-usage periods
• Monitor progress continuously
• Maintain communication with stakeholders
• Document any issues
• Validate after each migration

​

Security

• Encrypt data in transit
• Protect source credentials
• Use secure network connections
• Audit migration activities
• Follow data residency requirements

​

Performance

• Optimize network bandwidth
• Use incremental replication
• Parallelize when possible
• Monitor resource utilization
• Plan for data transfer costs

​

Validation

• Test applications in target environment
• Verify data integrity
• Confirm performance meets requirements
• Check all configurations
• Validate integrations

​

Migration Strategies

​

Lift and Shift

• Migrate with minimal changes
• Fastest migration approach
• Optimize after migration
• Good for initial cloud adoption

​

Replatform

• Make minimal cloud optimizations
• Update configurations for cloud
• Balance speed and optimization
• Common for database migrations

​

Refactor

• Redesign for cloud-native architecture
• Maximize cloud benefits
• Longer timeline
• Best long-term approach

​

Hybrid

• Combine strategies based on workload
• Phased migration approach
• Minimize risk
• Gradual cloud adoption

​

Troubleshooting

​

Migration Failed

• Error messages in migration details
• Source system connectivity
• Target resource availability
• IAM permissions
• Network configuration

• Insufficient permissions
• Network connectivity problems
• Resource quota limits
• Incompatible configurations
• Data validation errors

​

Migration Stuck

• Network bandwidth limitations
• Large data volume
• Resource contention
• Configuration issues

• Review migration logs
• Check network connectivity
• Verify source system health
• Monitor resource utilization
• Contact Oracle Support if persistent

​

Cannot List Migrations

• IAM permissions
• Correct compartment
• Region selection
• Network connectivity

​

Performance Issues

• Increase network bandwidth
• Use dedicated connections (FastConnect)
• Optimize source systems
• Schedule during off-peak hours
• Use incremental replication

​

Migration Phases

​

Pre-Migration

1. Discovery
   • Inventory source resources
   • Identify dependencies
   • Document configurations
2. Assessment
   • Evaluate cloud readiness
   • Identify challenges
   • Estimate costs
   • Plan resources
3. Planning
   • Design target architecture
   • Create migration schedule
   • Assign responsibilities
   • Prepare rollback plans

​

Migration

4. Setup
   • Configure migration tools
   • Establish connectivity
   • Verify permissions
   • Test connections
5. Replication
   • Initial data sync
   • Incremental updates
   • Monitor progress
   • Validate data
6. Testing
   • Verify in target environment
   • Test applications
   • Check performance
   • Identify issues

​

Post-Migration

7. Cutover
   • Final sync
   • Switch to cloud resources
   • Update DNS/routing
   • Monitor closely
8. Validation
   • Verify all functionality
   • Check data integrity
   • Confirm performance
   • User acceptance testing
9. Optimization
   • Tune for cloud
   • Right-size resources
   • Implement cloud features
   • Optimize costs

​

Integration Patterns

​

Monitoring Integration

Migration Progress
        ↓
OCI Monitoring
        ↓
Alerts & Notifications
        ↓
Stakeholder Updates

​

Automation

Migration Events
        ↓
OCI Events Service
        ↓
Functions/Automation
        ↓
Post-Migration Tasks

​

Related Services

• Compute - Target compute resources
• Database - Database migrations
• Networking - Network configuration
• Object Storage - Data staging and backup
• Monitoring - Monitor migration progress

​

Additional Resources

• OCI Migration Documentation
• Migration Best Practices
• OCI Python SDK - Migration