1. Summary
  2. Files
  3. Support
  4. Report Spam
  5. Create account
  6. Log in

Release Files for Download (DIST)

SourceForge.net? provides a Beta 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 DIST facility are automatically distributed to our worldwide network of download mirrors?, ensuring file availability, and providing great download performance to users.

Note: 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 desired folder where the file is to be uploaded
    • If the location is the root folder, proceed to next step.
  3. Click on the "Add File" button
  4. Navigate to the location of the file on your local file-system
  5. Add up to X number of additional files to be uploaded.
  6. Click the the upload button
    • A progress bar will display showing upload progress

The file(s) is/are uploaded. When complete, press the "Done" button.

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>

Statistics

The new DIST facility has a separate Download statistics collection space.

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 interface.
  3. Click on the link representing the name of the folder you wish to upload the file to
  4. Click the "Add File" button"
  5. Navigate to the location of the file on your local file-system
  6. Add up to X number of additional files to be uploaded.
  7. Click the the upload button
    • A progress bar will display showing upload progress

The file(s) is/are uploaded. When complete, press the "Done" button.

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. Click the link in the upper right part of the page labeled "Regular Version"
  2. Left click on the filename to select additional properties for the file you have uploaded.
  3. 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

Add a Folder

  1. Navigate to the desired parent folder and select the Add Folder Button.

Move a Folder

  1. Click the link in the upper right part of the page labeled "Regular Version"
  2. Click on the Gear icon next to the folder to be moved.
  3. From the menu select “Cut”.
  4. Click on the Gear icon for the destination folder.
  5. From the menu, select “Paste”.

Delete a Folder or File

  1. Click on the checkbox next to the folder(s) and/or file(s) you wish to delete.
  2. Click the "Delete Selected" button
  3. Files and or Folders are deleted immediately.

You may also click on the file name and use the delete menu item to delete the file. For folders, you may mouse-over the folder and select the gear icon to use another menu to delete the folder.

Note: folders and contents will be deleted on selecting to delete a folder.

Editing Folder Details

Mouse-over the folder, then select the "Gear" icon to the left of the folder icon.

Stats

  • Displays the statistics for the files in the selected folder.

Rename

  • Change the name of the folder.

Delete

  • Folder and contents of the selected folder will be deleted.

Files

To set additional file details, click the link in the upper right part of the page labeled "Regular Version", then 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 the link in the upper right part of the page labeled "Regular Version"
  2. Click on the Gear icon next to the file.
  3. From the Menu select “Cut”.
  4. Click on the Gear icon next to the destination folder.
  5. 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 checkbox next to the folder(s) and/or file(s) you wish to delete.
  2. Click the "Delete Selected" button

You may also click on the file name and select the "Delete" option.

Editing File Details

Click the link in the upper right part of the page labeled "Regular Version". 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

Error: Failed to load processor Include
No macro or processor named 'Include' found