File Management
---------------

.. index:: diag;diag disk
.. index:: system;system download
.. index:: app;app install
.. index:: app;app list
.. index:: app;app cleanup
.. index:: cluster; cluster upgrade

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 :ref:`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 a mount directory ``media/<iso_file basename>`` on nodes that may have remained after for example
an upgrade, run:

**cluster run all app cleanup**