I use Sourceforge.jp ( A Japanese project branched from Sourceforge.net) CVS repository via NetBeans. This time I tried NetBeans' CVS utility under Windows Environment. As for network management Windows is so cheap, with no CVS or SSH tools pre-installed. So we must introduce, for example, WinCVS and PuTTY by ourselves.
PuTTY is one of the popular SSH(and so on) client for Windows.
http://www.chiark.greenend.org.uk/~sgtatham/putty/
These four excutables are at least required. You can download them from the site above.
putty.exe
puttygen.exe
plink.exe
pageant.exe
I thought it were pagent.exe. Queen's English?...
Anyway, these files were gathered into c:\putty directory.
You can download it from
WinCVS include CVSNT. Now I wonder I might have needed only CVSNT from
Sorry if I had.
In the case of WinCVS, The downloaded product is in a zip form, all you need is to extract it, start setup.exe, and follow the guidance of the installer.
puttygen.exe makes public & private key files for ssh authentication.
Double-click the icon as above, so you will see the Key Generator window.
Please look at the "Parmeters" option. I set "Type of key to generate"to "SS1(RSA)". It's because when I started a project in sourceforge.jp the supported type was, as I remember, only SSH1 and I did not know now SSH2 is also supported. Sorry!
To Generate key files, click "Generate" button. The generation process is fun, like below:
As the mouse cursor wanderes around the progress bar, it streches to the end. Then there is a short process of generating codes, And finally the window changes:
This is a dummy code abandoned afterward. Don't forget to input Key passphrase into the field.Then click "Save public key" and "Save private key" one by one. As saved, the file extensions for public and private key files are to be .pub and .ppk, respectively. For my example, they are
c:\putty\identity.pub
and
c:\putty\identity.ppk
Now, the key files got prepared.
I went to sourceforge.jp site, logged in with my account. Then entered into Account maintenance page.
The black characters (not bold) means " Account maintenance".
In this page,far below, there is a link for "Edit keys".
The blue characters in the [] blackets.
Clicking the link, a text area appears. I copied all the content of identity.pub file(text data) into it.
The label of above button means update, maybe( I have never seen the English version). Anyway clicking it, the public key is registered. I here it would take several hours for updating, but I don't know.
Now let's use PuTTY by double-clicking the icon:
This is the first setting page.
HostName is set as "cvs.sourceforge.jp".
This setting was saved as a session named "sourceforge". After I found I should name it as "cvs.sourceforge.jp", the same as the CVS server's name, but this naming also is available.
Hold clicking "Open" button in this step. You will still get nothing.
Next. Click "Connection"->"SSH". In my case I had to set "Preferred SSH protocol version" to "1".
Then Click "SSH"->"Auth".
Input the path for the Private
key file authentication, in my case c:\putty\identity.ppk, into the
field . Then you can test connection by clicking the charming "Open"
button. What happens? A console window appears and requires the passphrase.
Input it, and what happens!?
The console closes.
Many documents say this as the reaction when the connection was successful.
You could see the console for a longer time, if an error occurred.Happy connection!...though
not so exiting ...
Before closing the setting window, Look at the options "Authentication parameters". Check "Allow agent fowarding" on.
Still don't close the window, Go to "Session" node, and save this sourceforge session. Well, it is a little inconvenience feature of this interface...
What is "Agent" written above? That is pageant, which I frequently spell wrong.
But why every agent has an black-hatted icon!? I think this kind of hat would make man even featured when he walks in the street nowadays...Anyway, by double-clicking it, this icon goes to the task tray.
To assign a mission to this agent, right-click the lovely little icon.
Select "View Keys", so a window for key list appears.
The list is blank for the first time. Click "Add Key" button. Select the private key file, identity.ppk, from the file chooser shown then. When another window appears for the pathphrase, fill it. In this way one item is registered to the key list. Maybe the displayed item is not a secret one, but it's not bad to hide because it is about an actual key I use,
Click "close" button and the agent remains as a background application. After this, the agent send the pathphrase automatically to other applications using SSH.
Now wake up, NetBeans4.0(dev)!
Select from Menu bar,"Versioning"->"CVS"->"Grobal
CVS Check Out".
The configuration windows seems much updated compared to NB3.6. Could we set to check out from ext server before?
How to configure NetBeans to use PuTTY is written in a NetBeans.ORG document. It is for NB3.6, but very useful.
One important thing is "CVS Server Name" to be set as , when using PuTTY, the session name set and saved by putty.exe. In my case, "sourceforge". That's why I regret to have given this name to the session...If it were named "cvs.sourceforge.jp", there would be no confusion."
Another is "Remote Shell" to be set as "c:\putty\plink.exe", not the default value "ssh".
Then hit "OK"! So we can see in the output window,
Gorgeous! Now, where can we find
this CVS module checked-out? Maybe not in "Projects" or "Files".
Select from Menu bar "Window"->"Versioning", then a with
a tab "Versioning" appears at the same position as "Projects"
or "Files".
Then there it is!
Nice to see you again, the pink icon of mounted CVS! Though I still don't know what this figure means! In this way, at first, we got how to check out CVS via NetBeans4.0. How to add, edit, and commit would be reported next time.
November 5, 2004