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

**URL:** <https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567>\
**Category:** F5 Technical Articles\
**Tags:** cloud, big-ip, aws, application-delivery\
**Created:** [December 21, 2017, 12:00pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567 "2017-12-21T12:00:00Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![Chase\_Abbott](https://d1p9zq3aats0t8.cloudfront.net/user_avatar/community.f5.com/chase_abbott/32/11109_2.png) [@Chase\_Abbott](https://community.f5.com/u/Chase_Abbott)\
**Post date:** [December 21, 2017, 12:00pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567/1 "2017-12-21T12:00:00Z")

</div>

_ **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](https://github.com/f5devcentral/f5-journeys#readme)

## 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&nbsp;[**tmsh**](https://support.f5.com/kb/en-us/products/big-ip_ltm/manuals/product/bigip-tmsh-reference-12-0-0.html)&nbsp;command that performs the migration from a UCS to a running system. F5 Journeys uses this&nbsp; **tmsh** &nbsp;command to accomplish the migration using the platform-migrate option (see more details [K82540512](https://support.f5.com/csp/article/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](https://github.com/f5devcentral/f5-journeys#readme)

## 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](https://github.com/f5devcentral/f5-journeys/issues/new?assignees=&labels=&template=bug_report.md&title=%5BBUG%5D) and attach the journeys.log file from the working directory (

```tcl
/tmp/journeys

```

by default)

### Feature requests

