= Perforce Helix Server Deployment Package (for UNIX/Linux)
Perforce Professional Services <consulting@perforce.com>
:revnumber: v2024.1
:revdate: 2024-06-13
:doctype: book
:icons: font
:toc:
:toclevels: 5
:sectnumlevels: 4
:xrefstyle: full
// Attribute for ifdef usage
:unix_doc: true

== Preface

Welcome to the Helix Installer Test Suite.

*Please Give Us Feedback*

Perforce welcomes feedback from our users. Please send any suggestions for improving this document or the SDP to consulting@perforce.com.

:sectnums:

== Overview

The `hits.sh` script is used to build test machine images on various operating systems, execute tests, and capture and summarize the results.

.Overview of the Helix Installer Test Suite `hits.sh` script:
----
include::../doc/hits.command_summary.txt[]
----

== Interacting with the Test Suite

Interact with a command like this sample:

  podman run --rm -v /Users/ttyler/pub/hi/dev/hi:/hi -e OS=rocky9 -e SDP_BRANCH=main -it perforce_hi/rocky9-hi /bin/bash

== Requirements and One-Time Setup

The `podman` utility must be installed. Testing has been done with podman v5.0.3. Other versions may work.

[appendix]
== Test Suite History

The third and current generation of the Helix Installer Test Suite came online in June, 2024. This replaced Docker with Podman.

The second generation of the Helix Installer Test Suite came online in January, 2021. This used Docker for VM management.

Docker displaced Vagrant-based VM management that had been used in first generation of the test suite from November, 2018 to January, 2021.