Difference between revisions of "VCM"

From PrattWiki
Jump to navigation Jump to search
 
(17 intermediate revisions by the same user not shown)
Line 1: Line 1:
This page will go through how to set up a Virtual Machine to do work for various classes in Spring 2018It will be focused on the EGR 103L course which includes Python and App Inventor.
+
This page will go through how to set up a Virtual Machine to do work for various classes in Spring 2024.
 +
 
 +
== Multifactor Authentication ==
 +
To use the virtual computers, you need to have multi-factor authentication set up; go to [https://oit.duke.edu/what-we-do/applications/multi-factor-authentication Multi-Factor Authentication] and enrollYou will generally need a smart phone or access to email to log in.
 +
 
 +
If you are not on the Duke network, you will need to use Cisco AnyConnect as a VPN.  Go to [https://oit.duke.edu/what-we-do/services/vpn VPN] at OIT for links to the installation page.
 +
 
 +
== Spring 2024 ==
 +
This section is being revised in Spring of 2024 and supercedes any information below.  The older information will be edited or removed as appropriate as testing continues with the new VCM.  The specific VCM is the [https://vcm.duke.edu/reservations/find_app_stack/77 EGR 103 / ECE 110 / EGR 224 / ECE 382 / ME 344 Windows 10 + Math apps for Gustafson EGR / ECE classes]]
 +
 
 +
=== Items Already Installed ===
 +
==== Box Drive ====
 +
Duke has a partnership with Box to provide storage for Duke community members.  There are several advantages to storing files using Box Drive:
 +
* Work locally and backup remotely
 +
* Share folders and files when appropriate.
 +
The first time you log into your VCM, you will get an option to log in to your Box account.  Use your Duke credentials for this.  You will need to have multifactor authentication.
 +
 
 +
Once connected, you will be prompted to take the tour.  If you have not used Box or Box Drive before, please take the tour!  Among other things, take note of the "Make Available Offline" option.  For your files for class, you will generally want to have this option enabled.  While you obviously will not be able to use a VCM while offline, you will have local access on your own computer if needed.
 +
 
 +
==== Anaconda ====
 +
The [https://www.anaconda.com/ Anaconda] distribution is pre-installed on the VCM.  This includes Spyder (4.1.4, which is *old* old) as well as other design environments and languages.  For EGR 103, the primary part of Anaconda that we will be using is Spyder.  Best bet is to update things.  Note that this does take some time...
 +
* Upon first run, you will likely want to update things.
 +
** Go to Start - Anaconda3 - right click on Anaconda Prompt - more - Run as administrator
 +
** <code>conda update conda</code>
 +
*** This will be fairly quick
 +
** <code>conda deactivate</code>
 +
** <code>conda update anaconda-navigator</code>
 +
*** This seems to really get everything up to the latest and greatest versions
 +
*** Navigator 2.4.1, Spyder 5.4.2, Notebook 6.5.4 among others
 +
 
 +
==== Maple ====
 +
Maple 2020 is already installed.  Don't worry about installing any updates.  There is an introductory video you can watch - note that the VCM can play sounds on your local computer!
 +
 
 +
== Changes to VCM ==
 +
The following is a list of changes Dr. G. made to his own copy of the VCM to keep track of any deviation from the standard one.
 +
* (failed) Kite - when Spyder first starts, it asks if you want to install Kite.  Kite has better and clearer documentation of some features in Spyder and provides help while programming.  Unfortunately, at the moment, Kite doesn't play nice with the VCM so it is not actually installed
 +
* Spyder preferences:
 +
** Appearance: Fonts set to 16 and 15 vice 10 and 9
 +
** iPython console: Graphics / Graphics Backend set to Automatic
 +
* Anaconda prompt (run as administrator):
 +
** conda install black: add [https://pypi.org/project/black/ Black]
  
 
== Getting Started ==
 
== Getting Started ==
Line 5: Line 45:
  
 
* On the Virtual Computing Manager page, click on "Reserve a VM"
 
* On the Virtual Computing Manager page, click on "Reserve a VM"
* In Application and Operating System dropdown of the New Virtual Machine Reservation page, pick "Windows Office 2016" and then click Reserve
+
* In Application and Operating System dropdown of the New Virtual Machine Reservation page, pick "Windows Office 2019" (or whichever of the Windows options looks best to you) and then click Reserve
 
* Read the terms of use and if you agree to them, click Agree.  If you do not agree with them, contact Dr. G as soon as possible.  It may take a little time to set up the virtual machine - eventually you will go back to the VCM page and you should see a link under My Reservations.
 
* Read the terms of use and if you agree to them, click Agree.  If you do not agree with them, contact Dr. G as soon as possible.  It may take a little time to set up the virtual machine - eventually you will go back to the VCM page and you should see a link under My Reservations.
  
Line 11: Line 51:
 
* Click on the link for your virtual machine; this should bring up the VM Manamagement Tools page.
 
* Click on the link for your virtual machine; this should bring up the VM Manamagement Tools page.
 
* In the General Information pane on the right, there should be a link for Remote Desktop; click that to download the remote desktop (rdp) file.
 
* In the General Information pane on the right, there should be a link for Remote Desktop; click that to download the remote desktop (rdp) file.
* Open the file; on Windows, this will bring up Remote Desktop Connection.
+
* Open the file; on Windows, this will bring up Remote Desktop Connection.  On a mac, it should bring up RDC but if it does not, see [https://vcm.duke.edu/help/15  Remote Desktop Connection (RDC) Clients] for information on how to download the client.
 
* The desktop should be trying to connect with your Duke credentials (WIN\NetID).  Enter your Duke password to finish connecting.  Do '''not''' click "Remember Me" if you are on a public computer, even if you logged in as you!
 
* The desktop should be trying to connect with your Duke credentials (WIN\NetID).  Enter your Duke password to finish connecting.  Do '''not''' click "Remember Me" if you are on a public computer, even if you logged in as you!
 
* Read the note about unauthorized use, then click OK - the first time you start your VM, it may take some time "Preparing Windows."
 
* Read the note about unauthorized use, then click OK - the first time you start your VM, it may take some time "Preparing Windows."
Line 18: Line 58:
  
 
== Accessing your files from your VM ==
 
== Accessing your files from your VM ==
* Your Duke (CIFS) folder should automatically be mounted to the windows machine.  If you open the File Explorer (yellow folder at the bottom of the screen) and click on This PC, your NetID should be the name of one of the Network locations.  You should always use this folder to store files -- these files get backed up every 12 hours.  Do not use the Documents folder on the VM.
+
* For some people, their Duke (CIFS) folder should automatically be mounted to the windows machine.  If you open the File Explorer (yellow folder at the bottom of the screen) and click on This PC, your NetID should be the name of one of the Network locations.  You should always use this folder to store files -- these files get backed up every 12 hours.  Do not use the Documents folder on the VM.
 +
* If that is not the case, go to [https://oit.duke.edu/help/articles/cifs-home-directories-and-web-spaces-how-connect-windows Duke's page on how to mount CIFS on Windows]
  
 
== Installing software on your VM ==
 
== Installing software on your VM ==
 
There are two ways to install software.  There is a Software Center icon on the desktop - this contains ways to get commonly-installed programs and packages.  The second way is to just install the software yourself.  Depending on the class you are using the VM for, you may be using one or both mechanisms to install software.
 
There are two ways to install software.  There is a Software Center icon on the desktop - this contains ways to get commonly-installed programs and packages.  The second way is to just install the software yourself.  Depending on the class you are using the VM for, you may be using one or both mechanisms to install software.
 
=== For EGR 103 Fall 2017 ===
 
* From Software Center:
 
** ePrint
 
** Firefox or Google Chrome (or you can use Edge)
 
** MobaXterm
 
* From web sites:
 
** Anaconda with Spyder: [https://www.anaconda.com/download/ Download]
 
*** Click on Windows icon and choose Python 3.6 version
 
*** If you want the cheat sheet, go for it!
 
*** Agree to the terms
 
*** Install for "Just Me"
 
*** Keep the default destination folder
 
*** Register Anaconda as default
 
*** Sit back and watch the magic happen!
 
*** When the installer is finished, learn more at will!
 
** Adobe Acrobat Reader DC: [https://get.adobe.com/reader/ Download]
 
*** '''Unclick''' the Optional offers.
 
*** Leave the "Install the Acrobat Reader Chrome Extension" clicked if you installed Chrome
 
*** Click on the "Install now" button
 
*** Once the executable has finished downloading, run it
 
 
 
 
=== For EGR 103 ===
 
* From Software Center:
 
** ePrint
 
** FileZilla
 
** Firefox or Google Chrome (or you can use Edge)
 
** MobaXterm
 
* From web sites:
 
** Anaconda with Spyder: [https://www.anaconda.com/download/ Download]
 
*** Click on Windows icon and choose Python 3.6 version
 
*** If you want the cheat sheet, go for it!
 
*** Agree to the terms
 
*** Install for "Just Me"
 
*** Keep the default destination folder
 
*** Register Anaconda as default
 
*** Sit back and watch the magic happen!
 
*** When the installer is finished, learn more at will!
 
** MiKTeX: [https://miktex.org/download Download]
 
*** Click on Download - it should know you are on a Windows machine
 
*** After running the installer, accept the conditions
 
*** Install only for you
 
*** Use the default directory
 
*** Change the preferred paper to letter and say Yes to install missing packages on the fly
 
*** Start the installer
 
*** Install!
 
*** TeXworks, a very handy editor and viewer, is automatically installed with MiKTeX 2.9 or later!
 
** Adobe Acrobat Reader DC: [https://get.adobe.com/reader/ Download]
 
*** '''Unclick''' the Optional offers.
 
*** Leave the "Install the Acrobat Reader Chrome Extension" clicked if you installed Chrome
 
*** Click on the "Install now" button
 
*** Once the executable has finished downloading, run it
 
<!--
 
** TeXstudio: [http://texstudio.sourceforge.net/ Download]
 
*** Click the Download now button
 
*** Start the installer
 
*** Use the default folder
 
*** Have TeXstudio create a desktop shortcut if you'd like
 
*** When you run TeXstudio, start a new file and under Wizards pick Math Assistant - this will prompt you to install .NET Framework. 
 
**** Download and install the .NET Framework
 
**** Once installed, you should be able to run the Math Assistant - this will allow you to draw math and have it translate into code.
 
-->
 

Latest revision as of 17:32, 24 December 2023

This page will go through how to set up a Virtual Machine to do work for various classes in Spring 2024.

Multifactor Authentication

To use the virtual computers, you need to have multi-factor authentication set up; go to Multi-Factor Authentication and enroll. You will generally need a smart phone or access to email to log in.

If you are not on the Duke network, you will need to use Cisco AnyConnect as a VPN. Go to VPN at OIT for links to the installation page.

Spring 2024

This section is being revised in Spring of 2024 and supercedes any information below. The older information will be edited or removed as appropriate as testing continues with the new VCM. The specific VCM is the EGR 103 / ECE 110 / EGR 224 / ECE 382 / ME 344 Windows 10 + Math apps for Gustafson EGR / ECE classes]

Items Already Installed

Box Drive

Duke has a partnership with Box to provide storage for Duke community members. There are several advantages to storing files using Box Drive:

  • Work locally and backup remotely
  • Share folders and files when appropriate.

The first time you log into your VCM, you will get an option to log in to your Box account. Use your Duke credentials for this. You will need to have multifactor authentication.

Once connected, you will be prompted to take the tour. If you have not used Box or Box Drive before, please take the tour! Among other things, take note of the "Make Available Offline" option. For your files for class, you will generally want to have this option enabled. While you obviously will not be able to use a VCM while offline, you will have local access on your own computer if needed.

Anaconda

The Anaconda distribution is pre-installed on the VCM. This includes Spyder (4.1.4, which is *old* old) as well as other design environments and languages. For EGR 103, the primary part of Anaconda that we will be using is Spyder. Best bet is to update things. Note that this does take some time...

  • Upon first run, you will likely want to update things.
    • Go to Start - Anaconda3 - right click on Anaconda Prompt - more - Run as administrator
    • conda update conda
      • This will be fairly quick
    • conda deactivate
    • conda update anaconda-navigator
      • This seems to really get everything up to the latest and greatest versions
      • Navigator 2.4.1, Spyder 5.4.2, Notebook 6.5.4 among others

Maple

Maple 2020 is already installed. Don't worry about installing any updates. There is an introductory video you can watch - note that the VCM can play sounds on your local computer!

Changes to VCM

The following is a list of changes Dr. G. made to his own copy of the VCM to keep track of any deviation from the standard one.

  • (failed) Kite - when Spyder first starts, it asks if you want to install Kite. Kite has better and clearer documentation of some features in Spyder and provides help while programming. Unfortunately, at the moment, Kite doesn't play nice with the VCM so it is not actually installed
  • Spyder preferences:
    • Appearance: Fonts set to 16 and 15 vice 10 and 9
    • iPython console: Graphics / Graphics Backend set to Automatic
  • Anaconda prompt (run as administrator):
    • conda install black: add Black

Getting Started

To get started, go to Duke's Virtual Computing Manager and log in with your NetID. You will then want to "Reserve a VM" - this means that Duke will be setting up a virtual computer for you. You will be able to install and run applications remotely for just about any computer with an internet connection. Students in EGR 103 will be creating a Windows based VM for the semester.

  • On the Virtual Computing Manager page, click on "Reserve a VM"
  • In Application and Operating System dropdown of the New Virtual Machine Reservation page, pick "Windows Office 2019" (or whichever of the Windows options looks best to you) and then click Reserve
  • Read the terms of use and if you agree to them, click Agree. If you do not agree with them, contact Dr. G as soon as possible. It may take a little time to set up the virtual machine - eventually you will go back to the VCM page and you should see a link under My Reservations.

Accessing your VM

  • Click on the link for your virtual machine; this should bring up the VM Manamagement Tools page.
  • In the General Information pane on the right, there should be a link for Remote Desktop; click that to download the remote desktop (rdp) file.
  • Open the file; on Windows, this will bring up Remote Desktop Connection. On a mac, it should bring up RDC but if it does not, see Remote Desktop Connection (RDC) Clients for information on how to download the client.
  • The desktop should be trying to connect with your Duke credentials (WIN\NetID). Enter your Duke password to finish connecting. Do not click "Remember Me" if you are on a public computer, even if you logged in as you!
  • Read the note about unauthorized use, then click OK - the first time you start your VM, it may take some time "Preparing Windows."
  • Once prepared, you should now have a Windows machine working in a window!
  • The first time you connect, you may need to perform updates - this is a potentially hours-long process so it may be best to start it when you can leave the VM running but do not need to be using it.

Accessing your files from your VM

  • For some people, their Duke (CIFS) folder should automatically be mounted to the windows machine. If you open the File Explorer (yellow folder at the bottom of the screen) and click on This PC, your NetID should be the name of one of the Network locations. You should always use this folder to store files -- these files get backed up every 12 hours. Do not use the Documents folder on the VM.
  • If that is not the case, go to Duke's page on how to mount CIFS on Windows

Installing software on your VM

There are two ways to install software. There is a Software Center icon on the desktop - this contains ways to get commonly-installed programs and packages. The second way is to just install the software yourself. Depending on the class you are using the VM for, you may be using one or both mechanisms to install software.