How To : Installing Add-ons

Several tutorials

How To : Installing Add-ons

Mensagempor BrazilFW » Seg Dez 24, 2007 7:45 pm

Versão em Português
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
("Mount the floppy")

Código: Selecionar todos
cp /mnt/package.tgz /
("Copy the file to the root folder")

Código: Selecionar todos
umount /mnt 
("Unmount the floppy")

- 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 /
(Go to the root folder)

Código: Selecionar todos

- 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 /
(Go to the root folder)

Código: Selecionar todos
(Log in to the ftp server)

Código: Selecionar todos
get package.tgz 
(Download the file)

Código: Selecionar todos
(Leave the ftp server)

- 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
(Mount HD or boot disk)
Código: Selecionar todos
 cp package.tgz /mnt 
(Copy the new package to HD)
Código: Selecionar todos
Código: Selecionar todos

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.

Voltar para Several tutorials

Quem está online

Usuários navegando neste fórum: Nenhum usuário registrado e 0 visitantes