summaryrefslogtreecommitdiffstats
path: root/site/trunk/site-publish/documentation-2x/setting-up-ssh.html
blob: 154948bd8d4557233b49200fd62686c5f87bc94f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML>
    <HEAD>
           <META name="description" content="Apache Tuscany">
   <META name="keywords" content="apache, apache tuscany, tuscany, service, services, fabric, soa, service oriented architecture,  sca, service component architecture, das, sdo, csa, ruby, opensource">

        <LINK type="text/css" rel="stylesheet" href="http://tuscany.apache.org/stylesheets/default.css">
        <LINK rel="SHORTCUT ICON" href="https://cwiki.apache.org/confluence/display/TUSCANYxDOCx2x/$images/favicon.ico">   
        <TITLE>Setting up ssh : Apache Tuscany</TITLE>
    <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>

   <STYLE>
    .spacetree * ul {
       padding-left:0px;
       margin-left: 0px;
    }
    .spacetree * li {
       margin-left: 5px;
       padding-left:5px;
    }
   </STYLE>

    <BODY onload="init()">
            <!-- topNav -->
    <TABLE border="0" cellpadding="2" cellspacing="0" width="100%">
      <TR class="topBar">
        <TD align="left" valign="middle" class="topBarDiv" align="left" nowrap="">
          <A href="https://cwiki.apache.org/geronimo"> Home</A> &gt;&nbsp;<A href="index.html" title="Apache Tuscany Docs 2.x">Apache Tuscany Docs 2.x</A>&nbsp;&gt;&nbsp;<A href="index.html" title="Index">Index</A>&nbsp;&gt;&nbsp;<A href="making-releases.html" title="Making Releases">Making Releases</A>&nbsp;&gt;&nbsp;<A href="" title="Setting up ssh">Setting up ssh</A>
        </TD>
        <TD align="right" valign="middle" nowrap="">
          <FORM name="search" action="http://www.google.com/search" method="get">
            <INPUT type="hidden" name="ie" value="UTF-8">
            <INPUT type="hidden" name="oe" value="UTF-8">
            <INPUT type="hidden" name="domains" value="">
            <INPUT type="hidden" name="sitesearch" value="">
            <INPUT type="text" name="q" maxlength="255" value="">        
            <INPUT type="submit" name="btnG" value="Google Search">
          </FORM>
        </TD>
      </TR> 
    </TABLE>

        
    <TABLE border="0" cellpadding="2" cellspacing="0" width="100%">
        <TR class="topBar">
            <TD align="left" valign="middle" class="topBarDiv" nowrap="true" width="100%">
                &nbsp;<A href="index.html" title="Apache Tuscany Docs 2.x">Apache Tuscany Docs 2.x</A>&nbsp;&gt;&nbsp;<A href="index.html" title="Index">Index</A>&nbsp;&gt;&nbsp;<A href="making-releases.html" title="Making Releases">Making Releases</A>&nbsp;&gt;&nbsp;<A href="" title="Setting up ssh">Setting up ssh</A>
            </TD>

            <TD align="right" valign="middle" class="topBarDiv" align="left" nowrap="true">
            <A href="http://tuscany.apache.org/">Tuscany Home</A> | <A href="http://mail-archives.apache.org/mod_mbox/tuscany-user">User List</A> | <A href="http://mail-archives.apache.org/mod_mbox/tuscany-dev">Dev List</A> | <A href="http://issues.apache.org/jira/browse/Tuscany">Issue Tracker</A>&nbsp;&nbsp;
            </TD>
        </TR>
    </TABLE>

        <TABLE border="0" cellpadding="0" width="100%" bgcolor="#FFFFFF">
            <TR>
                <TD valign="top" align="left" width="22%" bgcolor="#F9F9F9" class="noprint">
                        <DIV class="tabletitle">Table of Contents</DIV>
        <DIV class="spacetree">
            
            
            </DIV>
                </TD>
                <TD align="left" valign="top" width="78%">
                        <!-- pageContent -->
    <DIV id="PageContent">
      <DIV class="pageheader" style="padding: 6px 0px 0px 0px;">
        <!-- We'll enable this once we figure out how to access (and save) the logo resource -->
        <!--img src="http://geronimo.apache.org/images/confluence_logo.gif" style="float: left; margin: 4px 4px 4px 10px;" border="0"-->
        <DIV style="margin: 0px 10px 0px 10px" class="smalltext">Apache Tuscany Docs 2.x</DIV>
        <DIV style="margin: 0px 10px 8px 10px" class="pagetitle">Setting up ssh</DIV>

        <DIV class="greynavbar" align="right" style="padding: 2px 10px; margin: 0px;">
