Skip to content

Commit 28b3efd

Browse files
authored
readme updates (#48)
* lab0 updated with Guacamole info * lab3 edits * lab5 edits
1 parent e12e008 commit 28b3efd

File tree

13 files changed

+63
-37
lines changed

13 files changed

+63
-37
lines changed

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ See [Lab0 prerequisites](/labs/lab0/prerequisites.md) for the Hardware/Software
6262

6363
Review the Github Repo content for the NGINX Basics Workshop 101. If you have taken this Workshop, and understand the content, you can successfully complete the Lab exercises in this NGINX One Console Workshop. It is HIGHLY recommended that you complete the 101 Workshop prior.
6464

65-
It will take approximately 1 hour to complete the NGINX One Console Workshop.
65+
It will take approximately 2-3 hour to complete the NGINX One Console Workshop.
6666

6767
<br/>
6868

labs/lab0/media/almostthere.png

-233 KB
Loading

labs/lab0/media/apache_guacamole.png

26.8 KB
Loading

labs/lab0/media/guacamole_login.png

28.2 KB
Loading

labs/lab0/media/joinbutton.png

-148 KB
Loading

labs/lab0/media/launchrdp.png

-165 KB
Loading

labs/lab0/media/rdp.png

2.16 KB
Loading

labs/lab0/media/rdp_desktop.png

2.83 MB
Loading

labs/lab0/media/useruser.png

-112 KB
Loading

labs/lab0/media/waitforboot.png

-132 KB
Loading

labs/lab0/readme.md

Lines changed: 58 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -27,72 +27,102 @@ Look for an email from **`[email protected]`**. This will have instructi
2727
## Step 1: Get yourself to UDF
2828

2929
- Navigate to [https://udf.f5.com/](https://udf.f5.com/) and select `Invited Users`
30+
3031
![Non F5](media/udfloginnonf5.png)
3132

3233
- If this is your first time using UDF, use the `Sign Up` link which would take your to F5 registration page.
3334

34-
**NOTE:** this will *not be the password to the Ubuntu Desktop or other VMs in the class!*
35+
>**NOTE:** this will *not be the password to the Ubuntu Desktop or other VMs in the class!*
36+
3537
![Sign up](media/F5signup.png)
3638

3739
- Once you have filled in your registration details, you should be receiving an `Account Activation` email as shown below
38-
![Account Activation Email](media/F5accountactivationemail.png)
40+
41+
![Account Activation Email](media/F5accountactivationemail.png)
3942

4043
- When you click on the `Activate Account` button within the activation email, you would be redirected to setup 2 factor authentication as shown below. Select your preferred authentication method.
41-
![2factor Authentication prompt](media/2factorAuthentication.png)
44+
45+
![2factor Authentication prompt](media/2factorAuthentication.png)
4246

4347
- Once you have set up 2 factor authentication successfully, you will see a `green` checkmark on your preferred method. Click on `Finish`.
44-
![2factor Confirmation](media/2factorConfirmation.png)
48+
49+
![2factor Confirmation](media/2factorConfirmation.png)
4550

4651
- If you already have an account but you can't remember your password, simply reset your password by clicking on `Forgot Password?` link.
47-
![Non F5](media/udfloginreset.png "happens to the best of us")
52+
53+
![Non F5](media/udfloginreset.png "happens to the best of us")
4854

4955
## Step 2: Start the course
5056

5157
- Once logged into UDF, click `Launch` (This will open a new tab.)
52-
![Non F5](media/courselist.png "click launch")
58+
59+
![Non F5](media/courselist.png "click launch")
5360

5461
- And then click on `Join`
55-
![Non F5](media/joinbutton.png "'Yes I'm sure'")
62+
63+
![Non F5](media/joinbutton.png "'Yes I'm sure'")
5664

5765
- Click the `DEPLOYMENT` tab at the top
58-
![Non F5](media/almostthere.png "I'm up here")
5966

60-
## Step 3: RDP to the Ubuntu Jumpbox
67+
![Non F5](media/almostthere.png "I'm up here")
68+
69+
## Step 3: RDP to the Jumphost
6170

62-
- username: `ubuntu`
63-
- password: `Nginx123`
71+
- Wait for the Jumphost to finish booting. . .
6472

65-
THIS REQUIRES AN RDP CLIENT! If you have a Mac *and* haven't downloaded an RDP client before, here is the first-party version:
73+
![Non F5](media/waitforboot.png "loading. . .")
6674

67-
[Microsoft's RDP client on the Apple Apps Store](https://apps.apple.com/us/app/microsoft-remote-desktop/id1295203466?mt=12)
75+
- There are two ways to RDP to the Jumphost
6876

69-
- Now you just have to wait for the Ubuntu Desktop to finish booting. . .
77+
![Non F5](media/launchrdp.png "almost there")
7078

71-
![Non F5](media/waitforboot.png "loading. . .")
79+
### OPTION 1: Using **Apache Guacamole**
7280

73-
- Make sure to select a small enough resolution to see the whole screen.
81+
![Apache Guacamole](media/apache_guacamole.png)
82+
83+
This workshop is enabled with Apache Guacamole, which is a clientless remote desktop gateway.
7484

75-
![Non F5](media/launchrdp.png "almost there")
85+
- To use Apache Guacamole, select `Guacamole` from the ACCESS drop down for the Jumphost.
7686

77-
- Once you select the resolution, your browser will download an rdp file. Open this file to connect to Ubuntu Desktop.
87+
- Click on "Allow" for the popup and then enter below credentials.
7888

79-
- Accept the self-signed cert, the Ubuntu Desktop username and password will be `ubuntu` and `Nginx123`.
89+
![Guacamole Login](media/guacamole_login.png)
8090

81-
(**NOTE:** This is *not* your UDF login username & password.)
91+
- In the next window click on "OK" and then enter the login password (`Nginx123`) to log into the Jumphost.
8292

83-
![Non F5](media/useruser.png)
93+
![Non F5](media/useruser.png)
8494

85-
-------------
86-
> **If you can't connect to the Ubuntu Desktop, *remember to shut off your VPN*, or join a non-proxied network (sometimes a guest network in the office will work)**
87-
-------------
95+
### OPTION 2: Using **xRDP**
96+
97+
![RDP](media/rdp.png)
98+
99+
THIS OPTION REQUIRES AN RDP CLIENT! If you have a Mac *and* haven't downloaded an RDP client before, here is the first-party version:
100+
101+
[Microsoft's RDP client on the Apple Apps Store](https://apps.apple.com/us/app/microsoft-remote-desktop/id1295203466?mt=12)
102+
103+
- To use your RDP client, select `xRDP` from the ACCESS drop down for the Jumphost. Make sure to select a small enough resolution to see the whole screen.
104+
105+
- Once you select the resolution, your browser will download an rdp file. Open this file to connect to the Jumphost.
106+
107+
- Accept the self-signed cert and then enter the login password (`Nginx123`) to log into the Jumphost.
108+
109+
(**NOTE:** This is *not* your UDF login password.)
110+
111+
![Non F5](media/useruser.png)
112+
113+
> **If you can't connect to the Jumphost, *remember to shut off your VPN*, or join a non-proxied network (sometimes a guest network in the office will work)**
114+
115+
**For machines running Windows and attached to a domain, Windows will helpfully attempt to use your domain creds to log in, and you'll see:**
116+
117+
![Non F5](media/domaincreds.png "everyone has credentials.com email accounts right?")
88118

89-
**For machines running Windows and attached to a domain, Windows will helpfully attempt to use your domain creds to log in, and you'll see:**
119+
**Click "More choices" to enter both a username and a password**
90120

91-
![Non F5](media/domaincreds.png "everyone has credentials.com email accounts right?")
121+
![Non F5](media/domaincredsannotated.png "green arrows")
92122

93-
### Click "More choices" to enter both a username and a password
123+
- Irrespective of which Option you choose to RDP to Jumphost, once logged in you should see an ubuntu desktop as below screenshot.
94124

95-
![Non F5](media/domaincredsannotated.png "green arrows")
125+
![rdp desktop](media/rdp_desktop.png)
96126

97127
That wraps the pre-requisites.
98128

labs/lab3/readme.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -350,12 +350,11 @@ If you would like to just run a few containers without Docker Compose, here are
350350
curl https://docker-registry.nginx.com/v2/nginx/agent/tags/list | jq
351351
```
352352

353-
1. Find all the currently available `NGINX Plus` containers with Agent installed. Curl the `NGINX Private Registry` ( **NOTE:** you will need your `nginx-repo Certificate and Key` files to run this command):
353+
1. Find all the currently available `NGINX Plus` containers with Agent installed. Curl the `NGINX Private Registry` ( **NOTE:** you will use your `nginx-repo.jwt` license file to run this command):
354354

355355
```bash
356-
curl https://private-registry.nginx.com/v2/nginx-plus/agent/tags/list --key nginx-repo.key --cert nginx-repo.crt | jq
356+
curl https://private-registry.nginx.com/v2/nginx-plus/agent/tags/list -u $JWT:none | jq
357357
```
358-
359358
<br/>
360359

361360
This ends Lab3.

labs/lab5/readme.md

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -160,7 +160,7 @@ Don't forget to remove your unused Instances from the NGINX One Console.
160160

161161
## Install NGINX Plus R32 on a VM
162162

163-
Next you will create an NGINX instance that is pinned to version R32 on a virtual machine. This will show you an upgrade from R32 to the new R33 on a VM, a common NGINX upgrade task. From the Jumphost you can use the terminal to SSH to the VM's command line to do an install.
163+
Next you will create an NGINX instance that is pinned to version R32 on a virtual machine. This will show you an upgrade from R32 to the new R33 on a VM, a common NGINX upgrade task. From the Jumphost you can use the terminal to SSH to the VM's command line to do an install.
164164
165165
1. From the VS Studio Terminal window, run the following commands.
166166
@@ -170,9 +170,6 @@ Next you will create an NGINX instance that is pinned to version R32 on a virtua
170170
ssh nplus
171171
cd ~/Documents
172172
173-
sudo mkdir -p /etc/nginx/
174-
sudo cp license/license.jwt /etc/nginx/license.jwt
175-
176173
sudo mkdir -p /etc/ssl/nginx
177174
sudo cp license/nginx-repo.* /etc/ssl/nginx/
178175
```
@@ -461,7 +458,7 @@ Let's take the previous R32 install you just created and upgrade it. This time y
461458
462459
![NGINX Plus](media/lab5-add-license-1.png)
463460
464-
Copy the value from the `~/Downloads/license/license.jwt` and enter it into this file. Click the `Next` button.
461+
Copy the value from the `lab5/license.jwt` and enter it into this file. Click the `Next` button.
465462
466463
>**NOTE:** Make sure you do not add any extra spaces or characters to the license file or it would be considered invalid.
467464

0 commit comments

Comments
 (0)