Center for Nanoscale Science and Technology NIST home page Nanofab Facility Group Nanofab Equipment User Information page Manuals and Forms page Safety Information page User Forum site Staff News and Announcements
RestrictedThis page is for NIST Staff only!

Coral Tutorial

  Download printer friendly PDF.

Online: August 2005
Last Updated: July 2007
Contact: nanofab@nist.gov



I. Installing Java Web Start

In order to run Remote Coral, it is necessary to install the Java runtime environment (version 1.4.2_08 or higher) and Java Web Start. Download the installer: Nanofab Coral Software and follow the on-screen instructions. After successful installation, there will be a shortcut to "Java Web Start" on the desktop (Figure 1).


Java Web Start shortcut on desktop
Figure 1: Java Web Start shortcut on desktop

Double click on the shortcut to begin the Java Web Start setup utility. With the installation of Java Web Start, there are four pre-installed applications to demonstrate the Java Web Start technology (Figure 2). These can be optionally removed by doing the following: Go to File –> Preferences and select the Advanced tab (Figure 3). Click the "Clear Folder" button and then select "Yes" on the confirmation dialog (Figure 4) to remove pre-installed applications.


Java Web Start main screen.
Click for larger image. Java Web Start main screen. Click for larger image. Java Web Start main screen.  Click for larger image.
Figure 2: Java Web Start main screen Figure 3: Java Web Start preferences screen Figure 4: Clearing pre-existing Java Web Start applications

Return to Top

II. Installing Remote Coral

Open Java Web Start and type http://nanofab.nist.gov/coral/etc/ into the "Location" bar. Press the Enter key to populate the applications section with an icon for "NIST Coral Remote" (Figure 5). Double click on this icon to begin downloading Remote Coral (Figure 6).


Java Web Start with Remote Coral.  Click for larger image. Loading Remote Coral.  Click for larger image.
Figure 5: Java Web Start with Remote Coral Figure 6: Loading Remote Coral

The first time Coral is run, it will ask for permission to trust Verisign (Figure 7). Click on "Start" to accept. It will then ask for permission to install Bouncy Castle (Figure 8). Click on "Install" to accept.


Verisign security dialog.  Click for larger image. Bouncy Castle security dialog. Click for larger image
Figure 7: Verisign security dialog Figure 8: Bouncy Castle security dialog

The application will ask to display a shortcut to "NIST Coral Remote" on the desktop (Figure 9). It is reccommended, though not necessary, to select "Yes" and create a shortcut directly to Remote Coral (Figure 10).


Coral desktop integration dialog. Click for larger image. Remote Coral shortcut on the desktop
Figure 9: Coral desktop integration dialog Figure 10: Remote Coral shortcut on the desktop

Return to Top

III. Logging in to Coral

Double click on the "NIST Coral Remote" icon to start Coral. The login screen offers two forms of authentication – one by NIST domain account and the other by NIST email account (Figure 11). Select an authentication method, enter a username/password, and press "OK". Once the authentication is complete, the main Coral window will appear (Figure 12).


Coral login screen. Click for larger image. Coral main screen. Click for larger image.
Figure 11: Coral login screen Figure 12: Coral main screen

Before enabling equipment or making reservations it is necessary to complete the login process. Scroll down to find the section labeled "Users". Select the first user slot which is not currently enabled. For example, if there is one user currently in the lab, then select the second user slot and go to Equipment Actions –> Enable (Figure 13).


Completing the login process. Click for larger image.
Figure 13: Completing the login process

A dialog box will appear containing machine enable information. Simply click on "OK" to complete the login process (Figure 14).


Completing the login process. Click for larger image.
Figure 14: Completing the login process

The login process is now complete. To verify this, ensure that your member name appears in parenthesis following the user slot that was enabled (Figure 15).


User logged in to User#2 slot. Click for larger image.
Figure 15: User logged in to User#2 slot

Return to Top

IV. Making a Reservation

Select the name of the machine to be reserved in the left panel. Machines for which you are privileged to use will be marked with an asterisk following the machine name. In the right panel, highlight a block of time to reserve. Click on Reservation Actions –> Make to open the machine reservation dialog (Figure 16).



Reserving equipment. Click for larger image.
Figure 16: Reserving equipment

Input all necessary information in the reservation dialog. Place any comments about the reservation in the Process/Comment field. When finished, click "OK" to complete the reservation (Figure 17).



Machine Reservation dialog. Click for larger image.
Figure 17: Machine Reservation dialog

When the reservation is complete, your member name will appear in every timeslot of the reservation for the specified machine (Figure 18).