<!-- -->         
            <A href="https://cwiki.apache.org/confluence/pages/editpage.action?pageId=21791345">
            <IMG src="http://geronimo.apache.org/images/icons/notep_16.gif" height="16" width="16" border="0" align="absmiddle" title="Edit Page"></A>
            <A href="https://cwiki.apache.org/confluence/pages/editpage.action?pageId=21791345">Edit Page</A>
          &nbsp;
          <A href="https://cwiki.apache.org/confluence/pages/listpages.action?key=TUSCANYxDOCx2x">
            <IMG src="http://geronimo.apache.org/images/icons/browse_space.gif" height="16" width="16" border="0" align="absmiddle" title="Browse Space"></A>
            <A href="https://cwiki.apache.org/confluence/pages/listpages.action?key=TUSCANYxDOCx2x">Browse Space</A>
          &nbsp;
          <A href="https://cwiki.apache.org/confluence/pages/createpage.action?spaceKey=TUSCANYxDOCx2x&fromPageId=21791345">
            <IMG src="http://geronimo.apache.org/images/icons/add_page_16.gif" height="16" width="16" border="0" align="absmiddle" title="Add Page"></A>
          <A href="https://cwiki.apache.org/confluence/pages/createpage.action?spaceKey=TUSCANYxDOCx2x&fromPageId=21791345">Add Page</A>
          &nbsp;
          <A href="https://cwiki.apache.org/confluence/pages/createblogpost.action?spaceKey=TUSCANYxDOCx2x&fromPageId=21791345">
            <IMG src="http://geronimo.apache.org/images/icons/add_blogentry_16.gif" height="16" width="16" border="0" align="absmiddle" title="Add News"></A>
          <A href="https://cwiki.apache.org/confluence/pages/createblogpost.action?spaceKey=TUSCANYxDOCx2x&fromPageId=21791345">Add News</A>
<!-- -->	 
        </DIV>
      </DIV>

      <DIV class="pagecontent">
        <DIV class="wiki-content">
          <TABLE class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><TBODY><TR><TD class="confluenceTd" valign="top" width="15%"><P></P>
<DIV class="error"><SPAN class="error">Unable to render {include}</SPAN> Couldn't find a page to include called: <A href="https://cwiki.apache.org/confluence/pages/createpage.action?spaceKey=TUSCANYxDOCx2x&title=Menus&linkCreation=true&fromPageId=21791345" class="createlink">Menus</A></DIV></TD><TD class="confluenceTd" valign="top" width="85%">

<H3><A name="Settingupssh-Setupmvntoworkwithyourapacheaccount"></A>Setup mvn to work with your apache account</H3>

<H4><A name="Settingupssh-Generateanauthoriseddsa%2Frsakey"></A>Generate an authorised dsa/rsa key</H4>

<P>Logon to <TT>minotaur.apache.org</TT> using your apache id and run:</P>

<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
$ ssh-keygen -t dsa
</PRE>
</DIV></DIV>

<P>Give it some file name eg <TT>mysshkey</TT> and a pass phrase. This should create two files, a private key and a public key (<TT>mysshkey</TT>, <TT>mysshkey.pub</TT>). Copy <TT>mysshkey.pub</TT> to <TT>~/.ssh/authorised_keys</TT>. (you may need to create the .ssh directory), and scp the private key to you local machine.</P>

<P><B>OR</B></P>

<P>Use <TT>ssh-keygen</TT> to create a SSH key locally using shell or cygwin:</P>

<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
$ ssh-keygen -t rsa -b 4096
</PRE>
</DIV></DIV>

<P>The keys will be saved in <TT><SUB>/.ssh/id_dsa</TT> (private) and <TT></SUB>/.ssh/id_dsa.pub</TT> (public).</P>

<P><TT>scp</TT> your SSH public key <TT><SUB>/.ssh/id_dsa.pub</TT> created in last step to <TT></SUB>/id_dsa.pub</TT> on <TT>people.apache.org</TT>. </P>

