Common Errors and FAQs

General FAQs

What are pre-requisites to using Deltek ComputerEase with Agave Sync?

1. You must be on the on-premise or single-tenant, hosted models for Agave Sync (see below).
2. You must have a login to Deltek ComputerEase that the integration can use (see below)
3. If you are on the single-tenant, hosted model for ComputerEase, you must have access to:
   • The Desktops view in the ComputerEase website (note, you typically need Admin-level permissions to access this view), and
   • ODBC Setup under Apps

What instances of Deltek ComputerEase are supported by Agave Sync?

Agave Sync supports the following Deltek ComputerEase instances:

1. On-premise: these are instances not hosted directly by Deltek. They run on a server managed locally by your company or by a third-party IT provider. You are likely using an on-premise instance if you log in with a URL that does not include https://your-company.computerease.cloud. Note, your Computerease instance must be installed on a supported version of Windows (see below).
2. Single-tenant, hosted: these are instances hosted by Deltek but dedicated solely to your company (not shared). You’re on a single-tenant hosted instance if you log in with a URL that includes your company’s name plus computerease.cloud — for example, https://your-company.computerease.cloud.

What instances of Deltek ComputerEase are not supported by Agave Sync?

Agave Sync does not support the shared cloud model. These are instances hosted by Deltek and shared among multiple ComputerEase customers. If you log in at https://computerease.cloud, you’re on a shared cloud instance.

How can I upgrade from shared cloud to single-tenant hosted?

If you’re on the shared cloud and want to switch to a single-tenant hosted instance, please contact your Deltek Account Manager to discuss an upgrade.

What versions of Windows are supported for on-premise instances?

Agave Sync support the following versions of Windows:

• Windows 10
• Windows 11
• Windows Server 2016
• Windows Server 2019
• Windows Server 2022

Agave follows Microsoft's Product Lifecycle policy for Windows.

caution

As of October 2023, Windows 8.1 and Windows Server 2012 have reached end of support and do not receive security updates. If you are using either version, we recommend upgrading immediately. Agave does not support these versions of Windows.

For more information, see related Microsoft announcement.

Do I need to whitelist any domains for my firewall?

If your team has an on-premise instance of ComputerEase and uses a firewall that restricts outbound traffic, you will need to whitelist the following domains to allow Agave Sync to communicate with your instance. This is only required for teams with firewalls that block outbound connections by default — most teams will not need to complete this step.

Whitelist the following domains on port 443 (HTTPS/WSS):

Domain	Purpose
rest.ably.io	REST API requests
realtime.ably.io	Realtime WebSocket connections
a.ably-realtime.com	Fallback host
b.ably-realtime.com	Fallback host
c.ably-realtime.com	Fallback host
d.ably-realtime.com	Fallback host
e.ably-realtime.com	Fallback host
internet-up.ably-realtime.com	Connectivity check
ws-up.ably-realtime.com	WebSocket connectivity check

tip

For forward compatibility, we also recommend whitelisting the following CNAME targets that Ably's domains resolve to:

• main.realtime.ably.net
• main.a.fallback.ably-realtime.com
• main.b.fallback.ably-realtime.com
• main.c.fallback.ably-realtime.com
• main.d.fallback.ably-realtime.com
• main.e.fallback.ably-realtime.com

note

Ably does not publish static IP addresses, as their service uses dynamically assigned IPs. Domain-based whitelisting is the recommended approach.

Getting Started

There are two steps to authenticate Agave with your Deltek ComputerEase instance:

1. Set up ODBC access, and
2. Install and enable the Agave Connector.

As a reminder:

1. For single-tenant hosted (cloud) instances of ComputerEase, you will need access to the Desktops view in the ComputerEase website. Note, you typically need Admin-level permissions to access this view.

2. For on-premise instances of ComputerEase, we recommend having an ability to log into the ComputerEase server with a user that has Admin-level permissions.

Step 1: Set Up ODBC Access

note

The following step applies to both single-tenant hosted (cloud) and on-premise ComputerEase instances.

1. From the Citrix Workspace view, press ODBC Setup. This action executes a process that sets up ODBC Access for your ComputerEase instance.

2. To verify this action worked, log into the Desktop view. From the Windows Taskbar, open ODBC Data sources (64-bit):

3. In the User DSN tab, you should see a list of Company Names:

note

If you do not see the Company Name in this step, we recommend contacting Deltek Support and ask them to enable an ODBC access for your Desktop ComputerEase instance.

Step 2: Install and Enable Agave Connector Access

The second step in authenticating Agave to use Deltek ComputerEase is to enable ODBC access through the Agave Connector. This ODBC access allows Agave to read data from ComputerEase and sync it to your Project Management system.

Downloading the Agave Connector

1. Navigate to the Agave ERP Sync tool Settings screen and follow the prompt to connect ComputerEase.

2. Select No, disable API integration when prompted to Enable ComputerEase API Integration.

note

API Integration is not required for most customers and in most cases should be left disabled.

Continue in the Agave UI and click on the Agave Connector hyperlink to download and install the Agave Connector app before clicking Create Account.

tip

For on-premise customers, we recommend installing the Agave Connector on the server used to host Deltek ComputerEase instead of a user's workstation.

Some customers also choose to run the Agave Connector on a separate account (rather than admin) on the host machine. Ensure you install the Agave Connector while signed in with the account that will run it.

3. Open the Agave Connector and press Add Account. Then select ComputerEase as your Source System.

4. Input the Company Number, Username, Password, and Application Path for your ComputerEase user you use in Agave Sync. Then press Test and Save.

note

The Username and Password can be the same login details you use in ComputerEase.

tip

For ComputerEase single-tenant hosted instances, the Application Path will always be X:\ComputerEase\mmr.exe.

For ComputerEase on-premise instances, the Application Path will map to the root of the ComputerEase installation directory.

5. In the Agave Sync view, add the Account ID and Account Token to the Agave Connector view. Input these details in the next screen of the Agave Connector and then press Test and Save:

6. In the Agave Sync view, press Validate Connection. Agave will now be connected to your ComputerEase account:

Common Errors

User is denied access to table

If you receive an error like the following User is denied access to table, it is because you are missing the required permissions for the ComputerEase user you are using for the integration.

To add permissions for this user:

1. Log in to ComputerEase with your PW MAINT account:

2. Select the user (e.g. "Agave" below) and press Edit User:

3. Scroll down to Data Files (User Reports & ODBC) and expand it:

4. Select the relevant data file for the record (E.g. "Accounts Receivable"). Press Read Only: