Using silent installations

This guide describes how to use the command line for software installation and uninstallation for automation.

When you follow the standard installation instructions for Security World Software, the setup.msi installer runs automatically when you place the Security World Software installation media in the optical disc drive. You then follow the on-screen instructions from the installer to configure your installation.

However, if you run the setup.msi installer from the command line, you have the option to define the components you want to install via the Windows command prompt. This allows your installations to run 'silently', without the need for further interaction with the installer.

Installing using the silent install functionality

The Windows Installer (MSI) has the ability to install software without user interaction. This is useful for automation purposes.

Before starting, please ensure that:

Any previously installed Security World Software is uninstalled
If the directory C:\Program Files\nCipher exists, it is deleted
If the directory C:\ProgramData\nCipher exists, it is renamed or deleted

To install the nShield Software using the silent install functionality:

Log in as Administrator or as a user with local administrator rights.
Place the Security World Software installation media in the optical disc drive. If the installer runs automatically, quit the installer.

Open a Command Prompt, and run the msiexec command:

To perform a full install of the nShield Security World software:
```
msiexec /i <PATH_TO_MSI> /quiet /forcerestart
```
This installs the nShield Security Software to the default installation directory, %PROGRAMFILES%\nCipher\nfast\, and restarts the machine.
To manually select the packages installed with the nShield Security World software, use the ADDLOCAL="<options>" argument and specify the required packages. For example:
```
msiexec /i d:\setup.msi /quiet ADDLOCAL="FeatDrivers,FeatHwsp,FeatCSPs" /forcerestart
```
See the ADDLOCAL options table for a list of available options.

You can generate a verbose install log by adding /l*v <path-to-file.txt> to the command after the /quiet argument. For example:

msiexec /i E:\setup.msi /quiet /l*v C:\users\USER_NAME\installLog.txt> /forcerestart

This creates a log file in the specified directory.

ADDLOCAL options
Option	Description
FeatCSPs	nShield CSP package, includes CAPI and CNG providers and associated tools.
FeatCtd	nShield CipherTools Developer package, includes example programs and libraries.
FeatCtls	nShield Core Tools package, includes diagnostic and performance tools.
FeatDebug	nShield Debug package, includes PDB files.
FeatDocs	nShield Developer Reference, includes documentation of the nCore API.
FeatDrivers	nShield Device Driver package, includes PCIe and USB drivers.
FeatHwsp	nShield Hardware Support package, includes the hardserver.
FeatJava	nShield Java package, includes nShield Java jars.
FeatJavaDev	nShield Java Developer package, includes examples and javadocs.
FeatRACClientTools	nShield Remote Administration Client Tools package, includes nShield Remote Administration Client executables.
FeatRACServer	nShield Remote Administration Server package, includes nShield Remote Administration server.
FeatRnrDrv	nShield Trusted Verification Device drivers.
FeatSnmp	nShield SNMP package, includes SNMP service and tools.

Uninstalling using the silent install functionality

To uninstall the nShield Security Software using the silent uninstall functionality:

Log in as Administrator or as a user with local administrator rights.
Place the Security World Software installation media in the optical disc drive. If the installer runs automatically, quit the installer.
Open a Command Prompt, and run the command:
```
msiexec /x <PATH_TO_MSI> /quiet /forcerestart
```
This uninstalls the nShield Security Software packages and restarts the machine.

To generate a verbose uninstall log, add /l*v <path-to-file.txt> to the command after the /quiet argument. For example:
```
msiexec /x E:\setup.msi /quiet /l*v C:\users\USER_NAME\uninstallLog.txt> /forcerestart
```
This creates a log file in the specified directory.