4.12. File Releases

4.12.1. Introduction

The File Releases System (FRS) is used to upload files to the FusionForge site and to make these files available to the users in an easy and efficient way.

Files can be divided in different packages, and every single package can be monitored by the users; these users will receive an email every time a new file has been added to the package.

4.12.2. Administration

The FRS system allows you to upload file to FusionForge and make this file available to the public.

You have to define a package before you can release a file. A package should have a descriptive name for the project, e.g. gforge3.

To add a new package, insert a package name in the textbox at the bottom of the page and click Create this Package.

You can use the radio buttons to make the package publicly viewable or not. Default is public.

You can use the menu buttons to make the package active or hidden. Hidden packages will not be listed in the Files section.

Your package will appear in the Releases list at the bottom of the page.

Click Add release. The form has the following fields:

Package ID

You can select here the package.

Release Name

Insert here the name of your release. The name should be indicative for the version of your file, e.g. pre-8.

Release Date

The Release Date.

File Name

Click the Browse button to select the file to upload. In some browsers you must select the file in the file-upload dialog and click OK. Double-clicking doesn't register the file.

Note

You can't upload file that exceed the UploadFile Limit in php.ini.

File Type

You can select here the file type (.zip, .html, .exe, .tar.gz, etc).

Processor Type

You can select here the processor required to run the application.

Release Notes

The release notes.

Changelog

The changelog.

Click the Release File button. Your file will now appear in the list of files in the File section.

4.12.3. Managing packages and releases via CLI (Command-Line Interface)

We give here some basic examples of CLI commands. For more information, please consult the FusionForge Command-line interface (CLI) documentation.

4.12.3.1. Logging in with CLI
gforge.php -v login --username="user" --project=myproject
4.12.3.2. Getting a list of releases

Get the package id

gforge.php frs packages

Get the list of releases of a given package

gforge.php frs releases --package=xxx
4.12.3.3. Add a release of a given package
gforge.php frs addrelease --package=xxx --name="My new release"
4.12.3.4. Edit a release

Add a text file to a release of a given package.

gforge.php frs addfile --package=xxx --release=yyy --file=zzz

Retrieve file on the standard output

gforge.php frs getfile --package=xxx --release=yyy -id=www

Retrieve file in a file

gforge.php frs getfile --package=xxx --release=yyy -id=www 
                       --output=newfile

4.12.4. Monitoring packages

You can monitor a package by clicking on the envelope next to the package name. The envelope now bears a red symbol.

You can unmonitor the package by clicking again on the envelope.

4.12.5. Subscribing RSS feed for a package

You can subscribe a RSS feed for a package on the summary page of the project, by clicking on the RSS icon and select Alcatel-Lucent Forge Developer New Project Releases.