packer-plugin-xenserver/examples/README.md

## Examples

In order for new users to get up and running with the packer builder, a few examples of building a machine image with popular distros have been created.

In order to see an exhaustive list of configuration options for the packer builder please see the [following documentation](../docs/builders/xenserver-iso.html.markdown). This doc will focus on the details relevant to the particular distro.

### Running the examples

In order to run the examples you will need to perform the following steps:
1. Export those vars:
```
PKR_VAR_remote_host
PKR_VAR_remote_password
PKR_VAR_remote_username
PKR_VAR_sr_name
PKR_VAR_sr_iso_name
``` 
`PKR_VAR_remote_host` must be the resource pool primary, aka the master.

2. Run `packer init path/to/defenition.pkr.hcl` to download the xenserver plugin

2. Run `packer build  path/to/defenition.pkr.hcl`   
so for example:
`packer build  examples/centos/centos8-netinstall.pkr.hcl`

### Ubuntu

The Ubuntu example uses the [autoinstall tool](https://ubuntu.com/server/docs/install/autoinstallhttps://ubuntu.com/server/docs/install/autoinstall) to configure the VM template. Please see the [autoinstall docs](https://ubuntu.com/server/docs/install/autoinstall-reference) for an exhaustive list of what is supported.

Packer will create a http server to serve the files as specified from the `http_directory` specified in the builder configuration. This is where the [user-data](http/ubuntu-2004/user-data) and [meta-data](http/ubuntu-2004/meta-data) for autoinstall must be present.

### Centos

The Centos examples use kickstart files to configure the VM template. Please see the [kickstart documentation](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/installation_guide/sect-kickstart-syntax) for the options that are supported.

Packer will create a http server to serve the files as specified from the `http_directory` specified in the builder configuration. This is where the [kickstart config](http/centos8/ks-centos8.cfg) file must be present.
Update documentation with changes from upstream, fix shutdown command for examples 2021-01-03 01:52:00 -06:00			`## Examples`

updated examples/README.md to refekt current state 2021-02-02 06:33:48 -06:00			`In order for new users to get up and running with the packer builder, a few examples of building a machine image with popular distros have been created.`
Update documentation with changes from upstream, fix shutdown command for examples 2021-01-03 01:52:00 -06:00
Fixing more links 2021-01-03 01:58:22 -06:00			`In order to see an exhaustive list of configuration options for the packer builder please see the [following documentation](../docs/builders/xenserver-iso.html.markdown). This doc will focus on the details relevant to the particular distro.`
Update documentation with changes from upstream, fix shutdown command for examples 2021-01-03 01:52:00 -06:00
			`### Running the examples`

updated the example readme 2021-04-14 04:30:25 -05:00			`In order to run the examples you will need to perform the following steps:`
Revert "Update the ubuntu example to be resilient to ISO releases" 2023-02-26 23:09:29 -06:00			`1. Export those vars:`
Update documentation with changes from upstream, fix shutdown command for examples 2021-01-03 01:52:00 -06:00			```
updated examples/README.md to refekt current state 2021-02-02 06:33:48 -06:00			`PKR_VAR_remote_host`
			`PKR_VAR_remote_password`
			`PKR_VAR_remote_username`
			`PKR_VAR_sr_name`
			`PKR_VAR_sr_iso_name`
			```
updated the example readme 2021-04-14 04:30:25 -05:00			`PKR_VAR_remote_host` must be the resource pool primary, aka the master.
updated examples/README.md to refekt current state 2021-02-02 06:33:48 -06:00
Revert "Update the ubuntu example to be resilient to ISO releases" 2023-02-26 23:09:29 -06:00			2. Run `packer init path/to/defenition.pkr.hcl` to download the xenserver plugin
updated examples/README.md to refekt current state 2021-02-02 06:33:48 -06:00
Revert "Update the ubuntu example to be resilient to ISO releases" 2023-02-26 23:09:29 -06:00			2. Run `packer build path/to/defenition.pkr.hcl`
updated examples/README.md to refekt current state 2021-02-02 06:33:48 -06:00			`so for example:`
			`packer build examples/centos/centos8-netinstall.pkr.hcl`
Update documentation with changes from upstream, fix shutdown command for examples 2021-01-03 01:52:00 -06:00
			`### Ubuntu`

			`The Ubuntu example uses the [autoinstall tool](https://ubuntu.com/server/docs/install/autoinstallhttps://ubuntu.com/server/docs/install/autoinstall) to configure the VM template. Please see the [autoinstall docs](https://ubuntu.com/server/docs/install/autoinstall-reference) for an exhaustive list of what is supported.`

Fixing more links 2021-01-03 01:58:22 -06:00			Packer will create a http server to serve the files as specified from the `http_directory` specified in the builder configuration. This is where the [user-data](http/ubuntu-2004/user-data) and [meta-data](http/ubuntu-2004/meta-data) for autoinstall must be present.
Update documentation with changes from upstream, fix shutdown command for examples 2021-01-03 01:52:00 -06:00
			`### Centos`

updated examples/README.md to refekt current state 2021-02-02 06:33:48 -06:00			`The Centos examples use kickstart files to configure the VM template. Please see the [kickstart documentation](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/installation_guide/sect-kickstart-syntax) for the options that are supported.`
Update documentation with changes from upstream, fix shutdown command for examples 2021-01-03 01:52:00 -06:00
Fixing more links 2021-01-03 01:58:22 -06:00			Packer will create a http server to serve the files as specified from the `http_directory` specified in the builder configuration. This is where the [kickstart config](http/centos8/ks-centos8.cfg) file must be present.