BrazilFW Linux pkg.Installer for On-line/ On-Demand package installation
download from here:
http://www.brazilfw.com.br/users/tarsiu ... kginst.tgz
This package is for HDD installations and for Floppy installations... it works the same way with both versions....
CAUTION: this package DOESN'T ALLOW YOU to install packages that make use of databases such as rrdstats or those who has their own config file which is not coyote.conf, for these last ones an addon called PKGBACKUP (
http://www.brazilfw.com.br/users/tarsiu ... backup.tgz ) could be used if those packages save their config somewhere in /etc/config directory...
basically pkgbackup saves EVERYFILE on /etc/config although sometimes it doesn't work either...)
Here there is a list of INCOMPATIBLE packages:
-rrdstats
-rrdtools
-l7-qos
(THIS doesn't mean you can't use them together... you CAN install them using the traditional method AND ALSO have pkg.installer for other packages...)
Version 0.4 of this Manual
Version 1.2 of pkg.installer
1.0- Description
1.1- Files Included
1.2- Features
2.0- Installation
2.1- Configuration
3.0- Usage
3.1- Boot-time
3.2- Runtime
3.3- Webadmin
4.0- FAQ
1.0- Description
This package allows you to download and install addons during runtime.
It also allows you to download and install addons during boot-time,
so that you can erase every package from the floppy and install
them into BFW during boot-time or runtime, freeing some space on the
floppy disk.
1.1- Files Included
/bin/pkg.installer: contains the script itself
/etc/rc.d/pkgs/rc.pkginst: script to launch the main script at
boot-time
/etc/coyote/pkg-all: list of available packages through different
servers
NOTE: you MAY find DIFFERENT packages versions on different
servers!!!!
/var/lib/lrpkg/pkginst.list: the list of files of this package
/var/lib/lrpkg/pkginst.version: the version of the installed
pkg.installer
/var/lib/lrpkg/pkginst.help: this help file
/var/lib/lrpkg/pkginst.configs: configuration parameters list
1.2- Features
- Supports downloading from different servers, reducing the chance of
not being able to download a package
- Ability to load packages during runtime
- Ability to load packages during boottime
- As long as you have memory available you can load more than 1.44 MB in packages
- Easy Webadmin control
2.0- Installation
Erase every package file from your floppy (EXCEPT dhcpd.tgz,
root.tgz, etc.rgz and modules.tgz), then download this file:
http://www.brazilfw.com.br/users/tarsiu ... kginst.tgz
and copy it into the floppy disk, boot your BFW and go to item 3.1
on this manual.
2.1- Configuration
Configuration parameters are kept in:
/etc/coyote/coyote.conf
Here is the list of parameters and their descriptions:
PKGINST_SOURCES
default value:"http://www.brazilfw.com.br/downloads/addons
http://cablemodem.fibertel.com.ar/brazilfw/addons http://www.tarsius.com.ar/addons"
(WITH QUOTES)
This is the list of sources of the packages, feel free to change it
if you need to
PKGINST_SAVELOG
default value:yes
Change it to "no" if you don't want to save the log
PKGINST_RUN_AT_BOOT
default value:yes
If set to "yes" pkg.installer will run at boot and load selected
packages in PKGINST_PKG_LST
PKGINST_LOG
default value:/var/log/pkginst.log
This file contains a log of pkg.installer actions when PKGINST_SAVELOG
is set to "yes"
PKGINST_PKG_LST
default value:"webadmin"
(WITH QUOTES)
This parameter keeps the list of packages to be downloaded during boot
or when pkg.installer is called without parameters. You can add
the packages you want to download here...BUT REMEMBER, if you delete
webadmin.tgz from floppy you must have it here.. otherwise webadmin
won't be availible...
Here's an example:
PKGINST_PKG_LST="libpthread,webadmin,sslwrap,upnp"
ALWAYS PUT LIBRARIES FIRST otherwise some addons may not work...
This example will install pthread library, with webadmin, upnp support
and sslwrap to access webadmin from the internet
3.0- Usage
There are two ways to use this script:
3.1- Boot-time
Write down the names of the packages you want to install
during boot-time onto PKGINST_PKG_LST parameter, change
PKGINST_RUN_AT_BOOT to yes and backup the floppy. If you
don't know how to do this open webadmin, go to "Configuration
Files > BrazilFW Main Configuration File" and type those
parameters as it is explained in "2.1 Configuration" section,
then backup and then reboot
There's a full list of availible packages webadmin > install
new addons > Available Packages
DON'T FORGET TO BACKUP UP YOUR CONFIG BEFORE RESTARTING
WARNING: you must ALWAYS put LIBRARIES FIRST, otherwise some
add-ons may not work properly.
3.2- Runtime
Open a SSH Client and type "pkg.installer" to install all the
packages listed in PKGINST_PKG_LST parameter
If you would like to install a certain package type:
pkg.installer thepackagename.tgz
and that will install the package "thepackagename", you
can also do something like this:
pkg.installer package1 package2.tgz package3
(as you can see .tgz extension can be ommited)
and so on...
DON'T FORGET TO BACKUP UP YOUR CONFIG BEFORE RESTARTING
WARNING: you must ALWAYS put LIBRARIES FIRST, otherwise some
add-ons may not work properly.
3.3- Webadmin
I Think webadmin control itself explains everything quite
good, the only "weird" thing is the option:
Install "Selected Packages"
This option installs the packages that you selected to be
installed during boot-time... that's what "Selected
Packages" means....
4.0- FAQ
4.1- Configuration is lost everytime you restart BFW?
No, it doesn't. Add-ons save their config into
/etc/coyote/coyote.conf and this file is saved each time
you do a backup.
4.2- If I download an addon of more than 1.44 MB, my floppy disk
would crash?
No! it won't, since packages are NOT saved into the floppy
disk, even when they have been downloaded and installed.
Only their config is saved and a few text files won't
fill the floppy disk.
4.3- Where does pkg.installer install the packages?
It installs them into the Virtual Disk created using
RAM memory during the boot process, just as BFW does when
it boots...
Yes, the more memory you have, the more packages you can
install...
4.4- Does pkg.installer work with any connection?
I don't know that yet, I was hoping you could tell me :P.
It should work but I don't know if BFW gives enough time
between enabling the internet connection and launching
this script.
Cablemodem connections work fine since they are always
online.
4.5- Can I add a different server to PKGINST_SOURCES list?
Yes, you can... just keep in mind what "2.1 Configuration"
section says about this parameter...(I mean, the "quotes"
thing, but only if you're editing coyote.conf directly)
The best way to do this is through webadmin
4.6- Pkg.Installer configuration is lost everytime I update
Pkg.Installer?
No, it doesn't because it's saved into coyote.conf file
which is BFW main configuration file.
Editado pela última vez por tarsius em Seg Fev 19, 2007 1:26 am, em um total de 8 vezes.