10. Installing add-on packages

When FREESCO 0.2.7 is installed on a hard disk you can install so called add-on packages. There are two flavours, officially released packages and 3rd party add-on packages.

The official released packages have been tested and approved by the FREESCO team, the 3rd party add-on packages are not! Read the Disclaimer and Warnings section for details.

The main online library for FREESCO packages is FREESCOSoft maintained by howler.

10.1 Principle of packages

FREESCO 0.2.7 packages consist (usually) of two files. One part is the package installation script with .sh extension, the other part a so called tarball with .tgz extension that contains the actual add-on package.

The angel package f.i. contains thus a file angel.sh and angel.tgz.

Simon Byrnand has written an acticle about the packages system of FREESCO 0.2.7.

The package system of FREESCO 0.3.x is completely re-written and is thus NOT compatible with the FREESCO 0.2.7 package system!

10.2 Package commands

listpkg

listpkg [URL]

This command can be used to list the packages available on a package site. When the command is executed without the optional URL then the default download site is listed, otherwise the package list at the requested URL.
Basically this command is using snarf to download and display a file called packages.txt on the remote download site.

Sample run
[Linux] listpkg
No URL specified - checking freesco site for official packages.
error: HTTP error from server: HTTP/1.1 404 Not Found

Sadly enough, (due to several site moves) the official packages.txt seems to be lost :-(

[Linux] listpkg http://dingetje.homeip.net
Checking http://dingetje.homeip.net/ for packages.
Sorry, wrong URL for freesco 0.2.7 packages!
Use http://dingetje.homeip.net/packages instead.

[Linux] listpkg http://dingetje.homeip.net/packages
Checking http://dingetje.homeip.net/packages/ for packages.
Available packages for Freesco 0.2.7
------------------------------------

Check out my 0.2.7 packages page http://dingetje.homeip.net/my_stuff_027.php
for details about these packages.


angel           - angel network monitor. requires full Perl package to be
                  installed and an HTTP server.
                  See: http://dingetje.homeip.net/angel/html/index.html
....

installpkg

installpkg [URL]packagename

This command can be used to install a package. Without the optional URL the package with the given name must exist on the official FREESCO package site. It is therefore advisable to use the listpkg command first!

The installation process occurs in two steps:

  1. the installation shell script of the package is downloaded to your system
  2. the installation shell script is executed

It is therefore very important that you are sure the package contents can be trusted. Before kicking off the installation script the installpkg command will ask if you want to have a look at the script code. This is higly recommended, allthough this does require some knowledge of shell script programming to understand what the installation script is doing (or trying to do :)).

removepkg

The removepkg command by itself can be used to list the packages that are installed on your FREESCO.

sample run
[Linux] removepkg
The following packages can be automatically removed:
Apache_ASP_2.45_dingetje
angel
apache_1.3.27_dingetje
...

Use the command with the name of one of the packages will remove that package from your system 1).

sample run
[Linux] removepkg dns2go
Are you sure you want to remove package dns2go [y/n] ? y
dns2go uninstall complete.

10.3 Disclaimer and Warnings

No responsibility is taken for any software or instructions given on this site. This site is merely a collection of material found to relate to FREESCO. As such, installing any program (including FREESCO, packages and any other programs linked to by or hosted on this site) or following any instructions, advice, links or information given is done so at your own risk.

Before installing anything (not just this but any programs you ever come across), be sure to check the scripts and source code, as well as the reliability of the authors. It is possible that a program could contain virii, trojans and other nasty stuff or that information given here could be incorrect, possibly causing damage to your computer, network or data.

Where possible, material taken from the FREESCO site is classed as “official” only when it appears to have come directly from the FREESCO team and not a forum member or other associated person. Support queries for “official” packages, programs and information should be directed to the FREESCO support forum. Support queries for “unofficial” packages, programs and information should be directed to the FREESCO third-party support forum and / or the authors.

We personally believe “official” resources to be more reliable than “unofficial” resources but wouldn't wish to say that either were flawless and virus-free or, for that matter, bug-ridden and virus-riddled.

We do not officially offer support, advice or assistance for anything on this site but are willing to help on a friendly, stranger-on-the-internet-who-just-so-happens-to-know-something basis.

This is the disclaimer notice dingetje uses on his packages page:

DISCLAIMER OF LIABILITY
This software is provided AS IS without warranty of any kind. Author makes no claims concerning the accuracy or correctness of the computer code contained in, or the results of the use of this software. The entire risk as to results and performance of this software is assumed by you.

In other words, I am not responsible for anything you do with it or it does with you, so use this at your own risk
  • add-on packages can damage your system!
  • Badly written packages may open one or more ports on your firewall or even completely disable the firewall!
  • When the uninstall script is badly written or not available(!), you may have to manually remove (parts of) the package from your system.
  • etc, etc. you get the message?
1) provided that the uninstall script of that package is correctly written!
 
freesco/manuals/027/10._installing_add-on_packages.txt (110506 views) · Last modified: 2005/09/14 00:49 (external edit)
 
Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki