{section: Assumptions}

We assume you already have an AWS account.

{section: Installation and Configuration}

Martin Kandes wrote excellent instructions on installing and configuring =condor_annex=: http://www.t2.ucsd.edu/twiki2/bin/view/UCSDTier2/Condor_annex.

First-time users should:
*: Follow steps 1-3 as written
*: Skip step 4, and just use the 'us-east-1' region.
*: Follow steps 5&6 as written
*: Skip step 7, and just use the [FIXME] AMI
*: Follow steps 8-9
*: Instead of step 10, please obtain the most recent version of =condor_annex= from [FIXME]

Everyone should then follow the instructions below ("set the default launch configurations").

{subsection: Set the default launch configurations.}

1: Go to your list of Auto Scaling group launch configurations: https://console.aws.amazon.com/ec2/autoscaling/home?region=us-east-1#LaunchConfigurations:
1: If you don't have any Auto Scaling groups, you'll have to (temporarily) create one in order to create a Launch Configuration; click the *Create Auto Scaling group* button.
1: Click the *Create launch configuration* button in the lower-right.
1: Select "Community AMIs" from the tabs on the left.  Enter "FIXME" and hit the *Select* button to choose the default AMI.
1: Select an instance type from the list.  If you just created a new account, the "t2.micro" type may be free.  Otherwise, "m3.large" is a nice, simple choice.
1: Click the *Configure details* button.
1: For HTCondor to find this launch configuration, it _must_ be named "HTCondorAnnex1".
1: If you're not able to use AWS' free tier, the cheapest way to experiment is the Spot instances; see FIXME for details.  The simplest way (because you instances won't vanish unexpectedly) is without Spot instances.
1: Click the the _5. Configure Security Group_ link at the top.
1: Click "Select an *existing* security group" and make sure the default security group (or the security you created) is selected.
1: Hit the *Review* button.
1: Hit the *Create launch configuration* button.
1: Select the EC2 keypair you created in step 5 of Martin Kandes' instructions.
1: Click the acknowledgement and the *Create launch configuration* button.
1: Now hit the "Cancel" link at the bottom -- =condor_annex= will create the autoscaling group(s) you need for you.

You only need one launch configuration to get started, but if you want to another instance types later, just change the name to "HTCondorAnnex2".  =condor_annex= will recognize and use up to "HTCondorAnnex8".

{section: Start an Annex}

The minimal set of options to start an annex follows:

{term}
$ condor_annex --project-id MyFirstAnnex --instances 3 --expiry "2017-01-20 17:18:19"
{endterm}

_[The collector address and the password file path are both extracted from the command environment's HTCondor configuration.  The password file is uploaded to a private S3 bucket managed by condor_annex; the location is passed into the custom AMI via the usual instance contextualization methods.]_

This command will return after HTCondor has set up the lease and requested that Amazon start 3 instances of the type(s) you specified.

_[The tool allows you to create a set of default launch configurations, so you don't have to type them in every time, but specifying an example type on the command-line is a much faster way to get started.]_

It will take a few minutes for the annex's slots to show up, but they will be assigned in the next negotiation cycle (which may also take a few minutes), and your jobs will start running shortly after that.

{section: Monitor your Annex}

The following command line will print out the usual =condor_status= information for the annex you specify:

{term}
$ condor_status -annex MyFirstAnnex
ip-172-31-48-84.ec2.internal  LINUX      X86_64 Claimed   Busy      0.640 3767
ip-172-31-54-121.ec2.internal LINUX      X86_64 Claimed   Busy      0.880 3767
ip-172-31-56-45.ec2.internal  LINUX      X86_64 Claimed   Busy      0.600 3767

              Total Owner Claimed Unclaimed Matched Preempting Backfill  Drain
 X86_64/LINUX    11     0      11         0       0          0        0      0
        Total    11     0      11         0       0          0        0      0
{endterm}

<html><i>[This is entirely equivalent to </i><tt>condor_status -const 'AnnexName =?= MyFirstAnnex'</tt><i> so it should be easy to implement.]</i></html>

In this case, all three of the slots you requested have already started to run jobs.

{section: Stop an Annex}

If you're already familiar with the =condor_off= command, you can use it to turn off HTCondor on the annex nodes; the default image is configured so that this will also shut down the machine.  To shut down each machine in an annex, use the following command-line:

{term}
$ condor_off -annex MyFirstAnnex
{endterm}

<html><i>[This is entirely equivalent to </i><tt>condor_off -const 'AnnexName =?= MyFirstAnnex'</tt><i> so it should be easy to implement.]</i></html>