IBM Support

ERROR 500 (Internal Server Error) When Accessing 'IBM Systems Director Navigator' or 'IBM Web Administration for i5/OS' in HTTP ADMIN

Technote (troubleshooting)


Problem(Abstract)

When accessing the 'IBM Systems Director Navigator' or 'IBM Web Administration for i5/OS' link in the HTTP ADMIN GUI, an 'Internal Server Error' or ERROR 500 message appears in the browser. This usually occurs due to one of the necessary ADMIN jobs in the QHTTPSVR subsystem failing to start properly.

Resolving the problem

The ADMIN IBM powered by Apache HTTP server utilizes the Integrated Application Server (IAS), which is responsible for serving the content of the IBM Web Administration for i5/OS link. When an ERROR 500 - Internal Server message is received when accessing the site, it is typically caused by one of these IAS server jobs not starting properly. Below are some typical causes of the problem and their solution:

  • V7R1

      Here is an example of how the HTTP ADMIN jobs should look in the QHTTPSVR subsystem:

      QHTTPSVR subsystem view of Admin jobs

      When any of the jobs that have a user of QLWISVR or QWEBADMIN (ADMIN1, ADMIN2, ADMIN4 or ADMIN5) fail to start, it causes the ERROR 500 - Internal Server Error.

      Typical Problems/Solutions to the Problem:

    • The HTTP group PTF (SF99368) and/or the Java group PTF (SF99572) is backleveled


      a. On the WRKPTFGRP screen, check the level of the HTTP group PTF (SF99368) as well as the Java group PTF (SF99572), and check if the status is 'Installed'. If it is in a 'Not Installed' status, an IPL may be required to apply all of the PTFs in the group.

      b. Check our Preventative Service Planning website to make sure the HTTP and Java group PTF levels are at the latest level:

      http://www-912.ibm.com/s_dir/sline003.nsf/GroupPTFs?OpenView&Start=1&Count=30&Collapse=1#1

      c. If either the HTTP or Java group PTF level is not at the current level, it is recommended that these be installed. Note: The HTTP group (SF99368) will automatically order the Java group PTF (SF99572) when it is ordered. This was done in order to always keep both at the most current level.

    • One of the prerequisite licensed products is not installed


      Required Licensed programs:

        5770SS1 option 30 - QShell
        5770SS1 option 33 - Portable App Solutions Environment (PASE)
        5761JV1 *BASE
        5761JV1 option 14 - Java SE 7 32 bit
        5761JV1 option 15 - Java SE 7 64 bit
        or
        5761JV1 option 17 - Java SE 8 64 bit

      Check GO LICPGM option 10 to make sure these licensed programs are installed. If these are not installed the following document shows how to obtain this licensed programs from the Entitled Software Support site:

      http://www.ibm.com/support/docview.wss?uid=nas8N1011217

      • The JVM that the ADMIN1, ADMIN2, ADMIN4, and ADMIN5 jobs use is not functioning properly


        To test the JVM that the ADMIN IAS jobs use, perform the following steps:

        a. On the IBM i command line type the following command:

        CALL QSYS/QHCRPRECHK

        b. The command will check each version of Java on the system as well as PASE to see if everything works properly. If everything is successful the screen should look like the following:

        Image of QHCRPRECHK output


        c. If there are any errors thrown it will indicate whether PASE or Java encountered errors. This will dictate which licensed products will need to be reinstalled from media.

        If a reinstall of the 5761JV1 is needed we would also need to reinstall the Java group PTF (SF99572) with an IPL.

        • Symbolic links are missing from the IFS


          There are two key symbolic link files that are used for QShell functions used by the HTTP Admin server jobs. On some systems these symbolic link files can be missing. The following are steps to check for the existence of the files and how to re-create them if they are missing:

          a. On the IBM i command line, issue the STRQSH command to enter QShell.

          b. Type the following commands (pressing Enter after each one):

          ls -l /bin

          then type:

          ls -l /lib

          c. The results should look as follows:

          Screen shot of QShell symbolic link check

          d. If these objects are not found, we will need to re-create the ones that are missing by issuing the following commands in QShell:

          To create the /bin symbolic link, type the following:

          ln -s /usr/bin /bin

          To create the /lib symbolic link, type the following:

          ln -s /usr/lib /lib

          e. If you repeat Step b, you now should see symbolic links similar to the screen shot above.

      • V7R2

          Here is an example of how the HTTP ADMIN jobs should look in the QHTTPSVR subsystem:

          QHTTPSVR subsystem view of Admin jobs

          When any of the jobs that have a user of QLWISVR or QWEBADMIN (ADMIN1, ADMIN2, ADMIN4 or ADMIN5) fail to start, it causes the ERROR 500 - Internal Server Error.

          Typical Problems/Solutions to the Problem:

        • The HTTP group PTF (SF99713) and/or the Java group PTF (SF99716) is backleveled


          a. On the WRKPTFGRP screen, check the level of the HTTP group PTF (SF99713) as well as the Java group PTF (SF99716), and check if the status is 'Installed'. If it is in a 'Not Installed' status, an IPL may be required to apply all of the PTFs in the group.

          b. Check our Preventative Service Planning website to make sure the HTTP and Java group PTF levels are at the latest level:

          http://www-912.ibm.com/s_dir/sline003.nsf/GroupPTFs?OpenView&Start=1&Count=30&Collapse=1#1

          c. If either the HTTP or Java group PTF level is not at the current level, it is recommended that these be installed. Note: The HTTP group (SF99713) will automatically order the Java group PTF (SF99716) when it is ordered. This was done in order to always keep both at the most current level.

        • One of the prerequisite licensed products is not installed


          Required Licensed programs:
          5770SS1 option 30 - QShell
          5770SS1 option 33 - Portable App Solutions Environment (PASE)
          5770JV1 *BASE
          5770JV1 option 14 - Java SE 7 32 bit
          5770JV1 option 15 - Java SE 7 64 bit
          or
          5770JV1 option 17 - Java SE 8 64 bit

          Check GO LICPGM option 10 to make sure these licensed programs are installed. If these are not installed the following document shows how to obtain this licensed programs from the Entitled Software Support site:

          http://www.ibm.com/support/docview.wss?uid=nas8N1011217

        • The JVM that the ADMIN1, ADMIN2, ADMIN4, and ADMIN5 jobs use is not functioning properly


          To test the JVM that the ADMIN IAS jobs use, perform the following steps:

          a. On the IBM i command line type the following command:

          CALL QSYS/QHCRPRECHK

          b. The command will check each version of Java on the system as well as PASE to see if everything works properly. If everything is successful the screen should look like the following:

          CALL QHCRPRECHK screenshot


          c. If there are any errors thrown it will indicate whether PASE or Java encountered errors. This will dictate which licensed products will need to be reinstalled from media.

          If a reinstall of the 5770JV1 is needed we would also need to reinstall the Java group PTF (SF99716) with an IPL.

        • Symbolic links are missing from the IFS


          There are two key symbolic link files that are used for QShell functions used by the HTTP Admin server jobs. On some systems these symbolic link files can be missing. The following are steps to check for the existence of the files and how to re-create them if they are missing:

          a. On the IBM i command line, issue the STRQSH command to enter QShell.

          b. Type the following commands (pressing Enter after each one):

          ls -l /bin

          then type:

          ls -l /lib

          c. The results should look as follows:

          Screen shot of QShell symbolic link check

          d. If these objects are not found, we will need to re-create the ones that are missing by issuing the following commands in QShell:

          To create the /bin symbolic link, type the following:

          ln -s /usr/bin /bin

          To create the /lib symbolic link, type the following:

          ln -s /usr/lib /lib

          e. If you repeat Step b, you now should see symbolic links similar to the screen shot above.

      • V7R3

          Here is an example of how the HTTP ADMIN jobs should look in the QHTTPSVR subsystem:

          QHTTPSVR subsystem view of Admin jobs

          When any of the jobs that have a user of QLWISVR or QWEBADMIN (ADMIN1, ADMIN2, ADMIN3, ADMIN4 or ADMIN5) fail to start, it causes the ERROR 500 - Internal Server Error.

          Typical Problems/Solutions to the Problem:

        • The HTTP group PTF (SF99722) and/or the Java group PTF (SF99725) is backleveled


          a. On the WRKPTFGRP screen, check the level of the HTTP group PTF (SF99722) as well as the Java group PTF (SF99725), and check if the status is 'Installed'. If it is in a 'Not Installed' status, an IPL may be required to apply all of the PTFs in the group.

          b. Check our Preventative Service Planning website to make sure the HTTP and Java group PTF levels are at the latest level:

          http://www-912.ibm.com/s_dir/sline003.nsf/GroupPTFs?OpenView&Start=1&Count=30&Collapse=1#1

          c. If either the HTTP or Java group PTF level is not at the current level, it is recommended that these be installed. Note: The HTTP group (SF99722) will automatically order the Java group PTF (SF99725) when it is ordered. This was done in order to always keep both at the most current level.

        • One of the prerequisite licensed products is not installed


          Required Licensed programs:
          5770SS1 option 30 - QShell
          5770SS1 option 33 - Portable App Solutions Environment (PASE)
          5770JV1 *BASE
          5770JV1 option 14 - Java SE 7 32 bit
          5770JV1 option 15 - Java SE 7 64 bit
          or
          5770JV1 option 17 - Java SE 8 64 bit

          Check GO LICPGM option 10 to make sure these licensed programs are installed. If these are not installed please perform a GO LICPGM opt. 11 and install them from the B_GROUPx_05 disc that comes with the OS.

        • The JVM that the ADMIN1, ADMIN2, ADMIN3, ADMIN4 and ADMIN5 jobs use is not functioning properly


          To test the JVM that the ADMIN IAS jobs use, perform the following steps:

          a. On the IBM i command line type the following command:

          CALL QSYS/QHCRPRECHK

          b. The command will check each version of Java on the system as well as PASE to see if everything works properly. If everything is successful the screen should look like the following:

          CALL QHCRPRECHK screenshot


          c. If there are any errors thrown it will indicate whether PASE or Java encountered errors. This will dictate which licensed products will need to be reinstalled from media.

          If a reinstall of the 5770JV1 is needed we would also need to reinstall the Java group PTF (SF99725) with an IPL.

        • Symbolic links are missing from the IFS


          There are two key symbolic link files that are used for QShell functions used by the HTTP Admin server jobs. On some systems these symbolic link files can be missing. The following are steps to check for the existence of the files and how to re-create them if they are missing:

          a. On the IBM i command line, issue the STRQSH command to enter QShell.

          b. Type the following commands (pressing Enter after each one):

          ls -l /bin

          then type:

          ls -l /lib

          c. The results should look as follows:

          Screen shot of QShell symbolic link check

          d. If these objects are not found, we will need to re-create the ones that are missing by issuing the following commands in QShell:

          To create the /bin symbolic link, type the following:

          ln -s /usr/bin /bin

          To create the /lib symbolic link, type the following:

          ln -s /usr/lib /lib

          e. If you repeat Step b, you now should see symbolic links similar to the screen shot above.




        If the problem is still occurring after following the instructions in this document please run our QMGTOOLS ADMIN collector to submit data to IBM service to look into the issue further:

        http://www.ibm.com/support/docview.wss?uid=nas8N1020078


        Cross reference information
        Segment Product Component Platform Version Edition
        Operating System IBM i 6.1
        Operating System IBM i 7.3
        Operating System IBM i 7.2
        Operating System IBM i 7.1

        Historical Number

        536510002

      Document information

      More support for: IBM i
      Communications-TCP

      Software version: 7.1, 7.1.0, 7.2, 7.2.0, 7.3

      Operating system(s): IBM i

      Reference #: N1018538

      Modified date: 10 July 2013