Version en Espanõl
How To : Installing Add-ons
The Definitive Guide
Created and developed by Claudio Roberto Cussuol.
(Translated by Marcelo - Brazil/Esteban)
STEP 1 - Downloading an add-on.
Usually an add-on for BrazilFW has one or more files with the .tgz extension.
Some of these add-ons need you to replace the kernel, but most of them do not require any special action,
not taking into account that you have to copy it to the boot disk.
When BrazilFW is running from a floppy and you have access to it, the installation is very simple,
normally it is enough to save the file to the floppy and reboot.
However, many users get confused when BrazilFW has been transferred to a HD or the computer is physically far from them and it is
not possible to manipulate the boot disk personally.
Once you identified which add-on you need, you can download it using any computer
and any operating system.
STEP 2 - Moving the file to BrazilFW.
Before starting: Backup BrazilFW.
In this example, I will use a ficticious add-on called package.tgz.
First, I will copy it to the memory of BrazilFW,
in the root folder and only in step 3, I will move it to the hard disk.
There are several ways of doing this. I will explain the most common ones.
2.1 - Using a floppy.
- Save the file package.tgz in a regular, empty and formatted floppy in MS-DOS mode.
- Insert this diskette in the drive in which BrazilFW is running.
- Login in to the BrazilFW console (Console=Keyboard and Monitor attached to the computer running BrazilFW) or remotely via SSH (PuTTY).
- In the console, type the following commands:
- Código: Selecionar todos
mount /dev/fd0 /mnt -t vfat
- Código: Selecionar todos
cp /mnt/package.tgz /
- Código: Selecionar todos
umount /mnt
- Now you can remove the floppy from the 1.44" drive and move on to step 3.
- If you run BrazilFW from a floppy, do not forget to insert it back in the drive, it will be necessary in the next step.
2.2 - Downloading directly to BrazilFW
- In the BrazilFW console, type:
- Código: Selecionar todos
cd /
- Código: Selecionar todos
wget http://site.com/folder/folder/package.tgz
- Go to step 3.
2.3 - Using an ftp client
For this method to work, it is necessary to have previously installed the ftp.tgz add-on.
- Download package.tgz
- Copy it to an ftp server where you have access.
- In the console type:
- Código: Selecionar todos
cd /
- Código: Selecionar todos
ftp your.ftp.server.com
- Código: Selecionar todos
get package.tgz
- Código: Selecionar todos
quit
- Go to step 3.
2.4 - Using an scp client
For this method to work, it is necessary to have previously installed the scp.tgz add-on.
- Download package.tgz to your computer.
- Log in to winscp according to the instructions in the link above.
- Copy or move the file to the root folder.
- Log off from winscp.
- Go to step 3.
STEP 3 - Copying the file to the hard disk
Now that you are going to install the add-on remotely, I will assume that you used one of the methods in STEP 2
and that your file has already been copied to the root folder of BrazilFW.
- In the BrazilFW console (Console=Keyboard and Monitor attached to the computer running BrazilFW) or remotely via SSH (PuTTY), type:
- Código: Selecionar todos
mt
- Código: Selecionar todos
cp package.tgz /mnt
- Código: Selecionar todos
umt
- Código: Selecionar todos
reboot
WARNING: DO NOT backup BrazilFW after installing a package. You must always reboot WITHOUT MAKING BACKUP.
ANNEX - Changing the kernel
Some add-ons need you to replace the BrazilFW kernel. The kernel is a file called linux that is in the floppy or HD.
In case the add-on requires a new kernel you will have to download it and rename it to "linux" (without quotes)
and copy it to your Brazil HD or floppy using one of the procedures above.