EZProxy: Regular Maintenance
- Cari Davis
- Cassondra Darling
EZProxy Regular Maintenance
log into EZProxy Administration
https://ezproxy.lib.ou.edu/admin
Terminate old sessions:
select View server status under Current Activity
terminate any sessions that weren't started today
click on old Session and then select Terminate session
Host Maintenance:
from the View server status screen, select Host Maintenance link at top
near the bottom of the page select "Remove ## hosts that have not been used in over 30 days (requires EZproxy restart)"
select process
select "restart EZproxy"
Occasionally, there will be a need to remove orphaned hosts. There will be an additional option “Remove ## orphaned host that has !!! database index (requires EZproxy restart)”
select process
select “restart EZProxy”
Checking for Errors:
config errors, connection errors, etc:
Select “View messages.txt”
Scan for anything new or unusual.
tripped security rules (Blocks due to OCLCByteLimit will appear here):
Select “View security rules”
Select “Tripped Security Rules”
Clear blocked user if necessary.
usage limits and suspensions (Suspensions due to limits set in config):
Select “View usage and clear suspensions”
Select user that needs to be cleared and click “Clear Suspension”
unreported missing host errors:
In the “View ezproxy.log lines containing” search, enter “ 599 “
Search for hosts in Discover and LibGuides to see if links are missing proxy prefix
Bad Requests or Unauthorized Access errors:
In the “View ezproxy.log lines containing” search, enter “ 400 “
In the “View ezproxy.log lines containing” search, enter “ 401 “
DB Definition Conflicts:
from the Administration screen, select "Check for database definition conflicts" under Miscellaneous.
go line by line and research the issue
________________________________________________________
EZProxy Server Access:
ssh ezproxy-alpha.prod.nor.internal
config.txt:
sudo -u ezproxy vim /srv/ezproxy/config.txt
user.txt:
sudo -u ezproxy vim /srv/ezproxy/user.txt
to restart ezproxy:
sudo systemctl restart ezproxy
To update the files that the public sees:
navigate to srv/ezproxy/docs/
Manually blocking users:
navigate to user.txt file:
navigate to #manually blocked users section
add this line, inserting the blocked user's 4x4 at the bottom of the list
IfUser 4x4; Deny
Redirecting Concurrently Enrolled students to K-12 Databases page:
navigate to user.txt file
navigate to #concurrently enrolled users section
add this line, inserting the student's 4x4
IfUser 4x4; Banner k12.htm