Silent installation and upgrade
The following are prerequisites for AssureID Sentinel:
-
Microsoft .NET Framework 4.8 - available from Microsoft website, and the Windows/Microsoft Update Services
-
Microsoft Windows Installer (MSI) 4.5 or later - automatically installed with AssureID using setup.exe.
Note: If you are using
AssureID_Sentinel_Install.msi, you must obtain MSI 4.5 directly from Microsoft and install it manually before installing AssureID.
Silent install and upgrade for i-Dentify drivers (exe)
Section titled “Silent install and upgrade for i-Dentify drivers (exe)”You can perform a silent installation or upgrade with this package using the same options documented in the previous section, as shown in the following example:
i-Dentify_Drivers_x.exe /s /v"/qn"Silent install and upgrade for i-Dentify drivers (msi)
Section titled “Silent install and upgrade for i-Dentify drivers (msi)”You can perform a silent installation or upgrade for i-Dentify drivers with this package using the quiet with no user interface command-line switch. You can also specify the path to install the software using the following command-line switch:
INSTALLDIR="<install_folder>"| Silent installation type | Command syntax |
|---|---|
| New silent installation to a custom folder | i-Dentify_Drivers_x64.msi /qn. INSTALLDIR=“C:\My Programs\i-Dentify Drivers” |
| New silent installation or upgrade with digitally signed drivers only | i-Dentify_Drivers_x64.msi /qn. ATS_SIGNEDDRIVERSONLY=1 |
| New silent installation, including the drivers for Gemalto 3M AT9000, 3M AT9000/MK2, 3M Kiosk, 3M KR9000, 3M QS1000 and 3M CR5400, and Thales document readers | i-Dentify_Drivers_x64.msi /qn ADDLOCAL=OEM_3MReaders,Prerequisites |
| New silent installation, including the drivers for ARHungary PRMc, Combo and KioskScan document readers | i-Dentify_Drivers_x64.msi /qn. ADDLOCAL=Prerequisites,. OEM_ARHungaryReaders,clrdrv,gxsddrv,prddrv |
| New silent installation, including the drivers for Desko document readers | i-Dentify_Drivers_x64.msi /qn. ADDLOCAL=Prerequisites,OEM_DeskoReaders |
| New silent installation for SnapShell camera readers | i-Dentify_Drivers_x64.msi /qn. ADDLOCAL=SnapShell_Camera |
| New silent installation for ScanShell Drivers | i-Dentify_Drivers_x64.msi /qn ADDLOCAL=Prerequisites, ScanShell_Scanners,ScanShell800R,ScanShell800NR, ScanShell800DX,ScanShell800DXN, ScanShell2000R,ScanShell2000NR, ScanShell3100D,ScanShell3100DN |
Silent install and upgrade AssureID Sentinel (msi)
Section titled “Silent install and upgrade AssureID Sentinel (msi)”You can use the MSI package to perform a silent installation or upgrade by using the quiet with no user interface command line switch, as shown in the following example:
AssureID_Sentinel_Install.msi /qnNote: The AssureID MSI package requires the Microsoft .NET 4.8 Framework to be installed on the machine prior to installing the software.
You can also specify the following command-line switches:
| Setting | Description |
|---|---|
| INSTALLDIR=“<install_folder>” | <install_folder> is the location where software is installed |
| ATS_LICENSEKEY=“<license_key>” | <license_key> a permanent or evaluation license key |
| ATS_ASSURETECDATA=“<data_folder>” | <data_folder> is the location of the software data |
| ATS_CUSTOMEREXPERIENCE=<1/0> | =<1/0> opt-in/-out of AssureID Customer Experience program |
Note: The ATS_LICENSEKEY option is required for new installations and is optional for upgrades from AssureID 4.x and above.
Note: The ATS_CUSTOMEREXPERIENCE option will default to 1 (opt-in) for new installations. To opt-out of the AssureID Customer Experience program, this option must be specified with a value of 0.
| Silent installation type | Command syntax |
|---|---|
| New silent installation to a custom folder | AssureID_Sentinel_Install.msi /qn. INSTALLDIR=“C:\My Programs\AssureID” ATS_LICENSEKEY=00000-00000-00000-00000-00000-0 |
| New silent installation with opt-in to the AssureID Customer Experience program | AssureID_Sentinel_Install.msi /qn. ATS_LICENSEKEY=00000-00000-00000-00000-00000-0. ATS_CUSTOMEREXPERIENCE=1 |
| Silent upgrade from version 6.x.nnnn to version 6.y.nnnn where: version component y is greater than x with opt-in to the AssureID Customer Experience program | AssureID_Sentinel_Install.msi /qn. ATS_CUSTOMEREXPERIENCE=1 |
The ADDLOCAL command-line switch enables you to perform a custom installation, choosing only specific AssureID features to install. The features available for this package are:
| Feature | Description |
|---|---|
| Applications_RevealID | Installs the Reveal ID application |
| Tools_DocumentSampleCollector | Installs the Document Sample Collector application |
| Tools_IdentifyEmulator | Installs the Emulator application |
| Tools_LibraryCustomization | Installs the Library Customization application |
| Documentation | Installs the product documentation: SDK_Java_Documentation |
| Service_DeviceSupport | Installs device support services: Service_3M. Service_ARHungary. Service_DScan_Authenticator_CF. Service_Desko. Service_ID400 |
| Service_ThirdPartyFiles | Installs third-party services: |
| Service_ThirdPartyFiles | Service_ABBYY: ABBYY_CustomFonts. ABBYY_Engine. ABBYY_LanguageDictionaries. Service_BlueNinja. Service_Desaware. Service_IntelIPP. Service_OVD_Kinegram. Service_OpenSource. Service_RSOCR. Service_SQLCE. Service_SwiftDecoder. Service_TheSoftwareCompany |
| Service_AcuFill | Installs the AcuFill service |
| Service_Assemblies | Installs the assemblies service |
| Service_SDKRuntime | Installs the SDK runtime services: Service_COM_SDK. Service_OVD_Kinegram. Service_NET35_SDK. Service_NET40_SDK |
| Service Configuration | Installs the configuration service |
| Service_CustomerExperience | Installs the Customer Experience service |
| Service_SystemTray | Installs the System Tray service |
| Service_LicenseActivator | Installs the License Activator service |
| SDK | Installs the SDK samples, documentation, required files, and tutorial. SDK_CppDocumentWriterExample. SDK_CppSimpleExample. SDK_CppAdvancedExample. SDK_CsAdvancedExample. SDK_CsDocumentSampleExample. SDK_CsDocumentWriterExample. SDK_CsMultiThreadedExample. SDK_CsSimpleExample. SDK_JavaAdvancedExample. SDK_JavaSimpleExample. SDK_VB6SimpleDemo. SDK_VBNetSimpleExample |
| SDK_RequiredFiles | Installs the required files for the SDK |
| SDK_Tutorial | Installs the SDK Tutorial |
Note: With all custom installations, the Prerequisites, Service and Library options must be specified, and the other features must be typed exactly as shown.
Note: Do not exclude Service_SwiftDecoder from a custom installation. Without it, AssureID Sentinel installs and starts normally, but cannot decode 2D barcodes in software.
| Silent installation type | Command syntax |
|---|---|
| New silent installation, including the Reveal ID and Document Sample Collector applications, with opt-in to the AssureID Customer Experience program | AssureID_Sentinel_Install.msi /qn. ADDLOCAL=Prerequisites,Service,Library,. Applications_RevealID,. Tools_DocumentSampleCollector. ATS_LICENSEKEY=00000-00000-00000-00000-00000-0. ATS_CUSTOMEREXPERIENCE=1 |
| Generate a verbose log file that can be used for diagnosing failed silent installations and upgrades: | AssureID_Sentinel_Install.msi /qn. /l*v “<path>\AssureID_Install.log”. ATS_LICENSEKEY=00000-00000-00000-00000-00000-0 |
| Silent upgrade from version 6.x.nnnn to version 6.y.nnnn where: version component y is greater than x with opt-in to the AssureID Customer Experience program | AssureID_Sentinel_Install.msi /qn. REINSTALL=ALL. REINSTALLMODE=vomus |
Silent install and upgrade AssureID Sentinel (exe)
Section titled “Silent install and upgrade AssureID Sentinel (exe)”You can use the EXE package to perform a silent installation or upgrade using the same options documented in the previous section, as shown in the following examples:
| Silent installation type | Command syntax |
|---|---|
| New silent installation with opt-in to the AssureID Customer Experience program | AssureID_Sentinel_Install.exe /s /v”/qn. ATS_LICENSEKEY=00000-00000-00000-00000-00000-0. ATS_CUSTOMEREXPERIENCE=1” |
| Silent upgrade from version 6.x.nnnn to version 6.y.nnnn where: version component y is greater than x with opt-in to the AssureID Customer Experience program | AssureID_Sentinel_Install.exe /s /v”/qn. ATS_CUSTOMEREXPERIENCE=1” |
| Silent upgrade from version 6.x.nnnn to version 6.y.nnnn (where version component yyyy is greater than xxxx) | AssureID_Sentinel_Install.exe /s /v”/qn. REINSTALL=ALL. REINSTALLMODE=vomus” |
Silently activate an AssureID license
Section titled “Silently activate an AssureID license”You can silently activate the AssureID software using the License Activator application, located in the software installation folder (for example*, C:\Program Files\AssureTec\AssureID\bin)*, as shown in the following usage syntax and examples.
| Silent activation type | Command syntax |
|---|---|
| Silently activate an AssureID license, using the license key provided during the installation | AssureTec.AssureID.LicenseActivator.exe /a /silent |
| Silently activate an AssureID license using a specific license key | AssureTec.AssureID.LicenseActivator.exe /a xxxxx-xxxxx-xxxxx-xxxxx-xxxxx-x /silent |
| Silently create a manual AssureID license activation request file using the license key provided during the installation and save it to the specified directory | AssureTec.AssureID.LicenseActivator.exe /a /m “C:\My AssureID Data” /silent |
| Silently activate AssureID, using the license key provided during the installation, with a manually activated license file | AssureTec.AssureID.LicenseActivator.exe /a. /f “C:\My AssureID Data\License_AssureID…dlsc”. /silent |
| Silently activate an AssureID license with a specific license key, using a locally installed AssureID License Server | AssureTec.AssureID.LicenseActivator.exe. /a /l 192.168.1.1 /silent |
| Silently deactivate an AssureID license | AssureTec.AssureID.LicenseActivator.exe. /d /silent |
| Display the current license key, status, and maintenance expiration on a single line | AssureTec.AssureID.LicenseActivator.exe /i |
| Display all license properties, including type, class, customer name, product edition, activation date, and licensed feature options | AssureTec.AssureID.LicenseActivator.exe /v |
Note: The /i and /v options are read-only and must be used on their own; they cannot be combined with other options. Because the License Activator is a Windows application rather than a console application, its output is only visible if standard output is redirected or shared, for example: Start-Process -Wait -NoNewWindow AssureTec.AssureID.LicenseActivator.exe -ArgumentList ‘/i’