evergreen-user:installing_and_running_the_staff_client
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
evergreen-user:installing_and_running_the_staff_client [2009/06/08 20:36] – phasefx | evergreen-user:installing_and_running_the_staff_client [2022/02/10 13:34] – external edit 127.0.0.1 | ||
---|---|---|---|
Line 3: | Line 3: | ||
====== Installing and Running the Staff Client ====== | ====== Installing and Running the Staff Client ====== | ||
+ | NOTE: These instructions are also available in the Evergreen documentation at [[http:// | ||
===== Installing On Windows ===== | ===== Installing On Windows ===== | ||
Line 17: | Line 17: | ||
{{: | {{: | ||
- | 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. \\ \\ | + | First, configure the server you would like to connect to in the **Server** section. 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 every workstation is to assign it a workstation name. This is covered in the [[Workstation Names]] section of the documentation. | 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 every workstation is to assign it a workstation name. This is covered in the [[Workstation Names]] section of the documentation. | ||
Line 27: | Line 27: | ||
===== Installing On Mac ===== | ===== Installing On Mac ===== | ||
- | ==== Option 1 ==== | + | ==== Evergreen Indiana Pkg file [Evergreen v1.2.3.0] |
- Download and install the [[http:// | - Download and install the [[http:// | ||
- Download and install the Mac Installation package for the 1_2_3_0 Version Staff Client from [[http:// | - Download and install the Mac Installation package for the 1_2_3_0 Version Staff Client from [[http:// | ||
Line 35: | Line 35: | ||
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: | ||
- | {{http:// | + | {{http:// |
Click continue, accept the license, then finish the installation. The application will be located at the destination you selected during installation. You will then be able to drag the application into your toolbar for easier access. | Click continue, accept the license, then finish the installation. The application will be located at the destination you selected during installation. You will then be able to drag the application into your toolbar for easier access. | ||
- | {{http:// | + | {{http:// |
- | ==== Option 2 ==== | + | ==== Running directly using XULRunner |
- | Follow these next steps if you choose to build the client. | + | **Install recommended XULRunner Version** |
- | XULRunner | + | Evergreen 1.2.x.x - [[http:// |
- | The [[http:// | + | Evergreen 1.4.x.x - [[http:// |
- | There seems to be issues with the community provided package (currently 1.8.1.3), although ver 1.8.0.4 has been successfully used. | + | |
- | The staff client data from the ./ | + | Evergreen 1.6.x.x - [[https:// |
+ | |||
+ | *Note: If you have issues removing previously installed XULRunner versions see after this entry. | ||
+ | |||
+ | The staff client data from the ./ | ||
XULRunner must be called via the full path to the binary, followed by the install command and the path to the client data. | XULRunner must be called via the full path to the binary, followed by the install command and the path to the client data. | ||
Line 59: | Line 62: | ||
A folder named OpenILS under / | A folder named OpenILS under / | ||
+ | ==== Removing previously installed XULRunner versions ==== | ||
- | If you already have ver. 1.8.1.3 | + | If you already have a newer version |
+ | In addition, you may also need to remove the previous xulrunner-ver-mak.pkg file from / | ||
+ | If there is no xulrunner-ver-mak.pkg file in / | ||
+ | |||
+ | *Note: If we install a newer version over a previous (older) install the older one is not removed but the symlinks get changed to the newer one. | ||
+ | |||
+ | **Flush Receiptdb file:** | ||
+ | |||
+ | First we get the package identifier: | ||
+ | <code bash> | ||
+ | sudo pkgutil --pkgs > / | ||
+ | </ | ||
+ | Since I wanted to purge/ | ||
+ | <code bash> | ||
+ | sudo pkgutil --forget org.mozilla.xulrunner | ||
+ | </ | ||
+ | http:// | ||
+ | |||
+ | Note: At first I thought after deleting the folder XUL.framework I had to also edit InstallHistory.plist in / | ||
+ | |||
+ | ==== Creating an APP file - Evergreen Staff Client & XULRunner Bundled ==== | ||
+ | |||
+ | - An app file is basically a folder. | ||
+ | * Evergreen.app | ||
+ | * Contents | ||
+ | * Frameworks | ||
+ | * Resources | ||
+ | * MacOS | ||
+ | eg: | ||
+ | <code sh> | ||
+ | mkdir -p Evergreen.app/ | ||
+ | mkdir -p Evergreen.app/ | ||
+ | mkdir -p Evergreen.app/ | ||
+ | </ | ||
+ | |||
+ | - Create a new file in Evergreen.app/ | ||
+ | <code xml> | ||
+ | <?xml version=" | ||
+ | < | ||
+ | <plist version=" | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | - Download and install an appropriate Mac OS package of XULRunner from the Mozilla website (See above for recommendations) | ||
+ | - Make a copy of / | ||
+ | * Evergreen.app/ | ||
+ | * Contents/ | ||
+ | * Frameworks/ | ||
+ | * XUL.Framework/ | ||
+ | * Versions/ | ||
+ | * Current -> 1.9.1.3 (symlink) | ||
+ | * 1.9.1.3/ | ||
+ | * XUL -> Versions/ | ||
+ | * libxpcom.dylib -> Versions/ | ||
+ | * xulrunner-bin -> Versions/ | ||
+ | - copy XUL.Framework/ | ||
+ | - Make Evergreen.app/ | ||
+ | * Evergreen.app/ | ||
+ | * Contents/ | ||
+ | * Resources/ | ||
+ | * BUILD_ID | ||
+ | * application.ini | ||
+ | * chrome/ | ||
+ | * components/ | ||
+ | * etc. | ||
+ | - Put a Mac format icon file named Evergreen.icns in Resources | ||
+ | |||
+ | ==== WineBottler ==== | ||
+ | |||
+ | - download and install WineBottler: | ||
+ | - open the application " | ||
+ | - select " | ||
+ | - select the desired windows installer as your " | ||
+ | - set the " | ||
+ | - click " | ||
+ | - when you get to the end **UNCHECK** the option to "run Evergreen now" and complete the installation | ||
+ | - WineBottler should then pop up a dialog for you to select an executable -- select xulrunner.exe | ||
===== Installing On Linux ===== | ===== Installing On Linux ===== | ||
+ | ====Quick Upgrade of the Staff Client==== | ||
+ | A Linux staff client is built on the server as part of the initial installation of Evergreen. | ||
+ | To upgrade the client copy the folder containing the new client on to your workstation from the server. | ||
+ | < | ||
+ | scp -r build user@client.linux.machine: | ||
+ | |||
+ | It can be run from the build directory by: | ||
+ | < | ||
+ | |||
====Building the Staff Client on the Server==== | ====Building the Staff Client on the Server==== | ||
A Linux staff client is built on the server as part of the initial installation of Evergreen, using the following steps: | A Linux staff client is built on the server as part of the initial installation of Evergreen, using the following steps: | ||
Line 107: | Line 218: | ||
Next, you'll 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. | Next, you'll 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. Look in the " | + | To determine which tag to use, browse to http://git.evergreen-ils.org/? |
==2b: Download the Source Code.== | ==2b: Download the Source Code.== | ||
+ | |||
Now, open a terminal (command-line prompt) and navigate to the directory in which you wish to download the staff client. | Now, open a terminal (command-line prompt) and navigate to the directory in which you wish to download the staff client. | ||
< | < | ||
- | svn co svn://svn.open-ils.org/ILS/ | + | git clone git://git.evergreen-ils.org/Evergreen.git |
+ | git checkout -b tmp_branch origin/rel_1_2_1 # or git checkout rel_1_2_1 | ||
</ | </ | ||
Note that you'll want to change " | Note that you'll want to change " | ||
Line 143: | Line 255: | ||
< | < | ||
- | svn co svn://svn.open-ils.org/ILS/ | + | git clone git://git.evergreen-ils.org/Evergreen.git |
- | cd rel_1_4_0_4 | + | git checkout |
./ | ./ | ||
./configure --prefix=/ | ./configure --prefix=/ | ||
Line 205: | Line 317: | ||
Staff Client", | Staff Client", | ||
+ | ===== Running the Staff Client with an SSH Tunnel as a SOCKS 5 Proxy ===== | ||
+ | The Evergreen Staff Client can use an SSH tunnel as a SOCKS 5 proxy. |