Differences

This shows you the differences between two versions of the page.

--- evergreen-user:configuring_a_proxy_for_the_staff_client [2009/12/08 09:46] – created sylvar
+++ evergreen-user:configuring_a_proxy_for_the_staff_client [2022/02/10 13:34] (current) – external edit 127.0.0.1
@@ Line 23: / Line 23: @@
 For other client operating systems, [[http://inside.mines.edu/~gmurray/HowTo/sshNotes.html|How to set up SSH (for the beginner)]] has excellent advice.
-====== How to Configure the Evergreen Staff Client to Use the SSH Tunnel ======
+====== How to Configure the Evergreen Staff Client to Use the SSH Tunnel - SAFE METHODS ======
+In order to tell the Evergreen Staff Client that all traffic should be sent through the SSH tunnel you just configured you have three options.
+===== Log in without proxy, configure with about:config =====
+If you can log in without the proxy temporarily, use about:config to configure the proxy. You will want to set the following options:
+  * network.proxy.type - Set to 1 (default is system, which bypasses the other configurations)
+  * network.proxy.socks - Set to localhost
+  * network.proxy.socks_port - Set to 9999
+Restart the client and you should be using the proxy.
+===== Edit prefs.js =====
+If you need the proxy to log in you can edit your local preferences. This is per-user. You will need to run the staff client at least once first.
+In your profile folder you should have an AppData or Application Data folder, possibly with a Roaming folder. Inside of that should be a folder like this:
+OpenILS\open_ils_staff_client\Profiles\bf8bsk0o.default
+The last component will vary. Edit the prefs.js file to add the following lines, probably at the end of the file:
+<code>
+pref("network.proxy.type",1);
+pref("network.proxy.socks","localhost");
+pref("network.proxy.socks_port",9999);
+</code>
+===== Create a proxy.js defaults file =====
+If you want a system-wide proxy, regardless of user, you can change the Evergreen defaults. Create a new file named proxy.js in the "defaults/preferences" folder for your client install:
+<file js proxy.js>
+// Proxy configuration
+pref("network.proxy.type",1); // 5 is system, 4 is auto-detect.
+pref("network.proxy.socks","localhost");
+pref("network.proxy.socks_port",9999);
+</file>
+Start and/or restart your client and it should be using the proxy.
+====== How to Configure the Evergreen Staff Client to Use the SSH Tunnel - DANGEROUS METHOD ======
+<HTML>
+<p style="border:2px dashed red;"><span style="font-size: 3em; color: red;">AVOID THIS METHOD AT ALL COSTS</span><br/><span style="font-weight:bold; font-size:1.5em;">This method breaks upon upgrades of XulRunner itself and may cause automatic updates to fail on later versions of Evergreen.</span><br/>I am leaving it here for reference purposes of how not to do this.</p>
+</HTML>
 In order to tell the Evergreen Staff Client that all traffic should be sent through the SSH tunnel you just configured, edit the **''all.js''** file, usually located at ''C:\Program Files\Evergreen Staff Client\greprefs\all.js''.  Search this file for the word **''socks''**.