Migrating from Data Hub to IML

You can migrate Data Hub spaces associated with your developer.here.com accounts to the HERE platform using the self-service Data Hub migration tool.

This section outlines how to migrate your Data Hub spaces to the HERE platform using the self-service Data Hub migration tool:

Before you migrate

Before you migrate your Data Hub spaces to the HERE Platform, HERE recommends that you perform the following pre-migration steps:

  • Check with your team to see if you have an existing HERE platform organization. Any number of developer.here.com accounts can migrate their spaces to a single HERE platform organization.

Sign up for a HERE platform account

As part of the migration process, you will need to either sign up for or sign in to a HERE platform account.

Note

If your organization has signed up for HERE Marketplace, contact your organization admin who can invite you to join the HERE platform organization established for your company. You can also request a free trial of the HERE platform if your company does not have an organization established for it. For more information, see the HERE platform pricing.

You may need to add a credit card to your HERE platform account as part of the migration process. For example, you must have a credit card associated with your account to migrate HERE Data Hub resources.

To sign up for a HERE platform account, follow these steps:

  1. Sign in to your developer.here.com account.
  2. Click Create a platform account to get started from the yellow page banner or navigate to https://platform.here.com/sign-up.
  3. Follow the prompts to complete your HERE platform account creation or click Sign in instead to sign in to an existing HERE platform account.

Test your data before migrating

You can create a copy of your data to test it prior to migrating your spaces. Testing your data is performed on a space-by-space basis so that you can select what data is copied. Creating a copy of your data duplicates the data, with changes occurring only in one version.

Note

Copying your data incurs additional costs and may take some time depending on the size of the copied data.

You can repeat the process of copying and testing your data to update changes from HERE Data Hub to IML, but this process overrides existing features in IML. HERE Data Hub and IML identify a feature by ID, and if no ID is present, a new one is created. However, since data is being read from HERE Data Hub, all features have an existing ID. Therefore, within IML all features with matching IDs are overwritten. Features that have only been added to IML, and do not have an ID in HERE Data Hub, remain untouched.

To test your data, follow these steps:

  1. Install and configure the HERE Data Hub CLI.
  2. Install and set up your credentials for the OLP CLI.
  3. Look up your spaceId:
    here xyz list
    
  4. Download your data:
    here xyz show --all ${spaceId} > ${spaceId}.geo.json
    
  5. Create a catalog and IML using either the HERE platform or the CLI. For more information on how to create catalogs and layers, see the Data API Guide.
  6. Upload your data to the IML you created:
    olp catalog layer feature put "${catalogHrn}" "${layerId}" --data ${spaceId}.geo.json
    

    Note

    You can alternatively perform a direct copy using a pipe character to combine requests:

`here xyz show --all ${spaceId} | olp catalog layer feature put "${catalogHrn}" "${layerId}"`

Migrate your resources

To migrate your Data Hub spaces to the HERE platform, create or select a Data Hub token, that has full (all spaces) 'manageSpaces' rights for your user.

Use the following snippet to perform a dryrun:

curl -X 'GET' 'https://conversion-service-eu-west-1.api-gateway.ls.hereapi.com/list/dh' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer <PlatformToken>' \
  -H 'Dh-Token: <data-hub-short-token>'

Use the following snippet to start your migration:

curl -X 'POST' 'https://conversion-service-eu-west-1.api-gateway.ls.hereapi.com/convert/dh' \
   -H 'accept: application/json' \
   -H 'Authorization: Bearer <PlatformToken>' \
   -H 'Dh-Token: <data-hub-short-token>' \
   -d ''

Use the following snippet to check the status of your jobs:

curl -X 'GET' 'https://conversion-service-eu-west-1.api-gateway.ls.hereapi.com/convert/dh' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer <PlatformToken>' \
  -H 'Dh-Token: <data-hub-short-token>'

Migrate additional accounts to your HERE platform account

You can perform the self-service migration multiple times across several developer.here.com accounts to completely migrate your Data Hub spaces. For example, if you have resources associated with two developer.here.com accounts, you can perform two migrations and associate all your Data Hub spaces to a single HERE platform organization. For each additional developer.here.com account, repeat the procedure outlined in Migrate your resources.

results matching ""

    No results matching ""