RI Witness IQ
Installation guide for IT teams
Clinic connector
• The “Clinic Connector” is a piece of software installed at the clinic that allows a
connection between a Witness database and the RI Witness IQ servers in the cloud.
• The software runs as a background service on a computer in the clinic, ideally on a
server or other device which is always on. It can be the same server that hosts the
Witness database, but does not have to be. It has tiny resource requirements as it
does not store any data itself and exchanges only small amounts of data periodically
with RI Witness IQ.
• The installation package for the software should be downloaded from the RI Witness
IQ WebApp
• These steps can be performed by the Clinic Administrator, who can download and
install the software. A Global Administrator (you) can also access these screens, but
the software needs installing on the clinic’s own network.
2
Connect the clinic to RI Witness IQ
1. Log in to RI Witness IQ - https://riwitnessiq.coopersurgical.com/ (you should have received an invite
email with a temporary password)
2. Navigate to Admin -> Connectors and select the relevant clinic from the dropdown
3. Click “Install New Connector” followed by “Download Installation Package”
4. Run the installation package that has downloaded.
5. During install you will be prompted for a code and a location name. The code is the letters that
appeared in the “Install Connector” dialog box. The location name can be any name that can help
to identify the connector software that has been installed. For some set ups there may be multiple
Clinic Connectors installed, and it may be necessary to work out which is which. Also the connector
may be reinstalled elsewhere in the future, or the server could change, so it can be helpful to
identify which particular connector is being used.
6. Once the software is installed, it should connect automatically to RI Witness IQ
Footnotes and references go here. Consult the Reference & Footnote Guidelines on the intranet for best practice guidance. 3
4
5
6
7
8
9
Connecting the clinic’s Witness Database
1. Log in to RI Witness IQ
2. Navigate to Admin -> Devices and select the relevant clinic from the dropdown
3. Click “Add Device”
4. Enter a name to refer to the Witness Database (this can be anything you want)
o Enter the connection details for the Witness Database (the can be found on the installation record)
o You should select the previously installed connector from the dropdown list
o The database connection details are most likely the same details as used in Witness Manager or WorkArea
5. The state of the device connection can be monitored. Initially the device will be in a “NotYetConnected” state.
6. If the device shows “Error” then clicking the (i) info button will show the error details. If you get error ‘SQL Error: Login
failed for user 'Qsys’, please check if Windows authentication is being used instead of SQL authentication (use trusted
connection will be ticked in Witness software). If it is then ‘Network Service’ will need to be added as a user to the
database. Slides 18 onwards detail a way of adding the user.
7. Once the connection details are correct and the device starts talking, the device will show “ReceivingData”, which
indicates that the device is connected but initial data are still being received.
8. When the device shows “UpToDate” then all available data is received. Further data from the Witness Database will be
retrieved as more witness points are performed in the clinic.
10
11
12
13
14
15
16
17
18
Adding user ‘Network Service’ to RI Witness Database
• If the RI Witness server has been set up with Windows authentication
the ‘network service’ user will need to be added to the RI Witness
database with ‘db_datareader’ permissions
• The following slides detail how to add the user directly using Microsoft
SQL Management Studio
• Other ways are possible i.e. active directory
19
1. Open Microsoft SQL Management Studio
2. Navigate to server housing the Witness
database>Databases>RI Witness database>Security>Users
20
3. Right click on Users and select ‘New User’
4. Change User Type to ‘Windows User’
5. Click the two dots next to User name
21
6. Click ‘Advanced’
7. Click ‘Find now’
22
8. Select ‘Network Service’ and click ‘ok’
9. Click ‘OK’ again
23
10. Click ‘membership’ and ‘db_datareader’ and ‘OK’
24