Ideas for enhancements are welcome [here](https://github.com/f5devcentral/f5-journeys/issues/new?assignees=&labels=&template=feature_request.md&title=%5BFEAT%5D)

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

---

<div class="post-metadata">

**Author:** ![JoshBecigneul](https://d1p9zq3aats0t8.cloudfront.net/user_avatar/community.f5.com/joshbecigneul/32/19933_2.png) [@JoshBecigneul](https://community.f5.com/u/JoshBecigneul)\
**Post date:** [December 21, 2017, 3:05pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567/2 "2017-12-21T15:05:00Z")

</div>

Awesome. Is support for other cloud providers planned?

How does the AWS integration work? I don’t see an option to specify that as a destination.

---

<div class="post-metadata">

**Author:** ![jong\_39455](https://avatars.discourse-cdn.com/v4/letter/j/71c47a/32.png) [@jong\_39455](https://community.f5.com/u/jong_39455)\
**Post date:** [December 22, 2017, 12:56pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567/3 "2017-12-22T12:56:05Z")

</div>

AWS support is coming in early 2018. Other cloud platforms are also planned including Azure and Google. No firm dates yet.

---

<div class="post-metadata">

**Author:** ![stan\_piron](https://avatars.discourse-cdn.com/v4/letter/s/7bcc69/32.png) [@stan\_piron](https://community.f5.com/u/stan_piron)\
**Post date:** [December 22, 2017, 2:30pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567/4 "2017-12-22T14:30:00Z")

</div>

Does it mean platform-migrate now support any BIGIP module?

previously, this feature supported only LTM migration.

---

<div class="post-metadata">

**Author:** ![labilbo\_133663](https://avatars.discourse-cdn.com/v4/letter/l/97f17d/32.png) [@labilbo\_133663](https://community.f5.com/u/labilbo_133663)\
**Post date:** [December 22, 2017, 4:06pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567/5 "2017-12-22T16:06:05Z")

</div>

Yes, platform-migrate on versions 12.1.3 or 13.1.0 or greater now supports all modules

---

<div class="post-metadata">

**Author:** ![stan\_piron](https://avatars.discourse-cdn.com/v4/letter/s/7bcc69/32.png) [@stan\_piron](https://community.f5.com/u/stan_piron)\
**Post date:** [December 22, 2017, 4:14pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567/6 "2017-12-22T16:14:07Z")

</div>

Nice, the documentation doesn’t say that the command existed before with such limitation. I hope it will be changed! it can help people who want to migrate to previous versions even if last versions are recommended.

I would have preferred that it be available before. I migrated a BigIP with LTM, AFM, ASM, APM last summer to version 13.0 to vCMP and I had to migrate without this option because of this limitation.

---

<div class="post-metadata">

**Author:** ![P\_K](https://d1p9zq3aats0t8.cloudfront.net/user_avatar/community.f5.com/p_k/32/17950_2.png) [@P\_K](https://community.f5.com/u/P_K)\
**Post date:** [December 28, 2017, 2:47pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567/7 "2017-12-28T14:47:19Z")

</div>

Awesome tool! Right on time for our DR project.. But I keep getting this error

```tcl
TypeError: Cannot read property 'description' of undefined

```

when tried to add devices.

---

<div class="post-metadata">

**Author:** ![jong\_39455](https://avatars.discourse-cdn.com/v4/letter/j/71c47a/32.png) [@jong\_39455](https://community.f5.com/u/jong_39455)\
**Post date:** [December 28, 2017, 4:07pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567/8 "2017-12-28T16:07:45Z")

</div>

PK: A couple questions:

1. Are you uploading a UCS by hand, or are you having Migration Assistant contact your devices for you?
2. What version of Migration Assistant are you working with?
3. What OS is running the machine where you are using Migration Assistant?

Thanks!

---

<div class="post-metadata">

**Author:** ![jong\_39455](https://avatars.discourse-cdn.com/v4/letter/j/71c47a/32.png) [@jong\_39455](https://community.f5.com/u/jong_39455)\
**Post date:** [December 28, 2017, 4:08pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567/9 "2017-12-28T16:08:56Z")

</div>

Stanislas: I will see about getting the documentation updated to mention the older version of platform-migrate in TMOS for older versions.

Thanks for the comments.

---

<div class="post-metadata">

**Author:** ![P\_K](https://d1p9zq3aats0t8.cloudfront.net/user_avatar/community.f5.com/p_k/32/17950_2.png) [@P\_K](https://community.f5.com/u/P_K)\
**Post date:** [December 28, 2017, 4:48pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567/10 "2017-12-28T16:48:52Z")

</div>

Jong: See my response below

1. I’m just trying to add devices from Add device tab. I’m not there yet to do the migration.

2. v1.0.1

3. Win10

---

<div class="post-metadata">

**Author:** ![jong\_39455](https://avatars.discourse-cdn.com/v4/letter/j/71c47a/32.png) [@jong\_39455](https://community.f5.com/u/jong_39455)\
**Post date:** [December 28, 2017, 4:52pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567/11 "2017-12-28T16:52:38Z")

</div>

PK: Thanks, I will have our dev team look into this.

---

<div class="post-metadata">

**Author:** ![labilbo\_133663](https://avatars.discourse-cdn.com/v4/letter/l/97f17d/32.png) [@labilbo\_133663](https://community.f5.com/u/labilbo_133663)\
**Post date:** [December 29, 2017, 4:46pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567/12 "2017-12-29T16:46:28Z")

</div>

PK: thanks for the feedback, I’ll do my best to reproduce and fix that issue for the next release. If you’re able to provide the BIG-IP model and software version, that should be a big help in producing the repro.

---

<div class="post-metadata">

**Author:** ![P\_K](https://d1p9zq3aats0t8.cloudfront.net/user_avatar/community.f5.com/p_k/32/17950_2.png) [@P\_K](https://community.f5.com/u/P_K)\
**Post date:** [January 2, 2018, 4:38pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567/13 "2018-01-02T16:38:24Z")

</div>

Will: I tried adding below devices

Big-IP 4000 running 11.5.4,

vCMP guest running 12.1.2(w/ Latest HF) host is running 11.5.4(5250v),

Big-IP VE running 12.1.2..

All the above resulted in below error

 ![image_279685.png](https://d20hrnpixdzcsd.cloudfront.net/original/2X/0/0b4e133fd37ac5ca2a27b6b88e09ba43cb06501c.png)

Big-IP VE 13.1.0 was added to the list with no issues.

---

<div class="post-metadata">

**Author:** ![labilbo\_133663](https://avatars.discourse-cdn.com/v4/letter/l/97f17d/32.png) [@labilbo\_133663](https://community.f5.com/u/labilbo_133663)\
**Post date:** [January 2, 2018, 5:59pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567/14 "2018-01-02T17:59:46Z")

</div>

Ok thanks PK! Just one thing to note, the Migration Assistant won’t be able to connect directly to the BIG-IP running 11.5.4 (it requires software versions 12.1 or greater), but it should be returning a more friendly notification so I’ll get that fixed. If you’d like to migrate from an 11.5.4 config, the Migration Assistant ‘archives’ panel provides a tool for selecting a previously generated UCS from versions 11.1 or greater, which can then be used for migration. We’ll get the TypeError issue fixed for next release- thanks again!

---

<div class="post-metadata">

**Author:** ![Srini\_87152](https://avatars.discourse-cdn.com/v4/letter/s/aca169/32.png) [@Srini\_87152](https://community.f5.com/u/Srini_87152)\
**Post date:** [January 3, 2018, 6:26pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567/15 "2018-01-03T18:26:53Z")

</div>

Folks,

I dont see any software on github to download, is that something im wrong?

All im seeing .MD readle files.

Thx

Srini

---

<div class="post-metadata">

**Author:** ![stan\_piron](https://avatars.discourse-cdn.com/v4/letter/s/7bcc69/32.png) [@stan\_piron](https://community.f5.com/u/stan_piron)\
**Post date:** [January 3, 2018, 6:33pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567/16 "2018-01-03T18:33:37Z")

</div>

Click on the zip or tar.gz links

 ![image_279688.png](https://d20hrnpixdzcsd.cloudfront.net/original/2X/9/94f4adedbef84e761991d2ddf2b7b24f0c621cb7.png)

---

<div class="post-metadata">

**Author:** ![Srini\_87152](https://avatars.discourse-cdn.com/v4/letter/s/aca169/32.png) [@Srini\_87152](https://community.f5.com/u/Srini_87152)\
**Post date:** [January 3, 2018, 6:37pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567/17 "2018-01-03T18:37:33Z")

</div>

yes,i did and unzipd those..all im seeing FAQ,README,SETUP and SUPPORT .md files and one folder with resources[.png files].

 ![image_279689.jpg](https://d20hrnpixdzcsd.cloudfront.net/original/2X/1/19a5f4eb7cba6bc9ee13c7327fe36a782d149228.jpeg)  
Thx

Srini

---

<div class="post-metadata">

**Author:** ![jong\_39455](https://avatars.discourse-cdn.com/v4/letter/j/71c47a/32.png) [@jong\_39455](https://community.f5.com/u/jong_39455)\
**Post date:** [January 3, 2018, 6:43pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567/18 "2018-01-03T18:43:00Z")

</div>

Hi Srini,

This link should contain the executables for the tool:

[https://github.com/f5devcentral/f5-big-ip-migration-assistant/releases](https://github.com/f5devcentral/f5-big-ip-migration-assistant/releases)

Does that work for you?

---

<div class="post-metadata">

**Author:** ![Srini\_87152](https://avatars.discourse-cdn.com/v4/letter/s/aca169/32.png) [@Srini\_87152](https://community.f5.com/u/Srini_87152)\
**Post date:** [January 3, 2018, 6:52pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567/19 "2018-01-03T18:52:35Z")

</div>

Hi Jong,

I dont see any executable files, all it has just .md and .png file.

Thx

Srini

---

<div class="post-metadata">

**Author:** ![jong\_39455](https://avatars.discourse-cdn.com/v4/letter/j/71c47a/32.png) [@jong\_39455](https://community.f5.com/u/jong_39455)\
**Post date:** [January 3, 2018, 6:54pm UTC](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567/20 "2018-01-03T18:54:11Z")

</div>

Srini,

I apologize, I believe if you reload the page you should now see executables.

[Next page](https://community.f5.com/t/welcome-to-the-f5-big-ip-migration-assistant-now-the-f5-journeys-app/65567.md?page=2)