NAME

Tapper::MCP::Net

start_simnow

Start a simnow installation on given host. Installer is supposed to start the simnow controller in turn.

@param string - hostname

@return success - 0 @return error - error string

start_ssh

Start a ssh testrun on given host. This starts both the Installer and PRC.

@param string - hostname

@return success - 0 @return error - error string

start_local

Start a testrun locally. This starts both the Installer and PRC.

@param string - path to config

@return success - 0 @return error - error string

wait_for_minion_job

Wait until a Minion job reaches its 'finished' state.

@param string - path to config

@return success - 0 @return error - error string

start_minion

Start a testrun via a Minion job. This just enqueues into a queue named like the current TAPPER_HOSTNAME and assumes a Minion worker is picking it up as soon as possible so all the timeout assumptions are very similar to local execution, just with the difference of a job queue between it to decouple the load between different Tapper client hosts.

The config file is read into the corresponding data structure and provided to the Minion as option hash. The Minion worker writes that hash into a local temp file again and starts the PRC with that temp file, very similar as start_local() does, just not on server but on client side.

@param string - path to config

@return success - 0 @return error - error string

stop_minion

Stop a testrun's corresponding Minion job.

This finds the queue named like the current TAPPER_HOSTNAME, queries it for the current job, gets that jobs config, checks if it is for the current testun and broadcast a 'stop' command to Minion.

The PRC Minion worker that gets the signal command does the actual remote process cleanup.

@param string - path to config

@return success - 0 @return error - error string

install_client_package

Install client package of given architecture on given host at optional given possition.

@param string - hostname @param hash ref - contains arch and dest_path

@return success - 0 @return error - error string

write_grub_file

Write the given text to the grub file for the system given as parameter.

@param string - name of the system @param string - text to put into grub file

@return success - 0 @return error - error string

hw_report_create

Create a report containing the test machines hw config as set in the hardware db. Leave the sending to caller

@param int - testrun id

@return success - (0, hw_report) @return error - (1, error string)

AUTHORS

  • AMD OSRC Tapper Team <tapper@amd64.org>

  • Tapper Team <tapper-ops@amazon.com>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2024 by Advanced Micro Devices, Inc.

This is free software, licensed under:

The (two-clause) FreeBSD License