{section: description}

The annex daemon will be the production implementation of the _condor_annex_ tool.  (See ExperimentalCondorAnnex.)  At present, it provides only the ability to provision leased AWS instances efficiently (in bulk).

The lease implementation requires an AWS Lambda function; rather than upload it every time, for efficiency the annex daemon must be provided the function's ARN.  This may be automated in the future; see the installation instructions, below, for the manual process.

{section: installation}

Install the pre-release package(s) as normal.

Add the following three lines to your HTCondor configuration:

{verbatim}
# Turn the annex daemon on.
DAEMON_LIST = $(DAEMON_LIST) ANNEXD

# Optional: configure the default endpoints.  All three endpoints need to be the same region.
ANNEX_DEFAULT_EC2_URL = https://ec2.us-east-1.amazonaws.com
ANNEX_DEFAULT_CWE_URL = https://events.us-east-1.amazonaws.com
ANNEX_DEFAULT_LAMBDA_URL = https://lambda.us-east-1.amazonaws.com
{endverbatim}

{subsection: Lambda function}

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 CloudFormation.  (In the _Services_ menu, under _Management_.)
1: Click the "Create Stack" button.
1: Upload the template using the "Browse..." button
1: Click the "Next" button.
1: Name the stack; "HTCondorLeaseImplementation" is a good name.
1: Click the "Next" button.  (You don't to change anything on the options screen.)
1: Check the box next to "I acknowledge" (down near the bottom) and click the "Create" button (where the "Next" button was).
1: AWS should return the list of stacks; select the one you just created and select the "outputs" tab.
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}