******************************** Filename: README.config Software: Mathematica Locker: math_v11.2 Last Updated: 9/18/17 Alex Prengel ******************************** VOLUMES IN LOCKER: Volume Mounted at Replicated? ------- ---------- ----------- sw.math_v11.2 top level No LINKS TO VOLUMES/LOCKERS: CHANGES FOR ATHENA: We make the install root be at /mit/math_v11.2/distrib. Running Mathematica 11.2 automatically creates a .Mathematica directory in the user's home dir with various configuration settings. We instead create a directory .Mathematica.11.2 (if this does not already exist) and a link .Mathematica -> .Mathematica.11.2 to separate this from configuration files for other Mathematica versions (this is done in vendor's scripts, not our wrapper). We don't need to modify the vendors's architecture-specific directories (Linux, Linux-x86-64), with some exceptions- this is in /mit/math_v11.2/distrib/SystemFiles/Graphics/Binaries, where we make $ATHENA_SYS equivalents of these in order to have platform- independent launch scripts for the graphics utilities there, and in /mit/math_v11.2/distrib/SystemFiles/Libraries, to allow putting this dir on LD_LIBRARY_PATH script for wrapper script to launch psrender (needs to find libML64i3.so or libML32i3.so). We also add $ATHENA_SYS equivalents in /mit/math_v11.2/distrib/SystemFiles/Kernel/Binaries, to facilitate accessing wolframscript. Tell installer to put Mathematica scripts in /var/tmp (they are links which we replace with ones in the arch hierarchy). Make in Configuration/Licensing/mathpass, containing: % MachineName % !license-3.mit.edu PROGRAMS IN LOCKER: Mathematica (both GUI and command-line versions) STARTUP SCRIPT: DESCRIPTION "mathematica", "math", "MathKernel" and "mcc" are links to vendor scripts in: /mit/math_v11.2/distrib/Executables. "mathematica" and "math" are slightly edited. The edits consist mostly in setting up the .Mathematica directory. wolframscript in the arch hierarchy links to vendor binary in /mit/math_v11.2/distrib/SystemFiles/Kernel/Binaries/@sys INSTALLATION This can be done directly to the final AFS location MAKING CHANGES SPECIAL NOTES The 11.2 license server is backwards compatible with earlier clients. ACLS to font dirs should be set to system:anyuser l down to the actual font dirs, which should be system:anyuser rl: /Linux-x86-64/ /mit/math_v11.2/distrib/SystemFiles/Java/Linux/lib/fonts /mit/math_v11.2/distrib/SystemFiles/Components/Templating/Resources/StaticLoader/fonts /mit/math_v11.2/distrib/SystemFiles/Fonts We make links for our @sys values in /mit/math_v11.2/distrib/SystemFiles/Links/MathLink/DeveloperKit for TeXmacs Mathematica session invocation. For some reason, the "math" script for command-line launch gets invoked by the "mathematica" script for GUI launch now, resulting in both the local GUI and command-line local messages to be printed on GUI launch. We suppress this by setting a flag environment variable in the "mathematica" launch script that is looked for in the "math" script. The installer may create a /usr/share/Mathematica tree on the install machine. Be sure to delete this as it may interfere with add-on package documentation in the Help system, among other things. The link to wolframscript in /mit/math_v11.2/arch/$ATHENA_SYS/bin must be absolute rather than relative: wolframscript -> /afs/athena.mit.edu/software/math_v11.2/distrib/SystemFiles/Kernel/Binaries/@sys/wolframscript to get around a bug in how the wolframscript binary determines its own location. Workaround to fix R link: install libg2c.so.0.0.0 from Hardy: libg2c0_3.4.6-6ubuntu5_i386.deb (32 bit) lib64g2c0_3.4.6-6ubuntu3_i386.deb (64 bit) in /mit/math_v11.2/arch/@sys/lib, edit vendor math and mathematica scripts to put this on LD_LIBRARY_PATH. MAINTENANCE NOTES: To enable running makepsres and psrender without additional ATHENA_SYS values beyond the original ones, we make a short wrapper script using athdir to set path to these and put it in /mit/math_v11.2/arch/share/bin; links to this from the respective bin dirs in the arch hierarchy should make them launch properly. Installing R link: The following should use a local R installation, but Wolfram docs state this works only on Windows currently: Needs["RLink`"] RLinkResourcesInstall[] InstallR["RHomeLocation" -> "/afs/athena.mit.edu/software/r/current/lib/R"] The following uses Wolfram's R distribution: Needs["RLink`"] RLinkResourcesInstall[] InstallR[] ******************************************************************************* locations: version locker: /mit/math_v11.2 root of vendor's tree: /mit/math_v11.2/distrib X resources: none keysym file: none vendor-designed common tree for multiple platforms? : yes license key file: /mit/math_v11.2/distrib/Configuration/Licensing/mathpass (server name only) vendor launch script or link: (locally modified) /mit/math_v11.2/distrib/Executables/mathematica (GUI) /mit/math_v11.2/distrib/Executables/wolfram (TTY) /mit/math_v11.2/distrib/Executables/math (TTY) /mit/math_v11.2/distrib/Executables/mcc (Mathlink compiler) main binary: /mit/math_v11.2/distrib/ /Linux/ SystemFiles/FrontEnd/Binaries/Linux-x86-64/Mathematica (X front end) /mit/math_v11.2/distrib/ /Linux/ SystemFiles/Kernel/Binaries/Linux-x86-64/WolframKernel (kernel) wrapped? : yes ("everybody" restriction) @sys links used inside locker? : yes software protection? : yes helper application binaries: /mit/math_v11.2/distrib/SystemFiles/ Linux Graphics/Binaries/Linux-x86-64/psrender (ps renderer) See also converters in: Linux /mit/math_v11.2/distrib/SystemFiles/Converters/Binaries/Linux-x86-64 unusual aspects of configuration: The vendor uses their own architecture-specific sysnames (i.e. Linux-x86-64, Linux) For some reason, wrapping now causes double entries in the wrapper log when the graphical interface is launched.