Installation Guide

Zeneth 10.0
Statement of intended purpose
Zeneth is a computer-based, qualitative prediction tool that proposes chemical degradation pathways for specific chemical
structures that are submitted to stress testing. It is intended for use within a structured decision-support system as part of a
user’s overall drug development strategy.

Limited warranty
Lhasa Limited makes no warranties, either expressed or implied, regarding the software described in this document or the
online help, its merchantability, or its fitness for any particular purpose. In no event will Lhasa Limited be liable for any special,
consequential, indirect or similar damages including any loss of profits or lost data arising out of the use of the software or data
described in this document.

© Copyright, Lhasa Limited, 2024. All rights reserved.

The Zeneth software, the content of reports generated by the use of that software, and the technical documentation relating to
that software are proprietary to Lhasa Limited, and are protected by copyrights, database rights and similar intellectual
property rights in jurisdictions all over the world.

The use of Lhasa Limited software, and the copying, distribution and other exploitation of the content of reports generated by
the use of Lhasa Limited software and associated technical documentation, requires a licence from Lhasa.

Any unlicensed use of those assets will constitute an infringement of Lhasa’s copyrights and/or database rights and/or other
intellectual property rights in those assets.

Lhasa will take enforcement action in respect of any such intellectual property right infringements.

Trademarks
Zeneth® is a registered trademark of Lhasa Limited. Microsoft® is a registered trademark and Windows™ is a trademark of
the Microsoft Corporation. Other product names mentioned in this document may be trademarks or registered trademarks of
their respective companies and are hereby acknowledged.

CAS Registry Numbers® are the intellectual property of the American Chemical Society; and are used by Lhasa Limited with
the express permission of CAS. CAS Registry Numbers® have not been verified by CAS and may be inaccurate. Expert data
scientists at Lhasa Limited cross reference CAS Registry Numbers® against multiple sources to achieve a high level of
accuracy.

Acknowledgements
Lhasa Limited acknowledges the contributions to the Zeneth project made by members of the Zeneth Steering Committee.

