Getting started as quickly as possible¶
This documentation is already designed to provide a quick-start guide, but if you’ve used clusters before then you might just need a super-quick guide to getting started with your Alces Flight Compute cluster. Here are just the basics, along with things you should probably look at in more detail when you have time. Useful commands are included with each step - please refer to the full documentation for further details.
- Launch your personal Alces Flight Compute cluster on AWS or a compatible OpenStack private cloud. You will be asked various questions about how you want your cluster to look - most options are explained, with sensible defaults included.
- Login to your cluster via SSH using your chosen username, and the SSH key registered with your cloud provider. Your cloud service should report the access IP address to login to once your cluster is launched. If you enabled cluster auto-scaling, compute nodes are automatically added/removed based on the status of your job-scheduler queue. Use
alces configure autoscaling disableto turn off scaling if you’ll be running jobs manually.
- Start a graphical desktop session with the command
alces session start gnome. Connect using a VNC client, with the password provided when you started the session. Multiple users can connect to the same session for collaborative projects. Use the
xrandrcommand to change the screen resolution of a running session.
- Your user has full
yumis configured to install Linux packages. Use the
nodeattr -n nodescommand to see your list of compute node hostnames, and
pdsh -g nodes <command>to run commands across all nodes in your cluster.
- Your cluster has an NFS shared filesystem mounted across all nodes, which your home-directory is part of. Copy data to and from the cluster using SCP/SFTP. The
alces storagecommands provide access to object storage services including S3 and Dropbox.
- Use the
alces gridwarecommand to view and install software. The
mainrepository lists stable packages, with a larger list of applications available as part of the
- Your cluster comes with an installation of the SGE job-scheduler; use the
alces templatecommand for a list of template job-scripts to get you started.
- Terminate the cluster stack via your cloud provider when you’ve finished working. Remember to copy any data you want to keep off the cluster to secure storage before terminating it.