14. Additional Applications & Functionality (v2.5)
ToolsOnAir Preference Pane
Upon the first launch of just:connect a new preference pane called ToolsOnAir Preferences will be installed on the machine.
ToolsOnAir System Profile
The System Profile tab in the TOA preference pane is able to gather and save information related to TOA's software that may be important when diagnosing and fixing issues with the software and/or the system it is running on. Attach a newly saved TOA System Profile every time a new support related ticket has been made in the → ToolsOnAir Online Helpdesk. This will allow the support team to get a good overview over the system without the need for the user to give any additional informations.
Saving a System Profile
- Check the Exclude log files that are older than… option to exclude log files which are outside of the timeframe the issue happened.
- Additionally you can enable the Delete any excluded log files option to delete log files prior to the incident.
- Check the Include Apple System Profile option only on machines which are currently NOT on air! If you are unsure, leave it unchecked.
- Click the Save System Profile button and select a saving destination.
- Add the saved System profile to a ticket in the → ToolsOnAir Online Helpdesk.
DO NOT include the Apple System Profile if you generate the profile on an active playout channel running just:out. Include the Apple System Profile only on machines which are currently not on air.
ToolsOnAir's "Stay Alive"
The Stay Alive tab of the TOA system preference pane can be used to select certain applications that should be automatically started and additionally should be "kept alive" at all times. This helps you to ensure that interruptions to your playout are kept to an absolute minimum.
- In some situations just:out does not start properly after a restart of the Mac, but connects/disconnects every few seconds. This can happen especially when using an SSD drive as startup disk. We recommend to execute the following Terminal command to delay the startup of just:out slightly which will solve this problem: defaults write com.toolsonair.Just-Out preRollSeconds -float 5 (default value 1)
- If just:out still starts too fast, please execute the following Terminal command in addition to the command above: defaults write com.toolsonair.Just-Out alwaysDelayStartup -bool YES. To go back to the default value, please execute the following command: defaults delete com.toolsonair.Just-Out alwaysDelayStartup
- Power Outage at the Playout Center: Once the power returns and the system restarts, the selected applications will automatically start as well. If you select just:out and just:connect from the list of applications then your playout will automatically start.
- Unexpected Application Termination: Should just:out or just:connect crash at any time then they will automatically be restarted by the system and the playout will continue. This is particularly useful if you have a completely automated playout with limited human oversight (for example during the night) as without this function an unexpected termination of just:out or just:connect during such hours would result in complete loss of playout until human intervention.
Only the applications installed on the specific system are available for selection, any other applications in the list will be disabled in the Stay Alive preference pane.
Using Stay Alive
- Make sure that applications you are going to activate in Stay Alive are quitted the moment you activate them. Activating an already started application will start a second instance of it which can cause issues.
- Make sure that the option to "Reopen windows when logging back in" is DEACTIVATED under the Restart and Shut down option of the Apple menu.
Starting an Application using Stay Alive
When an application is enabled for Stay Alive, that application will always be started by the system (first after booting, then automatically whenever the application terminates for any reason).
- Make sure the application you are about to activate is currently not started.
- Activate the checkbox in front of the application to start it immediately and automatically after a restart or a crash.
Optional "Required Path" Selection
When a volume or folder is specified in the Required Path section, the respective application will only be started when the specified volume/folder is mounted/present. This may be useful if you have a NAS, SAN or other types of file systems that must be mounted during system startup that may take some additional time before they are available.
In this case it is important not to start any ToolsOnAir applications that may rely on data from these file systems until the volume is available. By specifying such volumes in Stay Alive you can make sure that any ToolsOnAir applications are not started until the relevant volume/file system is available.
Optional "Scheduled Restart" Selection
It is possible to schedule an automated restart for all applications which are controlled by Stay Alive at a predefined time. Such a restart can be done as a kind of maintenance or to automatically restart just:out after a DST change.
Activate the Scheduled Restart checkbox and define the time and day the selected element should be restarted.
- We recommend to restart just:connect every day and to restart just:out once per week.
- Restarting just:connect will not interrupt the play out but will close all user interfaces which are connected to one of the channels administrated by this just:connect.
- Restarting just:out will interrupt the playout for a few seconds. Use Tools On Air's failover:control and a redundant engine for continuous playout even while restarting the master playout engine.
Stopping an Application using Stay Alive
- Deactivate the checkbox in front of the application to stop it.
- A warning appears which informs you that turning off Stay Alive will end the selected application immediately.
- Click Yes to quit the application immediately.
Updating from Older Versions
- Deactivate all applications in Stay Alive first.
- Do the update.
- Start just:out, just:connect and the UI.
- Proceed with the System Update if asked to do so.
- Quit all TOA applications and activate Stay Alive for the TOA applications you would like to have restarted automatically.
ToolsOnAir Log Analyzer
The TOA Log Analyzer application can be accessed from the just:out help menu and allows the system admin to get a visual representation of the text based log files of the local just:out. In addition to just:out (and therefore playout) relevant informations like dropped frames and restarts of the engine, the log analyzer also offers system related info like free memory or CPU temperatures.
Please → contact us if you require more information.
just:next
Starting with version 2.5 we offer an optional application called just:next. It allows you to execute the Jump To Next command of several just:play channels at the same time. There is a dedicated user manual, check it out → here.
Importing just:out 1.7 Settings
Starting with version 1.8, event devices such as GPI output or video routers are defined for a channel in just:connect. In previous versions this was done in just:out. If you have defined any event devices in a previous version using just:out and you would like to reuse them in v1.8, you will need to import them into the relevant channel in just:connect.
To import previous event devices you must run the TOA System Checker on the machine running just:out v1.7.1 or earlier before you install any of the other applications via drag & drop.
- Navigate to the Library folder in the Finder. Do so by using the Go menu in the Finder while holding the alt-key and selecting Library.
- Go to the Preferences folder and locate the file com.toolsonair.Just_Out.plist.
- Copy this file to the system running just:connect.
- Then – after starting just:connect – select Import just:out 1.7 settings from the Help menu and select the com.toolsonair.Just_Out.plist file you copied before.
- Any event devices from the settings file will then be imported into the selected channel.
Please → contact us in case you need help to save your Events.