VMCatcher Site Setup

Setup your site for VMCatcher subscription to a VO-wide image list

Tip: For the following steps, please update your vmcatcher installation to >= 0.5.1-1

Install VMCatcher command line tool, see how-to details here
Request access to the VO-wide image lists area, as described here
Locate the VO-wide image list(s) of the VO(s) you wish to support. The quickest way to to find the available VO-wide image lists is through the VO section of the AppDB Image List Store

In principal, a VO-wide image list URL follows the following format:
```
https://vmcaster.appdb.egi.eu/store/vo/<VO_NAME>/image.list
```
Subscribe to the VO-wide image list(s) using your Personal Access Token obtained by step 2. More details on how to create a Personal Access Token can be found here

A subscription example for the fedcloud.egi.eu VO:
```
$ vmcatcher_subscribe -e -s \ 
        https://xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx:x-oauth-basic@vmcaster.appdb.egi.eu/store/vo/fedcloud.egi.eu/image.list 
```
where xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx is your Personal Access token
Flag the subscription in order to automatically accept and subscribe new image that will become part of the aforementioned image list

Example for the fedcloud.egi.eu VO:
```
$ vmcatcher_subscribe -r https://vmcaster.appdb.egi.eu/store/vo/fedcloud.egi.eu/image.list --imagelist-newimage-subscribe
```
Note: no Personal Access token needed
Make an update
```
$ vmcatcher_subscribe -U
```
Download and cache the images
```
$ vmcatcher_cache
```

Tip: Steps 6. and 7. could be part of a cron job in order to automatically download the updates or new image insertions from the image list that you have been subscribed.