Setting up team's Mac mini

scripts/shared-macmini/build-and-test.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+
+# Build and test Serac on team's shared MacMini, then report results to a set of emails
+
+# Update environment
+source ~/.bash_profile
+
+# Variables
+CI_ROOT_DIR="/Users/chapman39/dev/serac/ci"
+PROJECT_DIR="$CI_ROOT_DIR/repo"
+OUTPUT_LOG="$CI_ROOT_DIR/logs/macmini-build-and-test-$(date +"%Y_%m_%d_%H_%M_%S").log"
+HOST_CONFIG="$CI_ROOT_DIR/host-configs/[email protected]"
+RECIPIENTS="[email protected],[email protected],[email protected]"
+
+# Go to project directory
+cd $PROJECT_DIR
+
+# Update Serac
+git checkout task/chapman39/macmini-build >> $OUTPUT_LOG 2>&1 # TODO CHANGE TO DEVELOP
+git pull >> $OUTPUT_LOG 2>&1
+git submodule update --init --recursive >> $OUTPUT_LOG 2>&1
+
+# Clear previous build(s)
+rm -rf _serac_build_and_test* >> $OUTPUT_LOG 2>&1
+
+# Build and test Serac
+python3 ./scripts/llnl/build_src.py --host-config $HOST_CONFIG -v -j16 >> $OUTPUT_LOG 2>&1
+
+# Email variables
+if [ $? -eq 0 ]; then
+    EMAIL_SUBJECT="Serac Succeeded!"
+else
+    EMAIL_SUBJECT="Serac Failed!"
+fi
+EMAIL_SUBJECT="$EMAIL_SUBJECT MacMini build and test report $(date)"
+EMAIL_BODY="This is automatic weekly report of Serac's MacMini build. See attached for log."
+
+# Send report via email
+echo "$EMAIL_BODY" | mutt -a "$OUTPUT_LOG" -s "$EMAIL_SUBJECT" -- "$RECIPIENTS"

scripts/spack/configs/macos_sonoma_aarch64/spack.yaml

@@ -1,129 +1,221 @@
-
 spack:
-  # add package specs to the `specs` list
-  view: true
-  concretizer:
-    unify: true
+  view: false
+
+  compilers::
+  - compiler:
+      spec: clang@=14.0.6
+      paths:
+        cc: /opt/homebrew/opt/llvm@14/bin/clang
+        cxx: /opt/homebrew/opt/llvm@14/bin/clang++
+        f77: /opt/homebrew/bin/gfortran-14
+        fc: /opt/homebrew/bin/gfortran-14
+      flags: {}
+      operating_system: sonoma
+      target: aarch64
+      modules: []
+      environment: {}
+      extra_rpaths:
+      - /opt/homebrew/lib/gcc/14
+
   packages:
     all:
       compiler: [clang, gcc]
       providers:
-        blas: [netlib-lapack]
+        blas: [openblas]
         lapack: [netlib-lapack]
         mpi: [openmpi]
+        zlib-api: [zlib]
+
+    # Providers
     mpi:
       buildable: false
     openmpi:
       buildable: false
       externals:
       - spec: [email protected]_1
         prefix: /opt/homebrew
+    openblas:
+      buildable: false
+      externals:
+      - spec: [email protected]
+        prefix: /opt/homebrew
     netlib-lapack:
       buildable: false
       externals:
       - spec: [email protected]
         prefix: /opt/homebrew/opt/lapack
-    autoconf:
+    zlib-ng:
       buildable: false
       externals:
-      - spec: [email protected]
+      - spec: [email protected]
         prefix: /opt/homebrew
+
+    # External packages from Homebrew
     automake:
       buildable: false
       externals:
-      - spec: automake@1.16.5
+      - spec: automake@1.17
         prefix: /opt/homebrew
     bzip2:
       buildable: false
       externals:
       - spec: [email protected]
         prefix: /opt/homebrew/opt/bzip2
     cmake:
