Fix (APAR):  PH44666

Status:  Fix

Release:  22.0.0.3

Operating System:  AIX,IBM i,Linux,OS X,Windows,z/OS

Supersedes Fixes:  

CMVC Defect:  xxxxxx

Byte size of APAR:  2617387

Date: 2022-03-09

Abstract:  OpenAPI UI is missing CSS

Description/symptom of problem:  
PH44666 resolves the following problem:

ERROR DESCRIPTION:
The CSS for the OpenAPI UI is not linked correctly,             
resulting in the UI missing most of its styling.                
                                                                
The features affected are: mpOpenAPI-3.0, mpOpenAPI-2.0,        
mpOpenAPI-1.1, mpOpenAPI-1.0, openapi-3.1 and openapi-3.0       
                                                                
?                                                               

LOCAL FIX:

PROBLEM SUMMARY:

USERS AFFECTED:
 All users of IBM WebSphere Application
Server Liberty - OpenAPI and MicroProfile
OpenAPI

PROBLEM DESCRIPTION:
OpenAPI UI is missing CSS

RECOMMENDATION:
None

A code change to update the version of swagger-ui used by the
OpenAPI UI in fixpack 22.0.0.3 broke a link between the HTML
page and its CSS. As a result, the CSS cannot be loaded and the
page is displayed with no styling.

The change which introduced the problem was
https://github.com/OpenLiberty/open-liberty/pull/20054

PROBLEM CONCLUSION:
The OpenAPI UI was rebuilt, fixing the link between the HTML and
the CSS.                                                        
                                                                
The change containing the fix is                                
https://github.com/OpenLiberty/open-liberty/pull/20311          
                                                                
The fix for this APAR is currently targeted for inclusion in fix
pack 22.0.0.4.  Please refer to the Recommended Updates page for
delivery information:                                           
http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980   


Directions to apply fix:  
Install Fix to all WebSphere installations unless special instructions are included below.

Special Instructions: None

NOTE:
The user must:
* Logged in with the same authority level when unpacking a fix, fix pack or refresh pack.
* Be at V1.9.0 or newer of the Installation Manager. Certain iFixes may require a newer version of the Installation Manager and the Installation Manager will inform you during the installation process if a newer version is required.

The IBM Information Center can provide details, if needed, on the use of the Installation Manager to apply the iFixes.
http://www.ibm.com/support/knowledgecenter/SSDV2W_1.8.5/com.ibm.cic.agent.ui.doc/helpindex_imic.html. Shutdown WebSphere Application Server Liberty before applying the iFixes. Restart WebSphere Application Server Liberty after applying the iFixes.

Directions to remove fix:  

The IBM Information Center can provide details, if needed, on the use of the Installation Manager to remove the iFixes.
http://www.ibm.com/support/knowledgecenter/SSDV2W_1.8.5/com.ibm.cic.agent.ui.doc/helpindex_imic.html. Shutdown WebSphere Application Server Liberty before removing the iFixes. Restart WebSphere Application Server Liberty after removing the iFixes.

Directions to re-apply fix:  
1) Shutdown WebSphere Application Server Liberty.

2) Follow the Fix instructions to apply the fix.

3) Restart WebSphere Application Server Liberty.



Additional Information: