Installscript

Description

The Installsscript is a tool that the handles the conventional installation steps with a collection of scripts.

Prerequirements

• Development environment

Manual

• Manual De
• Manual En

Tutorial

First of all

• Linux knowledge is required
• It is useful to have experiences in compiling VDR and it's component manually

Scripts customisation

Decompression

sh vdr-install-script-<VERSION>.run --noexec --target /tmp/VDRtmp
cd /tmp/VDRtmp/setup

It is useful to customise the following configuration file to his own needs

• config/setup.conf
• config/commands.conf
• config/reccmds.conf
• config/make.conf
• config/kernel.conf
• config/configure.conf
• config/marks2pts.conf
• examples/plugins/accounts.conf

e.g. with the mcedit editor

mcedit config/setup.conf

In ../config/plugins befinden sich die Einstellungen der Plugins, als bsp das audiocd-plugin. ../config/plugins/audiocd.conf

## Description:
#
# -d DEV --device=DEV set device (default: /dev/cdrom)
#
##
-d /dev/cdrom

Options are prefaced with ^-, after selection it goes into the plugin_setup.conf, see pluginsetup-plugin, the same for Description.

## Description: AudioCD Plugin
                ^^^^^^^^^^^^^^
                Würde später im Menu des Plugins (pluginsetup) stehen, ansonnsten <NAME>

Most of the options can be delivered through the commandline, independently from setup.conf

./setup.sh --help
./vdr-install-script-<VERSION>.run -- --help

Backup

In order that the setting are not lost at updates, everything should be backuped.

Execute

./setup.sh

and go to

<-> - Configuration
    | - Load an Alternate Configuration File --->
    | - Save Configuration to an Alternate File --->
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

To save the settings somewhere else, e.g. /media/floppy/.config (ca. 80KB).

After an update, these setting can be loaded through

<-> - Configuration
    | - Load an Alternate Configuration File --->
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Another possibility is the backup of the complete script with

./setup.sh --buildrunpackage
     Label (default "vdr-install-script-<VERSION>.run"):

Gesichert wird, was in ../setup/SAFE definiert wurde.

#
# FILE(s) only txt files!
#
../setup/config/add.conf
#
# DIRECTORY(ies) maxdepth 1, only txt files!
#
../setup/config/plugins

Wer möchte kann auch Files "außerhalb" der Scripts sichern, einfach eintragen.

#
# FILE(s) only txt files!
#
/etc/lircrc.conf

Installation protocol

File:Installscript-01.png Mainmenu	Startmenu
File:Installscript-02.png Download Manager	Download Manager
File:Installscript-03.png DL Manager Sub 1	One layer deeper
File:Installscript-04.png DL Manager Sub 2	Here, one actually selects the sources
File:Installscript-05.png Download Status	Download status
File:Installscript-06.png Mainmenu	Startmenu => Software Manager
File:Installscript-07.png Software Manager	Selection of the packages.
File:Installscript-08.png Software Select	Here, the selection of the sources takes place (version independent). One should roughly what maches together!
File:Installscript-09.png Start up	Entry for /etc/inittab
File:Installscript-10.png Channels Select	Selection of the channels.conf
File:Installscript-11.png Software Manager	Software Manager => Patches
File:Installscript-12.png Patch Select	Basically all patches can be applied as available. Just copy them into ../packages/vdr/patches (requirement: --dry-run works)
File:Installscript-13.png Patchlog	If everythings went fine
File:Installscript-14.png Mainmenu	Mainmenu => Plugins Manager
File:Installscript-15.png Plugins Manager	There are three options: <I> for install, <U> for replace, and <D> for delete. Sometime VDR has to be patched for some plugins, should be visible in the plugins.log, for --reverse of a patches, just de-install the corresponding plugin (<D>).
File:Installscript-16.png Plugins Opt	Show additional options for plugins compilation. See also make.conf
File:Installscript-17.png Mainmenu	Mainmenu => Compiling
File:Installscript-18.png Driver Select	Selection of the DVB driver.
File:Installscript-19.png Postinstallation	Shows the Postinstallation.
File:Installscript-20.png Compile Menu	Selection of the options.
File:Installscript-21.png Edit	Here one can change the options for the compilation of VDR
File:Installscript-22.png Plugins Check	Show what was compiled
File:Installscript-23.png Mainmenu	Mainmenu => pluginsetup
File:Installscript-24.png Plugins Select	Dialog for activation of the plugins, it can later be changed through pluginsetup plugin
File:Installscript-25.png Installationslog	The log files are located in /var/log/vdr

Scripts

• runvdr
• vdr.conf
• shutdown.sh

Available modules

This is an index of the available modules. Everything below ./add can be upgraded.

Modules in the ../untestet directory must to be customised!

• One modules requires kernel 2.6 (actuator.cmd)
• Some modules are still in beta status
• Other have missing links

Stow(ES)

GNU stow helps to organise the files under /usr/local, by installing every software under his own directory tree under /usr/local/stow. And then, symbol links create the illusion, every software is installed in the same place.

Here are some of the most important commands

• help

/usr/local/stow/stowES help --prog stow=/usr/local/stow/stow

• checkstow (cs)

/usr/local/stow/stowES cs --prog stow=/usr/local/stow/stow
Checking packages in /usr/local/stow (78 matches):
I (  772.5) DFB++-0.9.20
I (  1,385) DirectFB-0.9.20
I (19223.5) ImageMagick-6.0.2
I ( 10,085) MPlayer-1.0pre4
....

• checkin (ci)

/usr/local/stow/stowES ci MPlayer-1.0pre4 --prog stow=/usr/local/stow/stow
Calling "stow" to check in package MPlayer-1.0pre4 ...done.
Calling ldconfig

• ceckout (co)

/usr/local/stow/stowES co MPlayer-1.0pre4 --prog stow=/usr/local/stow/stow
Calling "stow -D" to check out package MPlayer-1.0pre4 ...done.
Calling ldconfig.

• remove (rm)

/usr/local/stow/stowES rm MPlayer-1.0pre4 --prog stow=/usr/local/stow/stow
Calling "stow -D" to check out package MPlayer-1.0pre4 ...done.
Calling "rm -rf" to remove package MPlayer-1.0pre4 ...done.
Calling ldconfig.

• exchange

/usr/local/stow/stowES exchange MPlayer-1.0pre4 MPlayer-1.0pre5 --prog stow=/usr/local/stow/stow
Calling "stow -D" to check out package MPlayer-1.0pre4 ...done.
Calling "stow" to check in package MPlayer-1.0pre5 ...done.
Calling ldconfig.

Links

[1]	ftp://ftp.cadsoft.de/vdr/Tools	VDR FTP
[2]	http://linvdr.org/download/vdr/Tools	Download mirror
[3]	http://savannah.gnu.org/projects/stow	GNU Stow project homepage
[4]	http://www.inf.tu-dresden.de/~al10/stowES	Extensions to Stow
[5]	http://linuxwiki.de/Stow	Stow Wiki