Contact details
Lhasa Limited
Granary Wharf House Reception (: +44 (0)113 394 6020
2 Canal Wharf Applied Sciences (: +44 (0)113 394 6030
LEEDS General *: [email protected]
LS11 5PS Applied Sciences *: [email protected]
United Kingdom Website: www.lhasalimited.org

Lhasa Limited is a not-for-profit organisation. Registered charity number 290866

(Registered in England and Wales)

Zeneth 10.0 | Installation Guide 1.0 | April 2024 2

Contents

Prerequisites 4
Hardware requirements 4
Operating systems 4
Minimum and recommended resolution 4
Administrative rights 4
Users 4
Previous versions of Zeneth 5

Checklist 6
Installing the Zeneth application 7
Downloading the Zeneth installer 7
Upgrading Zeneth 7
Installing Zeneth 7
Licensing Zeneth 8
Uninstalling Zeneth 9
Running a repair install 10

Zeneth 10.0 | Installation Guide 1.0 | April 2024 3

Prerequisites
This section details the hardware requirements and platforms supported by Zeneth.
Zeneth runs locally on the machine it is installed on. A server framework is not required.

Hardware requirements
The minimum hardware requirements are:
l 10 GB disk space for a new install.
For data security, we strongly recommend installing Zeneth on an encrypted hard drive.
If upgrading from an older version of Zeneth, the minimum disk space is equal to the size of
the lhasafiles directory in the current installation directory (default location C:\Program
Files\Lhasa Limited\Zeneth <Version Number>\application\lhasafiles).
Note: Ensure that there is sufficient disk space available before performing an upgrade.
Insufficient disk space will cause the upgrade to fail and may result in a loss of prediction data.
l 4 GB RAM
l Intel/AMD multi-core processor

Operating systems
The supported client operating systems are:
l Windows 10 (64-bit)
l Windows 11 (64-bit)

Minimum and recommended resolution

Zeneth supports a minimum screen resolution of 1280 x 720. The recommended screen resolution
for Zeneth is 1280 x 1024.
Note: If the machine's display scale is above 100%, the installer interface may not appear as
designed (logo and text placement will be incorrect). This will not affect the actual installation or
usage of Zeneth.

Administrative rights
The Zeneth installation process requires administrative rights. Either log into the operating system as
an administrator before installing, or right-click the installer and use the Run as administrator or
Run as a different user function.
Note: Administrative rights are only required during the installation.

Users
Zeneth is a single user desktop application. There is no built-in user access control.

Zeneth 10.0 | Installation Guide 1.0 | April 2024 4

Previous versions of Zeneth
Running the Zeneth 10 installer on a workstation with an existing Zeneth 9 installation will initiate an
upgrade process. Predictions from Zeneth 9 will be copied to Zeneth 10, and the Zeneth 9 installation
will be removed.
If you have an existing Zeneth 8 installation then any predictions will be lost when upgrading to
Zeneth 10. If you wish to keep your predictions from a Zeneth 8 installation, you should first run the
Zeneth 9 installer to upgrade from Zeneth 8 to Zeneth 9 before running the Zeneth 10 installer.
Zeneth 10 will open predictions from Zeneth 8 or 9 in a read-only state. The prediction results can be
viewed, but settings cannot be changed and the prediction cannot be run again. If a Zeneth 8 or 9
prediction needs to be re-run, the prediction will need to be rebuilt in Zeneth 10.
User default settings in Zeneth 8 or 9 are not carried over to Zeneth 10 as part of the upgrade.
Predictions from Zeneth 7 will not open in Zeneth 8, 9 or 10. If any existing predictions in Zeneth 7 are
still in use, we recommend leaving the Zeneth 7 installation as it is. Zeneth 8, 9 or 10 will run on a
workstation with an existing Zeneth 7 installation with no issues.
If Zeneth 7 is no longer required, it can be uninstalled through Control Panel > Programs and
Features, and by then deleting the Zeneth 7 installation folder (default location
C:\Users\Public\Lhasa Limited\Zeneth 7).
For more information on the upgrade process, see "Upgrading Zeneth" on page 7.

Zeneth 10.0 | Installation Guide 1.0 | April 2024 5

Checklist
Use the below checklist to confirm that the machine meets the installation requirements. Cross-
reference this information with the version numbers stated in "Prerequisites" on page 4. Please have
this information available if you need to contact Lhasa Limited for assistance.

Answer (delete Version number or

Question
as applicable) other information

Does the machine meet the RAM and hard disk space
Yes/No
requirements?

Is the machine running a supported operating system? Yes/No

Does the Windows account satisfy the requirements

Yes/No
outlined in "Administrative rights" on page 4?

Zeneth 10.0 | Installation Guide 1.0 | April 2024 6

Installing the Zeneth application
Downloading the Zeneth installer
The installation files are located in the download centre:
https://download.lhasalimited.org/
For help logging in, contact the Lhasa Applied Sciences team ([email protected]).

Upgrading Zeneth
An existing Zeneth installation from 8.0 onwards can be upgraded to a newer version without
uninstalling the older version. The upgrade process is the same as the standard installation process.
During an upgrade, the Zeneth licence and all saved predictions are automatically transferred to the
new version of Zeneth.
Note: If an existing Zeneth installation is uninstalled, the saved predictions will be lost and will not be
transferred to the new version of Zeneth. If you want to uninstall the previous version of Zeneth but
save your existing predictions, the predictions must be backed up. For more details on backing up
predictions, contact the Lhasa Applied Sciences team ([email protected]).
Further notes on the upgrade process:
l The upgrades do not need to be installed sequentially - you may upgrade from any version of
Zeneth 8 or Zeneth 9 to Zeneth 10. Note that predictions from Zeneth 8 will not be kept if
upgrading directly to Zeneth 10; if you wish to keep predictions from Zeneth 8, first
upgrade to Zeneth 9 and then upgrade to Zeneth 10.
l Before running the upgrade process, ensure the currently-installed version of Zeneth is
closed.
l For an upgrade, the minimum disk space is equal to the size of the lhasafiles directory in the
current installation directory (default location C:\Program Files\Lhasa Limited\Zeneth
<Version Number>\application\lhasafiles).
l Ensure that there is sufficient disk space available before performing the upgrade. Insufficient
disk space will cause the upgrade to fail and may result in a loss of prediction data.
l The upgrade can be installed in the same directory as the older version of Zeneth. The older
installation files will be overwritten and data transferred to the new version of Zeneth.
l After upgrading to Zeneth 10, the Zeneth 8 or 9 directory is removed. All data is transferred to
the new location.
l During an upgrade, a message may appear stating that a reboot is required. A reboot is not
necessary - you may continue without rebooting.
l If the upgrade needs to be stopped while it is running, use the Cancel button. Closing the
installation window with the X close button, or using any other means to stop the installation,
may result in a loss of prediction data.

Installing Zeneth
1. Extract the files from the ZIP download package.
2. Navigate to the Installer folder and double-click the executable zeneth-<version number>-
windows-installer.exe.

Zeneth 10.0 | Installation Guide 1.0 | April 2024 7

 Note: If the logged-in Windows account does not have administrative privileges, right-click the
executable and select Run as Administrator, or hold Shift and right-click and select Run as
a Different User. Enter the Windows Administrator login and run the installer.
3. Follow the installation wizard instructions. Click Next to proceed or Back to return to the
previous page.
l Destination Folder
The default installation directory is C:\Program Files\Lhasa Limited\Zeneth 10\.
Accept the default installation directory or click Change... to specify another location.
Note: The location cannot be changed after installation. Renaming or moving the
Zeneth directory or files will result in errors when using Zeneth. If a Zeneth installation
must be moved to a new location, export the Zeneth data, uninstall the existing Zeneth
installlation and reinstall in the correct location.
l Installation Completion
If the tickbox on the final installation screen is ticked, the application starts immediately
after the wizard is closed. This tickbox is unticked by default.
To close the installation wizard, click Finish.

After installation, you can open the application by either:

l Using the Start Menu > Lhasa Limited > Zeneth 10 icon.
l Double clicking the run.bat file in the installation directory Application folder (default location
C:\Program Files\Lhasa Limited\Zeneth 10\application).

Note: Zeneth may be slow to load for the first time. This is due to post-installation scripts in the
background, including the upgrade process from Zeneth 9 (if applicable). Subsequent instances of
Zeneth will load faster.
If the installation is a new installation (not an upgrade of an older version), Zeneth will need licensing.
Follow the instructions under "Licensing Zeneth" below.

Licensing Zeneth
When running a new installation of Zeneth for the first time, a "No licence installed" message
appears.
The licence key is supplied via email from Lhasa's Applied Sciences team. To enter a licence key
into Zeneth:

1. Click Dismiss to close the "No licence installed" message.

2. Click the Submit licence button.
3. Either enter the path to the licence file in the Upload Licence File interface, or copy and paste
the licence key into the Enter Licence Key box
4. Click Validate, then Submit.

The licensed features are now listed.

Zeneth 10.0 | Installation Guide 1.0 | April 2024 8

Access the licensed features by clicking on icons on the menu bar on the left. Click to expand
the menu bar and see text descriptions for each icon.

Uninstalling Zeneth
There are two ways to uninstall Zeneth:
l Via the Control Panel.
l By re-running the installer and selecting the Remove option.

Note: Older versions of Zeneth do not need to be uninstalled before installing a newer version. If an
existing Zeneth 8 or 9 installation is uninstalled, the saved predictions will be lost and will not be
transferred to the new version of Zeneth. For more information, refer to "Upgrading Zeneth" on
page 7.
Further notes on the uninstallation process:
l Ensure Zeneth is closed before uninstalling.
l When uninstalling, a message may appear stating a reboot is required. This is to ensure the
Zeneth taskbar icons are removed. If the taskbar icons disappear without a reboot, you may

Zeneth 10.0 | Installation Guide 1.0 | April 2024 9

 continue without rebooting. Alternatively, the taskbar icon may be removed manually by
clicking the icon after uninstalling.
l Cancelling the uninstall process while it is running will still result in predictions being deleted.

Running a repair install

To perform a repair install of Zeneth, run the installer again. When prompted to select Modify, Repair
or Remove, select Repair. You may also use the Repair option in Control Panel.

Zeneth 10.0 | Installation Guide 1.0 | April 2024 10