Skip to content

Cloning a case (Experts only)

Robert Jacob edited this page Jan 30, 2017 · 1 revision

This is an advanced feature provided for expert users. If you are a new user, skip this section.

If you have access to the run you want to clone, the create_clone command will create a new case while also preserving local modifications to the case that you want to clone. You can run the utility create_clone either from $CCSMROOT or from the directory where you want the new case to be created. It has the following arguments:

-case The name or path of the new case.
-clone The full pathname of the case to be cloned.
-silent Enables silent mode. Only fatal messages will be issued.
-verbose Echoes all settings.
-help Prints usage instructions.

Here is the simplest example of using create_clone:

> cd $CCSMROOT/scripts
> create_clone -case $CASEROOT -clone $CLONEROOT 
create_clone will preserve any local namelist modifications made in the user_nl_xxxx files as well as any source code modifications in the SourceMods tree. Note that the new case directory will be identical to the cloned case directory except for the original cloned scripts ``$CASEROOT.$MACH.``build, ``$CASEROOT.$MACH.``clean_build, ``$CASEROOT.$MACH.``run, and ``$CASEROOT.$MACH.``l_archive, which will have new names in the new case.

Important:: Do not change anything in the env_case.xml file. The $CASEROOT/ directory will now appear as if create_newcase had just been run -- with the exception that local modifications to the env_* files are preserved.

Another approach to duplicating a case is to use the information in that case's README.case file to create a new case. Note that this approach will not preserve any local modifications that were made to the original case, such as source-code or build-script modifications; you will need to import those changes manually.

Clone this wiki locally