Interactive Shell Service
Project developers can access an Interactive Shell if they have been granted shell access for the project. The Interactive Shell provides a command line interface that can be used to manage the following:
- Project web content
- Developer web content
- Project uploads
- CVS repositories
The Interactive Shell supports the following features:
- SSH shell access to project content; access to data for other users and projects not provided
- Comprehensive set to command line tools
- 4 hour shell life - shells are automatically terminated after 4 hours.
- Password or SSH keys authentication
- CVS repository administration
The Interactive Shell does not support the following features:
Project members must be granted shell access by a project administrator. Project administrators can grant Shell Access to project members on the project membership page (select Membership in the Project Admin menu).
Interactive Shell sessions persist for 4 hours once created. Authorized developers that have been granted shell access for a project can create/connect to an Interactive Shell with:
ssh -t USER,PROJECT@shell.sourceforge.net create
NOTE: Be sure to substitute your SourceForge.net login username for USER, and the respective SourceForge.net project UNIX name for PROJECT.
If you do not have an active Interactive Shell session a help page can be viewed with:
Accessing Developer Web Content
Users who are a member of a project and want to access their Developer web content need to use the above method to connect and then change to the appropriate directory (replacing "jsmith" with your own username):
For those using the PuTTY SSH client, set the following settings for the PuTTY session:
Note: In Windows Vista or Windows 7, it may be necessary to run PuTTY in Windows XP compatibility mode.
Session Host Name: "shell.sourceforge.net" Session Connection Type: "SSH" Connection > SSH Remote command: "create" Connection > Data Auto-login username: "USER,PROJECT"
- Open the session and provide your password at the prompt.
Note: If you get disconnected after shell creation, in Connection > SSH > TTY uncheck the box for "Don't allocate a pseudo-terminal"
SSH Key Authentication
If a user has set up SSH keys, they can be used to authenticate to an Interactive Shell session. Please see the following for more information on setting up SSH keys:
Use the '-i' option to pass your private key file to the ssh command:
ssh -i PATH-TO-PRIV-KEY -t USER,PROJECT@shell.sourceforge.net create
Interactive Shell provides a small set of Interactive Shell specific command line tools. These include:
- sf-help - Prints an Interactive Shell help page.
- timeleft - Show the time left (of the 4 hour window) before the current shell expires.
- adminrepo - For managing CVS repositories; see adminrepo --help for more information
- shutdown - Initiate the immediate termination of an Interactive Shell session.
Accessing your files with other tools
You can access most of your files at any time, regardless of whether you have an Interactive Shell created or not, by using the web.sourceforge.net hostname. This includes your project and developer web files, your home files, and your download files. It does not include any git/bazaar/mercurial SCM files that are only mounted when you create an Interactive Shell.
One advantage of accessing your project's web files via USER,PROJECT@web.sourceforge.net is that the default transfer directory for relative pathnames is your project's web directory. For instance, this will update the index.html file for the "myproject" project as long as user "joe" has the permissions to do so:
rsync -aiv index.html joe,firstname.lastname@example.org:/home/project-web/myproject/htdocs/
For all other transfers the default transfer directory for relative pathnames is your user's HOME directory.
For files not accessible via web.sourceforge.net, you can use scp or rsync using your normal shell.sourceforge.net access. Only SFTP access requires an alternate means of accessing your shell's files, should you want to use that.
To use sftp to access your files, either use the web.sourceforge.net method, or run the sf-help command in your Interactive Shell and it will tell you an alternate access method that requires the use of a port number and an alternate hostname. In the following example replace USER with your SourceForge.net username, and PORT and HOST with the port number and hostname you obtained from sf-help:
sftp -o Port=PORT USER@HOST
A couple examples:
sftp -o Port=22002 email@example.com sftp -o Port=24007 joe,firstname.lastname@example.org
Important Safety Tip
Please be mindful of the symbolic links deployed in various SourceForge.net systems. Before attempting the following commands to write any data it would be wise to Backup your data first.