Page tree
Skip to end of metadata
Go to start of metadata

By default, Unimus uses 10 second timeouts for SSH / Telnet connections.
This means that if your device takes longer than this to establish an SSH session, Unimus will not connect to it.
(controlled by the unimus.core.connect-timeout setting)

During device discovery (more info here), Unimus will establish multiple session to a device to test credentials.
Unimus waits 250ms between session establishments by default.
Especially for older / slower devices, it can be beneficial to increase this inter-connection delay.
(controlled by the unimus.core.inter-connection-delay setting)

For device interaction, Unimus has a 20 second timeout on each command it issues to the device.
For example, if the device takes longer than 20 seconds to respond to a 'show version' command, Unimus will consider this a timeout.
(controlled by the unimus.core.cli-expect-timeout setting)

For backups, this however works differently.
Many devices output backups in 'paged' format.
Each page therefore has its own 20 second timeout.

For devices that do not output backups using paging, Unimus uses a 75 second timeout.
So for devices without paging, they need to output their backup contents under 75 seconds, or Unimus considers the backup operation failed.
(controlled by the unimus.core.max-backup-timeout setting)

All of these values can be adjusted.

On Windows:

For portable:
Create a file named Unimus.l4j.ini in the same directory as the Unimus executable.
Change Unimus in the above file name to exactly match the name of the Unimus executable.

For installer:
Add the below lines to Unimus.l4j.ini in 'C:\Program Files\Unimus\'.

Inside of this configuration file, please add the following lines:

-Dunimus.core.connect-timeout=20000
-Dunimus.core.inter-connection-delay=1000
-Dunimus.core.cli-expect-timeout=30000
-Dunimus.core.max-backup-timeout=120000

Please make sure to place each argument into its own line.
Insert proper values behind each configuration argument (in milliseconds).

Restart Unimus to apply the new timeouts.

On Linux (Debian/Ubuntu):

Edit the contents of /etc/default/unimus.

Add this into the file:

-Dunimus.core.connect-timeout=20000 -Dunimus.core.inter-connection-delay=1000 -Dunimus.core.cli-expect-timeout=30000 -Dunimus.core.max-backup-timeout=120000

Insert proper values behind each configuration argument (in milliseconds).

Restart Unimus to apply the new timeouts.

  • No labels