dist-git/beaker-tests/README.md

How to run tests
================

The following command will setup your system, setup a Fedora virtual machine and run tests from the `./tests/` subdirectory. You need to be root and the command will modify your system, i.e. install some packages, overwrite `/etc/rpkg/*.conf` configs and `/etc/rpkg.conf`, write an entry into `/etc/hosts`, and generates root ssh public key if not generated yet.

```
# ./run.sh
```

The setup part for most of the host system modifications and creation of the virtual machine is done by `./setup.sh` script that is invoked from `run.sh` and is the part that requires root privileges. Use `cat setup.sh` to see what the script does. You can choose not to run the script during `./run.sh` execution if you have run it before (either through `./run.sh` or `./setup.sh` directly). To do this, pass `-x` switch to `./run.sh`:

```
# ./run.sh -x
```

To run the tests for CentOS-7 (with epel-7 repos enabled) instead of Fedora, you can use:

```
# DISTGIT_FLAVOR=dist-git-centos-7 ./run.sh
```

This will spawn a new CentOS-7/epel-7 virtual machine.

To do the same for CentOS-8 (with epel-8 repos enabled), you can use:

```
# DISTGIT_FLAVOR=dist-git-centos-8 ./run.sh
```

Between each run, you need to remove `pkgs.example.org` record from `/root/.ssh/known_hosts` and you should also clean-up `/etc/hosts` from stale `pkgs.example.org` records.

Once the virtual machine you want to test exists and once it is correctly pointed to by `pkgs.example.org` IP record in `/etc/hosts`, you can again run just `./run.sh -x` to skip the `./setup.sh` invocation.

At this point, you can also run just a specific test by switching into `./tests/<testname>` subdirectory and invoking `./run.sh` there. Alternatively, you can pass `-r <testname>` together with `-x` switch to the master `./run.sh` script (the one next to this README):

```
# ./run.sh -x -r fedpkg-test
```

If you want to look inside the created virtual machines, switch to the git top-level directory and run `vagrant ssh <dist-git-flavour>` command there as root, e.g.:

```
# vagrant ssh dist-git
```

to switch to the Fedora virtual machine.

Or

```
# vagrant ssh dist-git-centos-8
```

to switch to CentOS-8/epel-8 virtual machine.

*NOTES:*

If you encounter vagrant error like: `Call to virDomainCreateWithFlags failed: Cannot access storage file '/root/.local/share/libvirt/images/dist-git_dist-git.img' (as uid:107, gid:107): Permission denied`, add the following into `/etc/libvirt/qemu.conf`.

```
user=root
group=root
```