1. Summary
  2. Files
  3. Support
  4. Report Spam
  5. Create account
  6. Log in
Version 57 (modified by ctsai, 4 years ago)

--

Release Files for Download (FRS)

SourceForge.net provides a File Manager as a means for projects to make files available for download by their users. In addition to the web based File Manager, SourceForge provides an interactive-shell service for managing files. The File Manager and the interactive shell service provide different methods to manipulate the same files and folders. See Accessing Releases via Shell later in this document for more information.

Files released using the FRS are automatically distributed to our worldwide network of download mirrors, ensuring file availability, and providing great download performance to users.

Note: All file releases should be a single file. Multiple files for the same release should be archived together (tar, deb, zip, etc.). We recommend using rsync for all uploads over 20 megabytes in size, as rsync allows for resuming canceled or interrupted transfers.


Upload Quick Start Guide

Note: Allowed characters for files and directories are: -_ +.,=#~@!()[]a-zA-Z0-9 (including " " - space). Disallowed characters are: &:%?/* Filenames may not start with a space or dot ("."), and may not end with a space (" ").

File Manager (UI)

  1. Select File Manager from the Project Admin menu
  2. Click on the Gear icon next to the “/” (root) folder or any other folder and select the New Folder menu item.
  3. Enter name of the folder to be created
  4. Click the Gear icon next to the folder where uploaded file will reside and select "Upload here"
  5. Navigate to file to be uploaded and click Open

The file is uploaded.

SCP

User jsmith seeks to put file.zip to the Rel_1 directory of his project, fooproject:

scp file.zip jsmith,fooproject@frs.sourceforge.net:/home/frs/project/f/fo/fooproject/Rel_1

Rsync

User jsmith seeks to put file.zip to the Rel_1 directory of his project, fooproject:

rsync -e ssh file.zip jsmith,fooproject@frs.sourceforge.net:/home/frs/project/f/fo/fooproject/Rel_1/

SFTP

User jsmith seeks to put file.zip to the Rel_1 directory of his project, fooproject:

$ sftp jsmith,fooproject@frs.sourceforge.net
Connecting to frs.sourceforge.net...
jsmith,fooproject@frs.sourceforge.net's password: 
sftp> cd /home/frs/project/f/fo/fooproject/Rel_1
sftp> put file.zip
Uploading file.zip to /home/frs/project/f/fo/fooproject/Rel_1/file.zip
ws                                            100% 1573     1.5KB/s   00:00    
sftp>

Uploading files for distribution

To make a file available for distribution through the mirror network, simply do the following:

  1. Login to SourceForge.net as a project administrator and access the Project Develop page.
  2. From the Project Admin menu, click on “File Manager”. You are presented with the File Manager explorer interface.
  3. Click on the Gear icon next to the folder you wish to upload the file to, and select "Upload Here"
    • This will open a file explorer on your local machine where you can choose the file(s) you wish to upload.

Note: Allowed characters for files and directories are: -_ +.,=#~@!()[]a-zA-Z0-9 (including " " - space). Disallowed characters are: &:%?/* Filenames may not start with a space or dot ("."), and may not end with a space (" ").

Set file Details

  1. Left click on the filename to select additional properties for the file you have uploaded.
  2. Use the file details box to select the file as the default download for an operating system, or link release notes to the file.

The file you have uploaded will be available for download from the worldwide mirror network, shortly after upload has been completed.

Release notes

The File Manager allows a file to be set as the release note of a release. Once set, the release note will be viewable by clicking on the release note icon in the "Notes/Subscribe" column on the Files page. How the file is displayed will vary dependant on the type of file:

  • If it is a plain text file, it will be displayed in a SourceForge page (HTML files will be interpreted as plain text).
  • If it is a binary file (such as a PDF), a download prompt for that file will appear.

Release notes are set by setting a file as a release note, then associating a file/folder to it.

Folders

The File Manager also provides directory and file management capabilities.

