Once you have opened up either the SIP
OR SIP2
ports to be accessible from outside you can do some testing
via telnet
. In the following tests:
$server
with your server hostname (or localhost
if you want to
skip testing external access for now);
$username
, $password
, and $instid
with the corresponding values
in the <accounts>
section of your SIP configuration file;
$user_barcode
and $user_password
variables with the values
for a valid user.
$item_barcode
variable with the values for a valid item.
Start by testing your ability to log into the SIP server:
We are using 6001 here which is associated with SIP2
as per our configuration.
$ telnet $server 6001 Connected to $server. Escape character is '^]'. 9300CN$username|CO$password|CP$instid
If successful, the SIP server returns a 941
result. A result of 940
,
however, indicates an unsuccessful login attempt. Check the <accounts>
section of your SIP configuration and try again.
Once you have logged in successfully, replace the variables in the following line and paste it into the telnet session:
2300120080623 172148AO$instid|AA$user_barcode|AC$password|AD$user_password
If successful, the SIP server returns the patron information for $user_barcode, similar to the following:
24 Y 00120100113 170738AEFirstName MiddleName LastName|AA$user_barcode|BLY|CQY |BHUSD|BV0.00|AFOK|AO$instid|
The response declares it is a valid patron BLY with a valid password CQY and shows the user’s $name
.
To test the SIP server’s item information response, issue the following request:
1700120080623 172148AO$instid|AB$item_barcode|AC$password
If successful, the SIP server returns the item information for $item_barcode, similar to the following:
1803020120160923 190132AB30007003601852|AJRégion de Kamouraska|CK001|AQOSUL|APOSUL|BHCAD |BV0.00|BGOSUL|CSCA2 PQ NR46 73R
The response declares it is a valid item, with the title, owning library, permanent and current locations, and call number.