Language

The Free and Open Productivity Suite
Released: Apache OpenOffice 4.1.15
Managing project files

Project help for project owner administration: Index


Managing project files

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:

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 download a file?

Under each heading, there may be files that you can download by clicking on them. If your browser supports file downloads, the download will immediately commence. The file will be downloaded to your default download directory on your workstation.


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:

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.


About file types

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.


Back to Project Owner Administration help
Back to main Help index

Apache Software Foundation

Copyright & License | Privacy | Contact Us | Donate | Thanks

Apache, OpenOffice, OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. The Apache feather logo is a trademark of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.