1. Summary
  2. Files
  3. Support
  4. Report Spam
  5. Create account
  6. Log in
Version 44 (modified by ctsai, 5 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.).


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 the New Folder link next to the file name box
  3. Enter name of the folder to be created
  4. Click folder name where uploaded file will reside
  5. Click the Upload File link to the right of the New Folder link
  6. 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
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 Summary page.
  2. From the Project Admin menu, click on “File Manager”. You are presented with the File Manager explorer interface.
  3. Select a folder for your file.
    • If you upload a file without selecting a folder, the file will be stored in the “/” (root) folder.
    • See “Folders” section for more information on how to work with folders.
  4. Click Upload to upload the file.
    • 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.

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. Navigate to the parent folder and right click.
  2. From the menu, select “New Folder”.

Folders can also be created using the “New Folder” link.

Move a Folder

  1. Navigate to the folder and right click.
  2. From the menu select “Cut”.
  3. Navigate to the destination folder and right click.
  4. From the menu, select “Paste”.

Delete a Folder

  1. Navigate to the folder you want to delete and right click.
  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

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

  1. Navigate to the file and right click.
  2. From the Menu select “Cut”.
  3. Navigate to the destination folder and right click.
  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. Navigate to the file to delete and right click.
  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.

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.

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 visable, simply move it to a different folder.

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

  • Change the name of a folder.
  • Creation of symlinks (this functionality is planned to be added to the file manager, but is currently broken).

These functions may not be achieved using the file manager.

Getting Help