HPC/Applications/comsol

Introduction

The COMSOL Multiphysics product is available for Mac, Windows, and Linux.

Access to COMSOL is subject to a license agreement and is granted on request to individual users.

• To request access, send a request to [email protected]. The license agreement restricts access to Argonne employees.
• Of the available features we have licensed a subset, shown at right.
• For the native desktop version, contact me (stern) for installation media. After installation, get Product Updates.

Options for running COMSOL

There are several ways of running COMSOL:

1. Run on Carbon, display on your desktop using X11.
   • Requires an X11 server on your client machine, and SSH X11 forwarding.
   • The X11 protocol can be slow over LAN.
2. Run on Carbon within a virtual desktop environment (VNC).
   • Requires a VNC client on your machine.
   • It can be confusing where VNC and the app runs.
   • The virtual desktop presents a (deliberatly) sparse windowing environment – Copy&Paste can be difficult to use.
3. Run on your own computer, remotely checking out Carbon's license.
   • Requires a full installation of COMSOL on your client machine.
   • Requires VPN or SSH license tunneling - can be intimidating for first-time users.
4. Running a batch calculation on Carbon.
   • For use with production jobs that are parallelizable and take hours to complete.

Support

For questions on how to run or start COMSOL, contact CNM IT support - see HPC/FAQ.

For questions related to COMSOL data or scripts, you may contact COMSOL support directly.

Export control

If your support question might contain data that is subject to US Export Control, contact support@us.comsol.com instead.

Use with X11

For casual use, and with X11 tunneling to Carbon set up, simply add to your ~/.bashrc file on Carbon:

module load comsol

Then, from the command line on a Carbon login node, start the COMSOL GUI:

comsol &

Comsol will use a number of cores to run calculations multithreaded by default. (On Carbon, COMSOL_NUM_THREADS is set.)

Quit the application as soon as you are done. Only one user can use Comsol at a time.

Use with VNC

See general instructions on using VNC, and the COMSOL example therein.

Running native desktop version

To get the fastest response from the COMSOL GUI, run a native COMSOL version on your desktop machine. You will have to configure it to check out a license from the Comsol license server running on Carbon.

Carbon provides a 3-server redundant license setup. Only the first two servers may actually serve licenses, with a primary server active most of the time and a secondary one which can take over as needed. CNM machines can talk to the Carbon license servers directly.

Edit <COMSOLDIR>/license/license.dat, where <COMSOLDIR> will be located at:

• Windows: C:\Program files\COMSOL\COMSOL44
• Linux: /usr/local/comsol44
• Mac: /Applications/COMSOL44

and enter:

SERVER cmgmt3 ANY 1718
SERVER cmgmt4 ANY 1718
SERVER csched1 ANY 1718
USE_SERVER

Note

These servers are reachable only from within the CNM.

Running native desktop version, non-CNM networks

Machines outside CNM networks need the following procedure to reach the license servers.

Configure port forwarding

• On your desktop machine, set up SSH tunneling. This step is only needed once.
  • Windows: Configure PuTTY
  • Linux/Mac/Cygwin: edit the file ~/.ssh/config and add to the Host clogin section:

Host clogin
	…
	# COMSOL licensing
	# Initial ("negotiation") ports of FlexLM's lmgrd; may be forwarded to different local port numbers.
	LocalForward 33318 mgmt03:1718
	LocalForward 33418 mgmt04:1718
	# Secondary ("payload") ports of the COMSOL vendor daemon; local and remote port numbers must match.
	LocalForward  1719 mgmt03:1719
	LocalForward  1720 mgmt04:1720

Note …318 vs. …418 in the the first line pair.

• Stop any previous connection that you might have to clogin.
• Connect to clogin. This will start the port forwarding configured in the previous step.
  • On PuTTY, open the Clogin session.
  • On Linux/Mac/Cygwin, type:

ssh -v clogin

Configure COMSOL to use forwarded ports

• Start the Comsol installer on your machine. When asked for licensing use the following type:
  • License type: networked server
• For License hosts use one of the following entries. If the first failed, use the second.
  • localhost, port 33318
  • localhost, port 33418
• Complete the installer.
• Locate and start the COMSOL Multiphysics application.

Preparing to run COMSOL

• Have an SSH connection to clogin active. It provides the forwarded ports to your machine.
• Then start the COMSOL application normally.

Addendum: Point to an alternate license server

The COMSOL application determines the license server to contact by the file <COMSOLDIR>/license/license.dat. The file should look as follows:

SERVER localhost ANY 33318
SERVER localhost ANY 33418
USE_SERVER

Most of the time, the first license server is active and will respond locally on port 33318. Unfortunately, automatic server selection only works for nodes within Carbon, and fails when using forwarded ports. If the first server does not respond, COMSOL fails with an error. Ideally, COMSOL should contact the alternate server port as given by the second SERVER line, but, at least for COMSOL43a, that line is ignored.

To temporarily use the alternate server, comment out the first SERVER line from the license.dat file:

#SERVER localhost ANY 33318
SERVER localhost ANY 33319
USE_SERVER

Then restart COMSOL. You do not need to change the SSH configuration or re-open the connection to clogin.

Multiple CPU cores

Ways to start multi-core (from http://www.comsol.com/support/knowledgebase/1096/)

comsol -np 8

export COMSOL_NUM_THREADS=8    # automatically provided on Carbon
comsol

• COMSOL does not benefit from hyperthreading (oversubscribing the physical core count).

Batch jobs

• http://www.comsol.com/support/knowledgebase/1001/ .
• Media:HPC 2012-05-16 Comsol parallel usage.pdf (Modified from http://www.comsol.com/support/knowledgebase/1001/files/4027/cluster_install_linux_42a.pptx – Appendix slide, PBS)
• Note: MPD is not supported on Carbon (I patched the main comsol script), and no longer necessary at all in Comsol-4.3.

Sample Job file

See:

$COMSOL_HOME/sample.job