Guide

Unified Connector Migration

Suggest Edits

Unified Connectors, the latest evolution of Akamai EAA connectors designed to seamlessly support both Cloud Zone applications and high-performance Edge Transport applications.

They can concurrently handle traffic from EAA Applications linked to both EAA Cloud Zones and the modern Edge Transport mechanism.

Existing Connector versus a Unified connector

An existing Connector in EAA supports Akamai Cloud Zone only as the transport mechanism.

cloud zone based application

You can find the Akamai Cloud Zone setting in an Application’s Detail Setting’s page:

akamai cloud zone diagram

A Unified Connector in EAA supports both Akamai Cloud Zone and modern Akamai Edge Transport mechanisms.

edge transport based application

With the unified connector you can configure Edge Transport based Application using the Akamai Edge Network. You can perform this connector migration as a self-service.

Unified Connector Migration process

You can upgrade your existing connectors to unified connectors. This upgrade process is seamless and ensures no disruption to end-user traffic. However, you cannot roll-back to the existing connectors after the migration. For optimal performance, Akamai recommends that you perform this upgrade process during off-peak hours.

📘

Note

All connector packages can be migrated to Unified Connector, except for Docker.

Prerequisite:

  1. You must update the allowlist with domains for unified connectors so that the Unified Connector can establish a connection with the Akamai intelligent network.
  2. Your Connector OS must be Ubuntu 22.04
  3. Connector version must be 23.02.00 or above.

For example, here's a OpenStack/KVN connector having the proper connector OS and version and can be migrated:

Connector suitable for upgrade

  1. You must have finished all security updates.

Follow this procedure to upgrade to Unified Connectors:

  1. Log in to Enterprise Center.

  2. In the Enterprise Center navigation menu, select Application Access > Clients & Connectors > Access and Identity Connectors. All your connectors are shown on the connector list page.

  3. Go to the Connector you wish to upgrade and click Security Updates Available icon (security updates available):

existing connector

  1. The security updates panel expands. If you have security updates available go to step 5. If you do not have any security updates go to step 6.

  2. If you have any security updates available, you must perform the update. Click Start Security Update, then Continue. The security update finishes and connector will be running. Next, go to step 6.

  3. If there are no security updates available, click the Upgrade to Unified Connector tab, click Upgrade.

Upgrade button

  1. In the Upgrade to Unified Connector dialog box, click Continue.

  2. The conversion process starts and it changes to Converting to Unified icon
    (convert to unified icon) in the Status column.

  3. After the connector migration is done, the connector package changes to
    Unified : <Package type>.

For example, if you converted a VMWare connector to Unified connector, the package column would change from (classic connector icon) to (unified connector icon) in the Package column.

Your existing connector has been upgraded to a unified connector and serves the application traffic.

📘

Note

If you encounter an issue in the connector migration, contact Akamai support.

Updated 10 days ago