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 EDSS_ROOT directory.

  3. At the command line, type:

    setenv EDSS_ROOT <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 EDSS_ROOT directory exists by typing the following command on the command line:

    mkdir -p $EDSS_ROOT

  5. Go to the directory whene 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 EDSS_ROOT directory. If the script encounters any problems, it will print an error message to point you to the problem.

The EDSS_ROOT 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 EDSS_ROOT <your selected directory for SMOKE installation>

  3. Save and close the .cshrc file. Your EDSS_ROOT 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, Using SMOKE Scripts, which discusses using the SMOKE scripts. Please refer to Section 4.4, “Running the nctox test case” for instructions on running the example scripts for the nctox case. The current SMOKE documentation can be found online at http://www.cep.unc.edu/empd/products/smoke/.