An introductory message describing what action was being attempted when we failed.
The exception that we caught.
Add a new message to the V1 profile conversion messages.
Formatting clues for the message.
Unformatted text of the message.
Convert V1 profiles into a zowe.config.json file.
It will also do the following: Create a zowe.schema.json file. Migrate V1 secure properties into the current consolidated Zowe client secure properties. Replace old SCS-plugin credential manager override with the Zowe embedded SCS. Delete old V1 profiles (and old V1 secure properties) if requested.
Calling this function after having already converted, will not attempt to convert again. However it will still delete the old profiles if requested.
You should NOT initialize the secure credential manager before calling this function. The CredMgr can only be initialized once. If the old V1 SCS-plugin happens to be configured as the CredMgr when this function is called, the old V1 SCS-plugin CredMgr is unable to create the current consolidated Zowe client secure properties. Users will have to re-enter all of their credentials.
Options that will control the conversion process.
Result object into which messages and stats are stored.
Convert a set of known property names to their new names for V2 conformance (and later releases).
The converted client configuration in which we shall rename obsolete property names to their conformant names.
Delete the secure property specified from the operating system credential vault.
The account the property is stored under
The name of the property to delete
true if the property was deleted successfully
Delete the V1 profiles that have been converted. We also delete the secure credentials stored for those V1 profiles.
Locate the names of secured properties stored under an account in the operating system's credential vault.
The account to search for in the credential store
a list of secured properties stored under the specified account
Retrieve info about old plug-ins and their overrides.
IOldPluginInfo plugins - List of CLI plug-ins to uninstall overrides - List of overrides to replace in app settings
Get the number of old profiles present in the CLI home dir.
Root profiles directory
Number of old profiles found
Initialize credential manager so that we can migrate the secure properties that are stored for V1 profiles to new secure properties for the converted config that we will create.
For all CLI commands other than convert-profiles, the credential manager is loaded in Imperative.init and frozen with Object.freeze so it cannot be modified later on. Because convert-profiles cannot create new secure properties for the converted config (if the old SCS plugin credMgr is already loaded), Imperative.init does not load the credential manager for the convert-profiles command.
VSCode extensions must also avoid initializing the Credential Manager before calling ConvertV1Profiles.convert.
If we encounter an error when trying to initialize the credential manager, we report (through ConvertV1Profiles.convertResult.credsWereMigrated) that creds were not migrated.
Detect whether we must convert any V1 profiles to a zowe client configuration.
True means we must do a conversion. False otherwise.
Report whether the specified plugin is installed.
name of the plugin to search for.
True if plugin is installed. False otherwise.
Verify that the credential vault is accessible, or whether there is a problem.
true if credential vault is available, false if it is not
Load V1 profile schemas, which will not have been loaded for VSCode extensions.
Move the contents of existing v1 profiles to a zowe client config file.
The path name to the new zowe client config file (null upon failure).
Put the path name to the config file, obtained from the supplied Config object, into our result object.
The config object from which we will extract the path.
Replace any detected oldCredMgr override entry in settings.json with the Zowe embedded credMgr.
After the replacement of the credential manager override, we can then initialize credential manager later in this class.
Generated using TypeDoc
Add a new message to the V1 profile conversion messages that reports a caught exception.