Details.md

Details

Installation Highlights

• Fedora x64
• WebSphere Liberty
• WAS traditional Base
• IBM Java 8
• IBM HTTP Server
• OpenLDAP
• DayTrader7 on WebSphere Liberty connected to OpenLDAP
• DayTrader7 on WAS traditional connected to OpenLDAP
• IBM Garbage Collection Memory Visualizer (GCMV)
• Eclipse Memory Analyzer Tool (MAT)
• IBM Java Health Center (HC)
• NMONVisualizer
• IBM Runtime Diagnostic Code Injection (Java Surgery)
• Request Metrics Analyzer Next
• IBM Thread and Monitor Dump Analyzer (TMDA)
• IBM HeapAnalyzer (HA)
• IBM Pattern Modeling and Analysis Tool for Java Garbage Collector (PMAT)
• IBM Trace and Request Analyzer for WAS (TRA)
• IBM ClassLoader Analyzer
• Eclipse IDE for Enterprise Java and Web Developers
  • IBM Liberty Developer Tools
• Firefox
• LibreOffice
• Wireshark
• Apache JMeter
• OpenJDK 8
• Eclipse Mission Control
• IBM Semeru (V8, V11, V17)
• Eclipse Temurin (V8, V11, V17)
• Liberty Bikes
• TrapIt.ear
• swat.ear
• WebSphere Application Server Configuration Comparison Tool
• WAS Data Mining
• WebSphere Performance Cookbook
• MariaDB
• Apache Derby
• IBM Channel Framework Analyzer
• IBM Web Server Plug-in Analyzer for WebSphere Application Server (WSPA)
• Connection and Configuration Verification Tool for SSL/TLS
• WebSphere Application Server Configuration Visualizer
• Problem Diagnostics Lab Toolkit
• Performance Tuning Toolkit
• SIB Explorer
• SIB Performance
• IBM Database Connection Pool Analyzer for IBM WebSphere Application Server
• Eclipse MAT Source
• IBM Service Integration Bus Destination Handler

Known Limitations

• Audio is not configured. In theory, it should be possible by configuring the host and run commands for audio passthrough and starting pulseaudio in the container with pulseaudio -D.

Development

Building

1. Prepare:
   1. macOS: Install the following and then open a new terminal window.

      brew install pandoc
      brew install --cask mactex
      

2. Delete existing images:

   podman stop --all
   podman system prune --all --force
   podman rmi --all
   

3. Use the root podman connection:

   podman system connection default podman-machine-default-root
   

4. Update version number, date and revision history in WAS_Troubleshooting_Perf_Lab.md
5. Update version number, date and revision history in Liberty_Perf_Lab.md
6. Update version numbers in the echos at the bottom of Containerfile
7. Generate lab PDF (yes, this is before building the final image):

   sed 's/<img src="\(.*\)" width.*\/>/![](\1)/g' WAS_Troubleshooting_Perf_Lab.md > WAS_Troubleshooting_Perf_Lab_imagesconverted.md
   pandoc --pdf-engine=xelatex -V geometry:margin=1in -s -o WAS_Troubleshooting_Perf_Lab.pdf --metadata title="WebSphere Application Server Troubleshooting and Performance Lab" WAS_Troubleshooting_Perf_Lab_imagesconverted.md
   rm WAS_Troubleshooting_Perf_Lab_imagesconverted.md
   

8. Generate Liberty lab PDF:

   sed 's/<img src="\(.*\)" width.*\/>/![](\1)/g' Liberty_Perf_Lab.md > Liberty_Perf_Lab_imagesconverted.md
   pandoc --pdf-engine=xelatex -V geometry:margin=1in -s -o Liberty_Perf_Lab.pdf --metadata title="Liberty Performance Lab" Liberty_Perf_Lab_imagesconverted.md
   rm Liberty_Perf_Lab_imagesconverted.md
   

9. If needed, update Liberty build in MAVEN_LIBERTY_VERSION in fedorawasdebug/Containerfile
10. git add, commit, and push.
11. Remove any previous IHS zips
12. Click the first "Download Fix Pack..." link at https://www.ibm.com/support/pages/fix-list-ibm-http-server-version-90 and follow through the "IBM HTTP Server archive file for 64-bit Linux, x86" link to download *IHS-ARCHIVE*zip
13. podman manifest create quay.io/ibm/webspherelab:latest
    1. If there is an error, instead run:
       1. podman manifest inspect quay.io/ibm/webspherelab | jq '.manifests[].digest' | tr '\n' ' ' | sed 's/"//g'
       2. For each digest, run podman manifest remove $DIGEST quay.io/ibm/webspherelab
14. podman build --platform linux/amd64 --manifest quay.io/ibm/webspherelab:latest .
15. podman build --platform linux/arm64 --manifest quay.io/ibm/webspherelab:latest .
16. Double check the manifest:

    podman manifest inspect quay.io/ibm/webspherelab
    

17. Run the image:

    podman run --rm -p 5901:5901 -p 5902:5902 -p 3390:3389 -p 9080:9080 -p 9443:9443 -it quay.io/ibm/webspherelab
    

18. Test the image (password websphere):
    • macOS:

      open vnc://localhost:5902
      

19. git commit -am "VXX: New version with ..."
20. git push
21. podman login quay.io
22. podman images
23. Tag the image with the version:

    podman tag quay.io/ibm/webspherelab quay.io/ibm/webspherelab:VXX
    

24. Push all the VXX images:

    podman push quay.io/ibm/webspherelab:VXX
    

25. Push the latest tags:

    podman push quay.io/ibm/webspherelab:latest
    

26. git tag VXX
    

27. git push --tags
    

28. Delete old images from https://quay.io/repository/ibm/webspherelab?tab=tags