Project help for project owner administration: Index

Project Owner Administration

Editing and maintaining the Project Home page

Managing project site news

You are here: Managing project files

• Downloading project files
• Uploading project files
• About file types

Adding project members and approving roles

Managing project mailing lists

Managing project documentation

Managing project source code with CVS version control

Tracking and managing project issues

Back to main Help index

This section focuses on uploading, or posting, files and documents on your project site for later downloading. We will first explain the page features and then, in the section titled "About file types" suggest some tips for project owners on how to place and maintain files for maximum ease of use by your developer community.

As project owner, the columns you see when you access this page will differ from those seen by other users who are not project owners, and you will see the following column headings:

• Size
• File Name
• Date Posted
• Posted By
• MD5 Checksum

These headings for the columns are fairly self-explanatory. The "Size" heading relates to the size of the file, and the "File Name" to the file name. "Date Posted," and "Posted By" refer to the date on which the file was placed on the project site and who posted it there.

"MD5 Checksum" refers to a commonly accepted protocol for verifying a file's integrity. The numbers uniquely identify a file, and are automatically generated by the page every time a file is uploaded to the page. Upon downloading a file, you can verify the integrity and authenticity of the file by checking the numbers you generate using the protocol's algorithm against those on the site. MD5 checksum thus safeguards against any form of corruption (including the malicious insertion of viruses or Trojan horses) encountered while downloading.

Generating the MD5 code generally requires that use an operating system based on Unix, such as Linux, though there are increasingly more implementations available. But for now, unless you are using Linux, you will not be able to fully use the MD5 checksum functionality of the site. (For more information about MD5, please see Lance Spitzner's useful account of MD5, "What is MD5 and why do I care?"

How do I upload a file? (Adding or replacing a download)

You can add to and replace files already on the page by using the "Add or Replace a Download" field. To select a file you want added to the page, click on the "Browse..." button. This button works with all browsers that support file uploads, regardless of the underlying operating system. If you are using Windows, and you do not see the file you wish to upload, try setting the "Files of type:" setting to "All Files" in your browser's window.

There are a few caveats about uploading files:

• The upload field does not support spaces in file names. Thus, if you are uploading a file whose name is, for instance, "Java Specifications," you will have to rename it on your computer to something like, "Java_Specifications."
• The field does not support the addition of directories; and adding many files at once could end up being counterproductive.
• The maximum file size allowed per upload is 25 MB. Larger files will not be accepted.

Once you have selected the file, you should describe the file. This description should be short and to the point. The idea is to provide the viewer with enough information to choose whether she needs to download the file or not. For instance, if you want to make available the the project's latest milestone, you might describe it using the date, or if it is a component, the version and function name.

The last field on the page, the "Public" checkbox, allows you to stipulate whether you want the file to be publicly available. Checking the box indicates that anyone who as accessed your downloads page can retrieve the file; they need not be members of your project. In contrast, an empty box denotes that only project members can retrieve the file. By default, the box is left unchecked.

You can post a variety of file types for later download: binaries, tarballs, zip files, text files, even graphic files. Since the point of this page is to provide members (and the public) an central place from which to download final (or major milestone) releases, you do not want to add files which are in flux. In short, files which require some form of concurrent version control.

Note: We do not recommend that you post source code to this page. Consequently, this page does not support CVS (Concurrent Versioning Control). If you are interested in posting source and wish to use concurrent version control, please see the CVS help information.