Flex Appliance 6.0 shell operation fails with "Ansible requires the locale encoding to be UTF-8; Detected ISO8859-1."

Problem

A Flex Appliance 6.0 shell operation fails with this error. You may also encounter other errors during shell operations. 

Error Message

"Ansible requires the locale encoding to be UTF-8; Detected ISO8859-1."

Cause

When you access the Flex Appliance Shell through SSH, the computer’s locale must be set to UTF-8.  

Solution

To resolve this problem, you must configure your computer’s locale to use UTF-8 encoding. Use the following steps to set the locale. 

For Linux or Mac: 

• Run the following command to set the locale to UTF-8:

  export LANG=en_US.UTF-8 export LC_ALL=en_US.UTF-8

• To make this change permanent, add the above line to your .bashrc or .zshrc file, depending on your shell.

For Windows PuTTY users:

• Open PuTTY.
• Navigate to Window > Translation in the settings.
• Set the Remote character set to UTF-8.
• Save this configuration.

Once your client machine locale is set to UTF-8, log in to the Flex Appliance Shell through SSH. You should be able to perform operations without encountering locale-related issues.