## 1. SSH Setup
-1. (Windows only) Install git for windows [https://git-scm.com/download/win](https://git-scm.com/download/win)
+1. (Windows only) Install Git for Windows [https://git-scm.com/download/win](https://git-scm.com/download/win)
1. Choose "64-bit Git for Windows Setup". It does not require admin privileges to install.
1. Hit "Next" a bunch of times to accept the defaults
- 1. The most important things is that "install git bash" and "install OpenSSH" are enabled.
+ 1. The most important things is that "install git bash" and "install OpenSSH" are enabled (this is the default).
1. At the end of the installation, you can launch tick a box to git bash directly.
1. Open "Git Bash" (installed in the "Git" folder of the start menu)
-1. From an open bash shell
+1. (All operating systems) Starting from bash shell (on MacOS or Linux you will open "Terminal")
1. Shell: Run `ssh-keygen`
1. Hit enter to save to a default location
1. You can choose to protect the key with a password, or just hit enter for no password.
- 1. Shell: Look for a message like `Your public key has been saved in /c/Users/MyUsername/.ssh/id_rsa.pub`
- 1. Shell: Run `cat /c/Users/MyUsername/.ssh/id_rsa.pub`
+ 1. Shell: Look for a message like `Your public key has been saved
+ in /c/Users/MyUsername/.ssh/id_rsa.pub` (Windows git bash
+ example, on MacOS or Linux this will probably start with `/Users` or `/home`)
+ 1. Shell: Run `cat /c/Users/MyUsername/.ssh/id_rsa.pub`
1. Shell: Use the pointer to highlight and copy the lines starting
with `ssh-rsa …` up to the next blank line. Right click and
select "Copy"
1. Select `Register or update CWL workflow on Arvados Workbench`
1. Go to your desktop
1. Right click on the desktop, select `New > Text Document`
- 1. Name the file `message.txt`
+ 1. Name the file `message`
1. Enter a message like "Hello earth" and save
1. Workbench: Go to `+NEW` and select `New project`
1. Enter a name for the project like "Lesson 2"
1. Click on the dot menu
1. Choose `Outputs`
1. Right click on `reverse.txt`
- 1. Click on `Download`
- 1. Open the downloaded file. It should have your results.
+ 1. Click on `Open in new tab`
+ 1. The results should be visible in a new browser tab.
## 5. Register a workflow with default inputs
The default value for the `message` parameter will taken from the `lesson3/defaults.yaml` file
+1. Vscode: Click on the `lesson3/main.cwl` file
+ 1. Click on the `Terminal` menu
+ 1. Click `Run Task…`
+ 1. Select `Register or update CWL workflow on Arvados Workbench`
1. Workbench: Go to `+NEW` and select `New project`
1. Enter a name for the project like "Lesson 3"
1. You should arrive at the panel for the new project
1. The `#main/message` parameter will be pre-filled with your default value. You can choose to change it or use the default.
1. Click `Run process`
1. This should take you to the status page for this workflow
+ 1. The greeting will appear in the `Log` of the `echo` task, which
+ can be found the same way as described earlier in section 3.
## 6. Run a workflow without registering it
1. Vscode: In the bottom panel select the `Terminal` tab
1. In the upper right corner of the Terminal tab select `Task - Run CWL Workflow` from the drop-down
1. Look for logging text like `submitted container_request zzzzz-xvhdp-0123456789abcde`
- 1. Highlight and copy the workflow identifier (this the string containing -xvhdp- in the middle)
+ 1. Highlight and copy the workflow identifier (this the string containing `-xvhdp-` in the middle)
1. The results of this run will appear in the terminal when the run completes.
1. Workbench: Paste the workflow identifier into the search box
1. This will take you to the status page for this workflow