Difference between revisions of "RGSConnect command line utility for Mac"

Line 1: Line 1:
===Installing the RGSConnect command line utility for Mac===
+
==Installing the RGSConnect command line utility for Mac==
 
See the [[Install Mac RGSConnect client|instructions]].
 
See the [[Install Mac RGSConnect client|instructions]].
  
===Why is there only a command line version of RGSConnect for Mac?===
+
==Why is there only a command line version of RGSConnect for Mac?==
 
Apple changes the requirements for Mac development every couple of months.  That means that developers have to re-program their software every couple of months to keep up with Apple's demands.  There is no such requirements to maintain a command line utility.  Maintaining a GUI-based RGSConnect launcher for Mac was becoming too time intensive.  The choices for now are no Mac client, or a command-line client.
 
Apple changes the requirements for Mac development every couple of months.  That means that developers have to re-program their software every couple of months to keep up with Apple's demands.  There is no such requirements to maintain a command line utility.  Maintaining a GUI-based RGSConnect launcher for Mac was becoming too time intensive.  The choices for now are no Mac client, or a command-line client.
  
===Using the RGSConnect command line utility===
+
==Using the RGSConnect command line utility==
 
* The RGSConnect command line utility is launched from a terminal window.  Reference [https://www.idownloadblog.com/2019/04/19/ways-open-terminal-mac| this article] to learn how to launch a terminal window on a Mac.   
 
* The RGSConnect command line utility is launched from a terminal window.  Reference [https://www.idownloadblog.com/2019/04/19/ways-open-terminal-mac| this article] to learn how to launch a terminal window on a Mac.   
 
* Inside the Mac terminal window, type <pre> rgs </pre>
 
* Inside the Mac terminal window, type <pre> rgs </pre>
Line 18: Line 18:
 
1: Linux: RGS Linux (Both on and off campus)
 
1: Linux: RGS Linux (Both on and off campus)
 
2: Windows: RGS Windows (Both On- and Off-campus)
 
2: Windows: RGS Windows (Both On- and Off-campus)
3: WindowsOverflow: Windows Desktops used as Overflow</pre>
+
3: WindowsOverflow: Windows Desktops used as Overflow
  
Please enter a pool number:
+
Please enter a pool number:</pre>
 +
Select the group of RGS machines to use by typing in the corresponding number.  For instance, to use "Windows RGS" in the menu above, type the number "2" on your keyboard.  The options in the menu above may be different for each user depending on what classes a student is enrolled in. 
  
 
===Troubleshooting===
 
===Troubleshooting===

Revision as of 11:31, 25 March 2020

Installing the RGSConnect command line utility for Mac

See the instructions.

Why is there only a command line version of RGSConnect for Mac?

Apple changes the requirements for Mac development every couple of months. That means that developers have to re-program their software every couple of months to keep up with Apple's demands. There is no such requirements to maintain a command line utility. Maintaining a GUI-based RGSConnect launcher for Mac was becoming too time intensive. The choices for now are no Mac client, or a command-line client.

Using the RGSConnect command line utility

  • The RGSConnect command line utility is launched from a terminal window. Reference this article to learn how to launch a terminal window on a Mac.
  • Inside the Mac terminal window, type
     rgs 
  • Typing "rgs" in a terminal window will launch the text-based RGSConnect client utility within the terminal window. The output should display:
yourMacUsername@YourMac ~ % rgs
Connecting to RGS Connect...
CAEDM User Name: 
  • Type in your CAEDM username and CAEDM password. You do not need to type a domain, or any other such syntax. Simply username and password.
  • After successfully providing your username and password, a prompt will appear with the available RGS Pools:
Choose a pool to connect to:
0: RGSExtended: RGS Extended Use Windows
1: Linux: RGS Linux (Both on and off campus)
2: Windows: RGS Windows (Both On- and Off-campus)
3: WindowsOverflow: Windows Desktops used as Overflow

Please enter a pool number:

Select the group of RGS machines to use by typing in the corresponding number. For instance, to use "Windows RGS" in the menu above, type the number "2" on your keyboard. The options in the menu above may be different for each user depending on what classes a student is enrolled in.

Troubleshooting

  • When I type in my password I keep getting:
Password: 
Traceback (most recent call last):
  File "/Applications/RGSConnect/rgsconnect.py", line 307, in <module>
    pools=getPools(cl_user,cl_pass,settings["Host_Addr"], int(settings["Client_Port"]))
  File "/Applications/RGSConnect/rgsconnect.py", line 122, in getPools
    raise ServerError(pools)
__main__.ServerError: Err:Invalid credentials

This means that you typed your username or password incorrectly. Try again. If you continue to have issues, contact your CSR or CAEDM.