First-Time Account Setup
Software you need
Mac/Linux: All the software you need is already installed on your system. Open your terminal application (on Mac go to Applications > Utilities for your terminal application) and type in the following, replacing
vunetid with your own VUnetID:
The first time you start ACCRE, you may see a message asking if you trust the system you are attempting to log in to. Type “yes” and hit return.
Windows: Download and install PuTTY. Type
login.accre.vanderbilt.edu in the host name field, then ACCRE in the Saved Sessions field, then click Save:
The next time you start PuTTY, you just need to double click on ACCRE in the Saved Sessions section and it will load automatically.
Click Open to start the terminal connection.
As with the Mac/Linux login, you may see a message asking if you trust the system you are attempting to log in to. Type “yes” and hit return.
Web browser: The ACCRE Visualization Portal allows users to perform a variety of cluster tasks within the web browser. This includes a point-and-click file explorer, an in-browser terminal, and a page for submitting and monitoring jobs, and the ability to create a virtual desktop environment for running graphical applications.
If you wish to go this route, go to portal.accre.vanderbilt.edu and login using your VUNetID and the password you should have received in your email (not the password that you use for other Vanderbilt services). Go to Clusters > ACCRE C7 Shell Access to open a terminal and continue setting up your account.
Your username, if prompted, is your VUNetID. Type it in and press enter.
Your password is in an email you should have received from ACCRE. The password system for ACCRE is separate from other Vanderbilt sites (the “ePassword”). Enter your password and hit return. Note that for security reasons the password will not appear as you are typing.
You will then need to change your password. Type in
accre_password change and follow the instructions. Your password must meet the following requirements:
- Your ACCRE password must be at least 14 characters long, and not more than 4096.
- Your password must receive a perfect score on the ZXCVBN test. If you need a password that can pass the ZXCVBN test, type in
- In addition to uppercase letters, lowercase letters, numbers and symbols, you may use non-ASCII characters (including emoji and characters in Chinese, Japanese, or Korean). However, you may have difficulty logging in later with different keyboards or terminal utilities. All characters must be printable and in UTF-8.
Your password change will take effect immediately.
Your terminal is now set up and ready to use. As a reminder, you will need to register for training within the first two months of receiving your account.
The ACCRE Visualization Portal
Now that your account is ready, you can go to portal.accre.vanderbilt.edu and access your visualization portal. Remember to log in with the password you have just created, not the password that you would use for other Vanderbilt services.
Some things you may want to try:
- Files > Home Directory will view any files that you have (right now it is empty).
- Clusters > ACCRE C7 Shell Access will open a new tab with a full-screen terminal client connected to ACCRE, as if you were logging in with
- Interactive Apps > ACCRE Desktop will start a virtual desktop within your browser. Accept the defaults, click launch, and click on “Launch noVNC in new tab (scale desktop to window)”. A new tab will open that looks just like a computer desktop. The desktop is on the ACCRE cluster and any changes you make go back and forth between your browser and the cluster.
More information about the ACCRE visualization portal, including a video tutorial, is available here.
Secure Copy client (SCP client)
SCP clients are useful for transferring files to and from the ACCRE server. While you may use the ACCRE Visualization Portal to transfer files instead (go to Files > Home Directory), an SCP client is still a good tool to have in place.
For Mac and Linux systems (including the Ubuntu for Windows setup) you already have an SCP client installed in the terminal. To transfer a file from your system to ACCRE:
scp <source_path> <vunetid>@login.accre.vanderbilt.edu:<destination_path>
To transfer a file from ACCRE to your system:
scp <vunetid>@login.accre.vanderbilt.edu:<source_path> <destination_path>
If you prefer a graphical interface, we recommend FileZilla.
For Windows users, you can use PSCP, which comes with the most recent installations of PuTTY. Open the command prompt (on Windows 10, right click the Start menu and choose “Command Prompt”). Then use the same command above, replacing “scp” with “pscp”.
pscp <source_path> <vunetid>@login.accre.vanderbilt.edu:<destination_path>
Windows users can also use FileZilla or WinSCP, an SCP client with a graphical user interface. Click here, then use the Installation Package link to begin the download.
X Window Server
The X Window Server lets you run applications on ACCRE that have a graphical user interface. While it may come in useful at times, applications running on an X connection are slower than if they are running locally. For this reason we do not recommend using it (especially from outside campus) unless there are no alternatives. Instead, we prefer using a virtual desktop within the ACCRE Visualization Portal (go to Interactive Apps > ACCRE Desktop).
For Mac systems, download and install XQuartz. Then, add an -X tag when you ssh to ACCRE (make sure it’s an uppercase X):
ssh -X login.accre.vanderbilt.edu
For Windows systems, download and install Xming. Then load PuTTY, load the ACCRE shared session, then expand the SSH item and go to the X11 page. Click the checkbox to enable X forwarding, then set the X display location to “localhost:0” (without the quotes). Then go back to the Session page and click on Save. Any future connections using the ACCRE shared session will use the X Window Server installed.
For many Linux installations, an X window server should be installed already. Just add an -X tag when you ssh to ACCRE (again, make sure it’s an uppercase X):
ssh -X login.accre.vanderbilt.edu
To make sure everything is working properly, type in “xeyes”. A window should open of a pair of eyes that move around with your cursor. Even though it appears similar to a program on your computer, it is being run on the ACCRE gateway.
Some X11 applications require “trusted X11 forwarding”, which can be enabled by replacing -X with -Y. Use the -Y flag only if necessary, since it is less secure than -X.
Default Environmental Settings
If you wish to view your default environmental settings, type set.
Changing Your Shell
Your “shell” is essentially your working environment while you are logged onto the cluster. Virtually any of the newer shells add such functionality as command/filename completion (e.g., spell part of the command, hit a “hot key,” and the shell will try to complete the name of the command/file), command line editor (so you can edit and re-invoke previously executed commands), manipulation of history on the system, and definition of command aliases/functions.
Currently the default user shell is set as bash.
To change your default shell (this is not recommended unless you have a good reason for doing so):
- Issue the command: ssh auth
Commands issued now (e.g., the passwd command) will effect modifications to all of the nodes.
- Type: chsh
- You will be prompted for your choice of shells. Enter/bin/bash for the bash shell or/bin/tcsh for C-shell.
- To disconnect from auth, type exit. You will still be logged into your account. You may either continue working on the cluster or log out.
Your shell change will be propagated out to all of the nodes within approximately one hour.