Installing Your Firmware
========================

Your packed firmware needs to be uploaded to your system (fussy does not 
provide this functionality).  Once uploaded, you need to arrange to call 
the fussy-install script.  Keep in mind that this script likely needs to 
be called as root (in order to allow it to properly set ownership and 
start/restart services).

To install a package into the default `/opt/firmware/` location:

.. code-block:: bash 

    $ fussy-install /tmp/fussy-iHUyhV-pack/sample-setup.tar.gz.gpg
    $ fussy-clean

this will update the `/opt/firmware/current` link to point to the unpacked 
version of the firmware and run the .pre-install and .post-install scripts 
with the final location of the firmware as their first argument.

If you install the same firmware twice, the firmware's directory name will 
be altered to have a trailing integer suffix.

If the installation fails, then the *previous* current installation will be 
re-installed (i.e. will be linked, then have its pre and post-install scripts 
run.

fussy-install
-------------

`fussy-install` unpacks the firmware into a temporary directory, rsyncs it into 
the firmware target directory, runs the `.pre-install` script, if present, then 
"fixates" the version by linking `current` to the new version, and finally 
runs the `.post-install` script, if present.

.. code-block:: bash

    $ fussy-install --help
    Usage: fussy-install [options]

    Options:
      -h, --help            show this help message and exit
      -f FILE, --file=FILE  The firmware archive to unpack, must be a .tar.gz.gpg
                            or a .tar.gz.asc
      -k KEYRING, --keyring=KEYRING
                            GPG keyring to use for verification/decryption
                            (default /etc/fussy/keys)
      -t TARGET, --target=TARGET
                            Directory into which to rsync the firmware (default
                            /opt/firmware)

fussy-clean
-----------

.. code-block:: bash 

    $ fussy-clean --help
    Usage: fussy-clean [options]

    Options:
      -h, --help            show this help message and exit
      -t TARGET, --target=TARGET
                            Directory into which to rsync the firmware (default
                            /opt/firmware)
                            

Module: fussy.install
---------------------

.. automodule:: fussy.install
    :members: