File Management#

Each user has a unique home directory in which local files can be stored. It is the user’s responsibility to manage the disk space used by these files.

The command diag disk displays the disk usage. Files in the user’s directory are displayed using the standard ls command, and deleted with rm.

New applications or upgrade packages are uploaded to the platform user using scp or sftp, for example scp <filename> platform@192.168.0.1: on the remote Unix file server. Refer to Network URI Specification for usage. If sftp or ftp is used, the following FTP servers are supported:

  • OpenSSH for Unix or Linux based systems

  • Titan SFTP and Cygwin (which is OpenSSH based) for Windows based systems.

A sftp or scp of files to VOSS Automate must be done in the media directory (/opt/platform/admin/home/media), which is a writable directory.

Alternatively a downloadable URL can be downloaded directly on the VOSS Automate system using system download <URL> and the downloaded file is placed in the platform user’s directory, For example: system download http://myserver/path/myfile.iso

Individual applications are installed using app install <filename>.script. For details, see Installing Applications. A list of available applications and versions is displayed using the command app list.

ISO packages include all the individual packages required for upgrading. Upgrade the system using cluster upgrade <filename>.iso. Alternatively, the ISO package file system can be mounted with the system mount command, and the individual applications are visible under the media directory, and visible via the app list command.

On a running system, the app list command shows versions and details of applications and patches installed or not installed on the node where the command is run, as for example in this output snippet on a web proxy node:

...

mongodb - NoSQL database server
   not installed
   version available: 11.5.2 (2017-09-14 16:16)


nginx - Nginx web server
   latest version 21.1.0 (2021-07-11 16:01) is installed
   other version available: 11.5.2 (2017-09-14 16:15)


services - Platform core services
   latest version 21.1.0 (2021-07-11 16:07) is installed
   other version available: 11.5.2 (2017-09-14 16:15)


selfservice - selfservice install script
   not installed
   version available: 11.5.2 (2017-09-14 16:16)


voss-deviceapi - voss-deviceapi install script
   not installed
   version available: 11.5.2 (2017-09-14 16:16)

...

To remove an empty mount directory media/<iso_file basename> on nodes that may have remained after for example an upgrade, run:

cluster run all app cleanup

This command will also remove any application .script files in media/ that have already been back up.