Issue 40218 - SSH2Guide Update
Summary: SSH2Guide Update
Status: CLOSED FIXED
Alias: None
Product: Infrastructure
Classification: Infrastructure
Component: Documentation (show other issues)
Version: current
Hardware: All All
: P3 Trivial (vote)
Target Milestone: ---
Assignee: diane
QA Contact:
URL: http://www.openoffice.org/scdocs/ddSS...
Keywords:
: 40581 (view as issue list)
Depends on:
Blocks:
 
Reported: 2005-01-09 00:29 UTC by diane
Modified: 2013-08-05 13:55 UTC (History)
5 users (show)

See Also:
Issue Type: DEFECT
Latest Confirmation in: ---
Developer Difficulty: ---


Attachments
list of changes made to file www/www/docs/ddSSHGuide.html (1.39 KB, text/plain)
2005-01-11 16:28 UTC, diane
no flags Details
updated file www/www/docs/ddSSHGuide.html (19.04 KB, text/html)
2005-01-11 16:29 UTC, diane
no flags Details
Linux Guide (7.40 KB, application/vnd.sun.xml.writer)
2005-02-24 17:31 UTC, lsuarezpotts
no flags Details
rewrite started; but unfinished. Plan was to Copy&Paste details from FAQs. (16.83 KB, text/html)
2005-02-26 22:39 UTC, diane
no flags Details
Revised PuTTY Section, Added Tunnelling Guide (16.77 KB, text/html)
2005-02-27 10:00 UTC, willysr
no flags Details
ssh guide-latest (17.01 KB, text/html)
2006-06-02 17:35 UTC, lsuarezpotts
no flags Details

Note You need to log in before you can comment on or make changes to this issue.
Description diane 2005-01-09 00:29:54 UTC
The anchor named Mac is targeted by mac. This causes a dead bookmark in the TOC.
Fixing this will (soon) break the related FAQ:
http://documentation.openoffice.org/faqs/site_maintainers/003.html.

Under http://www.openoffice.org/scdocs/ddSSHGuide.html#Mac the MacSSH link needs
change from hhttp://www.macssh.com to http://www.macssh.com. Firefox pops up an
error box and cannot handle hhttp files.
Comment 2 diane 2005-01-09 03:58:09 UTC
the last entry is wrong. The "Tunneling..." link in the left menu TOC should be
changed from http://www.openoffice.org/scdocs/ddSSHGuide.html#tunneling to
http://www.openoffice.org/scdocs/ddSSHGuide.html#HowtoConnect.
Comment 3 diane 2005-01-09 04:39:15 UTC
I've checked out this file (from www/www/docs/ddSSHGuide.html), and will work
through the links as I go, then will attach the file to this issue. I could not
see the scdocs dir. Did I grab the right file? It seemed like the newest. Please
advise if I should grab a different file?
Comment 4 diane 2005-01-11 16:28:04 UTC
Created attachment 21361 [details]
list of changes made to file www/www/docs/ddSSHGuide.html
Comment 5 diane 2005-01-11 16:29:56 UTC
Created attachment 21362 [details]
updated file www/www/docs/ddSSHGuide.html
Comment 6 diane 2005-01-11 16:39:56 UTC
There's still a bad link, second one up from the bottom, i think, in the list of
further documentation. It connects to a site, but doesn't find content.
Comment 7 diane 2005-01-11 21:14:45 UTC
maybe http://www.linuxhelp.ca/guides/ssh/ is the replacement link? ... or omit it?
Comment 8 diane 2005-01-11 21:18:52 UTC
reassigning from www (oops!) to issues@www.
Comment 9 lsuarezpotts 2005-01-11 21:46:55 UTC
thanks diane!
I'll take it over...
Cheers
Louis
Comment 10 stx123 2005-01-12 08:25:19 UTC
reassigning to louis...
Comment 11 diane 2005-01-13 13:40:10 UTC
*** Issue 40581 has been marked as a duplicate of this issue. ***
Comment 12 lsuarezpotts 2005-01-14 18:13:30 UTC
thanks diane!
I tried fixing things and then realized the whole document was wretched and needed major updating. 
So I reorganized it and pruned a lot of irrelevant stuff.  It needs a small section on putty: I couldn't get 
it to work last night using an old key as they use a unique format but one which is all the same easy to 
change to OpenSSH format, which is what we use.  

