SaltStack Config / RAAS service reporting internationalization errors
search cancel

SaltStack Config / RAAS service reporting internationalization errors


Article ID: 345129


Updated On:


VMware Aria Suite


The purpose of this KB article  is to provide fix for the error listed above.

RAAS service reporting error in the RAAS logs located in /var/log/rass/raas. Similar to below example: 

Traceback (most recent call last):
  File "tornado/", line 1701, in _execute
    result = method(*self.path_args, **self.path_kwargs)
  File "/var/lib/raas/unpack/_MEI8CM2Ja/raas/mods/rest/", line 139, in get
    return self.process_proxy(requests.get)
  File "/var/lib/raas/unpack/_MEI8CM2Ja/raas/mods/rest/", line 102, in process_proxy
    r = request_method(
  File "requests/", line 76, in get
    return request('get', url, params=params, **kwargs)
  File "requests/", line 61, in request
    return session.request(method=method, url=url, **kwargs)
  File "requests/", line 542, in request
    resp = self.send(prep, **send_kwargs)
  File "raven/", line 341, in send
    resp = real_send(self, request, *args, **kwargs)
  File "requests/", line 655, in send
    r = adapter.send(request, **kwargs)
  File "requests/", line 516, in send
    raise ConnectionError(e, request=request)
requests.exceptions.ConnectionError: HTTPConnectionPool(host='<IP>', port=8091): Max retries exceeded with url: /i18n/api/v2/locale/supportedLanguageList?productName=SSC&version=8.10.1&language= (Caused by NewConnectionError('<urllib3.connection.HTTPConnection object at 0x7xxxxxxxxfa0>: Failed to establish a new connection: [Errno 111] Connection refused'))
2023-01-23 08:45:45,076 [tornado.access][ERROR   :2246][Webserver:2573] 500 GET /i18n/api/v2/locale/supportedLanguageList?productName=SSC&version=8.10.1&language= (<IP>) 10.28ms


VMware Aria Automation Config 8.12.x


The error is due to "vmware internationalization service" is missing on the RAAS machine. This service came out as part of 8.6.2. In general SaltStack Config will run without it, but you will see a lot of errors in the logs. To fix the errors you need to install missing packages for Singleton service: 
  • singleton-manager-i18n
  • ssc-translation-bundle.


JAVA_JRE 11 must be installed and configured on the system

To resolve the problem, follow the steps below:
  1. Download RAAS installation package from that match your RAAS version , example: vRA_SaltStack_Config-
  2. After extraction missing files you will find in the location: /sse-installer/salt/sse/eapi_service/files/ 
  • singleton-manager-i18n-0.6.9-0.el7.x86_64.rpm
  • ssc-translation-bundle-8.10.2-2.ph3.noarch.rpm
  1. Copy installation files to RAAS node.
  2. Login to RAAS node as root via SSH or console.
  3. Install packages
    sudo yum install singleton-manager-i18n-0.6.9-0.el7.x86_64.rpm
    sudo yum install ssc-translation-bundle-8.10.2-2.ph3.noarch.rpm
  4. After the package installation you can check the status of the service:
    systemctl status singleton-manager-i18n.service
Service is running OK you will see the following message :
Jan 27 08:55:08 centosD.localdomain systemd[1]: Starting VMware Internationalization Service...
Jan 27 08:55:08 centosD.localdomain[14040]: start Singleton service
Jan 27 08:55:08 centosD.localdomain[14040]: execute start function
Jan 27 08:55:08 centosD.localdomain[14040]: executing:  /usr/local/vip/bin/ /usr/local/vip/vip-manager-i18n-common.jar /usr/local/vip/work/vip-runtime.log /usr/local/vip/work
Jan 27 08:55:08 centosD.localdomain[14040]: =====startup singleton=====
Jan 27 08:55:08 centosD.localdomain[14040]: found java home:  /etc/alternatives/jre
Jan 27 08:55:08 centosD.localdomain[14040]: run singleton from:  /usr/local/vip/vip-manager-i18n-common.jar
Jan 27 08:55:08 centosD.localdomain systemd[1]: Started VMware Internationalization Service.
  1. After successful installation restart the RAAS service:
    systemctl stop raas
    systemctl start raas
  2. The error should disappear from the logs.