Fixes for JOSSO Execution Related Errors

This post will discuss some basic and prevalent errors that occurs when working with JOSSO.

Most of the time, when we deploy and start the appliance, we start to face errors. We will now discuss how to come over those server errors.


Checklist:

This checklist is to ensure that all paths are set right so that your web server will compile pages smoothly.

I have given examples based on what version i have used in my JOSSO posts.

JAVA - Server JRE 8 Update 221

TOMCAT - Tomcat Version 7.0.94

In environment variables, make sure you set the following variables in user variables / system variables. See to that, values should not differ between user variables and system variables if set in both.

(i) JAVA_HOME   (Eg., C:\Java\jdk-1.8.0_221)

(ii) PATH  (Eg., C:\Java\jdk-1.8.0_221\bin; )

See to that if you have any other java path, kindly remove them and make this as first entry

Once this is done, you have restart command prompt if you were already working in it.

If you were working with atricore console, kindly close it and start josso server with a new command prompt.


Handling warnings / exceptions / errors:

Now, we will discuss the ways to avoid errors:

A. Before starting atricore-console: To get over JAVA_OPTS warning:

Inside command prompt, execute the following:

set JAVA_OPTS=-Xms256M -Xmx1024M

and then execute the atricore command to start josso.

B. After deploying and starting appliance:

You may see HTTP ERROR 404 & 500 when you start the appliance and access the partnerapp.
(Example: http://localhost:8080/partnerapp)

Make note you see the reason of your error from tomcat logs.

Location: <Tomcat-Installation-Directory>\logs\catalina.<date_of_execution>

Based on the error, solution is given below:

(1)  404 Error:

Encountered Server and version: Tomcat 6.0.32 / Tomcat 7.0.94 / Tomcat 8.5.43

Error: 404 - Not found when partnerapp is accessed

Reason:  Parternapp folder not installed / not installated in correct location

Fix:

1. Go to <Tomcat-Installation-Directory>/webapps location in system.

2. You should find partnerapp folder inside webapps.

404 occurs when this partnerapp folder is not found in webapps folder.

3. Go the JOSSO console in browser.

4. Inside appliance modeller, click the execution environment.

5. Check the Install Home path. This path should be where tomcat is installed.
     Example: C:\Apache\Tomcat70

6. If the path is correct / corrected, save the appliance

7. Click Activate tab

8. Check the following in the order below:
         Install Demo

         Overwrite

         Reactivate
9. Once reactivated, partnerapp folder will be present in <Tomcat-Installation-Directory>/webapps location.

10. Rebuild, deploy and start the appliance. Access partnerapp via browser.


(2)  Compilation Error:

(a) Encountered Server and version: Tomcat 6.0.32

Error:

org.apache.jasper.compiler.JDTCompiler$1 findType
SEVERE: Compilation error
org.eclipse.jdt.internal.compiler.classfmt.ClassFormatException

Reason:  Bug found in ecj-3.31 located in <Tomcat-Installation-Directory>\lib folder

Fix:

a. Stop Tomcat server
b. Download ecj4.2.2 from  http://www.java2s.com/Code/Jar/e/Downloadecj422jar.htm
c. Extract jar file from zip
d. Go to <Tomcat-Installation-Directory>/lib 
e. Rename exisitng ecj-3.3.1 to old-ecj-3.31
f. Copy the extracted ecj-4.2.2.jar to this location
g. Rename it to ecj-4.2.2 to ecj-3.3.1
h. Start Tomcat server

(b) Encountered Server and version: Tomcat 7.0.94 / Tomcat 8.5.43

Error: SSOAgent resolves to be a package / anything related to index.jsp

Reason:  JAVA_HOME and PATH environment variables are not set properly

Fix: Make sure your JAVA_HOME and PATH variables are set properly.
        Execute the following in command prompt:
        1. echo %JAVA_HOME% and echo %PATH%
            This should show your variable values set in environment variables.
        2. java -version and javac -version
            This should show the version of java installed and the appropriate path is set

(3)  Login Exception Error:

Encountered Server and version: Tomcat 6.0.32 / Tomcat 7.0.94 / Tomcat 8.5.43

Error:

org.apache.catalina.realm.JAASRealm authenticate
SEVERE: Unexpected error
javax.security.auth.login.LoginException: No LoginModules configured for josso

Reason:  jaas.conf  file is not seen by tomcat server

Fix:

a. Stop Tomcat server

b. Open Configure Tomcat  

     Click <Tomcat-Installation-Directory>\bin\tomcat6w.exe for tomcat 6.0.32

      Click<Tomcat-Installation-Directory>\bin\tomcat7w.exe for tomcat 7.0.94
      Click <Tomcat-Installation-Directory>\bin\tomcat8w.exe for tomcat 8.5.43 

c. Go to JAVA tab

d. In Java Options, append this line:

   -Djava.security.auth.login.config=<Tomcat-Installation-Directory>\conf\jaas.conf

   Replace <Tomcat-Installation-Directory> with the exact path like:

   -Djava.security.auth.login.config=C:\Apache\Tomcat70\conf\jaas.conf   (for tomcat 7.0.94)

e. Click Apply and OK

f. Start Tomcat server

Now your appliance should be working fine.

If there are any other errors encountered, kindly comment below with fixes if any.