12.3. Installing SMOKE

Steps for installing SMOKE:

  1. Make sure that the three files you downloaded from the CMAS website are in the same directory.

  2. Choose the directory where you want to install SMOKE and the data files. This directory will be known as your SMK_HOME directory.

  3. At the command line, type:

    setenv SMK_HOME <your selected directory for SMOKE installation>

    NOTE: the SMOKE scripts are designed to run under the UNIX C-shell (either csh or tcsh); the scripts will not work with other shells such as bash.

  4. Make sure your SMK_HOME directory exists by typing the following command on the command line:

    mkdir -p $SMK_HOME

  5. Go to the directory when you have saved the SMOKE installation files.

  6. Type the following at the command line:

    source smoke_install.csh

    This command will unzip and install the SMOKE files in your SMK_HOME directory. If the script encounters any problems, it will print an error message to point you to the problem.

The SMK_HOME setting is needed by the SMOKE scripts. Therefore, it is best to always have this setting defined when you log into your computer. To do this, perform the following additional steps before proceeding:

  1. Go to your home directory, then use a text editor to view the .cshrc file (note that this file is a hidden file, which can be listed in UNIX using the ls -a command at the prompt).

  2. In the .cshrc file, add the following line:

    setenv SMK_HOME <your selected directory for SMOKE installation>

  3. Save and close the .cshrc file. Your SMK_HOME directory will now be defined automatically when you log into the computer or when you open a new xterm window.

Now you are ready to run the SMOKE nctox case. Running SMOKE is described in Chapter 4, How to Use SMOKE, which discusses using the SMOKE scripts. Please refer to Section 4.3, “Running the SMOKE test case” for instructions on running the example scripts for the nctox case. The current SMOKE documentation can be found online at http://www.smoke-model.org.