This documentation is subject to change as an important milestone in the overall multi-region deployment plan to help our US customers comply with data residency policies and regulations is still ongoing.
When you create a hub, BIM Track stores your data on servers located in Canada, regardless of your geographical location. If you want your hub to be hosted on servers in the United States, contact us.
The name of the region where the hub is hosted is visible in the Hub Settings page.
As of October 16, 2020, you will be able to create a hub based on your geographical location, i.e automatically in the US if you are located in the United States and in Canada if you are located in Canada.
This article explains the particularities of having a hub hosted on servers located in the United States. It contains the following sections:
Accessing a hub in the US region
It’s no longer required to use the US-specific URL (https://bimtrackapp.us) to access a hub hosted in the US. Users can access any BIM Track hub by either using https://thehub.bimtrackapp.co, or by selecting it in the hub selection list, regardless of the region where the hub is hosted.
All requests targeting existing hubs are routed to the existing BIM Track instance. However, all traffic targeting non hub-specific pages (like the login page - https://bimtrackapp.co/en/Login) are routed to the US instance. The US instance serves requests targeting bimtrackapp.co for most of the US users.
BIM Track add-ins v1.53 and newer only are supported. If you are using an older version of the add-ins you might experience connectivity issues. Download and install the latest version of our add-ins here.
All customers can use the same installer to deploy the add-ins in their organization.
Users can access projects in hubs hosted in any region by running the installer available publicly on the BIM Track website.
Users who originally installed the add-in using the US installer can perform an in-place upgrade by simply running the latest standard installer.
BIM Track REST API
The BIM Track REST API also abstracts the notion of region. There is no need for the caller to know which region the hub is hosted in. Users always target https://api.bimtrackapp.co, regardless of the region where the hub actually resides.
However, customers who have a hub in the US region should be using the version 3 of the API. It's really straight-forward to migrate to v3. Efforts are minimal as the main purpose of this new version is to support our new multi-region deployment.
BCF REST API
Because of technical limitations, it is not possible to provide a unique URL and abstract the notion of region to users of the BCF REST API.
Calls to hubs hosted in the US region have to target the regionalized URL. This region-specific URL is available from the Integrations page.
Creating a hub in the US region
Because the region selection is not yet part of the hub creation process, customers who specifically request their hub to be hosted in the US region need to contact us or follow the procedure below.
Because there is no way to explicitly select the hosting region when creating the hub, you are required to follow the procedure below to make sure the hub was actually created in the US region (if required by your organization’s policies, for example).
- Go to https://bimtrackapp.us/en/Login and enter your login credentials.
- Once logged in, on the hub selection page, click Add new hub.
- On the hub creation page, enter a name for your hub, for example, your organization name.
- Click Start working. Your new hub will be automatically created in the US region.
Before creating projects, verify that the procedure worked with the region name included in the Hub Settings page.
It is not currently possible to move an existing hub or project to another region. The capability to move projects from one hub to another, regardless of the region of these hubs, will be available in the next development phase.