SPX performs silent installs to Windows systems using the standard SPX installer. Use this command in a script to perform the install:


msiexec /qn /package C:\spx-6.0.1-2.win64.msi IACCEPT=STORAGECRAFT.EULA {KEY=<License Key> NAME=<Name> ORG=<Organization> TYPE=<Type> HOST=<Hostname> PORT= <Port> }









Note: You can add /lvoicewarmupx <path> to the msiexec to generate a log file.

Example: msiexec /qn /lvoicewarmupx C:\InstallLog.txt /package C:\spx-6.0.1-2.win64.msi IACCEPT=STORAGECRAFT.EULA {KEY=<License Key> NAME=<Name> ORG=<Organization> TYPE=<Type> HOST=<Hostname> PORT= <Port> }


Parameters


The silent install command supports these parameters:


If you provide a license key you also have to provide the "Name" and "Organization" fields



















































Parameter

Description

Mandatory
Installer name and path Use the actual name and path to the MSI file> For example, C:\spx-6.0.3.win64.msi YES
IACCEPT=STORAGECRAFT.EULA This confirms the installer read and agrees with the StorageCraft EULA. YES
Key= ShadowProtect SPX license key (for example: 1234-A123-1234-1ABC) NO
NAME= Name of the user Yes, if the command includes the Key= parameter
ORG= Assigns the endpoint to this ShadowControl Organization. Yes, if the command includes the Key= parameter
*TYPE= The type of activation. Options are Default or SOCKET.  No, uses Default type if left blank
†HOST= Name or IP of the Socket Licensing Service Server. Options are FQDN or IP. Yes, if Type is set to SOCKET 
‡PORT= This the port used by the Socket Licensing service.  Currently only 8282 is supported No, Default is set to 8282 if no port is specified. 

*For socket-based licensing, you must specify the Host and you must set Type=socket. If the Type is not specified or set to SOCKET it is assumed to be "default" licensing.
†Host and Port are remembered but ignored if Type is not "socket".
‡Port assumes 8282 if not specified.









Note: After the install completes, run a script to enable remote management on the target systems (see below).

 


Using the Installer under a Local System ("SYSTEM") Account


When deploying SPX using the remote "Agent" running on a system, adjust the install options if the Agent is running under the Local System ("SYSTEM") Account:


msiexec /qn /package C:\Temp\spx-6.0.1-2.win64.msi /Lime "C:\Temp\install.txt" IACCEPT=STORAGECRAFT.EULA

Installing with an SPX license key:


msiexec /qn /package C:\Temp\spx-6.0.1-2.win64.msi /Lime "C:\Temp\install.txt" 
  IACCEPT=STORAGECRAFT.EULA KEY=XXXX-XXXX-XXXX-XXXX NAME=BOB ORG=BOBCORP








Note: Either command causes a forced restart of the system when it completes.


Deployment Using Windows Group Policies (GPO installs)


 Important: Download the GPO version of the SPX installer from the StorageCraft website to perform a Windows Group Policy install. Do not use the standard MSI installer.


When deploying SPX within a Microsoft Active Directory domain, Windows provides the option to use Group Policy (GPO) to install the software. As SPX has a mandatory string "IACCEPT=STORAGECRAFT.EULA" to include with the install, create a matching transform file (*.MST) with this string.









Note: A Transform (*.MST) file can include command line parameters to pass into an MSI installer as part of a software install using Group Policies (GPO).


Example Transform File (.MST)


This example includes acceptance of the StorageCraft EULA, together with license key and related details.



 Caution: Do not save the transform changes back to the original MSI file. Doing so will break the digital signature on the MSI.




Enable Remote Management


After the silent install (either scripted or GPO) SPX requires a separate script to enable remote management of the new SPX systems.


For a 64-bit install, run this command :


C:\Program Files\StorageCraft\spx\spx_cli.exe remote --enable <Port Number>

For a 32-bit install, run this command:


C:\Program Files (x86)\StorageCraft\spx\spx_cli.exe remote --enable <Port Number>

The <Port Number> parameter is optional. Omit it to install using the default port 13581.Otherwise, specify the desired port number.









Note: To log into the system after using this command with a new port number, use the specified port in the SPX login screen. For example, if the new port is Port 1234, enter "1234" in the Port field: