Troubleshooting
Problem
After logging into mobile the user receives the error "failed to authenticate user".
Resolving The Problem
You might need to configure settings in Maximo® Mobile Suite for the mobile device to communicate with the application server.
Symptoms
You are unable to log in to Maximo Mobile Suite.
Diagnosing the problem
Ensure that you indicated the correct server or server port in the mobile.properties file
Ensure that you are included in the security group that was given authentication to mobile
If the application server security is enabled, ensure the Maximo Mobile Suite has it active.
Check that your connection parameters are accurate (for example, SSL).
If SSL is active, ensure that you have the necessary certificates installed in the keystore of the Java™ Virtual Machine.
Resolving the problem
On the application server, open the maximo_root/mobiletools/profiles/common/appsetup/mobiles.properties file and ensure
that you specified the correct server or port.
In the Security Group (Mobile) module, ensure that you are part of a security group, and that the security group has the appropriate access rights.
Activate server security in the web.xml file. Open the maximo_root\applications\maximo\mobileweb\webmodule\WEB-INF\web.xml file and uncomment the security-constraint and login-config tags.
If you are using LDAP, open the maximo_root/applications/maximo/mobileweb/webmodule/WEB-INF/web.xml file and ensure that the env-entry-value parameter is set to true.
If you are using the SSL protocol, open the maximo_root/mobiletools/profiles/common/appsetup/mobile.properties file and ensure that the maximo.mobile.ssl parameter is set to true.
If you do not have the necessary certificates in the keystore of the Java Virtual Machine, you must run the keytool.exe file to manage the certificates of the keystore that is used by the J9 that operates on a Windows® Mobile platform.
In a DOS command prompt, navigate to the directory where keytools.exe file is stored, then type keytool to see all relevant information about how to add a certificate to the cacert file. Follow the instructions provided in the DOS Command window on how to add the certificate to the keystore. The default password for the keystore is changeit
.
In the \mobiletools\tools\wece-win-x86\bin\security folder, you must manually copy the cacert file into the J9\PPRO11\lib\security folder on the mobile device.
Was this topic helpful?
Document Information
Modified date:
17 June 2018
UID
swg21512442