From c5fb44aa2a10f26af71c9d9f4df6fbdc0709e745 Mon Sep 17 00:00:00 2001 From: Steve Sheppard Date: Thu, 16 Sep 2010 12:54:47 -0400 Subject: [PATCH] correct some typos and spelling errors; --- 1.6/admin/ServersideInstallation.xml | 42 ++++++++++++++-------------- 1.6/glossary.xml | 8 +++--- 2 files changed, 25 insertions(+), 25 deletions(-) diff --git a/1.6/admin/ServersideInstallation.xml b/1.6/admin/ServersideInstallation.xml index 0eab0dabca..878a72c940 100644 --- a/1.6/admin/ServersideInstallation.xml +++ b/1.6/admin/ServersideInstallation.xml @@ -200,7 +200,7 @@
Define Public and Private OpenSRF Domains - Define your public and private OpenSRF domains. For security purposes, OpenSRF uses Jabber domains to separate services into public and private realms. Throughout these instructions, we will use the example domains public.localhost for the public domain and private.localhost for the private domain. On a single-server system, the easiest way to define public and private domains is to define separate hostnames by adding entries to the file /etc/hosts. + Define your public and private OpenSRF domains. For security purposes, OpenSRF uses Jabber domains to separate services into public and private realms. Throughout these instructions, we will use the example domains public.localhost for the public domain and private.localhost for the private domain. On a single-server system, the easiest way to define public and private domains is to define separate host names by adding entries to the file /etc/hosts. As the root user, edit the file /etc/hosts and add the following entries for our example domains:
Example public and private domains in /etc/hosts @@ -301,7 +301,7 @@ Edit the file /openils/conf/opensrf_core.xml to change the ejabberd usernames and passwords as follows. - The following example uses common XPath syntax on the left-hand side to indicate the approximage position needing changes within the XML file. + The following example uses common XPath syntax on the left-hand side to indicate the approximate position needing changes within the XML file.
@@ -574,7 +574,7 @@
- PostgreSQL 8.1 is deprecated and will become unsupported in a future release, though existing installations upgrading from Evergreen 1.4 or before will work fine. However, consider upgrading your Postgres soon! + PostgreSQL 8.1 is deprecated and will become unsupported in a future release, though existing installations upgrading from Evergreen 1.4 or before will work fine. However, consider upgrading your PostgreSQL installation soon! @@ -1103,7 +1103,7 @@ - As the opensrf user, generate the Web files needed by the Staff Client and catalogue, and calculate the proximity of locations in the Organizational Unit tree (which allows Holds to work properly). + As the opensrf user, generate the Web files needed by the Staff Client and catalog, and calculate the proximity of locations in the Organizational Unit tree (which allows Holds to work properly). You must do this the first time you start Evergreen, and after making any changes to the library hierarchy in the configuration file config.cgi.
Commands to generate web files @@ -1278,7 +1278,7 @@
Testing the Catalog By default, the OPAC will live at the URL http://my.domain.com/opac/. - Navigate to this URL and the front page of the OPAC should load. There is a basic text entry field with some extra search options. If you have any problems loading this page, check the Apache error logs. If the page loads but does not function correctly, then check for possible javascript errors. We hightly reccommend testing with the Firefox browser because of the helpful javascript debugging tools. + Navigate to this URL and the front page of the OPAC should load. There is a basic text entry field with some extra search options. If you have any problems loading this page, check the Apache error logs. If the page loads but does not function correctly, then check for possible javascript errors. We highty recommend testing with the Firefox browser because of the helpful javascript debugging tools. Assuming that the OPAC is functioning and there is data in your database, you can now perform other simple functional tests (e.g., searching the catalog). ZZZ-REVIEW @@ -1794,7 +1794,7 @@
Define Public and Private OpenSRF Domains - Define your public and private OpenSRF domains. For security purposes, OpenSRF uses Jabber domains to separate services into public and private realms. Throughout these instructions, we will use the example domains public.localhost for the public domain and private.localhost for the private domain. On a single-server system, the easiest way to define public and private domains is to define separate hostnames by adding entries to the file /etc/hosts. + Define your public and private OpenSRF domains. For security purposes, OpenSRF uses Jabber domains to separate services into public and private realms. Throughout these instructions, we will use the example domains public.localhost for the public domain and private.localhost for the private domain. On a single-server system, the easiest way to define public and private domains is to define separate host names by adding entries to the file /etc/hosts. As the root user, edit the file /etc/hosts and add the following entries for our example domains:
Example public and private domains in /etc/hosts @@ -1898,7 +1898,7 @@ This section reviews the process of installing pre-built versions of the Staff Client in various environments.
Installing on <systemitem class="osname">Windows</systemitem> - A standard Windows installer that contains the current version of the Staff Client is available from the downloads section of the Evergreen website at http://www.evergreen-ils.org/downloads.php. Download the staff client installer, then run it. A screen that looks similar to this should appear: + A standard Windows installer that contains the current version of the Staff Client is available from the downloads section of the Evergreen website at http://www.evergreen-ils.org/downloads.php. Download the Staff Client installer, then run it. A screen that looks similar to this should appear:
Running the Staff Client installer @@ -1908,7 +1908,7 @@
Click Next to continue through the guided install process. The install wizard will ask you to agree to the end-user license, ask you where to install the software, ask about where to place icons, and then will install the software on your workstation. - When you run the staff client for the first time, a screen similar to this should appear: + When you run the Staff Client for the first time, a screen similar to this should appear:
Running the Staff Client for the first time @@ -1918,7 +1918,7 @@
First, configure the server you would like to connect to in the Server section. For example, the PINES demo system is demo.gapines.org. After selecting a server, click Re-Test Server. - Because this is the initial run of the staff client, the Workstation section in the upper-right states: Not yet configured for the specified server. The first thing that must be done to the Staff Client on every workstation is to assign it a workstation name. This is covered in . + Because this is the initial run of the Staff Client, the Workstation section in the upper-right states: Not yet configured for the specified server. The first thing that must be done to the Staff Client on every workstation is to assign it a workstation name. This is covered in .
Installing on <systemitem class="osname">Mac OS X</systemitem> @@ -1928,11 +1928,11 @@ Download and install the latest version of xulrunner for Mac OS X. Release notes for the latest version can be found here: http://developer.mozilla.org/en/docs/XULRunner_1.8.0.4_Release_Notes. Note, later versions may not work correctly. Download and install the Mac OS X Installation package for the 1_2_3_0 Version Staff Client from http://evergreen.lib.in.us/opac/extras/files/evergreen_osx_staff_client_1_2_3.zip. - To upgrade to a more recent version of the staff client, you can copy the directory build from a working Windows installation of the desired version of the staff client to your Mac. The required files may be located in a directory like this on the Windows machine: C:\Program Files\Evergreen Staff Client\build. Copy these files into the folder Resources within the Open-ILS package in your Applications directory on the Mac, overwriting files with the same names. + To upgrade to a more recent version of the Staff Client, you can copy the directory build from a working Windows installation of the desired version of the Staff Client to your Mac. The required files may be located in a directory like this on the Windows machine: C:\Program Files\Evergreen Staff Client\build. Copy these files into the folder Resources within the Open-ILS package in your Applications directory on the Mac, overwriting files with the same names. Drag the application's icon into your toolbar for easier access. - When you run the staff client installer, a screen will appear that looks similar to this: + When you run the Staff Client installer, a screen will appear that looks similar to this:
Running the Staff Client installer @@ -1955,7 +1955,7 @@
Running directly using <application>xulrunner</application> - You must install an apropriate version of xulrunner to match the Evergreen version. See the following table for the recommended version of xulrunner: + You must install an appropriate version of xulrunner to match the Evergreen version. See the following table for the recommended version of xulrunner: Evergreen / XULRunner Dependencies @@ -1978,7 +1978,7 @@
If you have issues removing previously installed xulrunner versions see for information on removing previous XULRunner versions. - The staff client data from the directory ./staff_client/build must be placed somewhere on the machine (e.g. ~/Desktop/Evergreen_Staff_Client). Remember to call XULRunner with the full path to the binary, followed by the install command and the path to the client data. See the following command: + The Staff Client data from the directory ./staff_client/build must be placed somewhere on the machine (e.g. ~/Desktop/Evergreen_Staff_Client). Remember to call XULRunner with the full path to the binary, followed by the install command and the path to the client data. See the following command:
Executing <application>xulrunner</application> @@ -2005,7 +2005,7 @@
Creating an APP file: Staff Client & <application>xulrunner</application> Bundled - An APP file is basically a folder. Start with a folder stucture like this: + An APP file is basically a folder. Start with a folder structure like this:
Sample APP file folder structure @@ -2126,7 +2126,7 @@
Building the Staff Client on the Server A Linux Staff Client is automatically built on the server as part of the normal make install process for Evergreen server-side software. - In order to install a compatible Staff Client on another Linux system, just copy the applicable files from the server to that system, or even manually build it on that system. Ensure that the BUILD_ID you choose on the server matches the BUILD_ID for each staff client you use on other systems. + In order to install a compatible Staff Client on another Linux system, just copy the applicable files from the server to that system, or even manually build it on that system. Ensure that the BUILD_ID you choose on the server matches the BUILD_ID for each Staff Client you use on other systems. If you will be using a pre-packaged Windows version on some systems, you may want to choose the BUILD_ID on both server and other versions to match that of the Windows Staff Client. To determine which BUILD_ID is used in an existing Staff Client installation, just click About this Client on the running Staff Client. If you are allowed to make changes on the Evergreen server, another option is to create a symbolic link. In order for a copy of the Staff Client and server to work together, the BUILD_ID must match the name of the directory containing the server components of the Staff Client, or the name of a symbolic link to that directory.
@@ -2158,7 +2158,7 @@ Determine which version is needed - For most end-users, a specific version is required to communicate properly with the Evergreen server. Check with your system admininstrator, IT person, or HelpDesk to determine which Staff Client versions are supported. + For most end-users, a specific version is required to communicate properly with the Evergreen server. Check with your system administrator, IT person, or HelpDesk to determine which Staff Client versions are supported. Next, you need to determine which tag to use when downloading the source code. Tags are markers in the source code to create a snapshot of the code as it existed at a certain time; tags usually point to tested and stable code, or at least a community-recognized release version. To determine which tag to use, browse to http://svn.open-ils.org/trac/ILS/browser. Look in the Visit drop-down box; see the list of Branches and, further down, a list of Tags. You may have to do some guesswork, but it is fairly straightforward to determine which tag to use. If the server is version 1.2.1.4, you will want to use the tag that looks most appropriate. For example, as you look through the tag list, notice the tag named 'rel_1_2_1_4'. This is the tag you need; make a note of it for the next step. @@ -2240,7 +2240,7 @@ (OPTIONAL) Cleaning Up / Creating Shortcuts - The source code download included many files that are needed to build the Staff Client, but are not necessary to run it. You may wish to remove them to save space, or to create a clean directory containing the built staff client that can be copied to other machines. To create a clean "staging" directory in which to place the finished staff client, issue the following commands: + The source code download included many files that are needed to build the Staff Client, but are not necessary to run it. You may wish to remove them to save space, or to create a clean directory containing the built Staff Client that can be copied to other machines. To create a clean "staging" directory in which to place the finished Staff Client, issue the following commands:
Creating a "staging" directory @@ -2591,7 +2591,7 @@
Packaging the Staff Client - Once the Staff Client has been built, you can create several forms of client packages by using some targetted make commands in the Staff Client source directory. + Once the Staff Client has been built, you can create several forms of client packages by using some targeted make commands in the Staff Client source directory. Packaging a Generic Client @@ -2708,7 +2708,7 @@ During a manual Staff Client build process - You will used the variable AUTOUPDATE_HOST=hostname (see above). If you specify just a hostname (such as example.com) then the URL will be a secure URL (such as https://example.com. If you wish to use a non-HTTPS URL then prefix the hostname with "http://" (such as http://example.com). + You will used the variable AUTOUPDATE_HOST=hostname (see above). If you specify just a hostname (such as example.com) then the URL will be a secure URL (such as https://example.com. If you wish to use a non-HTTPS URL then prefix the host name with "http://" (such as http://example.com). If neither option is used then, by default, the Staff Client will not include the automatic update preferences. @@ -2802,7 +2802,7 @@
Multiple Staff Clients This may be confusing if you are not careful, but you can log in to multiple Evergreen servers at the same time, or a single Evergreen server multiple times. In either case you will need to create an additional profile for each additional server or workstation you want to log in as (see previous tip). - Once you have created the profiles, run XULRunner with the option (in addition to or if neeeded). Instead of XULRunner opening a new login window on your existing session it will start a new session instead, which can then be logged in to a different server or workstation ID. + Once you have created the profiles, run XULRunner with the option (in addition to or if needed). Instead of XULRunner opening a new login window on your existing session it will start a new session instead, which can then be logged in to a different server or workstation ID.
@@ -2820,7 +2820,7 @@
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. + 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 traveling 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 insecure 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: diff --git a/1.6/glossary.xml b/1.6/glossary.xml index 3c49e3f122..f80ccb5880 100644 --- a/1.6/glossary.xml +++ b/1.6/glossary.xml @@ -177,13 +177,13 @@ 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. + An encrypted network protocol using public-key cryptography that allows secure communications between systems on an insecure 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. + As used in Evergreen, a method of allowing one or more Staff Clients to communicate with one or more Evergreen servers over an insecure 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. @@ -192,7 +192,7 @@ SSH tunnel - An encrypted data channel existing over an SSH network connection. Used to securely transfer unencrypted data streams over unsecure networks. + An encrypted data channel existing over an SSH network connection. Used to securely transfer unencrypted data streams over insecure networks. @@ -209,7 +209,7 @@ 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. + 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 insecure 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. -- 2.43.2