Product Information
XSA/Cockpit installation Issues and Troubleshooting
Overview: HANA 2.0 is having XSA as base for many application like HANA cockpit, WEB IDE, Big Data Hub to name a few. You are lucky if you get it through for installation but sometimes you are stuck with few issues which you keep trying to solve , you don find solution. This Blog identifies and help you solve few of them.
Getting a guide is very easy. But troubleshooting in real world might make your head spin. So sharing my experience.
XX will represent the instance no. used in this blog.
Error:
- Adding role ‘xs_worker’ failed:
Check /var/tmp latest update folder and it will mention the file name which contains more details. It should be with name like hdbmodify_addlocalroles.log. and
Reason: FAIL: process hdbxscontroller HDB XS Controller not running
Sub Reason: Could not startup the controller components: SAP WebDispatcher failed to bind application port (already occupied). Route to application will be unavailable. Restarting the application may solve the issue.
xscontroller.out: FAILED to start: Could not startup the controller components: SAP WebDispatcher failed to bind application port (al
ready occupied). Route to application will be unavailable. Restarting the application may solve the issue.
Solution: Clearly xscontroller is not up and hence webdispatcher can’t bind.
- Try to find out the port using netstat -a|grep 3XX29 where xx is the instance no. If you find the port being used by some random process, you can kill the process , try to start XScontroller again (using HANA studio or CLI) and proceed
- sometime you don find any port used , in that case ,you can restart the entire application and try to start xscontroller again.
- if 2nd does not work, you can try to kill all processes after shutting down HANA system, and then try to restart xscontroller using HDB start. sometime sapcontrol -d -nr XX -function StartSystem.
2. com.sap.xs2rt.installation.util.InstallationException: Error during serviceBrokerClient.getServiceBrokers() UAA’s check_token() endpoint was called with invalid credentials. Could be a clientsecret mismatch
Reason: Such issue can occur when previous installation is not successful or credentials are mismatched
Solution: Remove previous installation/upgrade of XSA. using below steps:
- Remove xs roles using hdblcm from installation directory 9/hana/shared/<SID>/hdblcm) which can be different as per customer.
- uninstall XS component using hdblcm from same directory, but only xsa component, not entire DB or HDB client or something.
- Restart the installation/upgrade. it will work
3. /installation/update-content: Cannot upload the data.
Reason: There can be 2 reasons
- Network might be intermittently unavailable
- zip or other extract utility missing from store. (zypper or yum or other depending on your OS)
- Authorization issue/ownership issue.
Solution
- Make sure network is available , no DNS/Hostname etc issue should cause installation/upgrade to stop.
- install the zip or extract utility used by installer.
- make sure authorization and ownership do not cause the halt of installation.
4. Update not starting : unhandled exception: Can’t call method “getManifest” on unblessed reference at LCM/Utils/ComponentActionStringGenerator/InstallUpdate.pm line 109.
Reason: There are some files pending from where the ./hdblcm is getting information about previous attempt of update/installation.
Solution: Usually there will be xml available in installation directory where hdblcm resides.
files might be like hdblcm.update or hdm.pid . It does not matter where are you running it from. But you will find such flles always in installation directory
Will keep posting more in case faced some issues further , of course with resolutions.
Troubleshooting Tips:
XSA is quite tricky and when it comes to troubleshooting , there is not one place you can find the logs:
- cdtrace->/usr/sap/<SID>/HDB<nr>/<hostname>/trace and ls -lart , XS related stuff can be found in xsexeagent_0.log, xsuaaserver.out,uaa.log,xscontroller.out,hdbxscontroller_audit.log etc.
- /hana/shared/<SID>/xs under this directory (/hana/shared/<SID>/xs/controller_data/controller/router/webdispatcher). routing details can be found along with logs.
- if you are updating/installing you can find more details in /var/tmp and latest files. That is hopefully known to all.
5. HANA 401 unauthorized access
:HDB:dh1adm /usr/sap/DH1/HDB02 51> xs uninstall <Product_Name> N-PREMISE
Really uninstall ‘Product_Name’ ? (y/n)> y
Running uninstallation of “Product_Name” in org “orgname” / space “SAP” as xsa_admin…
ERR javax.ws.rs.NotAuthorizedException: HTTP 401 Unauthorized
Reason: We have to explicitly login using xs login
Solution: Xs login and provide credentials. CLI is faster than UI XSA.
Suggestion: If UI part of XSA lifecycle is having time out issues and taking time for deployment/deregistration etc , try using XS CLI, it is way too faster than UI as of now.
6 .Could not retrieve the download URL for Node.js: Error: certificate has expired
Error: Could not retrieve the download URL for Node.js: Error: certificate has expired (connecting to IP:Port)
Execution of bin/compile failed (exit value 1)
09:14:50.997 – INFO: Output line 111: [28] 5/18/18 9:14:50.792 AM [STG/4] ERR Failed to stage app ‘auditlog-db’ [Org ‘HANACockpit’, Space ‘SAP’]: Execution of bin/compile failed (exit value 1).
Reason: Certificate issue
Solution: Reset Certificate using command XSA reset-certificate
XSA reset-certificate
Stopping XSA …
Starting XSA …
OK
you can provide customer provided certificates directly.
6. mtaext files causing Cockpit installation to fail:
Error: HANACOCKPIT.mtaext file is wrong and installation cannot proceed. Invalid inputs.
Reason: The File is changed . The task for passing this file is to fix the ports for cockpit web and web app. Even an extra/less space may cause disruption.
Solution: Download the exact file from sap Note and change only port no. nothing else.
2389709 – Specifying the port for SAP HANA Cockpit before installation
7. HANA cockpit or XSA application performance issue on Hyperscalers AWS, Azure GCP
Error: XSA applications shows significant performance impact on public cloud platform
Reason: Seems issues with performance of XSA on hyperscalers. ‘XSA diagnose’ tool can help us in this case.
login with xs admin and run XSA diagnose
Checking operating system user setup (space users): Unexpected error, see log file: FAILED
File system: Checking realpath performance: OK
HANA: Checking INI parameter configuration: OK
File system: Checking write performance: FAILED
Thread count Dir. Count File Count Package Size(MB) Throughput(MB/s) Write Performance
————————————————————————————————
4 4000 24000 398.44 6.36 SLOW
————————————————————————————————
The file system is too slow for XSA to work properly.
Solution: Mount block devices for xs directory and install xs on it. Then performance looks fine.
I think it is important to know the reason behind an error which is very well explained here.. will Definitely come handy during troubleshooting !
Very informative. Thanks for sharing this 🙂
Very glad to see this coming randomly from one of my mentors from previous organisation. Thank you Vinod.
Thanks for sharing.
Good information, I am having trouble with this aspect of my installations. I will apply these notes to my debug process and report.
Thank you!
That was the purpose of sharing information. Glad it could help.
Hi Naveen,
Thanks for sharing much valuable info on cockpit.
Currently i am trying to install Cockpit full version: 2.11.11 & i am getting the below error:
05:24:17.358 - ERR : Resume of SAP HANA Cockpit Installation failed
05:24:17.358 - INFO: Summary of critical errors
05:24:17.358 - ERR : Resume of SAP HANA Cockpit Installation failed
05:24:15.320 - ERR : Cannot detect command line options dynamically.
05:24:15.320 - ERR : Cannot get external program configuration
I appreciate your help on this.
Regards,
Chinmayee
Hi Chinmayee,
Please check point "4. Update not starting". I have also experienced upgrade being stuck.
Also check .lock file in troubleshooting folders.
You can either uninstall cockpit and try installing it again.
BR,
Naveen
Hello Naveen Kumar I have experienced same error on my installation process, any idea how to fix it?
Im using RHEL 8.1
03:19:32.284 – INFO: Summary of critical errors
03:19:32.283 – ERR : Installation of SAP HANA Cockpit System failed.
03:19:32.209 – ERR : Cannot detect command line options dynamically.
03:19:32.202 – ERR : Cannot parse external program configuration:
syntax error at line 1, column 0, byte 0 at SDB/Install/Configuration/ExternalProgramConfiguration.pm line 80.
Hello colegues! We've found solution to our problem. Our problem was we need to install all the packages for lolcale -a because in RHEL 8 install only a lite version of the language you use in the installation.
The command to install:
yum install -y langpacks-en langpacks-de glibc-all-langpacks
Credits to:
Daniel Nashed blgo: https://blog.nashcom.de/nashcomblog.nsf/dx/locale-issue-on-linux-centos-rhel.htm
Hi, I've installed HANA DB & S/4hana 2022 on same host. Once i restart the system I'm getting the following error.
Error : FAIL: process hdbxscontroller HDB XS Controller not running
Detailed Error : Failed to connect to the database SHD (s4hana:30013) as user SYS_XS_RUNTIME: authentication failed
Can you please help me to fix this issue!
Best Regards,
Guru Balan.