Repository files navigation

Twopence is a test executor

• it can run tests in a KVM virtual machine without using the network
• it can also run more traditional SSH tests in a remote machine
• it can send the tests through a serial cable too

• Twopence is basically a set of libraries
• Shell, Ruby and Python wrappers are provided for convenience
• each library is seen as a plugin
• currently available plugins are virtio (KVM), SSH, serial, and TCP

Have a look at the examples:

• from the shell
• from Ruby
• from Python

• the test server runs on the system under test as root, performs no authentication,and will execute whatever command it is asked to
• the SSH tests assume that you have published a public keywith a private key without passphrase
• in short, Twopence is very unsafe and should be reserved topure test environments (test labs, no production servers)

# Gemsgem install rake-compiler# openSUSE Leap/Tumbleweed and SLEzypper install gcc libssh-devel ruby-devel python-devel# Ubuntuapt-get install gcc libssh-dev ruby-dev rake-compiler python-dev# Fedoradnf install gcc libssh-devel ruby-devel rubygem-rake-compiler python-devel redhat-rpm-config# macOS (tested on Sonoma)# install the Xcode command line toolsxcode-select --install# Install Homebrew (https://brew.sh)/bin/bash -c"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"brew install libsshsudo ln -s /opt/homebrew/Cellar/libssh/<your_version>/include/libssh /Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/include/libsshbrew install pyenvpyenv install 2.7ln -s$HOME/.pyenv/versions/2.7.18/include/python2.7$HOME/.pyenv/versions/2.7.18/include/Python

# as normal user executemake# as root executemake installldconfig

• on the system under test, make sure the sshd daemon is started:

service sshd start

and that it is not being blocked by the firewall

• on the testing system, create a pair of SSH keys:

ssh-keygen -t rsa

without setting a passphrase

• copy the public key to the system under test:

scp~/.ssh/id_rsa.pub joe@sut.example.com:.

• then, on the system under test, append the public key to theauthorized keys file:

cat id_rsa.pub>>~/.ssh/authorized keys

• repeat for each account that will be used to run the tests
• in the directory/usr/local/lib/twopence/adapt the first lines oftest.rb andtest.sh to the IP addressor hostname of your system under test
• run the following commands:

cd examples/usr/local/lib/twopence/test.shruby /usr/local/lib/twopence/test.rb

• setup a KVM virtual machine
• declare a UNIX domain socket
• to do that, you can use virt-manager:Hardware => Channel =>Path = the directory and name of your socket fileTarget type = virtioTarget name = org.opensuse.twopence.0
• or you can use the provided script:

/usr/local/lib/twopence/add_virtio_channel.sh mydomain

• start the VM
• copy the test server into the VM:

scp /usr/local/lib/twopence/twopence_test_server root@sut.example.com:.

instead of scp, you may use shared folders or whichever method you prefer

• inside of the VM, run the server as root:

./twopence_test_server

• in the directory/usr/local/lib/twopence/adapt the first lines oftest.rb andtest.shto the name of the socket file you just created; for example:

export TARGET=virtio:/run/twopence/test.sock

• run the following commands:

cd examplesexport LD_LIBRARY_PATH=../libraryruby /usr/local/lib/twopence/test.rb

• if you get errors opening the communication,check the permissions of the socket file:

ls -l /run/twopence/test.sock

• connect a null-modem cable to the system under test
• connect the other end to the testing machine
• determine the port name on both ends(you can use "minicom" to do that)
• copy the test server into the system under test:

scp /usr/local/lib/twopence/twopence_test_server root@sut.example.com:.

instead of scp, you may use shared folders or whichever method you prefer

• inside of the sut, run the server as root:

./twopence_test_server

• in the directory/usr/local/lib/twopence/adapt the first lines of test.rb and test.shto the name of the character device; for example:

export TARGET=serial:/dev/ttyS0

• run the following commands:

cd examples/usr/local/lib/twopence/test.shruby /usr/local/lib/twopence/test.rb

• if you get errors opening the communication,check the permissions of the character device file:

ls -l /dev/ttyS0