Installing Applications#
In general, it is not necessary to install single applications on a running system. Instead, the system is upgraded using cluster upgrade as described in the Upgrading Applications section.
The system collects all visible application versions for display using app list.
A screen for the app list command from the command line interface:
platform@cscluster1:~$ app list
selfservice - selfservice install script
latest version 1.5.0 (2015-11-23 17:28) is installed
voss-deviceapi - voss-deviceapi install script
latest version 1.5.0 (2015-11-23 17:26) is installed
cluster - cluster management
latest version 1.5.0 (2015-11-23 17:25) is installed
template_runner - Template Runner
not installed
version available: 1.5.0 (2015-11-23 17:36)
mongodb - no-sql database server
latest version 1.5.0 (2015-11-23 17:24) is installed
support - Diagnostic tools for tech support
latest version 1.5.0 (2015-11-23 17:27) is installed
snmp - snmp management client and server
latest version 1.5.0 (2015-11-23 17:31) is installed
nginx - lightweight web server
latest version 1.5.0 (2015-11-23 17:24) is installed
services - Platform core services
latest version 1.5.0 (2015-11-23 17:26) is installed
platform - Platform install/upgrade
latest version 1.5.0 (2015-11-23 17:26) is installed
nrs - NRS install script
not installed
version available: 1.2.0 (2015-11-23 17:36)
security - Latest system security updates
latest version 1.5.0 (2015-11-23 17:34) is installed
vmware - VMware tools
not installed
version available: 1.5.0 (2015-11-23 17:24)
Each application will display a short description of the application, the version installed, and whether other versions are available.
Additional applications can be downloaded using the instructions detailed under the System Control:Download section.
Single Application Installation#
An application can be installed with app install <application-name>[version:<version>] [delete-on-success <[yes|y]|[no|n]>]
For example,
app install snmp
app install platform version 0.8.1 2014-01-09 00:46
For release 19.1.2 and later; when using the app install command to install
patch scripts that have been added to the media/
directory,
the delete-on-success parameter and yes|no
value can be added to remove or keep the
the patch file in the directory after successful installation.
Example: app install media/patch.script delete-on-success yes
By default, in other words without this parameter, the user is prompted whether to delete or keep the patch script:
Do you want to remove patch after successful completion?
If the --force
parameter is appended to the parameter, no prompt is shown.
Note
This script file removal using the delete-on-success
parameter only applies to patch installation
and not to the installation of delta bundles or other bundles.
The application will automatically start its processes on install. In isolated rare cases, it may be necessary to manually provision the system afterward with cluster provision so that other applications are configured to work with the new application. This is taken care of automatically during the upgrade process described below.
Multiple Application Installation#
More than one application can be installed by adding them as multi_install
parameters:
A file media/<manifest_file>.manifest
can be created to list the applications per line or space-separated,
in the install sequence.
The delete-on-success
parameter is optional.
If the applications are listed on the command line, the sequence of the application parameters in the command is the sequence of the installation.
app multi_install [<manifest_file.manifest>|<app-name_1> <app-name_2> … ] [delete-on-success <[yes|y]|[no|n]>]
Note
It is advisable to make a system backup prior to installation so that a backup restore can be carried out in the case of a failure. Contact VOSS support if needed.
If an application URI is specified as a parameter, it is downloaded.
If an application is already installed, it is skipped with a message.
If an application with more than one version is found in
media/
, the latest version is installed.If an application in the list fails to install, the installation is terminated. Refer to the install logs.
If the
delete-on-success
parameter isyes
, the manifest file and application files are removed after successful installation.
The applications and manifest file can also be bundled into a single archive with extension:
.tar.gz
,.tar
.The command will then be of the format:
app multi_install <archive_file> [delete-on-success <[yes|y]|[no|n]>]
The archive is extracted to the
media/<archive_basename>
directory.Note
If no manifest file is found, the installation exists with an error message
If a file in the manifest is not available, an error message for the entry is displayed.
The same considerations apply as noted with a multiple installation that lists the files on the command line.
If the
delete-on-success
parameter isyes
, themedia/<archive_basename>
directory is removed after successful installation.