From: Steve Sheppard Date: Fri, 1 Oct 2010 15:33:18 +0000 (-0400) Subject: new file; X-Git-Url: https://old-git.evergreen-ils.org/?a=commitdiff_plain;h=e21cce24ae1586df8200dce17b52ed2c53b49839;p=contrib%2FConifer.git new file; --- diff --git a/1.6/admin/StaffclientInstallation.xml b/1.6/admin/StaffclientInstallation.xml index 9606604bea..a66da53d64 100644 --- a/1.6/admin/StaffclientInstallation.xml +++ b/1.6/admin/StaffclientInstallation.xml @@ -3,7 +3,7 @@
Installing a Pre-Built Staff Client You can install the Staff Client from pre-built images and packages without actually having to first build it. Pre-built packages are currently available for Windows, MAC OS X, and Linux. If you need to manually build the Staff Client, see the section "Manually Building the Staff Client". -
+ Installing on Windows A standard Microsoft 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:
@@ -26,8 +26,8 @@
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 the Re-Test Server button. 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 the section "Assigning Workstation Names". -
-
+ + Installing on Mac OS X A Mac package that contains the current version of the Staff Client is available for use with XULRunner.
@@ -205,8 +205,8 @@ Put a Mac format icon file named Evergreen.icns in Resources.
-
-
+ + Installing on Linux
Quick Upgrade of the Staff Client @@ -430,8 +430,8 @@ Running the Staff Client over an SSH Tunnel The Staff Client can use an SSH tunnel as a SOCKS 5 proxy. For more details, see the section Configuring a Proxy for the Staff Client.
-
-
+ + Assigning Workstation Names The Staff Client must be assigned to a library and given a unique name before it will connect fully to the Evergreen server. The only restriction is that the workstation's name must be unique within the assigned library. Make sure to select a workstation name that you will remember later, and reflects the role, purpose, and/or location of a particular computer. These names will come up later in statistical reporting, and can also be handy when troubleshooting.
@@ -462,12 +462,12 @@
You are now ready to log into the Staff Client for the first time. Type in your password again, and hit Login. -
+
Manually Building the Staff Client The Staff Client is automatically built by default as part of the normal make install process for Evergreen server-side software. See the section "Compile, Link and Install Evergreen" to review details related to building the Staff Client in the final compile/link/install phase of the default Evergreen build process. -
+ Building the Staff Client You can also manually build the Staff Client by using the make utility in the Staff Client source directory (e.g., the directory /home/opensrf/Evergreen-ILS-1.6.0.x/Open-ILS/xul/staff_client for the current Evergreen version). There are a number of possible options to manually build special versions of the Staff Client on a Linux system. Following is a list of environment variables that can be passed to make to influence the manual build process:
@@ -547,8 +547,8 @@
-
-
+ + Advanced Build Options In addition to the basic options listed above, there are a number of advanced options for building the Staff Client. Most are target names for the make utility and require that you build the Staff Client from its source directory. See the following table for a list of possible make target keywords: @@ -679,8 +679,8 @@ For more information on Automatic Updates, see the section "Automatic Updates". - -
+ + Installing and Activating a Manually Built Staff Client The Staff Client is automatically built, installed and activated as part of the normal make install process for Evergreen server-side software. However, if you manually build the Staff Client, then you need to take additional steps to properly install and activate it. You also have the option of installing the Staff Client on the same machine it was built on, or on a different machine. Assuming you have already built the Staff Client, and that your installation is in the directory /openils/var/web/xul, as the opensrf user, change directory to the Staff Client source directory, then execute the following commands: @@ -693,8 +693,8 @@ $ cp -R build/server "/openils/var/web/xul/$(cat build/BUILD_ID)" -
-
+ + 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. @@ -774,8 +774,8 @@ -
-
+ + Staff Client Automatic Updates It is possible to set up support for automatic Staff Client updates, either during the normal Evergreen server-side build process, or by manually building the Staff Client with certain special options.
@@ -885,8 +885,8 @@
-
-
+ + Other tips
Multiple workstations on one install @@ -909,7 +909,7 @@ 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 "-no-remote" (in addition to "-profilemanger" or "-P" 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.
-
+
Running the Staff Client @@ -925,7 +925,7 @@
Configuring a Proxy for the Staff Client -
+ Why Use a Proxy for the Staff Client? There are several reasons for sending network traffic for the Staff Client through an SSH proxy: @@ -936,8 +936,8 @@ 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. -
-
+ + Setting Up an SSH Tunnel You will need a server that allows you to log in via SSH and has network access to the Evergreen server you want to reach. You will use your username and password for that SSH server to set up a tunnel. For Windows users, one good solution is the open-source utility PuTTY, a free telnet/SSH client]]. When setting up a PuTTY session: @@ -957,8 +957,8 @@ Use the menu on the left to go back to "Session", and enter the host name of the SSH server. A window will open up so that you can enter your username and password. Once you are logged in, the tunnel is open. -
-
+ + Configuring the Staff Client to Use the SSH Tunnel In order to tell the Staff Client that all traffic should be sent through the SSH tunnel just configured, you must edit the file C:\Program Files\Evergreen Staff Client\greprefs\all.js. Search this file for the word socks to find the appropriate section for the following changes.
@@ -983,6 +983,6 @@
If everything is working correctly, you should now be able to run the Staff Client and all its data will be sent encrypted through the SSH tunnel you have just configured. -
+