...
You should always use an interactive session for any work when working on Odyssey rather than work on the login node. Working on the login node reduces your available memory and generally slows down the network for other users.
You can use the "interactive" script (downloaded to your bin/ directory during initial setup) to request an interactive session. The requested number of CPUS, nodes, memory (MB), time duration (min), and partition are all configurable. For example, to start an 8-hr interactive session with 13 8 CPUs, 1 node, and 4 GB on the interact partition, type:
interactive 13 8 1 4000 480 interact
You should request at least 3 hours for your interactive session when first setting up with MITgcm since the initial input download will take over an hour. If you plan on running MITgcm interactively rather than submit your job to slurm, you should request a multiple of 13 cores.
Once your interactive session starts up, we recommend that you also run the awake.sh script in the background (type 'awake.sh &'). This will periodically print. a blank line to keep your terminal from freezing. Alternatively, place awake.sh into your .my_personal_settings file and configure your .bashrc to source that file. It will then run every time you start an interactive session.
Step 2: Download the "MITgcm_code" repository
The MITgcm_code directory will serve as the local storage location for all MITgcm input files, including those used in additional MITgcm run directories that you create.
First, navigate to your /n/regal/sunderland_lab/your_user_name folder since you must store the MITgcm_code directory within your regal directory for maximum performance of the model. Next, navigate to whatever subdirectory in your regal directory you want to work in. Finally, type the following commands to download the MITgcm_code repository.
...
Step 3: Set up the initial PCB run directory
Change directories into MITgcm_code which you just cloned. Execute shell script make_initial_pcb_rundir.sh. Note that downloading input files from the Sunderland_lab space to your regal directory will take a while. For this reason, it is only done once and additional run directories that you set up later in the last step below will symbolically link to files in this directory.
Pay attention to the text output to learn what the script is doing. After it is complete instructions are printed out to clone the pkg/ source code repository developed by Helen Amos. Follow these instructions before proceeding.
The MITgcm_code directory will serve as the local storage location for all MITgcm input files, including those used in additional MITgcm directories that you create. For this reason, once you clone it and set it up using the instructions above, do not rename it or move it. Due to the 90-day storage retention on Odyssey, you will need to periodically perform this setup step again in the future to prevent the files from being deleted.
Step 4: Download the "hamos_mitgcm_pkg" repository
...