---
name: "fai-progress"
section: "1"
platform: "linux"
package: "goto-fai-progress"
version: "2.0-5"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/fai-progress"
---

# fai-progress(1)

show an informative progress bar during FAI operations.

## NAME

fai-progress - show an informative progress bar during FAI operations.

## SYNOPSIS

/usr/lib/cdebconf/debconf fai-progress

## DESCRIPTION

fai-progress is a script used to display an informative progress bar during installations or softupdates using FAI and a standard cdebconf method.

Use vga=788 as your kernel start parameter and you're getting the GTK backend instead of textual NEWT. You can use dpatch to change the graphical logo to your own one.

## ENVIRONMENT VARIABLES

- **FAI\_LOG\_PATH** FAI logfile to monitor for changes

  - **FAI\_METHOD** Either 'install' or 'update' - this only controls the displayed information

  - **GOSA\_SI\_SOCKET** Path to a named pipe to write the current progress information. It can be used for faimond related processes to update the client installation progress in percent.

  ## USAGE

This example is from the confdir.default.source hook. It creates a new VT and starts the fai-progress process inside of this VT. It can be stopped by "echo fai-progress: hangup \>\> `$FAI_LOG_PATH`".

FAI\_PROGRESS\_VT=$(openvt -v 2\>&1 -- sh -c "\
         export TERM=linux ;\
         export TERM\_UTF8=yes ;\
         export FAI\_LOG\_PATH=$LOGDIR/fai.log ;\
         export DEBCONF\_DEBUGFILE=$LOGDIR/debconf.log ;\
         export DEBCONF\_DEBUG=developer ;\
         export LANG=UTF-8

```
        if [ -c /dev/fb0 ]; then
                export DEBIAN_FRONTEND=gtk ;
        else
                export DEBIAN_FRONTEND=newt ;
        fi ;
        setterm -blank 0 -powersave off -powerdown 0 ;
        echo -ne "\033%G" ;
        touch -f $FAI_LOG_PATH ;
        /usr/lib/cdebconf/debconf /usr/bin/fai-progress ;
        reset")
```

FAI\_PROGRESS\_VT=${FAI\_PROGRESS\_VT##\* } echo "${FAI\_PROGRESS\_VT##/dev/tty}" \> `$LOGDIR`/fai-progress-vt

chvt ${FAI\_PROGRESS\_VT##/dev/tty}

## PRESUMPTION

In order to display the installation progress correctly, you have to set the MAXPACKAGES FAI variable to a large value - i.e. 10000.