View source for RGSConnect command line utility for Mac

You do not have permission to edit this page, for the following reason:
The action you have requested is limited to users in the group: erato.
You can view and copy the source of this page.
==Installing the RGSConnect command line utility for Mac==
See the [[Install Mac RGSConnect client|installation 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 [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>
* 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.  Your list of pools will differ based on what classes you are enrolled in.  It will look something like:
<pre>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:</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.  

* After selecting a pool from the menu, the HP RGS Client will be launched automatically connecting to a machine in that pool.  The utility will display a message stating:
 Reservation established for REMOTE-MACHINE-NAME
Where REMOTE-MACHINE-NAME is the name of the machine the HP ZCentral Remote Boost client will connect to automatically.  See example below.  


[[File:rgs_command_line.png|frame|center|In this example, the user selected "WindowsOverflow".  It launched the HP ZCentral Remote Boost client and is asking to accept the certificate.  After accepting the certificate, the connection will be established.]]



==Troubleshooting==
=== When I type in my password I keep getting: ===
<pre>
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</pre>

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

===Changing Resolution of Windows RGS Server Desktops===
[[File:rgs_resize.png|thumb|Sometimes the remote server may have an undesirable resolution set.  This problem is easily remedied.]]
Sometimes the resolution of an RGS session is either too large, or too small.  To change the resolution:
#Right click on the background of the remote server's Windows desktop
#Select "Intel Graphics Settings"
#Click on "Display"
#Under "Resolution" choose the desired resolution
#Click on "Apply" to try the setting...
Return to RGSConnect command line utility for Mac.
Retrieved from "https://caedm.et.byu.edu/wiki/index.php/RGSConnect_command_line_utility_for_Mac"