nitrc:Future User Guide - Other Features (Administrators)
From NITRC Wiki
 |  |
This section describes the administration of special features used mostly by developers. For information on the administration and management of the features available through your tool/resource menu, see the Administration section.
Contents |
Downloads/FRS Administration
You can create packages and releases of files that can be downloaded by NITRC users. This is a feature available through the tool/resource menu. Refer to the Downloads/FRS Administration section for more information.
Source Code (SCM) Administration
You can control the access to your source code. This is a feature available through the tool/resource menu. Refer to the Source Code (SCM) Administration section for more information.
Web Services Interface
If you would like to upload files and packages to NITRC without going through the GUI-based interface, NITRC supports Web service access using Simple Object Access Protocol (SOAP). Technical reference to the provided services may be found at http://www.nitrc.org/soap/.
NITRC-Hosted Web Site
On the NITRC server, every tool/resource has a home directory under /home/groups with the tool/resource "Unix name" (/home/groups/<tool/resource Unix name>). You can find the "Unix name" by going to the tool/resource Summary page and looking at the URL. The name that appears after "http://www.nitrc.org/projects/" is the "Unix name." The tool/resource's home directory has write permission by the primary administrator. This administrator can access the home directory over SFTP or use the rsync command-line utility over SSH to update the home directory.
Tool/Resource Web Page
In each home directory is an "htdocs" directory. The tool/resource administrator can create a Web page with this directory. When an index.html page is placed (by SFTP) in the /home/groups/<tool/resource Unix name>/htdocs directory, it is accessible at http://<tool/resource Unix Name>.projects.nitrc.org/. For example:
| Unix name: | example |
| Web page directory: | /home/groups/example/htdocs |
| Web page: | /home/groups/example/htdocs/index.html |
| Web page URL: | http://example.projects.nitrc.org/ |
If a project exists but does not have an index.html page, http://<tool/resource Unix Name>.projects.nitrc.org/ gets redirected to the NITRC Home page. For security reasons, PHP and CGI scripting has been disabled on the NITRC-hosted Web pages.
If you create a NITRC-hosted Web page, you may want to point to this page through the "Tool/Resource Home Page" link on your Summary page. To change the home page link, click "Admin" in the tool/resource menu, and then click "Edit Public Info."
Tool/Resource Files
You may also upload large files to your "/home/groups/" directory, and direct users to this file through a corresponding FTP URL. Place your file (by SFTP) in the home/groups/<tool/resource Unix name> directory. For example:
| Unix name: | example |
| File: | /home/groups/example/file.ext |
| File URL: | ftp://www.nitrc.org/home/groups/example/file.ext |
Uploading via SFTP
If you do not already have an SFTP client, we recommend the open-source project FileZilla client because it is easy to use and provides download restarts. Use your NITRC account and an SFTP client to connect to www.nitrc.org.
Host=www.nitrc.org
Username=<NITRC username>
Password=<NITRC password>
Port=22
On the remote server, go to /home/groups/<tool/resource Unix name>/htdocs. Upload your file from your local machine to the remote server.
| Note: Only the primary administrator, the one who registered the tool/resource with NITRC, can transfer files. |
Once your file has been uploaded, be sure to set the user and group permissions appropriately. For example, if you only want members of your tool/resource to access the file, then turn off global read access.
Tool/Resource Access Tracking (Google Analytics)
You can use Google Analytics to track access to your NITRC tool/resource, including hits to tool/resource pages and downloads. After registering a Google Analytics Web Property ID with NITRC, NITRC will call Google Analytics whenever your tool/resource pages are accessed, and Google Analytics will do the rest.
First, you must sign up for a Google Analytics account and sign in to this account. Add a new profile by selecting "Add Website Profile." Select "Add a profile for a new domain" and use "nitrc.org" for the URL of the site (not www.nitrc.org).
You will then get a Web Property ID for this profile; the ID is a string of the form "UA-1234567-1." Log in to NITRC and go to the main Admin page of the tool/resource you would like to track. Put the Web Property ID in the box marked "Google Analytics ID."
Information about access to your NITRC tool/resource pages, downloads, etc., can then be found by logging in to your Google Analytics account and looking at the nitrc.org profile. Data may take up to 24 hours to appear.
Tool/Resource Data Backup and Offline Access
If you would like to download all your tool/resource data, you may opt to create a nightly backup of your tool/resource. You may also use this download for offline access to your NITRC data. Please refer to the NITRC Tool/Resource Backup and Offline Access Instructions wiki for more information.
Remote Data Access
If you would like to pull data from NITRC for your own application, you may use some scripts developed by the NITRC team to get NITRC data in JSON format. Please refer to the NITRC Remote Data Access wiki for more information.
Biositemaps
In an effort to provide a way for biologists and bio-informaticians to find biomedical resources, the NIH Roadmap National Centers of Biomedical Computing (NCBC) (www.ncbcs.org) has developed biositemaps. A biositemap is simply controlled metadata about a biomedical resource that is stored in a biositemap.rdf file. By instantiating a biositemap.rdf file on an Internet site, a resource can become part of the biositemaps inventory. Any institution with an interest in biomedical research can deploy a biositemap.rdf file to their public Internet site. The institution can then publish this biositemap to a centrally located biositemap registry. This registry can be queried by anyone interested in finding biomedical resources.
NITRC automatically generates the biositemap.rdf file necessary for publication to the biositemap registry. The file is generated through the tool/resource Summary page.
| URL: | http://www.nitrc.org/projects/<tool/resource Unix name> |
| Filename: | biositemap.rdf |
You may view the source code of this file to see the metadata fields with their corresponding data. For a description of the metadata fields, please refer to the Biositemaps Information Model.
To publish this file on the biositemap registry, please visit the Biositemaps Registration.
For more information on biositemaps and searching the biositemap inventory, please visit the Biositemaps Home page.
