Chris Kline

Introscope Workstation Images for Mac

Discussion created by Chris Kline Employee on Mar 7, 2013
Latest reply on Nov 4, 2018 by Hallett_German

*Updated for latest process at APM 10.7 (on Mac 10.13)*

 

First, let me share that this is not an officially supported distribution. You cannot call support for help with this.  

However, using the very same files as are found in the Linux version of the workstation, I've created .app files for Mac, so you just use them like a regular app. The JNLP Web Start doesn't presently launch cleanly on Mac, so this is the better way to get full client functionality.

 

Pre-packaged Download

Currently supported versions of APM have workstation packages for Mac attached below.  

 

Manual Build Steps

If you wish to make your own images, here's the steps used. If you have a linux set of files to pull from, it takes less than 10 minutes to setup.

  1. Install workstation on Linux to gain access to files
    1. Untar the Linux version of the workstation tar from support.ca.com and run the installer on a Linux VM (there is no distro that is just the files only; everything is wrapped in .bin)
    2. Install necessary service packs, packaged as JAR files.  Presently for 10.7, this includes SP2. After installing the 10.7.0 workstation, copy the APM10.7.0.115SP2.jar to the Introscope Workstation directory. Then run it with java -jar. It will automatically patch the workstation (in my case from build 45 to build 115). 
  2. Copy Linux workstation to Mac
    1. Still on Linux, create a tarball of the entire workstation directory and copy the file over to Mac.
  3. Build Mac workstation. 
    1. Untar the Linux workstation file copied from above into a temp dir.
    2. Copy the old Mac .app (like 10.5) to to a new one.  Rename it to the correct new version (but still with the old files in it).
      1. We will whack the workstation subtree, but this will retain the package format
    3. Update the Info.plist with new CFBundleVersion (10.7.0.115).  Keep the rest the same
    4. Go to Resources/WilyWorkstation. This is the actual workstation subtree.
      1. Remove everything
  4. In your temp directory containing the exported Linux workstation, remove unnecessary stuff
    1. Remove jre/ UninstallerData/ install/ logs/ docs/ hotfix/
    2. Resulting dir tree should be about 95 mb in size
  5. Copy the remaining files from the temp dir into Resources/WilyWorkstation on your .app/ subtree.
  1. Run to make sure it's working
    1. Edit the workstation .lax file for a 1gig java heap (default is much smaller).
    2. Shouldn't need any further customizations
    3. Workstation requires java 8.  If you have java 10+ already installed and cannot go back to java8 for other reasons, follow these instructions to get java8 also installed: https://pete-woods.com/2018/01/multiple-jvm-versions-on-macos/. It will then work when launched from CLE (at CA APM Workstation 10.7.0.115.app/Contents/Resources/WilyWorkstation) with jenv global set to java8. Tested with APM 10.7.
    4. Double-click on the .app file and see that it launches correctly.  This app can now be shared around with others.
  2. Create a new image (dmg) for distribution.
    1. Check size of dir with du
    2. Use disk utility to create a new disk image (or you can copy an existing one and remove its old content, but you'll need to empty the trash before the existing image will have enough room for your new .app to be copied)
    3. Make the image the right size (we did 100mb, custom)
    4. Format: Mac OS Extended
    5. Partition: Single partition (default)
    6. Image name should have format CA_Wily_Introscope_Workstation-10.7.0.0.dmg.
  3. Mount the image, drag the app dir that you made into it
  4. Right-click, reveal in finder
  5. Create a readme telling to drag the app to apps folder and noting any custom changes you made.

    The <app_name.app>/Contents/MacOS/Introscope_workstation script:
#!/bin/sh DIR=`dirname "$0" | sed 's! !\\ !g'` DIR=$DIR/../Resources/WilyWorkstation cd "$DIR" #echo "*****" #echo "PWD = $PWD" exec ./Introscope_Workstation

Which in turn calls <app_name.app>/Contents/Resources/WilyWorkstation/IntroscopeWorkstation

I think this is the stock startup script for Linux, though I've copied it into the bottom of this page for comparison in case it ever gets trashed.

 

10/2018: Now need to apply jar file for service packs. Needs to be done on Linux before exporting the tarball for Mac. After installing the 10.7.0, copy the APM10.7.0.115SP2.jar to the Introscope Workstation directory. Then run it with java -jar. It will automatically patch the workstation (in my case from build 45 to build 115). It also leaves behind a hotfix directory of about 80mb that is no longer needed and which can be removed to save on the disk image size. This was done for 10.7 SP2.

 

10/2018: Keep in mind that this only works with Java 8, not Java 10. If you have java 10+ already installed and cannot go back to java8 for other reasons, follow these instructions to get java8 also installed: https://pete-woods.com/2018/01/multiple-jvm-versions-on-macos/. It will then work when launched from CLE (at CA APM Workstation 10.7.0.115.app/Contents/Resources/WilyWorkstation) with jenv global set to java8. Tested with APM 10.7.

Outcomes