Accessing the NCCS Systems Setting your Initial System Environment Moving Data onto the NCCS Systems Storing Data on the NCCS Systems Running the NASTRAN Script Requesting Help via the NCCS Ticketing
System Obtaining an NCCS Userid
Commands and Utilities
As a user of NCCS computing systems you must log on using secure shell (ssh).
You will be asked to authenticate your access using your Agency RSA SecurID and NCCS password.
The first time that you access NCCS computing
systems you must accept the secure shell key for
the system. Respond by entering "yes.":
From your workstation, access discover-nastran using any ssh client. For example:
You will need to provide your IP address before you are able to connect to discover-nastran, you can bypass this restriction by using GSFC VPN.
The first time you are prompted for a PASSCODE, you need to set a PIN.
https://www.nccs.nasa.gov/token_changes031109.html
You may save a session on putty by assigning a name and clicking the save button.
To open a saved session, click on the session
name, click load and click [email protected]
discover-nastrandiscover-nastran
Files and Configuration
Your home directory on discover-nastran will automatically be created as well as several files, like .xemacs or .cshrc (depending on your shell).
If you are not sure what program shell you are using, you can issue the command “echo $SHELL” to display the value.
Please refrain from importing your .cshrc file from eagle.
useriduseriduseriduserid
discover-nastran, xxx.xx.xx.xx
discover-nastran, xxx.xx.xx.xx
To Display other environment variables that the system is setting by default or that you have set via one of the startup files like .bashrc, .cshrc, .login or .profile, issue the “env” command:
You may use any text editor, such as vi, to make changes to your .bashrc, .cshrc, or .profile
You may also add aliases (short names for commonly used commands or messages) :
To activate changes to .cshrc, .profile, .bashrc, etc., you need to run the command: source .cshrc
Some packages or utilities need a module to be loaded in order for you to use them. To see the modules that have been loaded to your session, issue the command, module list:
To display a list of available modules, issue the command, module avail:
To load a new module, which dynamically modifies your environment (i.e. $PATH and/or other variables), issue the command: module load name
For example, to load the GNU project C and C++ compiler version 4.5, issue the command:
module load other/comp/gcc-4.5
Commands and Utilities
You can use the "sftp" or "scp" commands to transfer data between your local system and discover-nastran.
To transfer a file from your local machine to discover-nastran using the scp command (i.e. to push data to discover-nastran), issue the following:
To transfer a file to your local machine from discover-nastran using the scp command (i.e. to pull data from discover-nastran), issue the following:
Note the above command ends with a dot “.” to signal that you want the file placed in the current working directory on your local machine.
To transfer files between your local system and discover-nastran using the sftp command, you first have to establish a connection. For example:
The above method will simplify the initial move of your data from eagle to discover-nastran.
You may use the cd command to change the working directory and the ls command to display all of the files in the current working directory.
Variables like $NOBACKUP are not recognized in the sftp environment, the absolute path is required.
To transfer files from your local machine to discover-nastran using the sftp command, you need to use “get”, to copy a file to your local machine from discover-nastran and “put”, to move a file from your local machine to discover-nastran. For example:
You may use WinSCP, a free sftp and ftp client for Windows to transfer files between your local PC and discover-nastran. You first have to establish a connection. For example:
discover-nastran.nccs.nasa.govdiscover-nastran.nccs.nasa.gov
You will be prompted for you PASSCODE and NCCS password:
You may select a file from your local machine (left panel) and drag it to discover-nastran (right panel).
The red arrows indicate the drop-down menus that will allow you to change the working directory.
File Systems and Quotas
The NCCS implements quotas on both, the home directory and the nobackup directory.
To display the current quotas on discover-nastran, for your userid, issue the showquota command:
The above example shows that djhome (also referred as $HOME or /discover/home) is over quota and there are only 2 days left before the user is prevented from writing any files.
When you first logon to discover-nastran, you will be placed in your $HOME directory. Your $HOME directory is the place for your startup files and important files (hence the 0.5GB quota).
The work directory, which may be accessed by a convenient link from $HOME, points to dnb11 (also referred as $NOBACKUP or /discover/nobackup), it has a quota of 100GB. We DO NOT create backups of any file on discover-nastran.
You are responsible for maintaining any backups.
Always use environment variable, such as $HOME or /discover/home or $NOBACKUP or
/discover/nobackup in executables. DO NOT use the path provided by the pwd command (i.e. hardcoded paths like /gpfsm/dnb11/ or /gpfsm/djhome/). System Administrators may move file systems due to maintenance, which would brake any hardcoded paths as mentioned above.
The mnas Script and PBS Scheduler
The NASTRAN script, mnas, provides a help message when the –h option is invoked. The help message lists the different options available, as well as examples on how to run mnas. To display the help, issue the command: mnas –h
Executing the mnas script from your $NOBACKUP automatically creates a .pbs file, which is used to submit the the job to the PBS batch.
To run the mnas script, you need to cd into the NASTRAN work directory and issue mnas along with any options and the name of the input file to be used. For Example:
The mnas script has several built-in options, such as –opt for NASTRAN specific options. The example above tells both NASTRAN and PBS that you are asking for a memory allocation of 40 Megawords. The job number in this example is 123.borgpbs2.
The option, sdir is not allowed on discover-nastran due to the manner in which PBS manages data between file systems.
The mnas script assumes MSC 2008r1 as the default.
The –t option is used to delay the start of a PBS job. For more information check the mnas help message.
To display the PBS queues on discover-nastran, issue the command: qstat –q
The above print screen shows that the “short” queue has a limit of 1 job and max run time (i.e. walltime) of 10 minutes. The long queue has a limit of 6 jobs and a walltime of 96 hours.
To display the list of minimums (i.e. the defaults for when walltime, queue, etc. are not specified in a job) and maximums for an specific queue, issue the command: qstat –Qf queuename
To display the current work on the PBS batch scheduler, issue the command: qstat
Jobs that are running will have an “R” under the status column and a “Q” if the job is queued.
To find more details regarding an specific job while it is in an R or Q state, issue the command: qstat –f jobid
To delete your job from the batch scheduler, you must first obtain the job Id using the qstat command and then issue qdel –f jobid.number
Jobs that were submitted via the mnas script, will send you an e-mail when aborted by the system, deleted by you or when the job finishes normally.
If your job is not running (i.e. not in an R state), you may issue the command, qstat –s jobid
One reason for your job to be queued for a long time, is that there are no user limits on the discover-nastran queues and a single user may potentially fill-up the entire queue.
Access and Overview
The NCCS ticketing system is the COTS application, FootPrints, by Numara software.
Users may access FootPrints via the following URL: www.nccs.nasa.gov/internal/footprints
FootPrints uses a dual factor authentication (RSA SecurID and password).
Documents and Process
To request access to discover-nastran use the NCCS Account Request Document at the following URL:
https://www.nccs.nasa.gov/usradmin/usaduarf.html
Items specific to your discover-nastran request include: item 3: check the “discover-nastran” box under the “Add”
column, item 6: your Computational Project is “j1060” and your PI is
“Carnahan,” item 13: requires your signature and item 14: requires your PI’s signature
The NCCS USG can be contacted at the following e-mail address:
[email protected] or by telephone at 301-286-9120 between
8:00 a.m. and 6:00 p.m. Eastern Time (USA), Monday through Friday (except U.S. Federal Holidays). At all other times the USG phone-mail service will be engaged.
