Come posso configurare il mio dispositivo/servizio SIP2 per funzionare con WMS?
Applies to
- Circolazione WorldShare
Answer
There are several steps to set up a SIP2 device or a service to work with WMS. These are listed below.
If you need help configuring the device, see your user manual or ask your vendor. Unfortunately, OCLC cannot help with how to configure different devices.
OCLC SIP2 configuration only supports IP authentication with SIP2 devices.
** When setting up SIP2 with WMS you will need to give the vendor the following information :
- What Port you will be using 2090 or 2093
- OCLC's Hostname - which will depend on the data centre to be used (see below) - Name is better than IP address.
- Institution Registry ID
- The Location Code is the Branch Registry ID (6 digit number, for example 123456), not the Branch Name or HCL .
- Username /Password if set up for the IP address in Service Configuration
Step 1: Give the device a unique external IP address, or set a username and password for the device if using a switch [NAT].
Ideally, each device or service will have its own, unique external IP address. [or several static IP addresses that can be set] .
The IP address must be an external IPv4 address that can communicate with OCLC's SIP2 servers. It can not start with 192.168 as these are always Internal IP addresses.
WMS's SIP2 will work with Network Address Translation (NAT), where multiple devices will use the same external address, but you must give each device a username and password. This helps WMS identify which device the transactions are coming from. When setting up a service you should set up each branch, with a different username and password, to track the activity of branches.
Step 2: Decide if you will use an encrypted SIP2 connection or an unencrypted one
By default, SIP2 sends its messages as plain text over the internet, meaning they can be easily intercepted and read.
OCLC consiglia di crittografare la connessione SIP2, in modo che tutte le informazioni scambiate siano al sicuro.
- For encrypted connections: you will need to install SSL tunneling software on your device. A suitable candidate is Stunnel. Work with your IT department or vendor to install it. Note that our SIP2 servers do not require an SSL certificate to be added - they use IP Address recognition to authenticate the SIP connection. A program like stunnel is only used to secure the communication between the device and our servers. If using Stunnel it must also be installed on the Vendor end also.
-
Note: OCLC cannot support or assist with troubleshooting issues if you are using stunnel software for SIP2 connections. Work with your IT department or vendor to install and troubleshoot the SSL tunnelling software.
-
- Per le connessioni non crittografate: OCLC chiederà di firmare una rinuncia nel caso in cui le informazioni personali degli utenti vengano intercettate. Contattare il supporto OCLC per discutere di questa opzione.
Step 3: In Service Configuration, configure your SIP2 Connection
Le impostazioni di connessione SIP2 determinano come i dispositivi SIP2 interagiranno con il WMS, inclusi i messaggi accettati, il tipo di informazioni che il WMS invierà e il modo in cui gli elementi devono essere ordinati dalle macchine per lo smistamento automatico.
These settings a configured at the branch level - all SIP2 devices at that branch will use the same settings.
Seguire le istruzioni nella pagina di configurazione SIP2.
Step 4: In Service Configuration, configure the SIP2 IP address
Le impostazioni dell'indirizzo IP SIP2 indicano a WMS da quale indirizzo IP accettare la comunicazione. È anche possibile impostare il nome utente e la password del dispositivo qui.
Note that this username and password is only for SIP2. It is completely separate from WMS accounts.
Seguire le istruzioni nella pagina Indirizzo IP SIP2 .
Step 5: (Optional) In Service Configuration, configure the SIP2 Custom Messages [if setting up a device]
The SIP2 Custom Messages page lets you customise the messages that are displayed to the device's user when certain events happen. It also lets you provide those messages in multiple languages.
Questo passaggio è facoltativo. Se non si modificano i messaggi personalizzati SIP2, verranno utilizzati i messaggi predefiniti.
Seguire le istruzioni nella pagina Messaggi personalizzati SIP2.
Passaggio 6: aggiungere il nome host e la porta per il server SIP2 di OCLC al dispositivo
Please contact OCLC Support to confirm which hostname you should use - it will depend on which data centre your WMS instance has been set up in.
OCLC recommends that you use the hostname rather than the IP address, in case the IP address changes. But the IP address will work if your system does not support hostnames.
L'utilizzo del numero di porta non crittografato o del numero di porta crittografato dipende dall'impostazione del tunneling SSL nel passaggio 2 precedente.
| DATA CENTER | HOSTNAME | INDIRIZZO IP | PORTA NON CRIPTATA | PORTA CRIPTATA |
|---|---|---|---|---|
| Dublin (United States) | sip2.sd00.worldcat.org | 132.174.0.71 | 2090 | 2093 |
| Amsterdam (Europa) | sip2.sd02.worldcat.org | 193.240.184.103 | 2090 | 2093 |
| Sydney Australia | sip2.sd03.worldcat.org | 113.29.23.195 | 2090 | 2093 |
| Toronto Canada | sip2.sd04.worldcat.org | 38.117.94.67 | 2090 | 2093 |
Step 7: To ensure the Date/Timestamp is in the correct format for your region
The Date/Timestamp format is controlled by the language set by the vendor either in a Configuration file or on the device's console itself.
- The language needs to be set for the device , if left unset it will default to Language unknown 000
- If set to English 001 [this will be US English] giving you this format MM/DD/YYYY
- If DD/MM/YYYY date format is required then their language code is required to be set instead.
- Note: if DD/MM/YYYY is required and English is the spoken language you can either leave it set to 000 but ensure you have your Worldcat Registry > Currency and Locale set to the correct locale and language (Australia/English) OR set the language & select 024 [United Kingdom to force the correct date format for region DD/MM/YYYY]
- If Language Code is unknown, it can be found in the 3M Standard Interchange Protocol Manual online [ search for SIP2 Protocol manual]
Or request the required Language code Contact OCLC Support.
Step 8 : Test your device/service
Once the device is configured, test it. Try placing a check-in /check-out or try to connect to the service [for example Overdrive, Kanopy or Hoopla]
If the test doesn't work, contact OCLC Support. To help us troubleshoot the problem, include as much of this information as possible:
- What is the institution's name, OCLC symbol, and branch? (remember, SIP2 is configured by branches)
- Qual è la marca, il modello e l'indirizzo IP esatti del dispositivo SIP2?
- Qual è il messaggio di errore o il problema? È possibile ottenere uno screenshot dal dispositivo?
- Quali sono state le azioni esatte che hanno causato il problema?
- In quale data e ora si è verificato il problema? Questo ci aiuta a controllare i nostri file di registro.
- Esiste un file di registro dal dispositivo SIP2? Inviarcelo.
Page ID
32358
