installtest

Documentation

Overview

Package installtest contains e2e tests for the Windows agent installer

Index

• func AssertAgentUserGroupMembership(t *testing.T, host *components.RemoteHost, username string) bool
• func AssertDoesNotRemoveSystemFiles(t *testing.T, host *components.RemoteHost, ...)
• func AssertGroupMembership(t *testing.T, host *components.RemoteHost, user string, ...) bool
• func AssertInstalledUserInRegistry(t *testing.T, host *components.RemoteHost, expecteddomain string, ...) bool
• func AssertUserRights(t *testing.T, host *components.RemoteHost, username string) bool
• func ExpectPython2Installed(majorVersion string) bool
• func RequireAgentRunningWithNoErrors(t *testing.T, client *common.TestClient)
• func SystemPaths() []string
• type Tester
  • func NewTester(tt *testing.T, host *components.RemoteHost, opts ...TesterOption) (*Tester, error)
  • func (t *Tester) ExpectAPM() bool
  • func (t *Tester) ExpectCWS() bool
  • func (t *Tester) ExpectPython2Installed() bool
  • func (t *Tester) TestInstallExpectations(tt *testing.T) bool
  • func (t *Tester) TestUninstallExpectations(tt *testing.T)
• type TesterOption
  • func WithAgentPackage(agentPackage *windowsAgent.Package) TesterOption
  • func WithExpectedAgentUser(domain string, user string) TesterOption
  • func WithExpectedConfigRoot(path string) TesterOption
  • func WithExpectedInstallPath(path string) TesterOption
  • func WithPreviousVersion() TesterOption

Functions

func AssertAgentUserGroupMembership

func AssertAgentUserGroupMembership(t *testing.T, host *components.RemoteHost, username string) bool

AssertAgentUserGroupMembership checks the agent user is a member of the expected groups

func AssertDoesNotRemoveSystemFiles

func AssertDoesNotRemoveSystemFiles(t *testing.T, host *components.RemoteHost, beforeInstall *windowsCommon.FileSystemSnapshot)

AssertDoesNotRemoveSystemFiles checks that the paths in the snapshot still exist

func AssertGroupMembership

func AssertGroupMembership(t *testing.T, host *components.RemoteHost, user string, expectedGroups []string) bool

AssertGroupMembership asserts that the user is a member of the expected groups

func AssertInstalledUserInRegistry

func AssertInstalledUserInRegistry(t *testing.T, host *components.RemoteHost, expecteddomain string, expectedusername string) bool

AssertInstalledUserInRegistry checks the registry for the installed user and domain

func AssertUserRights

func AssertUserRights(t *testing.T, host *components.RemoteHost, username string) bool

AssertUserRights checks the user has the expected user rights

func ExpectPython2Installed

func ExpectPython2Installed(majorVersion string) bool

ExpectPython2Installed returns true if the provided agent major version is expected to contain an embedded Python2.

func RequireAgentRunningWithNoErrors

func RequireAgentRunningWithNoErrors(t *testing.T, client *common.TestClient)

RequireAgentRunningWithNoErrors checks the agent is running with no errors

func SystemPaths

func SystemPaths() []string

SystemPaths returns a list of paths that are known to frequently change and should be ignored when collecting the list of files

Types

type Tester

type Tester struct {
	InstallTestClient *common.TestClient
	// contains filtered or unexported fields
}

Tester is a test helper for testing agent installations

func NewTester

func NewTester(tt *testing.T, host *components.RemoteHost, opts ...TesterOption) (*Tester, error)

NewTester creates a new Tester

func (*Tester) ExpectAPM

func (t *Tester) ExpectAPM() bool

ExpectAPM returns true if the agent is expected to install APM

func (*Tester) ExpectCWS

func (t *Tester) ExpectCWS() bool

ExpectCWS returns true if the agent is expected to install CWS

func (*Tester) ExpectPython2Installed

func (t *Tester) ExpectPython2Installed() bool

ExpectPython2Installed returns true if the agent is expected to install Python2

func (*Tester) TestInstallExpectations

func (t *Tester) TestInstallExpectations(tt *testing.T) bool

TestInstallExpectations tests the current agent installation meets the expectations provided to the Tester

func (*Tester) TestUninstallExpectations

func (t *Tester) TestUninstallExpectations(tt *testing.T)

TestUninstallExpectations verifies the agent uninstalled correctly.

type TesterOption

type TesterOption func(*Tester)

TesterOption is a function that can be used to configure a Tester

func WithAgentPackage

func WithAgentPackage(agentPackage *windowsAgent.Package) TesterOption

WithAgentPackage sets the agent package to be installed

func WithExpectedAgentUser

func WithExpectedAgentUser(domain string, user string) TesterOption

WithExpectedAgentUser sets the expected user the agent should run as

func WithExpectedConfigRoot

func WithExpectedConfigRoot(path string) TesterOption

WithExpectedConfigRoot sets the expected config root for the agent

func WithExpectedInstallPath

func WithExpectedInstallPath(path string) TesterOption

WithExpectedInstallPath sets the expected install path for the agent

func WithPreviousVersion

func WithPreviousVersion() TesterOption

WithPreviousVersion sets the Tester to expect a previous version of the agent to be installed and will not run all tests since expectations may have changed.