Migrating your old Zowe yaml profiles for Zowe v3.0

When upgrading to Zowe Explorer v3.0, you will no longer be able to use your old Zowe v1 YAML based profiles. The following steps are provided in order to keep your old profiles working and utilize them in your workspace:

Migrating through Zowe CLI

  1. Review your installed Zowe plugins from Zowe CLI by running zowe plugins list and verify that the secure credential store plugin is not installed.

  2. If the secure credential store plugin is installed, issue the following command in your terminal zowe scs revert --force.

  3. If the secure credential store plugin is installed, run the following command to uninstall zowe plugins uninstall @zowe/secure-credential-store-for-zowe-cli.

  4. Verify your plugins are updated to a version compatible with Zowe CLI v8.0.0, otherwise you can uninstall your installed Zowe plugins by using zowe plugins uninstall <your zowe plugin name> for each plugin installed.

  5. Install the new version of Zowe CLI by running npm install -g @zowe/cli@zowe-v3-lts.

  6. Run the command to convert v1 YAML profiles into a Team Configuration file, zowe config convert-profiles.

Migrating through Zowe Explorer VS Code Extension

  1. If auto-install is disabled, update Zowe Explorer by going to "extensions > Zowe Explorer" in Visual Studio Code and clicking the Update button.

  2. If Zowe v1 YAML based profiles are detected by Zowe Explorer you will be presented with a modal message with an option to migrate them to a Team Configuration file for continued use.

Last Updated:
Contributors: Rudy Leonel Pichola Flores, Kimberlee Maselli, Billie Simmons