Difference between revisions of "Uploading to Savannah"

(this page is new, minimal, but will be heavily modified, and experienced people should be able to follow it atm)

Uploading to Savannah

So you have made a package for your system you want to share? Well done. But there is a few things you need to do first. Follow the instructions for you operating system below.

Uploading on Linux

1. First you have to make yourself a gpg key and ssh key (If you already have both, skip to step #)
2. To do this, you need to install gnupg. Run the equivilent of "urpmi gnupg" (Mandriva) for your system (sometimes called apt-get, yum, rpm, or similar)
3. When gnupg is installed, run in a console "gpg --gen-key".
4. When asked for the type of key, select "DSA and Elgamal (default)" (for me, thats #1, but it could be different on other systems).
5. When asked for keysize, you can type any numerical value you want between 1024 and 4096, but for this tutorial, we'll just use 1024.
6. Expiry can cause problems, so when promted, select 0 (never expires) and select Yes when it asks if you are sure.
7. Type your real name and email when asked, and for comment, say something like Savannah key, something you'll remember.
8. Click O and Enter to accept what you've typed (if nothing needs changing).
9. Enter a passphrase when promoted. You can leave it empty, but for security, you should put something simple to remember.
10. It will now generate a new key. Move you mouse or type something on the keyboard to generate a more secure key.
11. When the process is completed, it should lead you back to a command prompt.
12. From here, type "ssh-keygen -t dsa" and hit enter to save in the in the default folder (normally ~/.ssh/id_dsa)

If a key already exists, then you don't need to do these steps. Hit no so you don't overwrite it, then go to step #

1. Enter a passphrase (again, not required, but better for security). Type it twice to confirm then hit enter to generate the key. If it goes well, you'll be lead back to a command prompt.
2. Upload your public ssh key to Savannah
3. Upload your public gpg key to Savannah
4. Wait 1 hour for everything to take effect.
5. Open the console and run

sftp [username]@dl.sv.nongnu.org:/releases/glob2/

1. Or if you prefer a more graphical interface, open Konqueror and run

sftp://[username]@dl.sv.nongnu.org/releases/glob2/

Uploading on Windows

1. Install WinSCP from http://winscp.net/ (for this guide, I used WinSCP 4.0 beta Installation package, but they may have released a newer version when you read this)
2. Open PuTTYgen (a program installed that should be installed with WinSCP). If you dont have it, download it from http://the.earth.li/~sgtatham/putty/latest/x86/puttygen.exe
3. In PuTTYgen, generate a new 1024bit length DSA2-SSH key with a passphrase (for security). Move the mouse in the empty space to generate the key.
4. When it is generated, save your private file to a folder of your choice (if this file is moved, you will need to change WinSCP, so its best to keep it in either My Documents, or some other folder where it can stay for as long as you use WinSCP)
5. In PuTTYgen, save your public file to your desktop (this wont remain here, only till the end of the guide)
6. With PutTTgen still open, highlight and copy the ssh key at the top of the gewnerted key page (starts with ssh-dsa). Post this key to the ssh key configuration page when you are logged into Savannah.
7. Close PuTTYgen and with a text editor like Wordpad (notepad tends to make it not work), open and copy the entire contents of the public key you saved to your desktop, then post this to the gpg key configuration page when you are logged into Savannah. The contents of the public key should look something like:

---- BEGIN SSH2 PUBLIC KEY ----

[lots of charters and information here]

---- END SSH2 PUBLIC KEY ----

1. Because Savannah is quite busy, you have to wait 1 hour for everything to take effect (that is when their cron script update you details and make them effective).
2. Open WinSCP. It should pop up with the new host configuration page. It not, click the New button.
3. Set host as dl.sv.nongnu.org, with port 22
4. Set username as the one on Savannah (the same account you added the ssh and gpg keys too)
5. Set password as the passphrase you set during the making of the key (again, this is for security reasons, so no one can hack and steal you files to upload things in your name).
6. Set the private file as the one you saved in the place where it will remain (My Documents or some other folder)
7. Set protocol as SFTP (with SCP fallback). Although the program is called WinSCP, we actually use it as if it were WinSFTP. It works the same, if not better.
8. Save the connection information, and hit Login.
9. If the details are set correctly, you should be promted for your passphrase, and after enting it, be presented with two sides. On the left you have you local computer, and on the right, Savannahs server.
10. Using the norton Commander interface (the two sided interface described in the setp above), hit CTRL+O. This opens bookmarks, which you'll need.
11. Type /releases/glob2/ into the text feild, hit Add, then click Ok to go to that folder. You are now set to drag and drop files from the Left side to the right side to upload (or vise versa to download). See #Permissions on Windows before you do upload your first file however to prevent some permission problems

(further uses of WinSCP require you to open the bookmarks (CTRL+O), select the releases bookmark, and click Ok to get there, which takes away the need to type anything)

Setting Permissions

When you upload a file, it belongs to you. No one else can touch it. Which doesn't make it very good for others. So to allow others to move and rename etc, your files, do the following.

Permissions on Linux

• If using console, type the following after uploading all files to make them all have the right permissions (if you get any errors, then its because some other files arn't chmod correctly, ignore them, they are probably old):

chmod 775 *

• If you are using Konqueror, for each file you upload:

Right click uploaded files, click Properties > Permissions > Advanced Permissions > And tick all boxes in the first three columns minus Others Write (8 boxes in total)

Permissions on Windows

• In WinSCP, hit CTRL+ALT+P (or Options > Preferences)
• Go to the Transfer settings page
• Find the box about Upload options, click Set Permissions, and hit the litle box with three ...
• In the Octal text box, write 775 (it should then select all boxes in the first three columns minus Others Write (8 boxes in total)). Click close.
• Click ok. Further files will be automatically these permissions.