Troubleshooting

Troubleshooting information to help you diagnose and resolve common issues encountered when initializing encryption, exporting assets, and importing configurations by using the API Ops CLI.

Error message	Solution
Incorrect environment name in import-config.yaml or export-config.yaml file	The operation fails if the value of environment name does not match the environment configured in your system. Open the import-config.yaml or export-config.yaml file and update the environment name value to match the correct environment.
Invalid or incorrect path in the base directory	If the path in base directory is incorrect, the CLI cannot locate or export assets. Verify the folder path on your system and update the base directory value to point to the correct location.
Authentication failed due to incorrect username or password	Invalid credentials prevent the export or import command from running. Verify your username and password. For enhanced security, store credentials in environment variables instead of plain text.
Command not recognized because API Ops CLI is not installed or not in the system path	If the CLI is not installed or not added to your system path, the command will fail. Install the API Ops CLI and add the CLI installation directory to your PATH variable.
Issues with running the init command: Tag mismatch.	This issue may occur when you use environment, export, or import configuration files generated by a different tool installation. Change the passwords in all files from enc:<> to pwd<>, and then run the init command.
Command returns 500: Server error	Indicates that Akana is unable to process the command. Review the Akana logs to identify the detailed error and correct the underlying issue.