Use short meaningless hostnames
authorPaul Crowley <paul@lshift.net>
Thu, 15 Oct 2009 12:19:35 +0100
changeset 158 713c6cccbc2f
parent 157 bb53f3b9c411
child 159 609d1d4ec773
Use short meaningless hostnames
doc/manual.docbook
--- a/doc/manual.docbook	Thu Oct 15 12:09:00 2009 +0100
+++ b/doc/manual.docbook	Thu Oct 15 12:19:35 2009 +0100
@@ -42,33 +42,33 @@
 <para>
 In what follows, we assume that your username is <systemitem
 class="username">jay</systemitem>, that you usually sit at a machine called
-<systemitem class="systemname">my-workstation</systemitem> and you wish to
+<systemitem class="systemname">spoon</systemitem> and you wish to
 install mercurial-server on <systemitem
-class="systemname">repository-host</systemitem>. We assume that you have created your SSH public key, set up your SSH agent with this key, and that this key gives you access to <systemitem
-class="systemname">repository-host</systemitem>.  
+class="systemname">jeeves</systemitem>. We assume that you have created your SSH public key, set up your SSH agent with this key, and that this key gives you access to <systemitem
+class="systemname">jeeves</systemitem>.  
 </para>
 <para>First install mercurial-server on <systemitem
-class="systemname">repository-host</systemitem>:</para>
-<screen><computeroutput>jay@my-workstation:~$ </computeroutput><userinput>scp mercurial-server_0.6.1_amd64.deb repository-host:</userinput>
+class="systemname">jeeves</systemitem>:</para>
+<screen><computeroutput>jay@spoon:~$ </computeroutput><userinput>scp mercurial-server_0.6.1_amd64.deb jeeves:</userinput>
 <computeroutput>mercurial-server_0.6.1_amd64.deb 100%
-jay@my-workstation:~$ </computeroutput><userinput>ssh -A repository-host</userinput>
-<computeroutput>jay@repository-host:~$ </computeroutput><userinput>sudo dpkg -i mercurial-server_0.6.1_amd64.deb</userinput>
+jay@spoon:~$ </computeroutput><userinput>ssh -A jeeves</userinput>
+<computeroutput>jay@jeeves:~$ </computeroutput><userinput>sudo dpkg -i mercurial-server_0.6.1_amd64.deb</userinput>
 <computeroutput>[sudo] password for jay: 
 Selecting previously deselected package mercurial-server.
 (Reading database ... 144805 files and directories currently installed.)
 Unpacking mercurial-server (from .../mercurial-server_0.6.1_amd64.deb) ...
 Setting up mercurial-server (0.6.1) ...
-jay@repository-host:~$ </computeroutput></screen>
+jay@jeeves:~$ </computeroutput></screen>
 <para>
 mercurial-server is now installed on the repository host.  Next, we need to give you permission to access its repositories.
 </para>
-<screen><computeroutput>jay@repository-host:~$ </computeroutput><userinput>ssh-add -L > my-key</userinput>
-<computeroutput>jay@repository-host:~$ </computeroutput><userinput>sudo mkdir -p /etc/mercurial-server/keys/root/jay</userinput>
-<computeroutput>jay@repository-host:~$ </computeroutput><userinput>sudo cp my-key /etc/mercurial-server/keys/root/jay/my-workstation</userinput>
-<computeroutput>jay@repository-host:~$ </computeroutput><userinput>sudo -u hg /usr/share/mercurial-server/refresh-auth</userinput>
-<computeroutput>jay@repository-host:~$ </computeroutput><userinput>exit</userinput>
-<computeroutput>Connection to repository-host closed.
-jay@my-workstation:~$ </computeroutput></screen>
+<screen><computeroutput>jay@jeeves:~$ </computeroutput><userinput>ssh-add -L > my-key</userinput>
+<computeroutput>jay@jeeves:~$ </computeroutput><userinput>sudo mkdir -p /etc/mercurial-server/keys/root/jay</userinput>
+<computeroutput>jay@jeeves:~$ </computeroutput><userinput>sudo cp my-key /etc/mercurial-server/keys/root/jay/spoon</userinput>
+<computeroutput>jay@jeeves:~$ </computeroutput><userinput>sudo -u hg /usr/share/mercurial-server/refresh-auth</userinput>
+<computeroutput>jay@jeeves:~$ </computeroutput><userinput>exit</userinput>
+<computeroutput>Connection to jeeves closed.
+jay@spoon:~$ </computeroutput></screen>
 <para>
 You can now create repositories on the remote machine and have complete
 read-write access to all of them.
@@ -79,19 +79,19 @@
 <para>
 To store a repository on the server, clone it over.
 </para>
