Skip to content
Disguise User Guide

OSC Machine Control setup

The OSCMachineControl device allows restart and shutdown commands to be sent to from an external OSC device.

This topic outlines the setup steps in order to setup the OSCMachineControl device in which is used for remote failover and restore of machines using OSC commands.

Workflow

  1. Create a OSC device from device manager as detailed here.
  2. Create a OSCMachineControl device from device manager.
    • Set the OSC device to an existing OSC device (or create a new one)
    • Configure the input & output message strings to your preferences, or use the default strings.
    • The exports will be written to the output folder of the project folder.
  3. Send values from the OSC device to remotely trigger a machine restart or shutdown.

OSCMachineControl properties

OSC Device

OSC device

The OSC device defines the OSC device in that the commands will be sent to and from.

Input Addresses

Failover address

The failover address causes a machine failover. It accepts a string parameter which is the machine host name that should be failed over.

Restore address

The restore address restores a machine from failover. It accepts a string parameter which is the machine host name that should be restored.

Display query address

The string used to query display resolutions using the machine name.

Output Addresses

Machine resolution address

The string used to define the response to the Display query with 2 integer data with x & y resolution. For example: /d3/showcontrol/display/resolution/myMachine/0/0 1920 1080