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!
- Joe_ReifelEmployee
Hi @sp,
An alternative to the Migration Assistant is to just follow the steps outlined in K82540512: Overview of the UCS archive platform-migrate option.
- NikunjNimbostratus
Can this be used to migrate config from hardware to VE?
- svsCirrostratus
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.
- ghcheeNimbostratus
Hi Team,
Able to share F5 BIG-IP Migration Assistant tools for download?
- MradNimbostratus
hello does this tool cover the migration from I-series to Rseries
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:
runserverports:
- "${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