Developing and Submitting Programs, VPN, Using Rucs

Overview:

This document describes what needs to be done to compile and submit your Ada programs.

For personal machines, install the following:

Get the GNAT Ada Compiler
VPN (to allow access to rucs)

Choose a development environment, either an IDE or the command line (and install on personal machine)

An IDE (If not using the command line)

For personal or on-campus machines, do the steps below for every program. The examples assume that you want to create and submit the file homework_one.adb.

Create and compile your program
Copy your program to rucs (if it's not already there)
Login to rucs
Submit your program

Get the GNAT Ada Compiler [for personal machines]:

Download an appropriate installer from www.adacore.com/community

More installation information on this page
The GNAT compiler is already available on rucs and on department lab machines

Choose a development environment (IDE or command line) and Create File

Create and edit homework_one.adb using either one of these IDE or the command line. Each of the following is available on department machines and can be installed on personal machines:

AdaGIDE - Simplest to use (once it's fixed).
- Installer available from from SourceForge
- Make sure that you install the GNAT compiler before installing AdaGIDE!
- Must fix executable first (edit adagide.exe and replace "gnat05" with "gnat12". You must use an editor such as vim that handles binary correctly.

GPS - More complex than AdaGIDE, but has more features:

GPS is automatically installed with GNAT (on windows and mac)
Requires a project file (.gpr). Use your favorite editor to create a project file like the one below:

               -- File: hw1.gpr
               project hw1 is
                  for main use ("hw1.adb");
               end homework_one;

On Windows you can also click on the project file to start gps.

Once your project is opened, open a new file and create homework_one.adb
On macs, you may need to run gps from the command line and open the project file from within gps.

Edit with an editor of your choice and compile on the command line (either on rucs or on a local machine)

Editors on rucs: vim or pico (aka nano)

Follow the instructions below to login to rucs

Windows editors: notepad++, textmate, and many others
Mac editors: ??, or vim and a terminal window

Install VPN

VPN session required to access rucs or mount U drive from a personal machine

Obtain (from RU IT One Stop)
Install the RU VPN client: unzip the file and double click on the file that has "core-vpn" in the name (probably the the first file)
Run the RU VPN client

Compile and run an Ada program:

Adagide or GPS: Press the build and run buttons

Note that Build is different from compile

Command line:

Compile: gnatmake homework_one or gnatmake homework_one.adb

Windows run: homework_one or homework_one.exe
Rucs/Unix run: ./homework_one or homework_one

Accessing the command line:

Windows local: cmd, powershell, bash (or git bash)

Mac and Linux local: terminal window

Remote to rucs: PuTTY: [personal machines require vpn connection]

Copy your files to rucs

Before you can submit a file, you must copy it to rucs (if it's not already there)

Copy to rucs, using either WinSCP or scp or by mapping your U: unix drive.

VPN session required for non-RU machines

WinSCP: should be installed on department machines. For personal machines, download and install WinSCP

Connect to rucs.radford.edu using your username.
Drag and drop your file from your machine onto rucs.

scp: From a terminal window, you can use commands like

scp homework_one.adb username@rucs.radford.edu:homework_one.adb

U: Drive:

Your U: drive is the same as your rucs home directory. If you put a file on your U: drive, then it is also on rucs

To map your U: drive (ie connect it to your local machine), select This PC, then Computer, then Map network drive, and then map your U: drive as \\userdir\unix\username

You may need to check "Connect using different credentials" and enter RADFORD\username for your username)

Drag and drop homework_one.adb from your machine to your U: drive. This will put your file onto rucs.

Login to Rucs (to use the command line to edit and compile and/or to submit)

Personal machines - do this first:

Run VPN (install as described above, if needed)
Windows: Download and install putty (if not already installed)

Windows: Run putty and enter rucs.radford.edu as the Host Name
Mac/Linux Terminal: in a terminal window, enter ssh rucs.radford.edu

Enter your username and password at the prompts

If the prompts don't appear, then you probably need to run vpn
Nothing appears when the password is typed

Your U: drive should be your rucs home directory
If you have no home directory, see the Help Desk immediately

Submit your program from rucs

Use putty (or a terminal window) to access rucs and compile and submit the file:

Connect and log in to rucs (VPN connection required if off campus, and perhaps if you are on campus)
If homework_one.adb is in a subdirectory, use cd to navigate to that subdirectory
Compile your program on rucs, to create an executable and to verify that it works on rucs:

         gnatmake homework_one
         homework_one

Submit the .adb file :

         submit itec320-02 homework_one.adb

Check that the submit worked:

         submit itec320-02 -ls

This submit should list the file that you submitted