-      version: [3.29.6]
+      version: [3.30.4]
+      buildable: false
+      externals:
+      - spec: [email protected]
+        prefix: /opt/homebrew
+    diffutils:
+      buildable: false
+      externals:
+      - spec: [email protected]
+        prefix: /opt/homebrew
+    expat:
+      buildable: false
+      externals:
+      - spec: [email protected]
+        prefix: /opt/homebrew
+    fmt:
       buildable: false
       externals:
-      - spec: [email protected]
+      - spec: [email protected]
         prefix: /opt/homebrew
     gettext:
       buildable: false
       externals:
       - spec: [email protected]
         prefix: /opt/homebrew
+    gnuconfig:
+      buildable: false
+      externals:
+      - spec: [email protected]
+        prefix: /opt/homebrew
     graphviz:
       buildable: false
       externals:
-      - spec: graphviz@11.0.0
+      - spec: graphviz@12.1.12
         prefix: /opt/homebrew
     libtool:
       buildable: false
       externals:
-      - spec: libtool@2.4.7
+      - spec: libtool@2.5.3
         prefix: /opt/homebrew
     libx11:
       buildable: false
       externals:
-      - spec: [email protected].9
+      - spec: [email protected].10
         prefix: /opt/homebrew
-    llvm:
-      version: [18.1.8]
+    lua:
       buildable: false
       externals:
-      - spec: [email protected]
-        prefix: /opt/homebrew/opt/llvm
+      - spec: [email protected]
+        prefix: /opt/homebrew
     m4:
       buildable: false
       externals:
       - spec: [email protected]
         prefix: /opt/homebrew/opt/m4
-    perl:
+    ninja:
       buildable: false
       externals:
-      - spec: [email protected]~cpanm+opcode+open+shared+threads
-        prefix: /usr
+      - spec: [email protected]
+        prefix: /opt/homebrew
+    openssh:
+      buildable: false
+      externals:
+      - spec: [email protected]
+        prefix: /opt/homebrew
     pkg-config:
       buildable: false
       externals:
       - spec: [email protected]_3
         prefix: /opt/homebrew
+    pkgconf:
+      buildable: false
+      externals:
+      - spec: [email protected]_3
+        prefix: /opt/homebrew
+    readline:
+      buildable: false
+      externals:
+      - spec: [email protected]
+        prefix: /opt/homebrew
+    sqlite:
+      buildable: false
+      externals:
+      - spec: [email protected]
+        prefix: /opt/homebrew
+    xz:
+      buildable: false
+      externals:
+      - spec: [email protected]
+        prefix: /opt/homebrew 
+
+    # External packages in /usr
+    curl:
+      buildable: false
+      externals:
+      - spec: [email protected]
+        prefix: /usr
+    git:
+      buildable: false
+      externals:
+      - spec: [email protected]
+        prefix: /usr
+    gmake:
+      buildable: false
+      externals:
+      - spec: [email protected]
+        prefix: /usr
+    perl:
+      buildable: false
+      externals:
+      - spec: [email protected]~cpanm+opcode+open+shared+threads
+        prefix: /usr
     python:
       buildable: false
       externals:
-      - spec: python@3.12.4+bz2+crypt+ctypes+dbm+lzma+nis+pyexpat~pythoncmd+readline+sqlite3+ssl~tkinter+uuid+zlib
-        prefix: /opt/homebrew/opt/python
+      - spec: python@3.9
+        prefix: /usr
     tar:
       buildable: false
       externals:
       - spec: [email protected]
         prefix: /usr
-    readline:
-      buildable: false
-      externals:
-      - spec: [email protected]
-        prefix: /opt/homebrew
     unzip:
       buildable: false
       externals:
       - spec: [email protected]
         prefix: /usr
-    zlib:
+
+    # Devtools (optional)
+    cppcheck:
+      version: [2.15.0]
       buildable: false
       externals:
-      - spec: [email protected]
+      - spec: [email protected]
         prefix: /opt/homebrew
