Change the default SCC directory

[hangshao0]

Change the default SCC directory on Linux, AIX and MacOS to $HOME/.cache/javasharedresources/

Depends on eclipse-openj9/openj9-docs#1016
Closes #11417

Signed-off-by: Hang Shao hangshao@ca.ibm.com

[hangshao0]

Tested on:
Java 8 Linux_x64, sanity.functional and extended.functional
Java 11 AIX PPC64, sanity.functional and extended.functional
All passed.

Documentation issue is eclipse-openj9/openj9-docs#1016

[dsouzai]

Once this change is in, $HOME/javasharedresources will need to be deleted from all the farm machines since I don't think it'll automatically get deleted with -Xshareclasses:destroyAll right?

[hangshao0]

Once this change is in, $HOME/javasharedresources will need to be deleted from all the farm machines since I don't think it'll automatically get deleted with -Xshareclasses:destroyAll right?

No, it won't be deleted by -Xshareclasses:destroyAll after this change is merged. Our documentation will be updated to suggest users to delete the stale cache files and directory.

I remember we run -Xshareclasses:destroyAll to clean up the shared cache before and after each test. so we may not need to worry about the cache files. But for the directory $HOME/javasharedresources itself, we may need cleanup job to delete it. FYI @llxia @AdamBrousseau

[pshipton]

The doc says non-z/OS. Why not z/OS? Non-persistent control files should also go under .cache.

[hangshao0]

https://www.eclipse.org/openj9/docs/xshareclasses/#cachedir

On z/OS, the default directory is /tmp/javasharedresources, not under home.

It was changed back to /tmp/javasharedresources from home by #13438.

[pshipton]

jenkins compile aix,xmac jdk8

[pshipton]

jenkins compile alinux64,amac jdk17

[pshipton]

We can't rely on the tests having cleaned up $HOME/javasharedresources. I looked at one idle xlinux machine and found the following, two of which are old. The size is deceiving as they are sparse files, but still worth cleaning up at some point.

-rw------- 1 jenkins jenkins 314572800 Feb 19  2019 C290M11F1A64P_sharedcc_jenkins_G35
-rw------- 1 jenkins jenkins 314572800 Nov  3 20:01 C290M11F1A64P_sharedcc_jenkins_G43L00
-rw------- 1 jenkins jenkins 314572800 Oct  7 18:04 C290M17F1A64P_sharedcc_jenkins_G43L00

21M	javasharedresources/C290M11F1A64P_sharedcc_jenkins_G35
24M	javasharedresources/C290M11F1A64P_sharedcc_jenkins_G43L00
2.7M	javasharedresources/C290M17F1A64P_sharedcc_jenkins_G43L00

[hangshao0]

Maybe the cleanup job should be updated to run -Xshareclasses:destroyAll. But it is not guaranteed to be a clean solution, depending on the version of default Java on the machine. e.g if it is Java 11, it will not be able to delete a Java 20 shared cache that is left over on the machine.

[pshipton]

$HOME/javasharedresources will need to be deleted from all the farm machines

To clarify, only jenkins / OpenJ9 is affected. IBM Java / vmfarm is not.