Client uninstallation

A.V.A.T.A.R offers a PowerShell application for automatic uninstallation.

Preparing the uninstaller

1. Download A.V.A.T.A.R client zip file from GitHub.
   • Click on the button and Download zip.
2. Extract the A.V.A.T.A.R-Client-master.zip file using "Extract or Extract here" selection.

3. Run PowerShell regarding the platform:

   WindowsLinuxmacOS

   1. Select and run PowerShell from "All applications" menu by a right click and "Run as Administrator".

      Warning

      Run PowerShell as Administrator !
      Otherwise, the uninstallation program will generate errors when removing certificates.

   2. Change to A.V.A.T.A.R-Client-master/ directory.

      > cd $env:HOMEPATH\downloads\A.V.A.T.A.R-Client-master
      

      

   1. Open a terminal
   2. Change to downloads/A.V.A.T.A.R-Client-master directory.

      $ cd downloads/A.V.A.T.A.R-Client-master
      $ pwsh
      

      

   1. Open a terminal
   2. Change to downloads/A.V.A.T.A.R-Client-master directory.

      % cd downloads/A.V.A.T.A.R-Client-master
      % pwsh
      

      

Start the uninstaller

Parameters

Below are the mandatory or optional parameters added to the command:

Parameter	Windows	linux	macOS	Comment
-uninstall				mandatory parameter to uninstall the client.
-directory				Windows: mandatory parameter. The uninstallation can be made only from a directory. linux and macOS: optional parameter. The uninstallation is made for a server installed with the -directory parameter in this (user home) directory.
-application				Windows: Not recognized. linux and macOS: optional parameter. The uninstallation is made for the server application installed with the -application parameter (accessible from the applications).
-onlyapp				Optional parameter. Let's take the case of a 2nd client existing on the platform. We want to remove one of these clients. If we use the uninstaller without parameters, all additional applications (Regarding the platform: Sox, ffmpeg, embedded Chrome, HTTPS certificate in the Keystore and the modification of the /etc/hosts file) will also be deleted, and the remaining client will no longer work. This paramater removes only the Server application directory.
-nocertificate				Optional parameter. Same example case as the -onlyapp parameter. All additional applications are removed except the HTTPS certificate only (not removed from the KeyStore).
-nochrome				Optional parameter. Same example case as the -onlyapp parameter. All additional applications are removed except the embedded Chrome application only (located in <user directory>/.cache).
-nosox				Windows: Not recognized. The client uses its embedded Sox application. linux and macOS: optional parameter. Same example case as the -onlyapp parameter. All additional applications are removed except the Sox application only.
-noffmpeg				Windows: Not recognized. The client uses its embedded ffmpeg application. linux and macOS: optional parameter. Same example case as the -onlyapp parameter. All additional applications are removed except the ffmpeg application only.
-nohostName				Windows and linux: No modification made in the hosts file during the installation. macOS: optional parameter. If you want to keep the modification of the /etc/hosts file did during the installation.

Examples

1. Uninstalling the client in a Windows directory:

   ./installer.ps1 -directory "c:\avatar\client" -uninstall
   

2. Uninstalling the client as application

   ./installer.ps1 -application -uninstall
   

3. Uninstalling only the directory installed as application (Except all additional applications)

   ./installer.ps1 -application -uninstall -onlyapp
   

   4. Uninstalling only the directory installed in a folder (Except certificates)

   ./installer.ps1 -application -uninstall --nocertificate 
   

Execution of the uninstaller

Regarding want you want to do, start the installer with its parameters.

WindowsLinuxmacOS

For an installation in the c:\avatar\server directory:

> ./installer.ps1 -directory "c:\avatar\server" -uninstall

For an installation as linux application:

> ./installer.ps1 -application -uninstall

For an installation as macOS application:

> ./installer.ps1 -application -uninstall

You can stop or start the installation by answer "Y" or "N" ("N" by default).

Note

The installer warns you with messages if anything might prevent installation.

WindowsLinuxmacOS

Uninstallation of the A.V.A.T.A.R. server is automatic and requires no additional input.

The client installation continues automatically until removing A.V.A.T.A.R Client step, when you are asked a few questions:

1. Answer "Y" to continue

About Sox and ffmpeg uninstallation

In some cases, the question for the Sox and ffmpeg uninstallation may not be visible, so the program remains on hold.

Check that the program is not frozen, and if so, enter "Y" to continue uninstalling.

The client installation continues automatically until the remove hostname from /etc/hosts file step, when you are asked to remove the hostname manually:

1. Do what it is required as describe in the console.
2. Press Enter key to continue.

End of the uninstallation

At the end of the uninstallation, the following message should appear:

Warning

If this message does not appear, an error has stopped the uninstallation.
You can check the error on the terminal or in the ./server-installer.log file.
Once you've corrected whatever prevented the uninstallation from continuing, you can retrieve the command and run it again.