if you would like to review the new doc....

And yeah, scdocs is hidden; only some of the files have been placed where we can access them.
cheers
louis
Comment 13 diane 2005-01-14 19:58:34 UTC
wow Louis, cool beans!
Comment 14 jacqueline.mcnally 2005-01-15 00:07:47 UTC
Here is a tutorial on tunnelling with PuTTY:
http://www.cyberknights.com.au/doc/PuTTY-tunnelling-HOWTO.html

Authored by Leon and assisted by other PLUG members.
Comment 15 diane 2005-02-20 05:35:43 UTC
we have some very good notes written in the mail archives which could be used to
enhance the ddSSHGuide.html document:

http://documentation.openoffice.org/servlets/ReadMsg?list=dev&msgNo=2198

http://documentation.openoffice.org/servlets/ReadMsg?list=dev&msgNo=2216

http://documentation.openoffice.org/servlets/ReadMsg?list=dev&msgNo=2212
Comment 16 lsuarezpotts 2005-02-21 07:51:15 UTC
thanks Diane,
Sigh.
I wish then the Documentation project would just rewrite the doc to their satisfaction. :-/
I'll re-address it again.... but at the mo' it's not super high priority.

later
Louis
Comment 17 diane 2005-02-23 03:21:53 UTC
more feedback:
http://documentation.openoffice.org/servlets/ReadMsg?list=dev&msgNo=2344

no worries, Louis... someone will get to it eventually. This makes a good place
to gather more info while folks are thinking about it out loud. We can justify
the edits under the category of continuous process improvement. :) I'm willing
to work at it too, but like you, it will be a bit before I can make time for it.
Comment 18 diane 2005-02-23 03:30:48 UTC
Willy wrote a tutorial for PuTTY:
http://documentation.openoffice.org/servlets/ReadMsg?list=dev&msgNo=2321
Comment 19 willysr 2005-02-23 14:38:25 UTC
It will be best to link my guide from the ddSSHGuide page, since it contains
images (not too big actually), but it's your decision Louis

I'm willing to help if you need too.
Just let me know

Thanks
Comment 20 diane 2005-02-23 15:16:15 UTC
This faq http://documentation.openoffice.org/faqs/site_maintainers/003.html
contains the preliminary steps that Jean requested.

Also, a mail message suggests a possible layout and may include more details:
http://documentation.openoffice.org/servlets/ReadMsg?list=dev&msgNo=2346
Comment 21 willysr 2005-02-24 15:28:00 UTC
adding myself to cc
Comment 22 lsuarezpotts 2005-02-24 17:24:20 UTC
changing summary to reflect evolution.
adding Lindaw
Louis
Comment 23 lsuarezpotts 2005-02-24 17:31:05 UTC
Created attachment 23000 [details]
Linux Guide
Comment 24 lsuarezpotts 2005-02-24 22:19:44 UTC
thanks, Willy! I've also added Lindaw to this issue. I'm occupied by other things right now but would like 
to address this issue sooner than later. 

best
Louis
Comment 25 diane 2005-02-26 13:06:34 UTC
I grabbed a copy of the code via page source, and am working to update this page.
Comment 26 diane 2005-02-26 22:39:10 UTC
Created attachment 23073 [details]
rewrite started; but unfinished. Plan was to Copy&Paste details from FAQs.
Comment 27 diane 2005-02-26 22:53:27 UTC
I worked on updates to the ddSSHGuide.html by grabbing a copy of the page
source, then editing it. I grabbed the file yesterday, but didn't write that I
grabbed it until this morning. I put several hours into it, so there may be
something useful there, but maybe not too. Meanwhile, Linda has something in the
works too after a discussion with Louis, so we likely are duplicating efforts.
I'm not sure what to do from here, and the way this issue stands helps to
confuse things more, so I've put my stuff on the table and am backing away. :)
Please let me know if or how I can help on this task. There's plenty enough to
do where I can easily redirect myself. I will also act as support if you need
it. I hope it's helpful that I attached my work and not a hindrance. I found it
hard to decide what I should do.

I'm reassigning this to lindaw. :) If that is not ok, send it back to me. At
least this way things will be clear, so we don't have to wonder what we should
do. :) I hope this helps!
Comment 28 willysr 2005-02-27 10:00:58 UTC
Created attachment 23080 [details]
Revised PuTTY Section, Added Tunnelling Guide
Comment 29 willysr 2005-02-27 10:03:50 UTC
PuTTY can be used to create SSH Keypair and it worked. Jean Hollis Webber has
prove that (he used PuTTY 0.56 to produce SSH Keypair). I have correct this in
the guide i uploaded.

