Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 20 Next »

These instructions assume the machine you're using has already installed all the necessary software such as fortran compilers, MPI libraries, netcdf libraries, pnetcdf libraries, etc.  See /wiki/spaces/ED/pages/1867951 for a list of necessary software to build/run ACME.

Installing on a supported cluster.

If you intend to do E3SM development, you should instead follow steps 1-12 in the Development Getting Started Guide and return to step 7 here.

These steps assume you are a member of the E3SM project.   Check the /wiki/spaces/ED/pages/1867951 page to see if your machine is supported.

  1. Sign up for a free account at http://github.com
  2. Submit a ticket to the SE/CG Testing & CI Support Help Desk and ask to be added to the E3SM private organization on github.  Include your Confluence account name so we can verify you're a member of E3SM.      OR   "fork" the model to your own github account.

  3. Log on to the platform on which you want to run E3SM.  

  4. Install an ssh key from that platform to your github account.  See these instructions and note you can skip step 2 if you already have an ssh key on your machine.
  5. Clone the repository to your local account with:  git clone  --recursive git@github.com:E3SM-Project/E3SM.git  This will create a directory called "E3SM" with the code.
  6. cd to the E3SM directory.
  7. OPTIONAL When running with an MPAS component: Currently (until a better solution is found), it's useful to go into the components/mpas-source/src/core_ocean directory and run the two scripts get_cvmix.sh and get_BGC.sh to download those libraries so they are later replicated by the case creation process below. It's not required, but will bypass some credential entry during later builds.
  8. You are now ready to create a case, build and run following the CIME quick guide.   By default, you will be running the latest version of "master".

Installing on an un-supported cluster.

Follow steps 1-6 above.   If you want to make it supported, treat the steps as code development (done on a branch) following the Development Getting Started Guide.   You first have to tell the CIME case control system about your machine.  Complete instructions are in CIME Porting Guide and summarized here.

  1. Add your machine to <E3SM>/cime_config/machines/config_machines.xml where <E3SM> refers to the repository root.
    1. The easiest approach is probably to copy the configuration for some other machine and then replace all the values
    2. Choose a directory to serve as the inputdata store called DIN_LOC_ROOT in config_machines.xml.   Ideally, this should be readable by all E3SM developers on your platform.
    3. Most of the values should be obvious. You can look at the "userdefined" block to see which items are required and to see documentation on each item.
  2. Add compiler-specific information for each compiler supported by your machine to <E3SM>/cime_config/machines/config_compilers.xml
    1. Here, for each compiler you want to support, you'll need to create a block <compiler COMPILER="<toolset>" MACH="<machine>">
    2. This block will inherit the properties of the primary block for that toolset and allow you to add/override values for your machine.
      1. The most common thing you'll need to do is add link flags with the ADD_SLIBS item.
      2. You may also need to define NETCDF_PATH and PNETCDF_PATH
  3. Add batch settings for your machine by editing <E3SM>/cime_config/machines/config_machines.xml
    1. Machines with similar batch systems should serve a good example of what to add.
    2. If you need a batch system that doesn't exit or special settings, you may have to edit <E3SM>/cime_config/machines/config_batch.xml
    3. You may need to add a machine specific section in config_batch.xml that inherits from the global section for a specified batch system (e.g., pbs).
  4. In certain special cases, you may wish to add/edit <E3SM>/cime_config/machines/Depends.<platform>.<compiler> to tweak compilation options for specific files.
  5. Verify the install is working by building and running a simple X case.
    1. <E3SM>/cime/scripts/create_newcase --case <yourcasename> --compset X --res f19_g16 --mach <yourmachine>
  6. If the X case works, try more complex cases.
    1. <E3SM>/cime/scripts/create_newcase --case <yourcasename> --compset I1850CLM45CN --res f09_g16 --mach <yourmachine>
    2. <E3SM>/cime/scripts/create_newcase --case <yourcasename> --compset FC5 --res ne30_ne30 --mach <yourmachine>
      1. If you have more then one compiler, add -compiler <compiler> to the above.
      2. The above should run for 5 days successfully.



  • No labels