Installing for Windows

To install the Explorer Service for Windows:

Download the Tidal Explorer software from support.tidalsoftware.com.
Extract the files.
Copy + to the target machine.

When installing on a Windows machine, the TE-Service-Setup.exe installer does these:

Checks that.NET Framework 4.7.2 or 4.8 is already installed.
Installs the Tidal Explorer Service and Explorer Admin software into C:\Program Files\TIDAL\Explorer.
Installs the Explorer Windows Service as a Windows Service named ‘TidalExplorerService’ that will run under the LocalSystem account.

Note: The installation process does not start the explorer service on the machine.

Running the TidalExplorerService under a domain user account.

If you wish to manage Explorer data file space and archive files to a Network storage location, then run the TidalExplorerService using a Windows domain user account.

The domain user account must have read and write access to the nominated Network storage location.

It must also be an administrator on the local machine and have these user rights assigned:

Act as part of the Operating System
Logon as a batch
Logon as a service
Replace a process level token

New Explorer Service for Windows Installations

Manually verify that all installation prerequisites have been met.
Run the TE-Service-Setup.exe installer.

Upgrading an Explorer Service for Windows Installation

The TE-Service-Setup.exe installer will also perform an in-place upgrade of an existing Explorer installation.

Prior to performing an in-place upgrade:

Ensure that the 'TidalExplorerService’ service on the machine has been stopped.

Note: The upgrade process resets the user account for the service to the default LocalSystem. Take note of the user account that runs the service if not using LocalSystem.
Ensure that the TidalExplorerAdmin or TidalExplorerClient client tools are not running on the machine.
Run the TE-Service-Setup.exe installer.
Verify that the user account used to run the service is correct.

When upgrading an existing Explorer Service installation, these configuration files and license file are preserved and updates applied automatically, if required.
```
C:\Program Files\TIDAL\Explorer\TidalExplorerService.exe.config
```
```
C:\Program Files\TIDAL\Explorer\TidalExplorerAdmin.exe.config
```
```
C:\Program Files\TIDAL\Explorer\config\explorer.props
```
```
C:\Program Files\TIDAL\Explorer\explorer.lic
```

Note: Following the upgrade edit file C:\Program Files\TIDAL\explorer\config\explorer.props to set JAVA_HOME to the location of JAVA installed on the host machine. JAVA_HOME=C:\Program Files\Microsoft\jdk-17.0.6.10-hotspot

On each installation upgrade, a backup folder named install.<timestamp> is created in C:\Program Files\TIDAL\Explorer that contains these files:

Install Backup Files	Description
TidalExplorerService.exe.config.original TidalExplorerAdmin.exe.config.original explorer.props.original explorer.lic.original	The original files in use before the upgrade was applied.
TidalExplorerService.exe.config.new TidalExplorerAdmin.exe.config.new explorer.props.new	The new default config files that come with the upgrade.
TidalExplorerService.exe.config.updated TidalExplorerAdmin.exe.config.updated explorer.props.updated explorer.lic.updated	The updated files based on the original file and containing any required changes/updates to support the upgrade installation. Following a successful upgrade, the main config files will match the updated file versions.

Install Backup Files

Description

TidalExplorerService.exe.config.original

TidalExplorerAdmin.exe.config.original

explorer.props.original

explorer.lic.original

The original files in use before the upgrade was applied.

TidalExplorerService.exe.config.new

TidalExplorerAdmin.exe.config.new

explorer.props.new

The new default config files that come with the upgrade.

TidalExplorerService.exe.config.updated

TidalExplorerAdmin.exe.config.updated

explorer.props.updated

explorer.lic.updated

The updated files based on the original file and containing any required changes/updates to support the upgrade installation.

Following a successful upgrade, the main config files will match the updated file versions.

Unattended Explorer Server Installation

To install or uninstall the Explorer Service via command line with no user interaction, run a Windows command shell as administrator and use these commands:

TE-Service-Setup.exe -install -l serviceinstall.log -q

TE-Service-Setup.exe -uninstall -l serviceuninstall.log -q

Troubleshooting Explorer Service for Windows Installation Issues

Issue	Action
Install fails with error suggesting that you may have insufficient rights to perform the install	Verify that the TidalExplorerService is not already installed and running. Close the Windows Services Snap-In tool if it is open. Retry the installation.
Install fails	Open the Windows Event Viewer to look for administrative events or Application log errors related to .NET exceptions or TidalExplorerService exceptions associated with the service installation failure.
Install fails	Service Install Logging. Run the installer via cmd shell using the command line option below. This option captures the verbose install log that can be reviewed for issues. TE-Service-Setup.exe -install -lv serviceinstall.log

Issue

Action

Install fails with error suggesting that you may have insufficient rights to perform the install

Verify that the TidalExplorerService is not already installed and running.
Close the Windows Services Snap-In tool if it is open.
Retry the installation.

Install fails

Open the Windows Event Viewer to look for administrative events or Application log errors related to .NET exceptions or TidalExplorerService exceptions associated with the service installation failure.

Install fails

Service Install Logging.

Run the installer via cmd shell using the command line option below. This option captures the verbose install log that can be reviewed for issues.

TE-Service-Setup.exe -install -lv serviceinstall.log