-<screen><computeroutput>jay@my-workstation:~$ </computeroutput><userinput>cd my-mercurial-project</userinput>
-<computeroutput>jay@my-workstation:~/my-mercurial-project$ </computeroutput><userinput>hg clone . ssh://hg@repository-host/repository/name</userinput>
+<screen><computeroutput>jay@spoon:~$ </computeroutput><userinput>cd my-mercurial-project</userinput>
+<computeroutput>jay@spoon:~/my-mercurial-project$ </computeroutput><userinput>hg clone . ssh://hg@jeeves/repository/name</userinput>
 <computeroutput>searching for changes
 remote: adding changesets
 remote: adding manifests
 remote: adding file changes
 remote: added 119 changesets with 284 changes to 61 files
-jay@my-workstation:~/my-mercurial-project$ </computeroutput><userinput>hg pull ssh://hg@repository-host/repository/name</userinput>
-<computeroutput>pulling from ssh://hg@repository-host/repository/name
+jay@spoon:~/my-mercurial-project$ </computeroutput><userinput>hg pull ssh://hg@jeeves/repository/name</userinput>
+<computeroutput>pulling from ssh://hg@jeeves/repository/name
 searching for changes
 no changes found
-<computeroutput>jay@my-workstation:~/my-mercurial-project$ </computeroutput><userinput>cd ..</userinput>
-jay@my-workstation:~$ </computeroutput></screen>
+<computeroutput>jay@spoon:~/my-mercurial-project$ </computeroutput><userinput>cd ..</userinput>
+jay@spoon:~$ </computeroutput></screen>
 </section>
 <section>
 <title>Adding other users</title>
@@ -102,28 +102,28 @@
 <filename>~/sam-key.pub</filename>.  To manage access, you make changes to the special <filename
 class='directory'>hgadmin</filename> repository.
 </para>
-<screen><computeroutput>jay@my-workstation:~$ </computeroutput><userinput>hg clone ssh://hg@repository-host/hgadmin</userinput>
+<screen><computeroutput>jay@spoon:~$ </computeroutput><userinput>hg clone ssh://hg@jeeves/hgadmin</userinput>
 <computeroutput>destination directory: hgadmin
 no changes found
 updating working directory
 0 files updated, 0 files merged, 0 files removed, 0 files unresolved
-jay@my-workstation:~$ </computeroutput><userinput>cd hgadmin</userinput>
-<computeroutput>jay@my-workstation:~/hgadmin$ </computeroutput><userinput>mkdir -p keys/users/sam</userinput>
-<computeroutput>jay@my-workstation:~/hgadmin$ </computeroutput><userinput>cp ~/sam-key.pub keys/users/sam/their-workstation</userinput>
-<computeroutput>jay@my-workstation:~/hgadmin$ </computeroutput><userinput>hg add</userinput>
+jay@spoon:~$ </computeroutput><userinput>cd hgadmin</userinput>
+<computeroutput>jay@spoon:~/hgadmin$ </computeroutput><userinput>mkdir -p keys/users/sam</userinput>
+<computeroutput>jay@spoon:~/hgadmin$ </computeroutput><userinput>cp ~/sam-key.pub keys/users/sam/their-workstation</userinput>
+<computeroutput>jay@spoon:~/hgadmin$ </computeroutput><userinput>hg add</userinput>
 <computeroutput>adding keys/users/sam/their-workstation
-jay@my-workstation:~/hgadmin$ </computeroutput><userinput>hg commit -m "Add Sam's key'"</userinput>
-<computeroutput>jay@my-workstation:~/hgadmin$ </computeroutput><userinput>hg push</userinput>
-<computeroutput>pushing to ssh://hg@repository-host/hgadmin
+jay@spoon:~/hgadmin$ </computeroutput><userinput>hg commit -m "Add Sam's key'"</userinput>
+<computeroutput>jay@spoon:~/hgadmin$ </computeroutput><userinput>hg push</userinput>
+<computeroutput>pushing to ssh://hg@jeeves/hgadmin
 searching for changes
 remote: adding changesets
 remote: adding manifests
 remote: adding file changes
 remote: added 1 changesets with 1 changes to 1 files
-jay@my-workstation:~/hgadmin$ </computeroutput></screen>
+jay@spoon:~/hgadmin$ </computeroutput></screen>
 <para>
 Sam can now read and write to your
-<uri>ssh://hg@repository-host/repository/name</uri> repository.
+<uri>ssh://hg@jeeves/repository/name</uri> repository.
 Most other changes to access control can be made simply by making and
 pushing changes to <filename
 class='directory'>hgadmin</filename>, and you can use Mercurial to
@@ -131,7 +131,7 @@
 </para>
 <para>
 If you prefer, you could give them access by
-logging into <systemitem class="systemname">repository-host</systemitem>,
+logging into <systemitem class="systemname">jeeves</systemitem>,
 putting the key in the right place under <filename
 class='directory'>/etc/mercurial-server/keys</filename>, and re-running
 <userinput>sudo -u hg /usr/share/mercurial-server/refresh-auth</userinput>.