هەموو ڕێبەرەکان

Service Manual

ڕێبەری خزمەتگوزاری بە زمانی تۆ ئامادە دەکرێت. تا تەواو دەبێت، ئەمە وەشانەکەیەتی بە English.

Chapter 1Requirements

This chapter is for whoever prepares a laboratory before CLARUS Prime is installed. It sets out:

  • what is installed in the laboratory, and on which computer;
  • the system, disk and memory each computer needs;
  • what the network, the internet connection, the printers and the analysers need.

It ends with a list to go through before the day of installation.

1.1 What is installed in the laboratory

Every laboratory has one server computer. It holds the database and runs the program that keeps everything. The laboratory may have other computers, of these kinds:

ComputerWhat is on itWhat it does
The serverThe database and the whole programKeeps the laboratory's data, takes the backups, and receives the analysers connected to it
A member computerThe program in its "member" role, with no databaseWorks on the server's database, prints on its own printers, and links the analysers connected to it
Any other device on the networkNothing is installedOpens the program in a browser, once the server is opened to the network's devices

A laboratory with branches has a server in each branch, and the branches are linked as described in Chapter 5: Network, branches and Clarus Link.

The computer an analyser is connected to is called that analyser's station. It may be the server itself, or a member computer beside the analyser (see Chapter 6: Analysers).

1.2 The server

ItemRequiredWhat Setup does
Operating systemWindows 10 (version 1507 or later) or Windows 11Refuses anything older
Architecture64-bit onlyRefuses a 32-bit system
RightsAn administrator accountAsks for them when it starts (see 2.10 Installing without administrator rights)
Free space on drive CAt least 5 GB; 10 GB or more is betterRefuses below 5 GB, warns below 10 GB
Memory4 GB or moreWarns below it, does not refuse
Screen1280 × 720 or moreDoes not check it
Drive DRecommended; see below the tablePuts the program, its data and its backups on it when there is one

The program takes about 1.1 GB once unpacked. The database comes on top of that, and grows as the laboratory works, and then the backups.

1.2.1 Drive D

When the computer has a fixed drive D that can be written to, Setup puts three things on it: the program in D:\Clarus\Clarus_prime, the data in D:\Clarus\Clarus_prime\data, and the backups in D:\Clarus\Clarus_prime-backups. Otherwise it puts the program in C:\Program Files\Clarus\Clarus_prime, the data in C:\ProgramData\Clarus\Clarus_prime\data and the backups in C:\ProgramData\Clarus\Clarus_prime-backups (see Appendix B: Paths).

Drive D keeps the laboratory's data away from the Windows drive, so it survives a reinstallation of Windows. But on many computers it is another part of the same physical disk, so it does not protect against a failed disk. That is why a second copy off the machine is still required (see 8.6 The second copy off the machine).

1.2.2 What comes with the program

Nothing has to be installed on the server before the program. Setup brings with it:

  • a PostgreSQL 18 database, which runs on this computer alone (see Chapter 4: Database and services);
  • a Python environment of the program's own, inside the program's folder.

The program uses the Microsoft Edge browser that comes with Windows to make the PDF files of its reports, so Edge is not removed from the server.

1.2.3 Power and running

  • An uninterruptible power supply (UPS) for the server is strongly recommended. A power cut while the database is being written is the worst thing that can happen to it.
  • The program starts when someone signs in to Windows, not when the computer is switched on. So the server stays signed in; locking it with the lock screen does not stop the program (see 4.3 How the program starts).
  • Windows updates sometimes restart the computer at night. Set their time outside working hours, and sign in again after them.

1.3 Member computers

ItemRequired
Operating systemWindows 10 (1507 or later) or Windows 11, 64-bit
Free space on drive CAt least 2 GB
Memory2 GB or more
NetworkReaches the server on the same local network, or through Clarus Link (see Chapter 5: Network, branches and Clarus Link)

On a member computer the program starts by itself at every sign-in, with no window, so it prints and links its analysers even when nobody has opened it.

1.4 The network

After installation the program listens to the server alone (the address 127.0.0.1). When other computers need it, the server is opened to the network's devices from the program. Then:

  • the program's port is opened to the network, over an encrypted connection (HTTPS);
  • a second port is opened for the member computers;
  • Windows firewall rules are added for Private and Domain networks only. A Public network stays closed on purpose.

The server should have a fixed address on the network, or an address reserved for it in the router, because analysers that connect to the server are set to its address.

All the ports, their defaults and how each is chosen, are in Appendix A: Ports.

1.5 The internet

Daily work does not need the internet: orders, results, printing and the local backup all work without a connection. When there is one, it is used for:

Every connection goes out of the laboratory; nothing comes in from the internet. So no port is opened for the program on the router.

1.6 Printers

PrinterWhat will doNote
ReportsAny A4 printer with a Windows driverThe default paper is A4
Sample labelsA label printer that speaks ZPL or TSPL, or any label printer with a Windows driverThe default label is 50 × 25 mm, at 203 dots per inch
ReceiptsA thermal printer with an 80 mm or 58 mm roll that speaks ESC/POS or has a Windows driverThe default roll is 80 mm

Install each printer's driver in Windows before linking it to the program, and print a test page from Windows itself. The details are in Chapter 7: Printers.

1.7 Analysers

The program reaches an analyser in one of four ways:

WayWhat to prepare
The network (TCP or UDP)The analyser and the server on one network, with a fixed address for the analyser or for the server
A serial cable (RS-232)A serial port on the computer beside the analyser, which becomes the analyser's station
A shared folderA folder the analyser writes its result files to, and the program reads
Manual entryNothing

Before the day of installation, ask the analyser's supplier for its LIS interface manual: the protocol, the kind of connection and the test codes. With that sheet an analyser is linked in minutes (see Chapter 6: Analysers).

1.8 Before the day of installation

  1. The server runs 64-bit Windows 10 or 11, with an administrator account.
  2. Drive C has 10 GB or more free, and drive D (if there is one) has room for the data and the backups.
  3. The server has an uninterruptible power supply.
  4. The laboratory's network is of type "Private" in Windows, and the server has a fixed or reserved address.
  5. The printers' drivers are installed, and each printer has printed a test page from Windows.
  6. The technician holds the analysers' LIS interface manuals, and the cables are there.
  7. A place for the second copy off the machine: an external disk or a folder on another computer on the network (see 8.6 The second copy off the machine).
  8. If the laboratory comes from RealLab: the technician holds a copy of its old database (see Chapter 10: Migration from RealLab).
ڕاپۆرتکردنی هەڵەی وەرگێڕان
WhatsApp بەستەری داگرتن بۆ کۆمپیوتەرەکەت بنێرە