Also, i clarifies information that i succedded in creating tunneling, not keys
with PuTTY. I also add my guide here.
Comment 30 lindaw919 2005-03-11 12:23:30 UTC
.
Comment 31 diane 2005-03-11 14:37:47 UTC
Hi Linda,

Would it be possible for you to tell us what the period means, so that we do not
have to guess how to interpret it?

Thank you!
:)
Diane
Comment 32 lindaw919 2005-03-11 20:43:17 UTC
Sorry for the (.) post everyone.  I had a computer issue when filling out the
comment section.  I just wanted to add that I am working on the page and should
have a revision out very soon.  My day job has a way of getting in the way
sometimes. ;-)

Linda
Comment 33 lsuarezpotts 2005-03-14 06:13:49 UTC
adding self so I can track this
louis
Comment 34 lsuarezpotts 2005-03-19 08:46:48 UTC
I added Willy's fine version. Thanks!! I ought to have done it sooner and assigned it to myself.

Lindaw, are you still working on a version? If so, it may not be that necessary....then again, all good 
things can get better :-)

Thanks
Louis
Comment 35 lindaw919 2005-03-19 13:09:38 UTC
Adding Willy's version is not the only fix for this page Louis.  The code isn't
correct and the information and steps need to be updated.  I have been unable to
work on this, as the day job tends to get in the way sometimes.  
Comment 36 willysr 2005-03-20 01:41:39 UTC
True. My guide was only for Windows user, not for all platforms.
The documents should be revised on the structure itself

Linda: Can you point what should be updated. Maybe i can help restructuring the
document?

Thanks
Comment 37 lsuarezpotts 2005-04-03 23:21:35 UTC
reopening.  I'll look at the guide again. From what I can tell, the changes that need to be made are fairly 
minor. If anyone else wants to fix them, be my guest :-)
louis
Comment 38 lindaw919 2005-05-22 12:54:02 UTC
Since Louis reopened this ticket I am listing him as the owner. 
Comment 39 lsuarezpotts 2006-05-31 04:29:33 UTC
what exactly needs to be done to this guide to fix it?

Comment 40 willysr 2006-05-31 04:54:27 UTC
There are some broken link : 
- Using the Desktop Terminal which should be pointed to
http://www.openoffice.org/docs/ddSSHGuide.html#usingterminals
- Content which should be pointed to
http://www.openoffice.org/docs/ddSSHGuide.html#mac

both of the reference wasn't there

Willy
Comment 41 lindaw919 2006-06-01 09:33:46 UTC
Reassigning ticket
Comment 42 diane 2006-06-02 02:37:18 UTC
I'll take it... :)
Comment 43 willysr 2006-06-02 02:47:43 UTC
beside the broken links, what else should we do to update this document?
Comment 44 lsuarezpotts 2006-06-02 17:35:18 UTC
Created attachment 36883 [details]
ssh guide-latest
Comment 45 willysr 2006-06-03 07:22:08 UTC
comments for the latest version uploaded by louis : 
- Use either Cygwin, which we recommend Cygwin, as it works well, although setup
can sometimes be difficult. --> i think it will be best to remove the sentence
"Use either Cygwin, which" and just say, "We recommend Cygwin... "

- But: Your CVSROOT needs to point to your localhost to use the tunnel. --> as
long you are not in a directory of other CVS repository and do not set a
variable named CVSROOT, it will be empty and it's adequate to make a tunnel to OOo. 

- Shouldn't submitting keys should be done first before creating your first
tunnel connection? SInce it will take few hours/days to confirm this. So, people
that have configured their client should have submitted their public key and
their public key has been processed by support team before they can start tunneling.

I suggest that we make another section, "generating public key" before
"submitting your keys" and then followed by "Tunneling". It will a lot cleaner
for new person who don't know about CVS/tunneling (like i did at the beginning) :D
Comment 46 stx123 2011-03-23 16:10:12 UTC
Reset QA Contact to new default
Comment 47 Raphael Bircher 2013-02-08 20:55:36 UTC
This Guide is definitifly no longer needed. close issue