Changes for page Using Guacamole in HDC

Last modified by Dennis Segebarth on 2024/08/16 08:54
From version 17.1
edited by Dennis Segebarth
on 2024/05/28 11:37
Change comment: There is no comment for this version
To version 25.1
edited by Dennis Segebarth
on 2024/08/16 08:54
Change comment: Deleted image "Guacamole-Logo-300x100px cropped.png"

Summary

Details

Page properties
Content
... ... @@ -7,7 +7,7 @@
7 7  Apache Guacamole is a clientless remote desktop gateway that gives you access to Project-based Virtual Machines (VMs) to perform computational analyses on your Project data. Guacamole supports standard protocols like VNC, RDP, and SSH. To learn more about the application, visit the [[Guacamole documentation>>https://guacamole.apache.org/]] and [[administration guide>>https://guacamole.apache.org/doc/gug/administration.html]].
8 8  
9 9  (% class="wikigeneratedid" %)
10 -[[image:Guacamole-Logo-300x100px cropped.png||data-xwiki-image-style-alignment="center" height="146" width="376"]]
10 +[[image:1723655513077-695.png||height="155" width="399"]]
11 11  
12 12  = How it works =
13 13  
... ... @@ -25,7 +25,7 @@
25 25  
26 26  = Getting Access to Guacamole =
27 27  
28 -[[image:Project Workspace tool navigation Guacamole v2.1.5 2023-01-23.png||height="179" width="322"]]
28 +[[image:1723655536338-430.png||height="191" width="343"]]
29 29  
30 30  1. (((
31 31  Launch your Project and click **Guacamole **in the workspace icon group.
... ... @@ -56,15 +56,16 @@
56 56  For the initial creation of your Workspace VM-specific password, or to reset it at any time:
57 57  
58 58  1. Open your **Account **page in the HDC platform.
59 -1. Depending on whether you are generating your Workspace VM-specific password for the first time, or are resetting it after initial creation, click on the **Generate VM Password** or **Reset VM Password** button, respectively (see A in figure below, which shows the **Reset VM Password** button). Please note: This button will be disabled for your account until a Project Admin approved your Guacamole access request.
60 -1. A pop-up window will prompt you to confirm the generation or reset of your VM-specific password (see B in figure below).
59 +1. Depending on whether you are generating your Workspace VM-specific password for the first time, or are resetting it after initial creation, click on the **Generate VM Password** or **Reset VM Password** button, respectively (see below, which shows the **Reset VM Password** button). Please note: This button will be disabled for your account until a Project Admin approved your Guacamole access request.
60 +[[image:Reset_workspace_vm_password_01.png||height="154" width="861"]]
61 +1. A pop-up window will prompt you to confirm the generation or reset of your VM-specific password:
61 61  11. Click on **Cancel** to abort the process.
62 -11. Click on **Generate VM Password **or **Reset VM Password**, respectively, to confirm the action.
63 -1. Once you confirmed the action, a new pop-up window will open and display your new Workspace VM-specific password to you (see C in figure below). **Please make sure to save it appropriately, as you won´t be able to view it again once you close this pop-up window. **This randomly created password consists of lower case letters only. You will also receive a notification via email that your Workspace VM-specific password has been reset.
63 +11. Click on **Generate VM Password **or **Reset VM Password**, respectively, to confirm the action
64 +[[image:Reset_workspace_vm_password_02.png||height="181" width="409"]]
65 +1. Once you confirmed the action, a new pop-up window will open and display your new Workspace VM-specific password to you. **Please make sure to save it appropriately, as you won´t be able to view it again once you close this pop-up window. **This randomly created password consists of lower case letters only. You will also receive a notification via email that your Workspace VM-specific password has been reset.  
66 +[[image:Reset_workspace_vm_password_03.png||height="198" width="449"]]
64 64  1. You can now use this password to login to all Guacamole Workspace VMs you have access to within the HDC platform. We highly recommend changing it after your first login, see //Change your Workspace VM-specific password** **//below for more information.
65 65  
66 -[[image:Untitled-1.png||height="315" width="858"]]
67 -
68 68  === Change your Workspace VM-specific password ===
69 69  
70 70  In order to change your Workspace VM-specific password, please login to a Workspace VM (see //Launching a Guacamole VM connection//, and //Establishing a Desktop VM Connection// or //Establishing a Command Line VM Connection//, respectively).
... ... @@ -77,9 +77,8 @@
77 77  1. A pop-up will open and prompt you to confirm this action by providing your current password (i.e. your current Workspace VM-specific password), and to specify the new one. The new password must be at least 8 characters long.
78 78  1. Confirm to change your password by clicking on **Change**.
79 79  
80 -[[image:1714664556786-681.png||height="230" width="413"]]
81 +[[image:1723796357125-338.png||height="254" width="459"]]
81 81  
82 -
83 83  b) Change your VM-specific password via a Command Line VM Connection:
84 84  
85 85  1. After logging in to a Command Line VM using your current Workspace VM-specific credentials, enter the command //passwd//
... ... @@ -88,7 +88,7 @@
88 88  1. You are prompted to confirm the new password by providing it again.
89 89  1. A message in the terminal will notify you about the successful update of your password.
90 90  
91 -[[image:1714664883045-227.png]]
91 +[[image:1723796579348-927.png||height="128" width="464"]]
92 92  
93 93  After you changed your Workspace VM-specific password, the new password will be valid for all Workspace VMs within the HDC that you have access to.
94 94  
... ... @@ -102,8 +102,7 @@
102 102  (% start="1" style="list-style-type:lower-alpha" %)
103 103  1. If you have access to **both** Desktop **and **Command Line Interface VM connections, the Connections screen lists the available VMs. Each VM connection is identified by a name and ID number indicating
104 104  whether it is a Desktop or Command Line connection. Click a **VM connection **to initiate it.
105 -\\[[image:HDC Guacamole VMs from XWiki.png]]
106 -
105 +\\[[image:1723655596724-237.png||height="186" width="793"]]
107 107  1. If you only have access to **either** a Desktop connection **or **a Command Line Interface connection, the relevant login screen (Desktop or Command Line Interface) appears.
108 108  )))
109 109  1. Follow the instructions for establishing a **Desktop** or **Command Line Interface** VM connection.
... ... @@ -110,7 +110,7 @@
110 110  
111 111  == Establishing a Desktop VM Connection ==
112 112  
113 -[[image:Guacamole login modal from XWiki 2023-01-23.png||height="285" width="244"]]
112 +[[image:1723655606316-749.png||height="426" width="365"]]
114 114  
115 115  1. On the Desktop login screen, enter your VM-specific credentials (see //Management of Workspace VM-specific credentials//), then click **OK. **
116 116  1. The VM connection is established.
... ... @@ -120,6 +120,8 @@
120 120  
121 121  == Establishing a Command Line VM connection ==
122 122  
122 +[[image:1723655625737-284.png||height="56" width="466"]]
123 +
123 123  {{code language="none" width="50%"}}
124 124  Welcome to Ubuntu 20.04.5 LTS (GNU/Linux 5.15.0-1019-azure x86_64)
125 125  
... ... @@ -137,7 +137,7 @@
137 137  
138 138  After successfully logging into a Desktop VM, the default desktop is displayed. To launch the pre-installed Linux applications such as a standard terminal,
139 139  
140 -[[image:Project Workspace Guacamole Desktop Linux Terminal v2.1.5 2023-02-06 1422.png||height="446" width="802"]]
141 +[[image:1723655669214-227.png||height="481" width="864"]]
141 141  
142 142  1. Click **Activities **in the upper left corner.
143 143  1. Enter {{code language="none"}}terminal{{/code}} in the search box.
Guacamole login modal from XWiki 2023-01-23.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.dsegebarth
Size
... ... @@ -1,1 +1,0 @@
1 -161.6 KB
Content
Guacamole-Logo-300x100px cropped.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.dsegebarth
Size
... ... @@ -1,1 +1,0 @@
1 -15.8 KB
Content
HDC Guacamole VMs from XWiki.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.dsegebarth
Size
... ... @@ -1,1 +1,0 @@
1 -350.6 KB
Content
Project Workspace Guacamole CLI Connection Login v2.1.5 2023-02-06.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.dsegebarth
Size
... ... @@ -1,1 +1,0 @@
1 -1.2 KB
Content
Project Workspace Guacamole Desktop Linux Terminal v2.1.5 2023-02-06 1422.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.dsegebarth
Size
... ... @@ -1,1 +1,0 @@
1 -1.1 MB
Content
Project Workspace tool navigation Guacamole v2.1.5 2023-01-23.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.dsegebarth
Size
... ... @@ -1,1 +1,0 @@
1 -71.6 KB
Content
1723655513077-695.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +10.9 KB
Content
1723655536338-430.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +69.9 KB
Content
1723655596724-237.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +58.9 KB
Content
1723655606316-749.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +169.1 KB
Content
1723655625737-284.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +1.9 KB
Content
1723655669214-227.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +220.4 KB
Content
1723796357125-338.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +83.0 KB
Content
1723796579348-927.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +26.2 KB
Content
Reset_workspace_vm_password_01.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +233.9 KB
Content
Reset_workspace_vm_password_02.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +183.8 KB
Content
Reset_workspace_vm_password_03.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +178.0 KB
Content