Installation via Command Line¶
SpaceObServer DataCentral can also be installed using a command line for an unattended installation or via remote call.
Command Line Options¶
For an unattended installation or rollout, different command line parameters are available that can be passed to the setup:
Parameters |
Description |
---|---|
/SILENT /SUPPRESSMSGBOXES |
Installs the software with the default values without user interaction. The installation progress is displayed. |
/VERYSILENT /SUPPRESSMSGBOXES |
Installs the software without user interaction with the default values without any visual feedback. |
/PASSWORD=InstallKey |
Registers the software with the specified installation key. |
/DIR=”x:dirname” |
Specifies the path where SpaceObServer should be installed. |
/SERVICEUSER “<username>” |
Passes the application the name of the user account to be used for scanning and indexing. If no input is provided, the default system account will be used (not recommended). |
/SERVICEPWD “<password>” |
Passes the application the password of the user account to be used for scanning and indexing. Note: Use this parameter only in combination with /SERVICEUSER “<user name>”. |
/ENABLEINDEXSERVER |
Use this parameter to enable central indexing (DataCentral service). With this option, you can use UltraSearch to search this central index. This allows multiple devices to share a single common search index. |
/USESELFSIGNEDCERTIFICATE |
Use this parameter to create and use a new self-signed certificate (PFX file). Note: If no certificate parameters are specified, this parameter is the default option. |
/INDEXSERVERCERTIFICATE “<full path to pfx-file>” |
Specifies the full path to a certificate file (PFX file) that is already installed and will be used for encrypting communication with the DataCentral server. |
/INDEXSERVERCERTIFICATEPASSWORD “<password of pfx-file>“ |
Passes the application the name of the user account to be used for scanning and indexing. If no input is provided, the default system account will be used (not recommended). |
Unattended Installation using a PowerShell Script¶
Using the options above SpaceObServer can be distributed automatically. For example, the following PowerShell script copies the Setup.exe from a specified directory to a PC and executes it there. This example requires administrative shares to be enabled.
In the initial lines, the search path of the installation file and the name of the target computer are defined. Next, the username and password for accessing the computer are prompted. After testing the computer’s reachability, the temporary directory C:temp will be created and the setup file will be copied.
Finally, the Setup.exe will be invoked using these options to install SpaceObServer with enabled DataCentral service and self signed certificates:
/VERYSILENT, /SUPPRESSMSGBOXES, /ENABLEINDEXSERVER, /USESELFSIGNEDCERTIFICATE
$SOSSetupName = "SpaceObServer-Setup.exe"
$SetupPath = "\\intranet\setups\$SOSSetupName"
$DestinationHost = "client-pc"
$User = Read-Host "User name (z.B. domain\username)"
$SecPassword = Read-Host "Password" -AsSecureString
$Credential = New-Object System.Management.Automation.PSCredential($User, $SecPassword)
$RemoteTempFolder = "\\$DestinationHost\C$\Temp\"
$LocalSetup = "C:\Temp\$SOSSetupName"
if (-not (Test-Connection -ComputerName $DestinationHost -Count 1 -Quiet)) {
throw "Target host '$DestinationHost' cannot be reached."
}
if (-not (Test-Path $RemoteTempFolder)) {
New-Item -Path $RemoteTempFolder -ItemType Directory -Force | Out-Null
}
Copy-Item -Path $SetupPath -Destination $RemoteTempFolder
$ScriptBlock = {
param($LocalSetup)
Start-Process -FilePath $LocalSetup -ArgumentList "/VERYSILENT","/SUPPRESSMSGBOXES", "/ENABLEINDEXSERVER", "/USESELFSIGNEDCERTIFICATE" -NoNewWindow -Wait
}
Invoke-Command -ComputerName $DestinationHost -ScriptBlock $ScriptBlock -
ArgumentList $LocalSetup -Credential $Credential
Remove-Item -Path "$RemoteTempFolder$SOSSetupName" -Force