For more information regarding the security incident at F5, the actions we are taking to address it, and our ongoing efforts to protect our customers, click here.

Welcome to the F5 BIG-IP Migration Assistant - Now the F5 Journeys App

The older F5 BIG-IP Migration Assistant is deprecated and is replaced by F5 Journeys.

Welcome to the F5 Journeys App - BIG-IP Upgrade and Migration Utility

F5 Journeys App Readme @ Github

What is it?

The F5® Journeys BIG-IP upgrade and migration utility is a tool freely distributed by F5 to facilitate migrating BIG-IP configurations between different platforms. F5 Journeys is a downloadable assistant that coordinates the logistics required to migrate a BIG-IP configuration from one BIG-IP instance to another.

Why do I need it?

JOURNEYS is an application designed to assist F5 Customers with migrating a BIG-IP configuration to a new F5 device and enable new ways of migrating.

Supported journeys:

  • Full Config migration - migrating a BIG-IP configuration from any version starting at 11.5.0 to a higher one, including VELOS and rSeries systems.
  • Application Service migration - migrating mission critical Applications and their dependencies to a new AS3 configuration and deploying it to a BIG-IP instance of choice.

What does it do?

It does a bunch of stuff:

  • Loading UCS or UCS+AS3 source configurations
  • Flagging source configuration feature parity gaps and fixing them with provided built-in solutions
  • Load validation
  • Deployment of the updated configuration to a destination device, including VELOS and rSeries VM tenants
  • Post-migration diagnostics
  • Generating detailed PDF reports at every stage of the journey

Full config BIG-IP migrations are supported for software paths according to the following matrix:

        DEST      
  X 11.x 12.x 13.x 14.x 15.x 16.x
  <11.5 X X X X^ X^  
  12.x   X X X X^  
SRC 13.x     X X X  
  14.x       X X X
  15.x         X X
  16.x            

How does it work?

F5 Journeys App manages the logistics of a configuration migration. The F5 Journeys App either generates or accepts a UCS file from you, prompts you for a destination BIG-IP instance, and manages the migration. The destination BIG-IP instance has a tmsh command that performs the migration from a UCS to a running system. F5 Journeys uses this tmsh command to accomplish the migration using the platform-migrate option (see more details K82540512) .

The F5 Journeys App prompts you to enter a source BIG-IP (or upload a UCS file), the master key password, and destination BIG-IP instance. Once the tool obtains this information, it allows you to migrate the source BIG-IP configuration to the destination BIG-IP instance either entirely or in a per-application depending what you choose.

Where do I obtain it?

 F5 Journeys App Readme @ Github

What can go wrong?

Bug reporting

Let us know if something went wrong. By reporting issues, you support development of this project and get a chance of having it fixed soon. Please use bug template available here and attach the journeys.log file from the working directory (

/tmp/journeys
by default)

Feature requests

Ideas for enhancements are welcome here

For questions or further discussion please leave your comments below. Enjoy!

Updated Jun 06, 2023
Version 3.0

37 Comments

  • Nikunj's avatar
    Nikunj
    Icon for Nimbostratus rankNimbostratus

    Can this be used to migrate config from hardware to VE?

  • svs's avatar
    svs
    Icon for Cirrostratus rankCirrostratus

    Yes, this is possible. The difference between `platform-migrate` and the migration tools is, that the tools supports migrating interfaces, using an assistant, while platform migrate will just omit all device-specific configuration, like interfaces and trunks.

  • ghchee's avatar
    ghchee
    Icon for Nimbostratus rankNimbostratus

    Hi Team,

    Able to share F5 BIG-IP Migration Assistant tools for download?

     

  • Mrad's avatar
    Mrad
    Icon for Nimbostratus rankNimbostratus

    hello does this tool cover the migration from I-series to Rseries

  • RomanJ's avatar
    RomanJ
    Ret. Employee

    Hello Mrad yes Journeys App supports migration from Series to rSeries either using the full migration or per-app flow. Thanks!

  • If you modify docker compose file a little you can have the VM to expose the public ip address to connect to it.

     

    In the docker compose file:


    - DB_IP=${DB_IP}
    command:
    runserver

    ports:
    - "${DB_IP}:${JOURNEYS_PORT}:443"

     

    And In the .env file add:

     

    DB_IP=x.x.x.x

     

    If the docker compose ip just redeploy:

    docker compose down

    docker compose up -d