<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
$ scp ~/.ssh/id_dsa.pub &lt;your userid&gt;@people.apache.org:.
</PRE>
</DIV></DIV>

<P>Login to people.apache.org</P>

<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
$ ssh &lt;your userid&gt;@people.apache.org
</PRE>
</DIV></DIV>

<P>Create a <TT>~/.ssh</TT> folder in your home directory on <TT>people.apache.org</TT> and change its file mode to 700.</P>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
$ mkdir ~/.ssh
$ chmod 700 ~/.ssh
</PRE>
</DIV></DIV>

<P>Move or append <TT><SUB>/id_dsa.pub</TT> to <TT></SUB>/.ssh/authorized_keys</TT> and change its file mode to 600.</P>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
$ mv ~/id_dsa.pub ~/.ssh/authorized_keys
$ chmod 600 ~/.ssh/authorized_keys
</PRE>
</DIV></DIV>

<H4><A name="Settingupssh-UpdateMavensettings"></A>Update Maven settings</H4>

<P>At this point you should be able to ssh into <TT>people.apache.org</TT> without being prompted for a password.</P>

<P>In your maven <TT>settings.xml</TT> file (located in the .m2 folder in your home dir, eg <TT>C:\Documents and Settings\ant\.m2</TT>) add servers for the servers you use and specify you apache id, the location of the ssh key you just scp'd and the pass phrase you used when creating that key, eg:</P>

<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-xml">
<SPAN class="code-tag">&lt;servers&gt;</SPAN>
  <SPAN class="code-tag">&lt;server&gt;</SPAN>
    <SPAN class="code-tag">&lt;id&gt;</SPAN>apache.incubator<SPAN class="code-tag">&lt;/id&gt;</SPAN>
    <SPAN class="code-tag">&lt;username&gt;</SPAN>antelder<SPAN class="code-tag">&lt;/username&gt;</SPAN>
    <SPAN class="code-tag">&lt;privateKey&gt;</SPAN>file-path-of-private-key<SPAN class="code-tag">&lt;/privateKey&gt;</SPAN>
    <SPAN class="code-tag">&lt;passphrase&gt;</SPAN>xxx<SPAN class="code-tag">&lt;/passphrase&gt;</SPAN>
    <SPAN class="code-tag">&lt;directoryPermissions&gt;</SPAN>775<SPAN class="code-tag">&lt;/directoryPermissions&gt;</SPAN>
    <SPAN class="code-tag">&lt;filePermissions&gt;</SPAN>664<SPAN class="code-tag">&lt;/filePermissions&gt;</SPAN>
  <SPAN class="code-tag">&lt;/server&gt;</SPAN>
  <SPAN class="code-tag">&lt;server&gt;</SPAN>
    <SPAN class="code-tag">&lt;id&gt;</SPAN>me.people<SPAN class="code-tag">&lt;/id&gt;</SPAN>
    <SPAN class="code-tag">&lt;username&gt;</SPAN>antelder<SPAN class="code-tag">&lt;/username&gt;</SPAN>
    <SPAN class="code-tag">&lt;privateKey&gt;</SPAN>file-path-of-private-key<SPAN class="code-tag">&lt;/privateKey&gt;</SPAN>
    <SPAN class="code-tag">&lt;passphrase&gt;</SPAN>xxx<SPAN class="code-tag">&lt;/passphrase&gt;</SPAN>
    <SPAN class="code-tag">&lt;directoryPermissions&gt;</SPAN>775<SPAN class="code-tag">&lt;/directoryPermissions&gt;</SPAN>
    <SPAN class="code-tag">&lt;filePermissions&gt;</SPAN>664<SPAN class="code-tag">&lt;/filePermissions&gt;</SPAN>
  <SPAN class="code-tag">&lt;/server&gt;</SPAN>
  <SPAN class="code-tag">&lt;server&gt;</SPAN>
    <SPAN class="code-tag">&lt;id&gt;</SPAN>apache.snapshots<SPAN class="code-tag">&lt;/id&gt;</SPAN>
    <SPAN class="code-tag">&lt;username&gt;</SPAN>antelder<SPAN class="code-tag">&lt;/username&gt;</SPAN>
    <SPAN class="code-tag">&lt;privateKey&gt;</SPAN>file-path-of-private-key<SPAN class="code-tag">&lt;/privateKey&gt;</SPAN>
    <SPAN class="code-tag">&lt;passphrase&gt;</SPAN>xxx<SPAN class="code-tag">&lt;/passphrase&gt;</SPAN>
    <SPAN class="code-tag">&lt;directoryPermissions&gt;</SPAN>775<SPAN class="code-tag">&lt;/directoryPermissions&gt;</SPAN>
    <SPAN class="code-tag">&lt;filePermissions&gt;</SPAN>664<SPAN class="code-tag">&lt;/filePermissions&gt;</SPAN>
  <SPAN class="code-tag">&lt;/server&gt;</SPAN>
  <SPAN class="code-tag">&lt;server&gt;</SPAN>
    <SPAN class="code-tag">&lt;id&gt;</SPAN>apache.rsync<SPAN class="code-tag">&lt;/id&gt;</SPAN>
    <SPAN class="code-tag">&lt;username&gt;</SPAN>antelder<SPAN class="code-tag">&lt;/username&gt;</SPAN>
    <SPAN class="code-tag">&lt;privateKey&gt;</SPAN>file-path-of-private-key<SPAN class="code-tag">&lt;/privateKey&gt;</SPAN>
    <SPAN class="code-tag">&lt;passphrase&gt;</SPAN>xxx<SPAN class="code-tag">&lt;/passphrase&gt;</SPAN>
    <SPAN class="code-tag">&lt;directoryPermissions&gt;</SPAN>775<SPAN class="code-tag">&lt;/directoryPermissions&gt;</SPAN>
    <SPAN class="code-tag">&lt;filePermissions&gt;</SPAN>664<SPAN class="code-tag">&lt;/filePermissions&gt;</SPAN>
  <SPAN class="code-tag">&lt;/server&gt;</SPAN>
