VCL Reservations
General Info
What rights do I have on the machine?
- On a Windows environment you have administrative rights
- On a Realm Linux lab machine you have the same rights as you have in computer labs
- On a Linux environment you have administrative rights
Some images are specifically configured not to allow users to have administrative rights.
How long can I use my reservation?
- Students have a default duration of 8 hours
- Duration extension requests require a faculty or departmental sponsor
- Send duration extension requests to vcl_help@ncsu.edu
- Faculty and staff have duration limits greater than 48 hours
What are the system requirements for connecting?
Windows
- To connect to another Windows computer, you need a Remote Desktop Connection application:
- Microsoft’s Remote Desktop Connection is installed by default on Windows OS
- Ericom Blaze client
Google Chrome also has various remote desktop App
- To connect to a Unix/Linux computer you must have an SSH client (such as PuTTY). To display graphical applications you will also need an X server (such as X-Win32).
- The Microsoft Remote Desktop app is also available on the Google Play Store
Macintosh
- To connect to a Windows computer you will need a Remote Desktop Connection application:
- Microsoft’s Remote Desktop Connection software is available via the Apple App Store
- Ericom Blaze client
- To connect to a Unix/Linux computer you will need:
- ssh command is accessed through the Temerinal application
- X11 if running applications remotely
Linux
- Most Linux distributions include a Remote Desktop client (xfreerdp), as well as SSH/X.
How to print from a remote VCL computer?
Printing within VCL can be difficult due to the number of different printers that exist. Some printers that are locally attached through Remote Desktop Connection will be recognized by the default Windows printer drivers, others printers will not. To work around this, most VCL windows environments should have pdfFactory installed. PdfFactory will show up as a virtual printer and is selectable as a printer within the windows applications. This will print the output to a pdf and then you can copy this pdf file to your machine and print as you normally do.
If your local printer is not supported by the default windows drivers, then you must select the pdfFactory and print to a pdf file.
Connecting VCL
How do I make a VCL Reservation?
- On the main page, click ‘Make a Reservation‘ or ‘Reservations‘ at the top of the page.
- If you are not already authenticated, you will be presented with a login screen. Select your affiliation and proceed to log in.
- Once authenticated, you will be presented with the Reservations page. Click the ‘New Reservations‘ button. A window will pop-up and you will be presented with a menu of VCL application environments to choose from based on your level of access.
- Choose the VCL application environment you would like to use from the list.
- Select the time and duration you would like to start the reservation, for an immediate session select ‘Now‘. (By default the initial duration is 1 hour. Once the reservation is active the duration can be extended. Under certain cases longer durations are available for faculty, research, or departmental services.)
- Click ‘Create Reservation‘.
- You will be taken to the Current Reservations page. Here you will see the reservation pending while the assigned machine is being prepared.
- Click on the ‘Pending…‘ link for details of the processing.
- Once ready, a ‘Connect!‘ button will appear. Depending on the environment, it can take anywhere from 1 to 20 Minutes for the reserved system to be prepared.
- After clicking the ‘Connect!‘ button, the details of your requested environment will appear.
- The details can include the remote IP address, a single one-time password (depending on the environment) and information on how to connect to the remote computer running the application environment you selected. Also note the details regarding the connect information will change for each reservation you make.
- Connect to the remote machine.
How long do I have to wait after I hit ‘Connect’ before I can login into my reserved machine?
During periods of heavy utilization, it may take a minute before the time you hit ‘Connect’ and when you can actually connect; however, it will normally be ready by the time you try to connect to the computer.
How do I connect to a VCL environment from a Macintosh?
Depending on the VCL environment, you will need to use a remote desktop connection or SSH (secure shell) client.
Microsoft Remote desktop connection can be freely downloaded from the Apple App Store.
SSH (secure shell) client is natively available in Mac OS X.
- Open a terminal window and use the command
ssh youruserID@IPaddressofmachine
and then type the password stated.
How do I connect to a VCL environment from a Linux machine?
Depending on the environment you will need to use a remote desktop connection client or a ssh client. The ssh (secure shell) client is native to the linux operating system, open a terminal window and use the command ‘ssh’.
The remote desktop client ‘rdesktop’ for Linux/Unix operating systems is a third party application downloaded from sourceforge: http://sourceforge.net/projects/rdesktop/. Depending on your distribution, rdesktop may already be installed – open a terminal window and try to run the command rdesktop.
A full list of options are documented in rdesktop man page, but a sample command line might look like the following:
- rdesktop -g 1024×768 -a 24 -r disk:home=/home/<userid> -r disk:root=/ -r printer:<localqueue>
There is a nice GTK frontend called tsclient for rdesktop. It is likely available on your distribution as well. If not, it can be dlownloaded from sourceforge as well: http://sourceforge.net/projects/tsclient
If accessing a windows VCL resource from NCSU campus Linux and Solaris lab machines, rdesktop is available through the netutils locker. Run the command ‘add netutils’ in a terminal window to access the rdesktop command.
How do I connect to a VCL environment from a Chrome OS machine?
Depending on the VCL environment, you will need to use a remote desktop connection or SSH (secure shell) client.
Microsoft Remote desktop connection can be freely downloaded from the Google Play Store.
Modifying Reservations
I need more time than I originally thought. How can I get it?
On the website:
- Click Reservations.
- Find your reservation, and click the ‘Edit’ button.
- Find the drop-down box that has a time in it, and change it to a longer duration.
- Click ‘Confirm Changes’.
You will only be able to extend the length if the computer your reservation is on has time available before the next reservation. The maximum time for a reservation (even with an extension) is typically 8 hours from the initial starting time of your reservation.
End of Reservations
What happens at the end of my reservation?
You will receive warnings at 10 minutes and then at 5 minutes before your reservation expires. Once time is up, you are disconnected and any unsaved changes you have made will not be recoverable.
Can I reconnect to a computer if my reservation time has not expired but I disconnected?
Yes. Just run Remote Desktop Connection or SSH again and login with the same user name and password. You will have 15 minutes to reconnect before your reservation times out.
Reconnecting to a Remote Desktop session on a Windows server will show you to the “desktop” you were already using, with all of the programs and files you had open. Whereas reconnecting to a SSH session on a UNIX or Linux server will be like logging in initially, any programs you had running previously will no longer be running.
My reservation timed out. What does this mean?
If you have disconnected or logged out of your assigned machine. You will have up to 15 minutes to reconnect before the system assumes you have left the reservation. Once 15 minutes has been reached, the VCL system times out your reservation and will start the reclaim process. The reclaim process involves reinstalling the machine and you will lose any work you have left on the remote machine’s hard drive.
Make use of any network drives at all times to make sure you don’t lose any work.
Note: Server reservations or reservations greater than 24 hours are excluded from this timeout.
Reservation Notifications
I do not receive emails confirming my reservations.
Email notification can be enabled/disabled under the Manage tab and then User Preferences->General Preferences.
If email notification is enabled and you are not receiving emails, it is likely because the email address that the confirmation/notification emails are being sent to is not the email address that you primarily use. The email address that all VCL emails are sent to is the one listed in the NCSU online directory.
To change what email address VCL related emails are sent to, look yourself up in the NCSU online directory and follow the information provided there on updating your information.
Remote Desktop
What is an RDP file?
An RDP file is a settings file that can be opened by the Remote Desktop Client to automatically open a connection to the reserved computer.
For automatic login, provided your browser and operating system properly support the auto login feature. The RDP file can be used to automatically login you into the remote machine, just by clicking the Get RDP file button.
How do I modify my remote desktop connection screen size when using the Get RDP file?
On the website:
- Click ‘Reservations‘ or ‘Make a Reservation‘
- Select the Manage tab and then ‘User Preferences‘
- Select the RDP file preferences
Here you can edit the default settings for your RDP file for the screen size resolution, local drives, and sound.
When I click Get RDP file, Internet Explorer gives an error and states it cannot download index.php from vcl.ncsu.edu
This is related to a security setting in Internet Explorer which for some reason does not allow file downloads over a secure connection (https).
To fix this problem:
- Within Internet Explorer, click “Tools”.
- Click “Internet Options”.
- Select the “Advanced” tab.
- Under the Security settings section make sure “Do not save encrypted pages to disk” is checked.
- Click Apply.
- Close the Internet Options window.
Attempt to get the RDP file again: click “Get RDP file”. You should be able to save the RDP file to your local computer and open it to access the remote VCL machine.
SSH
How do I use SSH identity key authentication for Linux reservations?
- The following pages provide details on using SSH identity keys to connect to VCL reservations.
VCL Website
When hitting forward in my browser in the scheduling interface, I keep getting the initial page.
This is often caused by using Back/Forward in certain web browsers (particularly Safari on Macintosh).
In order for the web application that is the scheduling interface for VCL to work correctly it must know what web page you were referred from when showing you any page except for the entry page. Some web browsers (Safari in particular) tend to forget exactly how you came to a given webpage. Thus when your web browser tries to load a given page in the scheduling interface and cannot remember how you came to be at that page, the scheduling web application sends you back to the entry page.
I clicked “remember my selection” on the page where I select an authentication method. How do I change it?
The following URL will allow you to change your selection:
https://vcl.ncsu.edu/scheduling/index.php?mode=selectauth&clearselection=1
I logged out and forgot my password to the VCL connection. How do I look it up?
Revisit the VCL website:
- Click on Current Reservations
- Click on the “Connect!” button
Your connection details will be displayed.
Applications & Images
Why aren’t there offices/productivity applications installed in each environment?
The purpose of each VCL environment is to provide someone access to an application or group of applications that the person wouldn’t have access to already. There are many Office/Productivity Suites available that can be installed on each user’s machine that will be used to connect to the VCL system. OpenOffice is available for free and is compatible with Microsoft Office.
Applications I accessed via VCL are running very slowly.
The technologies employed in VCL to provide applications remotely are fairly network intensive. It is recommended that a Cable/DSL connection be used.
Additionally, even in scenarios where Cable/DSL is provided by your Internet Service Provider, there can be connection/configuration issues that slow down your network connection to a crawl. Please run one of the Bandwidth Speed Tests to see how fast your connection is operating at the moment. Rates at or above 1Mbit are acceptable for Cable/DSL. If you are testing at or above 1Mbit and still having extreme slowness, contact VCL Support.
Files & Data
What happens if I leave my work on the VCL machine?
Windows and Linux environments are reloaded after your reservation has completed or your session has timed out. Therefore, any work left on the server is erased or lost. Make sure you save your work to the network filespace (AFS), a thumb drive, or your local computers hard drive.
How do I transfer files between my computer and the remote one?
This depends on what operating system you are connecting from and to. See ‘Where to save my files’ for a detailed explanation.
Where should I save my files when connecting to a Non-Realm Red Hat Enterprise Linux VCL environment?
Most of the non-Realm Linux environments have openAFS installed and configured for NCSU acounts. If you are using a NCSU account, simply transfer you data from the remote machine to a location in /afs.
If AFS or some other network share is not mounted. Then you will need to transfer your data using sftp (secure file transfer protocol) or scp(secure copy). This requires you to copy it to your local machine or another machine you have access to.
Copying data from the remote computer to your local machine:
- Windows:
- You will need an SCP client such as WinSCP
- More information can be found at the EOS Remote Access site under WinSCP
- Linux:
- Use the native scp command
- Mac OS X:
Traditional ftp (file transfer protocol) is not recommended. It does not support encyrption or secure authentication. Also, some locations actually block ftp network traffic.
Where should I save my files when connecting to a Realm Red Hat Enterprise Linux VCL environment?
When connecting to a Realm Linux computer, your current working directory is your AFS home directory. So any data generated/modified will reside in your campus file space.
Where should I save my files when connected to a Windows environment?
For remote access to a Windows VCL environment there are 3 options for saving your files:
- Local Hard Drive tunneled through the Remote Desktop session
- AFS Home Directory via the OpenAFS Client (K: drive)
- AFS Home Directory via SCP/SFTP client (F-Secure)
- Local Hard Drive tunneled through the Remote Desktop session: Before you connect to a Windows computer, click the ‘Options’ button in the Remote Desktop Connection window. Go to the ‘Local Resources’ tab, and check ‘Disk drives’ under the ‘Local Devices’ section. Then connect to the remote server. Once connected, under ‘My Computer’ on the remote server you will notice a drive that has the name of your computer and is mapped to your Local Hard Drive. This setting is enabled by default in the .RDP configuration files distributed at the ‘Connect!’ page that is displayed after making a reservation. That setting is one of many that can be configured in your VCL User Preferences.
- AFS Home Directory via the OpenAFS Client: The OpenAFS Client is installed on most of the Windows environments used in the VCL. This will be listed as the “K: drive” under my computer. If the K: drive does not exist, double click on the desktop icon labeled “Map AFS” and enter your campus username and unity password. See the AFS Space at NC State page for additional information on AFS.
- AFS Home Directory via SCP/SFTP client (WinSCP) WinSCP is installed in most of the Windows environments used in the VCL. WinSCP is an SCP/SFTP client made to securely transfer files. See the OIT WinSCP page for more information about WinSCP.
Note: DO NOT leave your work on the hard drive of Windows environments. What happens when I leave my work on the server?
My Windows application crashes when saving files to my personal machine through remote desktop.
Many applications read and write to files many times very quickly. When the file is on the same machine this is fine. Even if it is on the network, as long as there is a fast network connection, it will work, though with some degraded performance.
However, the process by which you gain access to files on your personal machine through Remote Desktop is quite complicated. Therefore, it will not be fast enough for some applications. In these cases, it is recommended that you copy your files to the VCL machine, work on you files there, and then copy them back to your personal computer when you are done with your work.
For Faculty & Instructors
As an instructor, how do I request course access to VCL Windows or Linux environments?
Simply send a email request to vcl_help@ncsu.edu. Please state the course number section and the desired application environment for your course. All appilcations on the Linux and Solaris platforms are already available to NCSU students, staff and faculty.
The only requirement for access to custom environment is the course will need to be active in Wolfware.
How do I create a custom VCL environments?
This advanced feature is reserved for Faculty or support staff of a course such as a TA, system administrators for a College or Department, or researchers. The ability to create and or update VCL environments requires Image Creation privileges. Due to the storage limitations, image creation privilege is not generally available and must be requested by Faculty or departmental systems administrator.
How do I update images?
Updating images (or environments) is similar to the Image Creation process. The owner of an image is the only one who can update a VCL environment.