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 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, a modal message appears with an option to migrate them to a Team Configuration file for continued use.

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 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.

Last Updated:
Contributors: Rudy Leonel Pichola Flores, Kimberlee Maselli, Billie Simmons, phaumer, Vinithanjali Selvaraj, Esther M