Before you install or upgrade Trellix ePolicy Orchestrator - On-prem, run the Pre-Installation Auditor to reduce or prevent installation or upgrade issues. The tool also allows you to change your Trellix ePO admin password.
Important: Pre-Installation Auditor supports Trellix ePO versions that can directly upgrade to version 5.10.0 Service Pack 1 or later. For the list of supported upgrade paths, see KB51569.
The Pre-installation Auditor performs these checks based on the type of installation.
Checks | During installation | During upgrades |
|---|---|---|
Confirms that your server meets the Trellix ePO and SQL Server hardware requirements. | X | X |
Confirms that you have the needed SQL Server access and permissions. | X | X |
Verifies that the services that must be stopped, can be, and that no third-party software can cause the services to start unexpectedly. | X | |
Identifies the SQL Server browser status. | X | X |
Determines whether database encryption is enabled. | X | X |
Determines whether the SQL Server auto-close feature is enabled. | X | X |
Identifies the database recovery model. | X | |
Checks for Microsoft Windows scheduled tasks and automatic updates. | X | X |
Determines whether Microsoft Windows 8.3 naming is enabled. | X | X |
Checks for pending file rename operations. | X | X |
Checks for operating system permissions. Identifies the versions of Trellix ePO that the server operating system and version support. | X | X |
Checks whether the database option for arithmetic abort is enabled. | X | X |
Checks the compatibility level of the SQL database. | X | X |
Checks whether the database index fragmentation is below the suggested limit. | X | |
Checks whether the new Trellix ePO version supports migration to SHA-2 certificates. | X | |
Checks the database replication status. | X | |
Checks the database query cursor threshold value. | X | |
Verifies that no file handles are open in the Trellix ePO directory. | X | |
Provides a list of running Trellix ePO server tasks and warns you to disable them. | X | |
Estimates the required upgrade time. | X |
As each check is completed, the status of the test changes:
The test passed.
The test detected an issue that might put your installation or upgrade at risk, or that might cause problems after installation.
The test failed. Resolve this issue before attempting your installation or upgrade.
A status bar provides an estimate of how close the checks are to completion.
Download Pre-Installation Auditor
You can download the Pre-installation Auditor from the Trellix ePO Downloads page.
In the Trellix Support Service Portal, navigate to Product Downloads, and download the zipped Trellix ePO Pre-Installation Auditor file.
Extract the files to a temporary location and locate ePIP.exe.
Run a pre-installation check
Run the Pre-Installation Auditor from the directory where you downloaded the tool. You can run the check as many times as needed.
Task
Double-click ePIP.exe to run a pre-installation check.
(Upgrade only) Select the Trellix ePO version you are upgrading to.
Click Next to open the configuration page.
If you already have Trellix ePO installed, the Pre-Installation Auditor automatically populates your SQL Server information.
Click Next to run the pre-installation checks.
Select any check to display details at the bottom of the screen. You can make any changes and run the test again.
After all test statuses indicate that the tests have passed, click Next.
Click Check to run the product compatibility check.
After you have identified the incompatible products, click Finish.
Uninstall any incompatible products.
You can now proceed with your installation or upgrade. For information about completing your upgrade or installation, see the Trellix ePO - On-prem Installation Guide.
Change the administrator password
If you want to change the administrator password, you can do it by using Trellix ePO Pre-installation Auditor.
Task
Double-click ePIP.exe to run the Trellix ePO Pre-Installation Auditor tool.
Select Change ePO administrator password, then click Next.
If you already have Trellix ePO installed on the server, the Trellix ePO Pre-Installation Auditor tool automatically populates your SQL Server information.
Enter your SQL Server database information, then enter your new Trellix ePO administrator password.
Click Change Password.
After the tool indicates the successful password change, click Finish.
You can now use your new Trellix ePO administrator password to log on to Trellix ePO.
.