Working with Project Web

From gvSIG CE Wiki

Jump to: navigation, search

All of the gvSIG CE web sites are hosted on the SF.net Project Web service. This is essentially a free web hosting service. Since SF.net is a big free site, with hundred of thousands of users, there are some strict procedures and rules for running and managing web sites on Project Web.

Contents

Web hosting

All sites are stored in /home/project-web/gvsigce/htdocs on the Project Web server.

In order to install new web sites, update or change their (configuration) files, it is necessary to get file-level access to the Project Web hosting service. There are two principal ways of achieving this: SFTP and the shell service.

SFTP

SF.net supports only Secure FTP (SFTP), not the plain FTP protocol. So you will need to use a client that implements SFTP, such as FileZilla.

These are the details you need to know to connect with your SFTP client:

  • The FTP server name is frs.sourceforge.net.
  • It listens on port 22.
  • The login name is a combination of your SF.net account's user name and the project name, separated with a comma. So in the case of gvSIG CE this would be:<SF user name>,gvsigce.

After login, your FTP client should redirect you to the directory that stores the files for all sites.

Shell service

For full access, you can get a unix shell via SSH. The login name is a combination of your SF.net account's user name and the project name, separated with a comma. So in the case of gvSIG CE this would be:<SF user name>,gvsigce.

You must first request a new shell using the "create" option:

 ssh -t <user>,gvsigce@shell.sourceforge.net create

Until the login shell expires, you can log in again using:

 ssh <user>@shell.sourceforge.net

Jump into the correct directory:

 cd /home/project-web/gvsigce/htdocs

Outbound email

Project Web also allows outbound email, which is essential for notifications on sites such as the bug tracker. For obvious reasons, this feature must be used with restraint.

To enable outbound email on SF, an email password has been set up in "Project Admin > Features", and clicking on "Manage" beside "Project Web" and setting it up a password for outbound email. This account is available for all hosted applications (bug tracker, forums, etc.). No further action is needed.

Every hosted application has its own way for setting up its emailing features, but there are some general SF.net instructions.

If you need to provide a sender address for the SMPT daemon, to get output email working in a hosted web application, use the schema "<project-name>@users.sourceforge.net".

MySQL Database

Most of gvSIG CE's Internet sites require a MySQL database. This is provided by SF.net.

After logging in to SF, choose "Project Admin > Features" In the list of features displayed, make sure that "Project Database (MySQL)" is enabled. If not, switch to the "Available Features" page and enable it. Click on the "Manage" function next to the "Project Database (MySQL)" entry.

The resulting screen gives you all needed information to set up the database and use it from other software.

There are three predefined accounts at the bottom of the screen. They represent an initial read-only, a read/write and an admin user.

You can test the database connection and create more users later using the MySQL command line tools or the web front end (phpMyAdmin).

The "Database name prefix", and the name and password of the admin account are very important for setting up working MySQL connections for Project Web hosted sites.

Notes

All Project Web hosted pages must display the SF.net logo, available here.