Getting Started

Overview

As mentioned on the main page, Axon is a computer cluster where a scheduler program is used to submit compute tasks, called jobs, to one or more nodes in the cluster. Jobs are submitted to the cluster via a login node (axon.rc.zi.columbia.edu) as shown in the diagram below:

Accounts on Axon

There are two types of accounts on Axon:

  • Lab Accounts: Accounts that associate a set of resources that a lab has access to on Axon with the members of that lab.
  • Individual Researcher Accounts: Individual members of a lab that are associated with a lab account.  Individual researchers are granted or denied access privileges on Axon based on their membership in lab-level accounts.

In order to be able to access the login node and submit jobs, you must first make sure that your lab has an account on Axon.  You must then obtain an individual researcher account.

Currently Active Lab Accounts

To determine your eligibility for an individual researcher account, first check the table below to see if your lab is already participating in Axon and has an active lab account:

Lab NameLab Account Name
Center for Neurotheoryctn
Kriegeskorte Labnklab
Issa Labissa
Bendesky Labablab
Aronov Labaronov
Mesgarani Labnaplab

Polleux Lab

pascal

U19 Motor

u19moc3

Litwin Kumar

lkumar

Gadagkar

gadagkar

Axel

axel

Kahn

kahn

Gogos

gogos

Hillman

hillman

Shadlen

shadlen

Mann

mann

The lab account name is an abbreviation associated with your lab that is used by the cluster manager on Axon and as a mechanism to separate your lab's files from another lab's data on the filesystem.

Obtaining a Lab Account

Lab accounts are open to the groups which have purchased nodes in the cluster or to labs that are participating in the rental tier. If you are a researcher whose lab is presently not using Axon, email rc@zi.columbia.edu to either request access to the Axon rental tier or discuss purchasing nodes to add to the cluster.

Obtaining an Individual Researcher Account

If you are a member of a lab listed in the lab account table above, send an email to rc@zi.columbia.edu and we will add you to the cluster.  You will then be able to access the login node using the instructions below.

Once you've been added to the cluster, you will also be subscribed to the axon-users Google Group / mailing list.  axon-users is used to send out occasional announcements about configuration updates and cluster outages.  A searchable archive of all previous axon-related announcements can be found here (requires UNI login).

Connecting to the Cluster


The login node (axon.rc.zi.columbia.edu) is for job preparation, not computation!

The login node has limited CPU and memory resources, and should only be used for the preparation of batch jobs or to start an interactive session on one of the nodes.  Terminal sessions on axon.rc.zi.columbia.edu have limits enforced by the operating system- you may only use at most 1 GB of RAM and 6 hours worth of CPU time.  Trying to use more resources will not work.  This is to ensure that other researchers using the login node to submit jobs won't have their work disrupted.

Using SSH to Access to the Login Node

Secure Shell (SSH) is the software used by Axon to provide you with a terminal interface. To connect to Axon using this software, you must have a command line interface on your personal computer such as Windows Terminal in Windows 10 or Terminal for Macs. Older versions of Windows may require a third-party program such as Putty or MobaXterm.  Once you have a command line interface on your computer, you can use the instructions below to access Axon from either on-campus or remotely.

Connecting from inside the Columbia network or on the VPN

The Axon login node can be accessed when you are on the Columbia campus or using the VPN by using command below (where UNI is replaced by your Columbia UNI):

To login to the cluster ssh into the login node (replace UNI with your uni)
ssh UNI@axon.rc.zi.columbia.edu

Connecting from outside the Columbia network

The Axon login node can be accessed anywhere outside the internal Columbia network by using command below:

ssh -p 55 UNI@axon-remote.rc.zi.columbia.edu

You can make an ssh config file to abbreviate the above command. By creating a file named ~/.ssh/config (if it doesn't already exist) you can connect using a shorter name:

Sample .ssh config to connect to axon remotely
Host axon-remote
    HostName axon-remote.rc.zi.columbia.edu
    User UNI 
    Port 55

Once you have ~/.ssh/config in place you can run the abbreviated ssh command shown below:

Connecting using the ~/.ssh/config example above
> ssh axon-remote
UNI@axon-remote.rc.zi.columbia.edu's password:
Last login: Thu Apr  2 17:53:41 2020 from vpn-10-192-140-203.dyn.columbia.edu
Welcome to the Axon GPU Cluster!
...


Connectivity from outside Columbia

While SSH is available from outside Columbia this method will only allow you to connect via ssh to the login node. All other ports on the login node and the compute nodes are only accessible from the Columbia campus. You can use ssh tunneling to connect to other ports, but this can be complicated and configuration is different depending on the usage.