Login

Etch Demo

The instructions should help you get a demo of etch up and running on a single host as quickly as possible. If you'd like to set up a more complete etch environment see our QuickStart Guide.

1. Prepare Perl on your system. See this page.
2. Make a directory named /var/etch/.
3. Download the etch distribution from the download page.
4. Unpack the distribution and copy the configs directory into /var/etch. You won't need the other directories in the distribution for this simple setup.
5. Move /var/etch/configs/source-demo to /var/etch/configs/source
6. Edit /var/etch/configs/hosts.xml and create an entry for your host. The name field must exactly match the output of the hostname command on your system. For now an empty entry (no group or hardware tags) will suffice.
7. Run /var/etch/configs/etch without any options. It should print a help message.
8. Run /var/etch/configs/etch --dry-run --generate to do a dry run of the demo configuration files.
9. Edit the demo config files to test out etch's features, or consult the source-samples directory for an extensive selection of sample configurations. See the Manual for details on creating etch configurations.
10. See the QuickStart Guide for info about how to proceed further.