Folders can be used to logically group files together so it is easier for users who wish to download project files to get what they need. Folders can be used for many different purposes e.g. a project could represent packages and releases using folders, or group files together by platform or by release maturity (stable / alpha / beta) etc. SourceForge.net does not put a limit on the number of files uploaded or the number of sub folders created. However, all folders that are visible in the File Manager will also be visible to users browsing files for download (with the exception of the "OldFiles" directory).

Manipulating Folders

Create a Folder

  1. Click on the Gear icon next to the desired parent folder and select the New Folder menu item.

Move a Folder

  1. Click on the Gear icon next to the folder to be moved.
  2. From the menu select “Cut”.
  3. Click on the Gear icon for the destination folder.
  4. From the menu, select “Paste”.

Delete a Folder

  1. Click on the Gear icon next to the folder you wish to delete.
  2. Confirm deletion.

Note: folders can only be deleted if they are empty. Folders which contain files or subfolders can not be deleted until their contents have been moved or deleted

Editing Folder Details

Name

  • Edit the folder name displayed.

Label

  • The label will display next to the folder name on the Files page.

Release Notes for this folder

  • Files that have been identified as release notes can be easily linked (or associated with) a specific download folder. This drop-down menu shows the available release notes to associate with this folder.

Files

Basic file attributes will be displayed upon file upload. File attributes that are identified on upload include:

  • Filename, Size, File Date & File Type

To set additional file details, left click on the File name.

Note: Allowed characters for files and directories are: -_ +.,=#~@!()[]a-zA-Z0-9 (including " " - space). Disallowed characters are: &:%?/* Filenames may not start with a space or dot ("."), and may not end with a space (" ").

Manipulating Files

Move a File

Note: If a file is moved, it is recognized as a new file in the FRS. Per file download statistics for that file will start off at 0 again.

  1. Click on the Gear icon next to the file.
  2. From the Menu select “Cut”.
  3. Click on the Gear icon next to the destination folder.
  4. From the Menu, select “Paste”.

Delete a File

Note: Users are responsible for backing up all of their files. SourceForge.net will not restore individual files.

  1. Click on the Gear icon next to the file to be deleted.
  2. Confirm deletion.

Editing File Details

Additional File Attributes can be set for a file by clicking on the filename. The following attributes are editable:

Name

  • Edit the filename displayed.

Label

  • The label is an alternative name for the file that will be displayed to the user in the Download Now! box on the project summary page. The label will also display next to the filename on the Files page.

Platform (default download)

  • The platform download default checkbox is used to determine which file will be displayed in the Download Now! box on the project summary page, based upon the operating system detected, or provided by the user downloading the file.
  • Choose “Select All” to create a default download file for all platforms, or select the specific platform(s).
  • If a default platform file is not selected the latest file uploaded for the users operating system will be displayed in the Download Now! box.
  • The box above the file manager will display the currently selected default downloads. If no file is explicitly selected for a platform, it will show "auto".

Release Note

  • The release note checkbox is used to identify that a file is a release note. Once selected, the file will display the release note icon next to the filename and will be selectable to be associated with other files.

Release Notes for this file

  • Files that have been identified as release notes can be easily linked (or associated with) a specific download file. This drop-down menu shows the available release notes to associate with this file.

File management service

Accessing Releases via Shell

Developers may use the Shell service to manage file releases and the file release structure.

Log into the Shell service then your change directory based on your project UNIX name (Example project named "fooproject"):

cd /home/frs/project/f/fo/fooproject

Migration of existing files and known issues

For projects that had existing files available for download at the time of the change to the File Manager facility, those files will be migrated to logical folders. This is based upon the package & release names.

In addition to the folders created for migrated package and releases, an "OldFiles" folder is also created which contains files that were previously hidden. The "OldFiles" folder is not visible to users downloading files from your project. If you wish to make a file visible, simply move it to a different folder.

The following features may be accomplished via the shell for release folders:

  • Creation of symlinks.

These functions may not be achieved using the file manager.

Getting Help