Skip to content
The guest tools for lx-brand images
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
test
tools
.gitignore
.travis.yml
LICENSE
README.md
install.sh

README.md

SmartOS lx-brand Guest Tools

Build Status

This repo is used to install the guest tools for lx-brand images. The guest tools are required for enabling ssh key creation and meta data (user-sript, operator-script etc.) functionality. This repo, via the install.sh script, also creates symlinks and wrapper scripts for binaries found in /native in an lx-brand zone. See below for details.

Status

This software is still under active development and should be used with care.

Installing

To install the guest tools, run the ./install.sh script with the -i flag specifying the install path:

./install.sh -i /data/chroot

What Gets Installed

The install.sh script installs the following:

  • rc.local boot scripts from src/lib/smartdc
  • Symlinks to binaries found in /native. See symlinks.txt for the list of relevant binaries
  • Wrapper scripts for binaries in /native. See wrappers.txt for the list of relevant binaries
  • A custom rc.local file (/etc/rc.d/rc.local or /etc/rc.local depending on the distrubution)

Development

Bash Style

To enusre the scripts are consistent with the Joyent style guidelines, use ./tools/bashstyle:

./tools/bashstyle install.sh

Testing

Tests are executed using Bats and can found in test.

To install Bats:

$ git clone https://github.com/sstephenson/bats.git
$ cd bats
$ [sudo] ./install.sh /usr/local

Run the tests with:

bats test
You can’t perform that action at this time.