Installing 1E Catalog
When installing or upgrading 1E Catalog on a Tachyon 4.x or later server, the only supported method is to use Tachyon Setup. Installation using a standalone MSI is not supported unless advised by 1E, which may be necessary in complex installations, using non-interactive (quiet/silent) command-lines, and may require post-install configuration steps. Please refer to Tachyon 5.0 - Tachyon Setup for installing 1E Catalog on a Tachyon 5.0 server.
When installing or upgrading 1E Catalog on a SLA Platform 3.3 server, ensure you use the correct version of 1E Catalog before you install any of its companion products. In particular, SLA needs to refer to an existing 1E Catalog implementation during its own installation. Please refer to 1E Companion Products for details of correct versions.
Please refer to Tachyon 5.0 - Tachyon Setup for installing 1E Catalog on a Tachyon 5.0 server.
The following methods are only supported for SLA Platform 3.3, or for a remote Catalog server that is part of a Tachyon 5.0 system:
Using the interactive installation wizard
Start a command prompt with elevated rights and navigate to your downloaded copy of 1ECatalog.msi then run it using the following command-line:
Using the installer command-line
You can install the 1E Catalog in non-interactive mode using installer properties on the installer command-line:
Refer to the Installer properties page for details and optional installer properties.
Verifying the 1E Catalog installation
To verify the 1E Catalog installer is installed and configured correctly:
Browse to the install location, the default installation folder is
%programfiles%\1E\Catalog- you should see:
Folder Notes CatalogUpdateService Contains binaries used by the 1E Catalog update service. CatalogWebUI Contains files used by the 1E Catalog web service. Database Contains binaries for configuring the SQL database. Using complete code to manage SQL configuration enables you to patch 1E Catalog using Windows Installer patches (.msp files).
- Start IIS Manager open the Application Pools node, verify the CatalogWeb application pool is started using the service account specified during install.
- Locate the CatalogWeb web application. By default this is under the Default Web Site.
- Make sure you can browse to the application website. By default this will be Browse *:80 (http) which should open Internet Explorer with URL http://localhost/CatalogWeb. If your server is configured to prevent browsing on the server, open a browser on a remote computer and copy the URL, making sure you're logged on as the 1E Catalog installation account.
- Start services.msc and confirm the 1E Catalog Update Service is running.
Start SQL Server Management Studio and expand the 1ECatalog database. Check the 1E Catalog service account has been added as a user and the database role RoleCatalogUser is created, then check the service account is a member of RoleCatalogUser.
- Browse to the logpath location, the default install folder is C:\ProgramData\1E\Catalog - open and review Catalog.UpdateService.log for errors.
Upgrade the 1E Catalog
Please consider the following when upgrading 1E Catalog:
- Upgrade is supported from 1E Catalog 1.2.0 and later.
- You only need to upgrade 1E Catalog to 2.0 if you intend to use it with Tachyon 5.0 and associated applications.
- If you are currently using SLA Platform 3.3 this will need to be upgraded to the SLA provided with Tachyon 5.0 in order to take advantage of the new 1E Catalog features.
- The 1E Catalog 2.0 installer comes as part of Tachyon 5.0 and this should be installed or upgraded via the Tachyon Setup. Please refer to Tachyon 5.0 - Tachyon Setup for more details.
If you are upgrading using a different installation account to the previous installation, you must set the new installation account as db_owner on the existing 1E Catalog database prior to running the upgrade.
Before re-installing or upgrading 1E Catalog, backup its:
- Installation folder
In particular make sure you have backups for the following files, if they have been customized:
Web.config- located in
CatalogUpdateService.exe.config -located in
Before running the upgrade, make sure all existing connections to the 1E Catalog database are closed, otherwise the upgrade hangs when connecting to the database.
- Close SQL Server Management Studio.
- Stop all SLA Platform services - if you have the SLA Platform installed and running.
- Stop all AppClarity services - if you have AppClarity 5.2 installed and running.
- Stop the 1E Catalog Update Service.
If you have problems during the upgrade, refer to Upgrade issues.
Upgrading using the stand-alone installer
To upgrade your existing 1E Catalog to the latest version using the stand-alone installer:
- Download the installer from the Support portal: https://1eportal.force.com/s/1ecatalogtopicdetail
Start a command prompt with elevated rights, navigate to the location where you downloaded the 1ECatalog.msi and run it with:
The subsequent upgrade steps are the same as for the install.
On the 1E Catalog configuration screen:
In the Name of the 1E Catalog database field enter the name of your existing 1E Catalog - do not select Drop old database.
If you do select Drop old database, the 1E Catalog data will be rebuilt and you will lose all your site-defined data after the upgrade completes.
- When the upgrade is done, verify the installation. Please refer to Verifying the 1E Catalog installation.
As part of the upgrade any customizations found to the following settings will be retained:
Admins C:\Program Files\1E\Catalog\CatalogUpdateService\CatalogUpdateService.exe.config ResyncFrequency
If no applicable settings are found in older configuration files or the values for these settings are blank, default values will be applied.
Any other customizations to these files must be re-applied post-upgrade.
- Restart the SLA Platform and AppClarity services if they're installed and being used.
- Rebuild your Catalog data by resynchronizing at least one of the inventory connectors in your SLA Platform. Please refer to Rebuilding the 1E Catalog: Rebuilding your Catalog data.