Reservation complete. Click for larger image.
Figure 18: Reservation complete

Return to Top

V. Deleting a Reservation

In the left panel, select the name of the machine from which to remove a reservation. In the right panel, highlight a reservation by clicking on any one of the individual slots within the reservation block. Click on Reservation Actions –> Delete (Figure 19).


Deleting a reservation. Click for larger image.
Figure 19: Deleting a reservation

The reservation block will be removed from the schedule (Figure 20).


Reservation deleted. Click for larger image.
Figure 20: Reservation deleted

Return to Top

VI. Enabling equipment

Select the name of the machine to be enabled in the left panel. Machines for which you are privileged to use will be marked with an asterisk following the machine name. Click on Equipment Actions –> Enable (Figure 21).


Enabling equipment. Click for larger image.
Figure 21: Enabling equipment

Input all necessary information in the enable dialog. Place any comments about the machine usage in the Process/Comment field. When finished, click "OK" to enable the machine (Figure 22).


Enabling equipment dialog. Click for larger image.
Figure 22: Enabling equipment dialog

When the machine becomes enabled, your member name will appear in parenthesis following the name of the machine (Figure 23). The system has now logged the start time of your usage cycle for this machine.


Equipment enabled. Click for larger image.
Figure 23: Equipment enabled

Return to Top

VII. Disabling equipment


Select the name of the machine to be disabled in the left panel. Click on Equipment Actions &ndash> Disable (Figure 24).


Disabling equipment. Click for larger image.
Figure 24: Disabling equipment

When the machine becomes disabled, your member name will no longer be displayed following the machine name (Figure 25). The system has now logged the end time of your usage cycle for this machine.


Equipment disabled. Click for larger image.
Figure 25: Equipment disabled

Return to Top

VIII. Reporting a problem

In the left panel, select the name of the machine which has a problem to be reported. Click on Equipment Actions –> Report Problem (Figure 26).


Reporting a problem. Click for larger image.
Figure 26: Reporting a problem

Input all necessary information in the problem report dialog. When finished, click "Submit" to submit the problem report (Figure 27).


Problem report dialog. Click for larger image.
Figure 27: Problem report dialog

The status indicator beside the machine name will turn yellow indicating a problem has been reported (Figure 28). The machine is still available to be enabled/disabled as the problem is not critical.


Problem logged, stoplight indicator now yellow.  Click for larger image.
Figure 28: Problem logged, stoplight indicator now yellow

Return to Top

IX. Shutting down equipment

In the left panel, select the name of the machine which has a critical problem to be reported. Click on Equipment Actions –> Shutdown (Figure 29).


Shutting down equipment. Click for larger image.
Figure 29: Shutting down equipment

Input all necessary information in the problem report dialog. When finished, click "Submit" to submit the problem report (Figure 30).


Shutdown report dialog. Click for larger image.
Figure 30: Shutdown report dialog

The status indicator beside the machine name will turn red indicating a critical problem has been reported (Figure 31). The machine is not available to be enabled/disabled until the problem is remedied by a staff member.


Problem logged, stoplight indicator now red. Click for larger image.
Figure 31: Problem logged, stoplight indicator now red

Return to Top

X. Updating user information

Open the Resource Client by clicking on Window –> Resource (Figure 32).


Opening the Resource Client. Click for larger image.
Figure 32: Opening the Resource Client

The Resource Client will initially display a panel on the left for searching and a panel on the right for viewing results. To view all the members in the system, type an asterisk into the input field and press "Search" (Figure 33). A listing of all currently active members will appear in the left panel.


Searching for all members in the Resource Client. Click for larger image.
Figure 33: Searching for all members in the Resource Client

Highlight a particular member and click on "View Member Information" to display the user’s information in the right panel (Figure 34). If you are viewing your own record, the information will be editable.



Viewing/Editing user information. Click for larger image.
Figure 34: Viewing/Editing user information

Return to Top

XI. Logging out of Coral

Navigate to the user listing in the left panel of Coral and locate your username (Figure 35).


Listing of users currently in the lab. Click for larger image.
Figure 35: Listing of users currently in the lab

Click on Equipment Actions –> Disable to log out of Coral(Figure 36).



Logging out of Coral. Click for larger image.
Figure 36: Logging out of Coral

Your username will no longer appear beside the user slot, signifying a successful logout (Figure 37).


User has logged out. Click for larger image.
Figure 37: User has logged out

Select Window –> Exit to close Coral (Figure 38).


Exit Coral. Click for larger image.
Figure 38: Exit Coral

Return to Top

Online: August 2005
Last Updated: July 2007
Contact: nanofab@nist.gov