@@ -33,22 +33,26 @@ to delete the `qsim` directory with `rm -rf qsim` and rerun the clone command.
3333### Change directory
3434
3535Change directory to the tutorial:
36+
3637``` bash
3738cd qsim/docs/tutorials/multinode/terraform
3839```
40+
3941This is where you will use ` terraform ` to create the HTCondor cluster required to run your jobs.
4042
4143### Edit ` init.sh ` file to match your environment
4244
4345Using your favorite text file editor, open the ` init.sh ` file. The first few
4446lines should look like this:
47+
4548``` bash
4649# ---- Edit below -----#
4750
4851export TF_VAR_project=[USER_PROJECT]
4952export TF_VAR_zone=us-east4-c
5053export TF_VAR_region=us-east4
5154```
55+
5256Replace ` [USER_PROJECT] ` with the project name you chose on the
5357` Before you begin ` page.
5458
@@ -63,9 +67,11 @@ your project will create new jobs.
6367### Source the ` init.sh ` file
6468
6569The edited ` init.sh ` file should be "sourced" in the cloud shell:
70+
6671``` bash
6772source init.sh
6873```
74+
6975Respond ` Agree ` to any pop-ups that request permissions on the Google Cloud platform.
7076
7177The final outcome of this script will include:
@@ -94,10 +100,13 @@ Terraform has been successfully initialized!
94100
95101For convenience, some terraform commands are prepared in a ` Makefile ` . This
96102means you can now create your cluster, with a simple ` make ` command.
103+
97104``` bash
98105make apply
99106```
107+
100108A successful run will show:
109+
101110```
102111Apply complete! Resources: 4 added, 0 changed, 0 destroyed.
103112```
@@ -111,10 +120,13 @@ commands to submit and monitor jobs on HTCondor.
111120### List VMs that were created by HTCondor
112121
113122To see the VMs created by HTCondor, run:
123+
114124``` bash
115125gcloud compute instances list
116126```
127+
117128At this point in the tutorial, you will see two instances listed:
129+
118130```
119131NAME: c-manager
120132ZONE: us-central1-a
@@ -145,14 +157,17 @@ complete.
145157
146158This new window is logged into your HTCondor cluster. You will see a command
147159prompt that looks something like this:
160+
148161``` bash
149162[mylogin@c-submit ~ ]$
150163```
164+
151165The following steps should be performed in this window.
152166
153167### Checking the status
154168
155169You can run ` condor_q ` to verify if the HTCondor install is completed. The output should look something like this:
170+
156171```
157172-- Schedd: c-submit.c.quantum-htcondor-14.internal : <10.150.0.2:9618?... @ 08/18/21 18:37:50
158173OWNER BATCH_NAME SUBMITTED DONE RUN IDLE HOLD TOTAL JOB_IDS
@@ -161,6 +176,7 @@ Total for query: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 su
161176Total for drj: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
162177Total for all users: 0 jobs; 0 completed, 0 removed, 0 idle, 0 running, 0 held, 0 suspended
163178```
179+
164180If you get ` command not found ` , you will need to wait a few minutes for the HTCondor install to complete.
165181
166182## 4. Get the sample code and run it
@@ -172,10 +188,13 @@ sample jobs have been provided in the Github repo.
172188
173189On the submit node, you can clone the repo to get access to previously
174190created submission files:
191+
175192``` bash
176193git clone https://github.com/quantumlib/qsim.git
177194```
195+
178196Then cd to the tutorial directory.
197+
179198``` bash
180199cd qsim/docs/tutorials/multinode
181200```
0 commit comments