From 0615f330785f8f03f3e4974e8d3061751a6bb713 Mon Sep 17 00:00:00 2001 From: Steve Sheppard Date: Thu, 16 Sep 2010 12:17:02 -0400 Subject: [PATCH] update the glossary; --- 1.6/admin/ServersideInstallation.xml | 100 +++++++++++++-------------- 1.6/glossary.xml | 39 +++++++++-- 2 files changed, 83 insertions(+), 56 deletions(-) diff --git a/1.6/admin/ServersideInstallation.xml b/1.6/admin/ServersideInstallation.xml index 06cbc1142b..db6897cd0e 100644 --- a/1.6/admin/ServersideInstallation.xml +++ b/1.6/admin/ServersideInstallation.xml @@ -1684,14 +1684,14 @@
Commands to add <systemitem class="username">opensrf</systemitem> user - $ su - opensrf - $ useradd -m -s /bin/bash opensrf - $ passwd opensrf - Enter new UNIX password: ****** - Retype new UNIX password: ****** - passwd: password updated successfully - $ - + $ su - opensrf + $ useradd -m -s /bin/bash opensrf + $ passwd opensrf + Enter new UNIX password: ****** + Retype new UNIX password: ****** + passwd: password updated successfully + $ +
@@ -1700,10 +1700,10 @@
Commands to download and unpack OpenSRF - $ su - opensrf - $ wget http://evergreen-ils.org/downloads/OpenSRF-1.0.7.tar.gz - $ tar zxf OpenSRF-1.0.7.tar.gz - + $ su - opensrf + $ wget http://evergreen-ils.org/downloads/OpenSRF-1.0.7.tar.gz + $ tar zxf OpenSRF-1.0.7.tar.gz +
The new directory /home/opensrf/OpenSRF-1.0.7 will be created.
@@ -1714,11 +1714,11 @@
Commands to install prerequisites for OpenSRF - $ su - root - $ cd /home/opensrf/OpenSRF-1.0.7 - $ make -f src/extras/Makefile.install [DISTRIBUTION] - ... - + $ su - root + $ cd /home/opensrf/OpenSRF-1.0.7 + $ make -f src/extras/Makefile.install [DISTRIBUTION] + ... +
Keywords Targets for <application>make</application> Command @@ -1759,12 +1759,12 @@
Commands to configure OpenSRF - $ su - opensrf - $ cd /home/opensrf/OpenSRF-1.0.7 - $ ./configure --prefix=/openils --sysconfdir=/openils/conf - $ make - ... - + $ su - opensrf + $ cd /home/opensrf/OpenSRF-1.0.7 + $ ./configure --prefix=/openils --sysconfdir=/openils/conf + $ make + ... +
@@ -1773,11 +1773,11 @@
Commands to build, link and install OpenSRF - $ su - opensrf - $ cd /home/opensrf/OpenSRF-1.0.7 - $ make install - ... - + $ su - opensrf + $ cd /home/opensrf/OpenSRF-1.0.7 + $ make install + ... +
@@ -1786,10 +1786,10 @@
Commands to modify system dynamic library path - $ su - root - $ echo "/openils/lib" > /etc/ld.so.conf.d/osrf.conf - $ ldconfig - + $ su - root + $ echo "/openils/lib" > /etc/ld.so.conf.d/osrf.conf + $ ldconfig +
@@ -1799,9 +1799,9 @@
Example public and private domains in /etc/hosts - 127.0.1.2 public.localhost public - 127.0.1.3 private.localhost private - + 127.0.1.2 public.localhost public + 127.0.1.3 private.localhost private +
@@ -1810,8 +1810,8 @@
Commands to change file ownerships - $ chown -R opensrf:opensrf /openils - + $ chown -R opensrf:opensrf /openils +
@@ -1820,19 +1820,19 @@
Commands to stop the <systemitem class="service">ejabberd</systemitem> service - $ /etc/init.d/ejabberd stop - + $ /etc/init.d/ejabberd stop +
If ejabberd reports that it is already stopped, it may have run into a problem starting back at the installation stage. One possible fix is to kill any remaining beam and epmd processes, then edit the configuration file /etc/ejabberd/ejabberd.cfg to hardcode a domain:
Commands to recover from <systemitem class="service">ejabberd</systemitem> errors - $ su - root - $ epmd -kill - $ killall beam; killall beam.smp - $ rm /var/lib/ejabberd/* - $ echo 'ERLANG_NODE=ejabberd@localhost' >> /etc/default/ejabberd - + $ su - root + $ epmd -kill + $ killall beam; killall beam.smp + $ rm /var/lib/ejabberd/* + $ echo 'ERLANG_NODE=ejabberd@localhost' >> /etc/default/ejabberd +
@@ -2810,16 +2810,14 @@
Configuring a Proxy for the Staff Client + By using an SSH proxy and an SSH tunnel, it is possible to provide secure (encrypted) network communications between the Staff Client and one or more Evergreen servers. In addition to providing excellent data security, this method also buffers and caches data travelling to and from the Staff Client and can speed up access to resources on remote Evergreen servers. This is important if your system architecture includes many Staff Clients and Evergreen servers in a busy environment, through network firewalls, or must operate over unsecure networks.
Why Use a Proxy for the Staff Client? There are several reasons for sending network traffic for the Staff Client through an SSH proxy: - - Firewalls may prevent you from reaching the server. This may happen when you are connecting the Staff Client to a test server that should not be available generally, or it may be the result of network design priorities other than ease of use. - - - You may wish to improve security where Staff Client traffic may be susceptible to network eavesdropping. This is especially true when wireless is otherwise the best option for connecting a staff machine to the network. - + Firewalls may prevent you from reaching the server. This may happen when you are connecting the Staff Client to a test server that should not be available generally, or it may be the result of network design priorities other than ease of use. + You may wish to improve security where Staff Client traffic may be susceptible to network eavesdropping. This is especially true when wireless is otherwise the best option for connecting a staff machine to the network. + You may wish to buffer and cache data from remote Evergreen servers to speed up access from Staff Clients.
diff --git a/1.6/glossary.xml b/1.6/glossary.xml index 539122cb33..3c49e3f122 100644 --- a/1.6/glossary.xml +++ b/1.6/glossary.xml @@ -132,9 +132,9 @@ O - Online Public Access Catalog (OPAC) + OPAC - An online database of a library's holdings; used to find resources in their collections; possibly searchable by keyword, title, author, subject or call number. + The "Online Public Access Catalog"; an online database of a library's holdings; used to find resources in their collections; possibly searchable by keyword, title, author, subject or call number. @@ -146,14 +146,14 @@ A popular open-source object-relational database management system that underpins Evergreen software. - - Putty A popular open-source telnet/ssh client for the Windows and Unix platforms. More information is available at http://www.chiark.greenend.org.uk/~sgtatham/putty/. + + Q @@ -174,6 +174,29 @@ A command language interpreter (shell) that executes commands read from the standard input. It is used to test the Open Service Request Framework (OpenSRF). + + SSH + + An encrypted network protocol using public-key cryptography that allows secure communications between systems on an unsecure network. Typically used to access shell accounts but also supports tunneling, forwarding TCP ports and X11 connections, and transferring files. + + + + SSH proxy + + As used in Evergreen, a method of allowing one or more Staff Clients to communicate with one or more Evergreen servers over an unsecure network by sending data through a secure SSH tunnel. It also buffers and caches all data travelling to and from Staff Clients to speed up access to resources on Evergreen servers. + + + + + + + SSH tunnel + + An encrypted data channel existing over an SSH network connection. Used to securely transfer unencrypted data streams over unsecure networks. + + + + SSL Certificate @@ -183,7 +206,13 @@ T - + + tunneling + + A method of encapsulating data provided in one network protocol (the "delivery" protocol), within data in a different network protocol (the "tunneling" protocol). Used to provide a secure path and secure communications through an unsecure or incompatible network. Can be used to bypass firewalls by communicating via a protocol the firewall normally blocks, but "wrapped" inside a protocol that the firewall does not block. + + + U -- 2.43.2