Skip to content

Commit d9cfe45

Browse files
committed
Formatting updates
1 parent b26c330 commit d9cfe45

File tree

1 file changed

+31
-16
lines changed

1 file changed

+31
-16
lines changed

docs/sections/section_1.md

+31-16
Original file line numberDiff line numberDiff line change
@@ -9,15 +9,15 @@ The lab environment runs in the [WWT Programmability Foundations On-Demand Lab](
99

1010
---
1111

12-
### :fontawesome-solid-flask: Lab Requirements
12+
## :fontawesome-solid-atom: Lab Requirements
1313

1414
You only need a few things to start working through the labs:
1515

1616
1. :fontawesome-brands-chrome: A computer with the [Google Chrome](https://www.google.com/chrome/ "Google Chrome Download"){target=_blank} web browser.
1717

1818
- We test access to the lab environment with Chrome, and you may experience issues with other web browsers.
1919

20-
2. :material-earth-plus: An account on [wwt.com](https://www.wwt.com/login "World Wide Technology Digital Platform Login"){target=_blank}.
20+
2. :fontawesome-solid-user-circle: An account on [wwt.com](https://www.wwt.com/login "World Wide Technology Digital Platform Login"){target=_blank}.
2121

2222
---
2323

@@ -28,7 +28,7 @@ The lab setup process is mostly automated although you will have to manually:
2828
1. :fontawesome-solid-laptop-code: launch a lab environment instance.
2929
2. :material-powershell: Use a command to initiate the automated lab build.
3030

31-
???+ abstract "Auto-provision the environment in the WWT Programmability Foundations Lab"
31+
???+ abstract "Auto-provision the hands-on environment in the WWT Programmability Foundations Lab"
3232

3333
???+ todo "Step 1"
3434

@@ -75,24 +75,33 @@ The lab setup process is mostly automated although you will have to manually:
7575
???+ danger "Important"
7676
Occasionally, the Docker Desktop service does not start on its own. Windows may ask you if you want to start the Docker service and then request permission for Net Command​ to run. You may safely confirm both actions.
7777

78-
[![13_start_docker](../images/pf_lab/13_start_docker.png "Manually Start the Docker for Windows Service")](../images/pf_lab/13_start_docker.png){target=_blank}
78+
<p align="center">
79+
[![13_start_docker](../images/pf_lab/13_start_docker.png "Manually Start the Docker for Windows Service")](../images/pf_lab/13_start_docker.png){target=_blank}
80+
</p>
7981

80-
[![14_start_docker_uac](../images/pf_lab/14_start_docker_uac.png "Allow Net Command to Run")](../images/pf_lab/14_start_docker_uac.png){target=_blank}
82+
---
83+
84+
<p align="center">
85+
[![14_start_docker_uac](../images/pf_lab/14_start_docker_uac.png "Allow Net Command to Run")](../images/pf_lab/14_start_docker_uac.png){target=_blank}
86+
</p>
8187

8288
??? todo "Step 7"
8389

84-
A PowerShell script will customize the lab environment automatically although and you need to paste a long command into a PowerShell window to start that process:
90+
A PowerShell script will automatically customize the lab environment, but you need to paste a long command into a PowerShell window to start that process.:
91+
92+
!!! tip "Details"
93+
1. Copy this entire command to your clipboard:
94+
95+
- :fontawesome-solid-exclamation-circle: Tip: move your mouse cursor over the command text and click the :material-content-copy: icon at the far right-hand side of the command block.
96+
97+
```powershell
98+
Set-Executionpolicy -Scope CurrentUser -ExecutionPolicy UnRestricted -Force; Set-Location \Users\admin; Invoke-WebRequest -Uri 'https://devasc-netconf.s3-us-west-2.amazonaws.com/setup_lab.ps1' -OutFile 'setup_lab.ps1’; .\setup_lab.ps1
99+
```
85100

86-
!!! tip
87-
1. Click the PowerShell icon in the taskbar to open a new PowerShell window.
88-
2. Then, copy the entire command below to your clipboard.
101+
2. On the Windows desktop, click the PowerShell icon in the taskbar to open a new PowerShell window.
89102
3. Right-click in the PowerShell window to paste the command
90103
4. Press your ++enter++ or ++"Return"++ key to run the command.
91104

92-
```powershell
93-
Set-Executionpolicy -Scope CurrentUser -ExecutionPolicy UnRestricted -Force; Set-Location \Users\admin; Invoke-WebRequest -Uri 'https://devasc-netconf.s3-us-west-2.amazonaws.com/setup_lab.ps1' -OutFile 'setup_lab.ps1’; .\setup_lab.ps1
94-
```
95-
96105
[![7_paste_ps_commands](../images/pf_lab/7_paste_ps_commands.png "Copy, Paste, & Run the Commands into a PowerShell Window")](../images/pf_lab/7_paste_ps_commands.png){target=_blank}
97106

98107
??? error "What to do if you see a 'Docker Desktop process is not running' error message:"
@@ -126,6 +135,12 @@ The lab setup process is mostly automated although you will have to manually:
126135

127136
Within a few minutes, when the lab is ready to use, a Chrome browser will open a **JupyterLab URL**. Open the **devasc-netconf-intro** folder from the navigation pane:
128137

138+
!!! attention
139+
A few minutes after the JupyterLab browser window opens, a second Chrome tab will open for YANG Suite.
140+
141+
- Switch back to the JupyterLab tab when this happens.
142+
- The instructions in the JupyterLab Notebook will show you how to use YANG Suite.
143+
129144
[![9_jupyter_nav_1](../images/pf_lab/9_jupyter_nav_1.png "Open the 'devasc-netconf-intro' folder")](../images/pf_lab/9_jupyter_nav_1.png){target=_blank}
130145

131146
??? todo "Step 10"
@@ -136,17 +151,17 @@ The lab setup process is mostly automated although you will have to manually:
136151

137152
??? todo "Step 11"
138153

139-
Open the file **python.ipynb** and follow the step-by-step instructions in the main pane:
154+
Open the file **ncclient_with_output.ipynb** and follow the step-by-step instructions in the main pane:
140155

141-
[![11_jupyter_nav_3](../images/pf_lab/11_jupyter_nav_3.png "Open the file 'python.ipynb'")](../images/pf_lab/11_jupyter_nav_3.png){target=_blank}
156+
[![11_jupyter_nav_3](../images/pf_lab/11_jupyter_nav_3.png "Open the file 'ncclient_with_output.ipynb'")](../images/pf_lab/11_jupyter_nav_3.png){target=_blank}
142157

143158
??? help "Lab Restart Instructions"
144159

145160
The lab setup process creates two shortcuts on the Windows desktop, which will help you restore the lab environment in the event the JupyterLab or YANG Suite browser tabs close, Windows restarts, etc.
146161

147162
!!! attention "Notice"
148163

149-
- The **Restart Lab** and **YANG Suite** shortcuts re-launch JupyterLab or YANG Suite, respectively (including the Chrome browser tabs), within a few seconds.
164+
- The **Restart Lab** and **YANG Suite** shortcuts re-launch JupyterLab or YANG Suite, respectively (including the Chrome browser tabs), within a few seconds; much sooner than during the initial lab setup.
150165
- Double-clicking these shortcuts will **NOT** cause you to lose any of your lab progress.
151166

152167
[![12_lab_restart](../images/pf_lab/12_lab_restart.png "Use the Lab Restart and YANG Suite Shortcuts")](../images/pf_lab/12_lab_restart.png){target=_blank}

0 commit comments

Comments
 (0)