Difference between revisions of "WebMO"

From Earlham CS Department
Jump to navigation Jump to search
m
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
WebMO is a web interface to the Gaussian chemistry tool maintained in the cluster world. Currently it and Gaussian live on Whedon. The official project website is [https://www.webmo.net/ here] and you can access our instance (if you have a WebMO-specific user account) [http://w0.cluster.earlham.edu/~alice/webmo-cgi-bin/login.cgi here].
+
WebMO is a web interface to the Gaussian chemistry tool maintained in the cluster world.
  
This is a guide for students and others who want to use WebMO.
+
== Overview ==
 +
 
 +
WebMO is a scientific web application providing a user interface for domain scientists to perform chemistry simulations. It provides a mechanism for domain scientists to perform chemistry simulations on high-performance computing systems through a web browser. Currently it and Gaussian live on the Wachowski cluster. The official project website is [https://www.webmo.net/ here] and you can access our instance (if you have a WebMO-specific user account) [http://w0.cluster.earlham.edu/~alice/webmo-cgi-bin/login.cgi here].
  
== First time logging in ==
+
Strictly "WebMO" is the web interface and associated configurations, but here we will use it as shorthand for "the computational chemistry stack". This accords with local usage.
  
Some user accounts have been used to log in to WebMO to use Gaussian but others have not. If you have not, you will see a “join group” screen after entering your credentials. (Put another way, for any given user, that screen only appears on the first login, so that the software knows what group to associate each user with. After that, user accounts work as expected.)
+
This is a guide for students and others who want to use WebMO.
  
Use the `wu*` password (ask a chemistry professor) to join the webmo group.
+
=== Sysadmins ===
  
== Disclaimer ==
+
Sysadmins should view [[Sysadmin:WebMO|this page]].
  
Sometimes we have had issues with people submitting WebMO/Gaussian jobs from off-campus - specifically, that the web interface would display an error after submitting some jobs (pattern not clear from logs etc.). If this occurs, remain calm because your job is still being run.
+
== Running a job ==
  
To retrieve the job afterward, you can look at your job history in WebMO.
+
Process:
 +
# Log in using your credentials
 +
# Submit job
 +
# Allow to run
 +
# Check job status as desired
 +
# On completion:
 +
## If the job was successful, view output
 +
## If the job failed, try again or change parameters
  
== Fixing WebMO off-campus jobs ==
+
== Issues ==
  
[[Sysadmin:WebMO from off-campus|See this page.]]
+
=== First time logging in ===
  
== Admin note on resolving down nodes ==
+
Some user accounts have been used to log in to WebMO to use Gaussian but others have not. If you have not, you will see a “join group” screen after entering your credentials. (Put another way, for any given user, that screen only appears on the first login, so that the software knows what group to associate each user with. After that, user accounts work as expected.)
  
= If the services are running but no jobs are running =
+
Use the `wu*` password (ask a chemistry professor) to join the webmo group.
  
If Slurm, WebMO, etc. are running but no jobs are running (or there's a queue that's longer than it should be), run <code>sinfo</code> to see the status. Likely the nodes are marked down and you need to make the daemons go to work. To bring them back, run this or equivalent for the right machine:
+
=== Fixing WebMO off-campus jobs ===
  
<pre>
+
Sometimes we have had issues with people submitting WebMO/Gaussian jobs from off-campus - specifically, that the web interface would display an error after submitting some jobs (pattern not clear from logs etc.). If this occurs, remain calm because your job is still being run.
scontrol update NodeName=lo[0-4] State=RESUME
 
</pre>
 
  
The important part is "<code>State=RESUME</code>".
+
To retrieve the job afterward, you can look at your job history in WebMO.
  
You can also use the command bellow to display information about a particular node.  
+
[[Sysadmin:WebMO from off-campus|Admins, see this page.]]
<pre>
 
scontrol show node <node-name>
 
</pre>
 

Latest revision as of 13:35, 22 August 2021

WebMO is a web interface to the Gaussian chemistry tool maintained in the cluster world.

Overview

WebMO is a scientific web application providing a user interface for domain scientists to perform chemistry simulations. It provides a mechanism for domain scientists to perform chemistry simulations on high-performance computing systems through a web browser. Currently it and Gaussian live on the Wachowski cluster. The official project website is here and you can access our instance (if you have a WebMO-specific user account) here.

Strictly "WebMO" is the web interface and associated configurations, but here we will use it as shorthand for "the computational chemistry stack". This accords with local usage.

This is a guide for students and others who want to use WebMO.

Sysadmins

Sysadmins should view this page.

Running a job

Process:

  1. Log in using your credentials
  2. Submit job
  3. Allow to run
  4. Check job status as desired
  5. On completion:
    1. If the job was successful, view output
    2. If the job failed, try again or change parameters

Issues

First time logging in

Some user accounts have been used to log in to WebMO to use Gaussian but others have not. If you have not, you will see a “join group” screen after entering your credentials. (Put another way, for any given user, that screen only appears on the first login, so that the software knows what group to associate each user with. After that, user accounts work as expected.)

Use the `wu*` password (ask a chemistry professor) to join the webmo group.

Fixing WebMO off-campus jobs

Sometimes we have had issues with people submitting WebMO/Gaussian jobs from off-campus - specifically, that the web interface would display an error after submitting some jobs (pattern not clear from logs etc.). If this occurs, remain calm because your job is still being run.

To retrieve the job afterward, you can look at your job history in WebMO.

Admins, see this page.