<SPAN class="code-tag">&lt;/servers&gt;</SPAN>
</PRE>
</DIV></DIV>

<P>Keep the ssh key and pass phrase safe and secure. Its a good idea to only add the key and passphrase to the settings.xml file while you're actually using it and delete form the file at other times. Also you MUST delete the private ssh key from your Apache directory once you've ftp'd it to your local machine.</P>


</TD></TR></TBODY></TABLE>
        </DIV>

              </DIV>
    </DIV>
                </TD>
            </TR>
        </TABLE>

            <!-- footer -->
    <TABLE border="0" cellpadding="2" cellspacing="0" width="100%">
        <TR>
          <TD align="left" valign="middle" class="footer">
            &nbsp;&nbsp;
            <IMG src="http://static.delicious.com/img/delicious.small.gif" height="10" width="10" alt="Delicious">
            <A href="http://delicious.com/save" onclick="window.open('http://delicious.com/save?v=5&noui&jump=close&url='+encodeURIComponent(location.href)+'&title='+encodeURIComponent(document.title),'delicious','toolbar=no,width=550,height=550'); return false;">Bookmark this on Delicious</A>
            &nbsp;&nbsp;
            <IMG src="http://digg.com/img/badges/16x16-digg-guy.gif" width="16" height="16" alt="Digg!">
            <A href="" onclick="window.open('http://digg.com/submit?url='+encodeURIComponent(location.href)+'&title='+encodeURIComponent(document.title)+'&topic=programming');">Digg this</A>
            <!-- Slicker, but no text
            <script type="text/javascript">
              digg_skin = 'icon';
              digg_window = 'new';
              digg_title = 'Apache Geronimo v2.2 Documentation : Setting up ssh';
              digg_topic = 'programming';
            </script>
            <script src="http://digg.com/tools/diggthis.js" type="text/javascript"></script>
            -->
            &nbsp;&nbsp;
          </TD>
          <TD align="right" valign="middle" class="footer">
            <A href="http://cwiki.apache.org/GMOxPMGT/geronimo-privacy-policy.html">Privacy Policy</A>&nbsp;&nbsp;-&nbsp;&nbsp;
            Copyright &copy; 2003-2010, The Apache Software Foundation, Licensed under <A href="http://www.apache.org/licenses/LICENSE-2.0">ASL 2.0.</A>&nbsp;&nbsp;
          </TD>
        </TR>
    </TABLE> 

    </BODY>
</HTML>