-
- # The "::" removes all found/known compilers from Spack except for these.
-  compilers::
-  - compiler:
-      spec: clang@=18.1.8
-      paths:
-        cc: /opt/homebrew/opt/llvm/bin/clang
-        cxx: /opt/homebrew/opt/llvm/bin/clang++
-        f77: /opt/homebrew/bin/gfortran-14
-        fc: /opt/homebrew/bin/gfortran-14
-      flags: {}
-      operating_system: sonoma
-      target: aarch64
-      modules: []
-      environment: {}
-      extra_rpaths:
-      - /opt/homebrew/lib/gcc/14
+    doxygen:
+      version: [1.12.0]
+      buildable: false
+      externals:
+      - spec: [email protected]
+        prefix: /opt/homebrew
+    llvm:
+      version: [14.0.6]
+      buildable: false
+      externals:
+      - spec: [email protected]
+        prefix: /opt/homebrew/opt/llvm@14
+    py-sphinx:
+      buildable: false
+      externals:
+      - spec: [email protected]
+        prefix: /Users/chapman39/dev/serac/venv
+    py-ats:
+      buildable: false
+      externals:
+      - spec: [email protected]
+        prefix: /Users/chapman39/dev/serac/venv

src/docs/sphinx/dev_guide/index.rst

@@ -24,6 +24,7 @@ Developer Guide
    codevelop
    state_manager
    equation_solver
+   macmini
 
 Developing a New Physics Module
 -------------------------------

src/docs/sphinx/dev_guide/macmini.rst

@@ -0,0 +1,61 @@
+.. ## Copyright (c) 2019-2024, Lawrence Livermore National Security, LLC and
+.. ## other Serac Project Developers. See the top-level COPYRIGHT file for details.
+.. ##
+.. ## SPDX-License-Identifier: (BSD-3-Clause)
+
+.. _macmini-label:
+
+==========================================
+Adding an Additional User to Serac MacMini
+==========================================
+
+This page assumes you are a Serac developer who requires access to the team's shared MacMini. This machine
+tests Serac Mac builds on a regular basis via cron. If you have any questions, reach out to either
+`Brandon Talamini <[email protected]>`_, `Alex Chapman <[email protected]>`_, or LivIT. The following
+are steps to guide you to gaining access on the machine to the point you're able to build Serac.
+
+1. **Add User**
+
+Without a MyPass, you can still log in using your LLNL username and AD password. Do this first to setup an account on the machine.
+You won't be able to do much, since you do not have access to FileVault, and you are not an admin... yet.
+
+2. **MyPass**
+
+Then, acquire a new MyPass with a USB-C port dedicated to this machine. This will grant you access to FileVault.
+Contact LivIT directly to setup an appointment and request one.
+
+3. **EARS Admin Request**
+
+Next, request admin access to the machine by visiting either ServiceNow or the `EARS website <https://ears.llnl.gov/dashboard>`_.
+
+4. **Two Logins**
+
+Once you have a MyPass and you have admin rights, try to log in again. There should be two passwords required to log in. The first one
+is for your MyPass (assuming it's plugged into to the machine) and the other is for the account login.
+
+5. **Download and setup Brew**
+
+Visit `Brew's website <https://brew.sh/>`_ to install and setup Brew. This is required to install some of Serac's third-party libraries
+(TPLs).
+
+6. **Add New SSH Key to GitHub**
+
+Next step setting up a new SSH Key to your GitHub account so that you're able to clone the Serac repo. In case you do not know
+how to do this, instructions can be found on
+`GitHub's website <https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account>`_.
+
+7. **Install Serac**
+
+You're now able to clone Serac and get started with the installation process. Further instructions for doing so are currently on 
+the `quickstart page <https://serac.readthedocs.io/en/latest/sphinx/quickstart.html#quickstart-label>`_ of the Serac documentation.
+
+================
+Cron Job Example
+================
+
+The following is an example of a cron job that could be used to test a Mac build, assuming TPLs have been built for Serac. Run
+``crontab -e`` to edit the cron file.
+
+.. code-block:: bash
+
+    0 7 * * 4 /Users/chapman39/dev/serac/ci/repo/scripts/shared-macmini/build-and-test.sh