Install the pre-release package(s) as normal.
-Add the following three lines to your HTCondor configuration:
+Add the following lines to your HTCondor configuration (maybe in =config.d/80annexd=). If you don't want your instances to show up in us-east-1 by default, edit the URLs in the last three lines appopriately.
{verbatim}
# Turn the annex daemon on.
@@ -24,7 +24,7 @@
The examples directory includes a CloudWatch template [FIXME] (the file =template-3.json=) you can use to create the necessary AWS Lambda function (and grant it the permissions necessary for it do its job). After logging into the AWS web console, do the following for each region you intend to use:
-1: Switch to the region. (Use the second drop-down box in from the upper right.)
+1: Switch to the region. (The second drop-down box in from the upper right.)
1: Switch to CloudFormation. (In the _Services_ menu, under _Management_.)
1: Click the "Create Stack" button.
1: Upload the template using the "Browse..." button
@@ -36,3 +36,20 @@
1: Copy the long string labelled "LeaseFunctionARN"; you'll need it to for each invocation of _condor_annex_. It may take some time for that string to appear (you may need to reload, as well.) Wait the stack to enter the 'CREATE_COMPLETE' state before using the LeaseFunctionARN (see below).
{section: usage}
+
+In this prototype, the =condor_annex= tool requires a JSON file describing the kind of instances you'd like. The easiest way to generate this JSON file is using the AWS web console; when you request a Spot Fleet, on the last page before you submit the request, there's a button in the upper-right labelled "JSON config"; click it to download a file. Save the file (the default name is =config.json=, which is fine).
+
+After you save the config, open it in your favorite text editor and remove the two lines containing "ValidFrom" and "ValidUntil". (FIXME: If =condor_annex= were to just ignore these entries, would it need to support additional CLI flags to set them?)
+
+Now you're ready to run =condor_annex=. If you've been using the example's filenames, the command will look something like the following.
+
+{verbatim}
+condor_annex \
+ # FIXME: should eiter be -access/-secret or -public/-private.
+ -public <public (access) key file> -secret <secret (private) access key file> \
+ -lease-duration <seconds> \
+ # FIXME: Leaving this out entirely doesn't produce a reasonable error message.
+ # FIXME: The daemon crashes on restart after the above failure.
+ -lease-function-arn <LeaseFunctionARN string> \
+ config.json
+{endverbatim}
