The TMUX Command

Overview

Some TOS management commands such as install, backup, and restore take time to complete and if your connection to the server is lost in the process, you may have to start from the beginning. In some cases, the system may even become unstable. To avoid this situation, we strongly recommend running the tmux command before running such TOS commands. This creates a named background in which to run the command and ensures that the management command will run to completion, even if your network session terminates unexpectedly.

Create a Named tmux Session

[<ADMIN> ~]$ tmux new-session -s <session name>
[<ADMIN> ~]$ <TOS_management_command>

where <session_name> is the name for the tmux session e.g. install, backup, restore).

The session will be listed as <pid>.<session_name> in the list of tmux sessions. Run the management command from within the new tmux session. Exit the tmux session when the management command has completed.

List all tmux Sessions

[<ADMIN> ~]$ tmux list-sessions

Example output:

There is a screen on:
6350.TufinCommands (Attached)
1 Socket in /var/run/screen/S-root.

Detach from the tmux Session

Type Ctrl-b and then 'd'.

Attach a Named tmux Session

You can reconnect to a named tmux session from another network connection on the server.

[<ADMIN> ~]$ tmux attach-session -t <session_name>

Terminate a tmux Session

You must be attached to the tmux session to terminate it.

To terminate the session, type exit at the prompt.