3rd Party Software Requirements

Tungsten relies on the following software. Each host must use the same version of each tool.

Software	Versions Supported	Notes
perl	-	Check using perl -v
Perl sigtrap module	-	In most cases this should be already available, however some distributions do not ship by default, therefore if required, install using sudo yum install perl-sigtrap or via cpan install sigtrap
rsync	-	Check using rsync --help
Ruby	1.8.7, 1.9.3, or 2.0.0 upwards	JRuby is not supported. See Note 1
Ruby OpenSSL Module	-	Checking using ruby -ropenssl -e 'p "works"'
Ruby Gems	-
Ruby io-console module	-	Install using gem install io-console. See Note 2
Ruby net-ssh module	-	Install using gem install net-ssh. See Note 3
Ruby net-scp module	-	Install using gem install net-scp. See Note 4
GNU tar	-	gtar is required for Solaris due to limitations in the native tar command
Java Runtime Environment	-	For details on Java Requirements see "Java Requirements"
zip	-	zip is required by tpm diag in 6.1.2 and higher
readlink (GNU coreutils)	-	On most platforms, this should be available. readlink, supplied by GNU coreutils, is required by tpm diag

Note 1

Ruby 1.9.1 and 1.9.2 are not supported; these releases remove the execute bit during installation.

Note 2

io-console is only needed for SSH activities, and only needed for Ruby v2.0 and greater.

Note 3

For Ruby 1.8.7 the minimum version of net-ssh is 2.5.2, install using gem install net-ssh -v 2.5.2

For Ruby 2.5.9 and above, ensure you use v6.1.0 of net-ssh, install using gem install --force net-ssh -v 6.1.0

Note 4

For Ruby 1.8.7 the minimum version of net-scp is 1.0.4, install using gem install net-scp -v 1.0.4

For Ruby 2.5.9 and above, ensure you use v4.0.0 of net-scp, install using gem install --force net-scp -v 4.0.0

These tools must be installed, running, and available to all users on each host.

To check the current version for any installed tool, login as the configured user (e.g. tungsten), and execute the command to get the latest version. For example:

• Java

  Run java -version:

  shell> java -version
  openjdk version "1.8.0_102"
  OpenJDK Runtime Environment (build 1.8.0_102-b14)
  OpenJDK 64-Bit Server VM (build 25.102-b14, mixed mode)

  Important

  See "Java Requirements" for more detail on Java requirements and known issues with certain builds.

  On certain environments, a separate tool such as alternatives (RedHat/CentOS) or update-alternatives (Debian/Ubuntu) may need to be used to switch Java versions globally or for individual users. For example, within CentOS:

  shell> alternatives --display

Important

It is recommended to switch off all automated software and operating system update procedures. These can automatically install and restart different services which may be identified as failures by Tungsten. Software and Operating System updates should be handled by following the appropriate maintenance procedures.

It is also recommended to install ntp or a similar time synchronization tool so that each host in the deployment has the same physical time.