Licencing Precision Bridge

The Licencing Interface

On the initial launch of Precision Bridge, the licence properties screen will appear, prompting you to request a licence.  The licence options are different depending on the version of Precision Bridge you have installed.  For version 8.0 or later the options will be presented like this:

The same dialog can be viewed at any time using help->licence from the menu.

 

Requesting a Licence

Enter your company name, project name, contact name and phone number then select the Licence Type. The Client Mac Address should be auto-populated. 

There are 2 licence types available:

• TRIAL: This will grant a 10 day, use of Precision Bridge for the set of connections defined. However, during execution of your projects, a maximum of 50 records for each form mapping will be migrated
• SUBSCRIPTION: This grants the user unlimited use of Precision Bridge for the set of connections defined for a given period. The duration of the licence will be determined by your entitlement.

For both trial and subscription licences, you need to add all the server connections that you want to licence for use. 

To add a new connection for a licence:

• Click the 'Add' button to the right of the table of licenced connections
• Select the connection type (for example Service Now)
• Select the connection scope, i.e whether this connection is to be licenced as a source or target for migration
• Select the connection role, i.e whether this connection is to a production or non-production server/instance. Typically, Precision Bridge will charge only for Production licences and for each production connection you will be able to licence 2 non-production instances, to be used for development and testing purposes. Note that licencing a connection as a non-production instance when it is in fact in use as a production instance is a violation of the licence agreement
• Specify the identification values for the connection. The values required here will depend on the type of connection. See the table below for more information
• Click 'OK' to add the connection.

Once you have added all the connections you would like to licence click 'Request Licence' to generate the licence request.

Connection Identification Values

Connection Type	Identifier	Example	Notes
CSV	-		No identifier required
Oracle DB	Data Source / Host Name and Service	acme_oracle_server xe	Host name is the domain name or ip address of server hosting the Oracle server
SQL Server DB	Data Source / Host Name and Database Name	acme_sql_server itsm	Host name is the domain name server hosting SQL Server
Postgres	Data Source / Host Name and Database Name	acme_db_server itsm	Host name is the domain name of server hosting the Postgres server
MySQL	Host Name and Database Name	acme_db_server itsm	Host name is the domain name of server hosting the MySQL server
Hana DB	Data Source	82d62e3d-c266-4dcb-b4cf-c2a72965301f	For Hana cloud, this will be the instance name
Snowflake	Data Source	acme.us-west-2.snowflakecomputing.com	The full domain path for the server
Databricks	Host Name	adb-xxxxxxxxxxxx.xx.azuredatabricks.net	The server hostname (from SQL warehouse connection details)
Service Now	URL / Domain Name	dev012345.service-now.com	The root URL for your instance, The https:// prefix is not needed
Remedy	Server Name and Port [optional]	ITSM91 9996	If the server uses portmapper, leave the port blank
Salesforce	Login URL and user name	login.salesforce.com [e-mail]	The username is the login name of the user you will be connecting with
RSA Archer	URL / Domain Name and Instance Name	[e-mail] prod	The url does not need to have the https:// prefix included
Jira	URL / Domain Name	acme-prod.atlassian.net/	The url does not need to have the https:// prefix included
Cherwell	URL / Domain Name	cherwelldev.acme.com	The url does not need to have the https:// prefix included
Ivanti	URL / Domain Name	pbridge.ivanti.com	The url does not need to have the https:// prefix included
HP Service Manager	URL / Domain Name	acme-soft.de:8443	The url does not need to have the https:// prefix included
Zendesk Extraction Utility	URL / Domain Name		This Utility extracts data from Zendesk and writes it to a csv file
ManageEngine Extraction Utility	URL / Domain Name		This Utility extracts data from ManageEngine and writes it to a csv file

For further details on Licence Types see the article What type of licences are available?

Completing the Licence Request

Once the licence details have been entered, including all connections to be licenced, click the Request Licence button.

The Licence Request screen will be presented, showing the details. This will include the encoded licence request, which Precision Bridge will use to generate your licence.

Click on the Copy to Email button to launch your email client and send the request to [e-mail] in order to obtain your licence key.

Alternatively, copy the full text (including the encoded licence request string) into an email.

Applying your Licence Key

You will receive a licence email from Precision Bridge that contains the key. An example is shown below, the key is highlighted

When you receive this email, re-open Precision Bridge and open the 'Apply Licence' tab.

Paste in the licence key, read and check the licence agreement and click 'Apply:

If the key was entered correctly then you should see a message in the Licence Status section indicating that the product is fully licenced.

If you go to the Licence Details tab, you should see the full details of your licence including the connections that are licenced and the expiry date.

Once licenced you can close the licencing dialog and begin to use Precision Bridge to create and execute migration projects.

The licencing screen can accessed at any time from the Precision Bridge Help->Licence menu item.

Related Articles

Video Tutorial - Installing and Licencing Precision Bridge