IBM Support

MAS V9: Setting the base language in the magae workspace

How To


Summary

This article will show you how to set the base language in Manage and force a redeployment to pick up the language change.

Steps

You may wish to switch the base language of the Manage deployment, or maybe you have come across a language-based error as part of an install (as below).
This article will guide you through how to set the language and force a redeployment so the new language is picked up
 
The error is the following:
TASK [ibm.mas_devops.suite_app_config : Configure application in workspace] ****
fatal: [localhost]: FAILED! => changed=false 
  msg: 'Failed to create object: b''{"kind":"Status","apiVersion":"v1","metadata":{},"status":"Failure","message":"ManageWorkspace.apps.mas.ibm.com \\"demo-wsdemo\\" is invalid: spec.settings.languages.secondaryLangs[0]: Unsupported value: \\"n\\": supported values: \\"AR\\", \\"CS\\", \\"DA\\", \\"DE\\", \\"EN\\", \\"ES\\", \\"FI\\", \\"FR\\", \\"HE\\", \\"HR\\", \\"HU\\", \\"IT\\", \\"JA\\", \\"KO\\", \\"NL\\", \\"NO\\", \\"PL\\", \\"PT-BR\\", \\"RU\\", \\"SK\\", \\"SL\\", \\"SV\\", \\"TR\\", \\"UK\\", \\"ZH-CN\\", \\"ZH-TW\\"","reason":"Invalid","details":{"name":"demo-wsdemo","group":"apps.mas.ibm.com","kind":"ManageWorkspace","causes":[{"reason":"FieldValueNotSupported","message":"Unsupported value: \\"n\\": supported values: \\"AR\\", \\"CS\\", \\"DA\\", \\"DE\\", \\"EN\\", \\"ES\\", \\"FI\\", \\"FR\\", \\"HE\\", \\"HR\\", \\"HU\\", \\"IT\\", \\"JA\\", \\"KO\\", \\"NL\\", \\"NO\\", \\"PL\\", \\"PT-BR\\", \\"RU\\", \\"SK\\", \\"SL\\", \\"SV\\", \\"TR\\", \\"UK\\", \\"ZH-CN\\", \\"ZH-TW\\"","field":"spec.settings.languages.secondaryLangs[0]"}]},"code":422}\n'''
  reason: Unprocessable Entity

Step 1: Locating the CRD manage workspace instance 

-On the left-hand menu select the "Administration" and then the "CustomResourceDefinitions" menu item (1)

- In the search box type "managew" to display the "ManageWorkspace" CRD (2)

- Select the "ManageWorkspace" CRD (3)

Step 2: Selecting the correct instance to update

If you are running more than one MAS instance on your cluster, you need to make sure you select the right instance.

- Select the "instances" tab (1)

- Select the instance you wish to update (2)

Note: I only have one instance of MAS on this cluster, so I only have one entry here (2)

Step 3: Setting the language

Select the "YAML" tab

Then scroll down until you see the below for "languages" (it's under spec)

This is where you can set the language code

NOTE: It must be in capital letters

Once you click save at the bottom of the YAML it will force a redeployment with this change

Valid values (languages)

In the manageworkspace CRD yaml you will see a list of valid values (languages to use)

To save you having to look them up, I have added a screenshot of them here. If you dont see the one you need, then check the file for your version as more languages may have been added over time.

Examples: UK = UK English, PT-BR = Brazilian Portuguese, etc

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSRHPA","label":"IBM Maximo Application Suite"},"ARM Category":[{"code":"a8m50000000CbKNAA0","label":"Install"},{"code":"a8m3p0000006xL0AAI","label":"Maximo Application Suite-\u003EMAS Applications-\u003EManage-\u003EDeployment"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.0.0;9.1.0"}]

Product Synonym

MAS;Maximo;Maximo Application Suite;

Document Information

Modified date:
04 July 2025

UID

ibm17238940