Installation Guide (Harlequin Direct)

Memory Recommendations

For a RIP Server, it is advisable to have a memory capacity of 128 GB as the recommended configuration, with a minimum requirement of 64 GB. These specifications are applicable to servers running both Linux and Windows operating systems.

Linux

Supported Versions

Ubuntu 20.04
Ubuntu 22.04
CentOS 7.4

Installation

To install a Linux RIP Server you will need a distribution, the filename following this format: HarlequinDirect_<distro>_<build number>.zip

Installing new RIP Server software will overwrite all files in the Rip Server SPCHD folder.

Exit the Smart Printer Controller connected to the RIP Server before starting this process

Log onto the RIP Server PC and change directory to the installation folder, this is usually:
```
$ cd /srv/samba/SPCHD
```

Stop all HarlequinDirect processes that may be running:

```
$ killall -9 "HarlequinDirect"
```
```
$ killall -9 "ScreenProDirect"
```
```
$ killall -9 "clrip"
```
```
$ killall -9 "SmartPcRemote"
```

Remove the existing RIP Server
1. Delete everything in this and sub-folders
  
  This will delete everything. Check and double check that the operation is executed in the correct folder (typically /srv/samba/SPCHD).
  
  This may require elevated permission to be run (use sudo), take extra care if doing this.
```
$ rm -rf *
```
Copy the new release to this folder.
1. This can be done a number of ways depending on the system, sometimes it's easiest to copy it to the RIP Server share that is used by SPC: e.g. \\<RIPServer_IP>\SPCHD
Unpack the release.
```
$ unzip HarlequinDirect_*.zip
```
$ tar -xvf HarlequinDirect.tar.gz
.Change permission to allow Smart Print Controller to update config files
```
$ sudo chmod -R 0777 * 
```
Start the RIP Server.
```
$ ./Start.sh
```

Additional Output Plugins

After installing additional output plugins, it is recommend that the step to change permissions is repeated.

$ sudo chmod -R 0777 *

Windows

Supported Versions

Windows 10 Pro
Windows 11 Pro
Windows Server 2016
Windows Server 2019
Windows Server 2022

Installation

The Smart Print Controller installer will automatically install Harlequin Direct.
If Smart Printer Controller and HarlequinDirect are used on the same PC it is better to use the Install and Uninstall of Smart Print Controller to manage HarlequinDirect, this will ensure they are always compatible.

There are two way to install HarlequinDirect for Windows, an Installer and a zip file.

Installer
This is the easiest option, it will create the share required, but gives no control over the share name used.
ZIP Archive
This option gives full control over the installation, but requires the user to create the share.

We strongly recommend that one method is chosen to manage HarlequinDirect, switching may confuse 'Add/Remove Programs' and result in an unstable system.

HarlequinDirect for Windows requires both Microsoft Visual C++ runtime 2013 and 2015 to be installed.

Installer

Unpack the archive (HarlequinDirect_Windows_Setup_<build number>.zip
Run HarlequinDirectSetup.exe

This will Install HarlequinDirect to a folder called C:\SPCHD, and create the share required by Smart Print Controller.

To uninstall, use the Add/Remove Programs option in Windows

ZIP Archive

Create a folder in C:\ - the default name is SPCHD
Enable sharing on the folder
The process may differ, below are some guidelines
1. Select Properties -> Sharing
2. Click Share
3. Select Everyone, Add
4. On the PC hosting Smart Print Controller, check that the share can be seen and it is possible to create (and delete) a new file in the share
Unzip to archive to the share folder
This will result in several folder, dlls and exes appearing in SPCHD
If any of the components of HarlequinDirect are running it may not be possible to overwrite them with new versions.
In this situation the task manager is used to ensure all components are stopped.
- HarlequinDirect.exe
- MeteorRouter.exe
- SmartPcRemote.exe
- ScreenProDirect.exe
- clrip.exe