Setting up a VIA Freeze on Chronicle

What you will need

• VIA Freeze running software >= 2.0.0
• Instrument connected to a wired ethernet network.
• Connection tested and passed GE Healthcare connectivity test
• An email with the API Authentication details or a Chronicle admin account for the relevant organization.

Obtain an API Password

1. Copy it from the API authentication details email, or if you have a Chronicle admin account, complete steps 2-4.
2. Log into Chronicle at (https://starter.chronicle.bio) or your organization's custom domain.
3. Navigate to the equipment record that represents the freezer we are trying to set up on Chronicle. If a record for this piece of equipment does not yet exist you will need to create one as described here: Creating instrument records.
4. Take a note of the API password that is displayed for the device.

Enter the API password into the freezer

On the VIA Freeze itself, navigate to the my.Cryochain menu screen (System Manager -> my.Cryochain). my.Cryochain was the original name for Chronicle when it was limited to cryogenic instruments only.

You will be presented with a form to fill in. The my.Cryochain domain box should contain the URL that is used to access the Chronicle instance. An example for demo.cryochain.com is shown below, but many customers will now use pre-gmp.chronicle.bio.

The system will then try and log into the Chronicle instance that was specified. If it is successful, the following pop-up should appear:

The system should now be able to be able to upload runs, synchronise profiles and users and all other features that require a Chronicle instance to work.

Testing

Start a controlled rate freeze using any available protocol. Make sure you clearly describe the run as a test in the comments. Within a few minutes you should see a new data record appear under the instrument in Chronicle with an icon indicating it is in progress. Refreshing the page should show new readings every 30 seconds.

Terminate the run on the VIA Freeze and check to see that the record in Chronicle also completes. If no alarms were triggered it should be marked with a green tick.

Troubleshooting

Request to Given Domain Failed Error

Check the domain name and API key that were entered were correct before trying again. 

Check that the serial number printed on the back of the instrument matches the serial number shown on System Manager -> Service Screens -> Engineering Display and matches the serial number recorded in the Chronicle instrument record.

Re-test the internet connection as described in the GE Healthcare connectivity test

Data appears after a run, but not in real time

The real-time temperature updates for freezers was implemented for all Via Freeze variants in software release 2.2.4. To determine your software version, visitSystem Manager -> Service Screens -> Engineering Display on the VIA Freeze unit and it will be listed under Software Revision.

Software version is not recorded in Chronicle

The reporting of the software version to Chronicle was introduced in the the 2.2.4 release of the VIA Freeze software. If the software version is not visible on the Via Freeze unit's equipment record, it will be running software prior to 2.2.4.