# Cisco Catalyst Center
## Introduction
Hamina Network Planner supports two ways of integrating with Cisco Catalyst Center (formerly known as Cisco DNA Center or "DNAC"):
* Exporting the network design as a file that can be imported to Cisco Catalyst Center. See [#export-to-cisco-catalyst-center](#export-to-cisco-catalyst-center "mention") for more information.
* Enabling the Live View through a cloud-to-premise connection to Cisco Catalyst Center. See [#live-view](#live-view "mention") for more information.
## Live View with Cisco Catalyst Center
Hamina Network Planner Plus connects from the Hamina Cloud to a on-premises instance of Cisco Catalyst Center.
{% hint style="danger" %}
The Live View with Cisco Catalyst Center requires a minimum Catalyst Center version of 2.3.7.9.
{% endhint %}
{% hint style="info" %}
The Hamina servers [listed here](https://docs.hamina.com/planner/other/faqs#my-organization-allowlists-ip-addresses-in-vendor-apis.-which-ip-addresses-do-i-need-to-allow-in-ord) must be able to connect to the Cisco Catalyst Center appliance using TCP port 443.
{% endhint %}
To enable it:
1. Start a new project, and click on the **Live** tab at the top to open the **Live View**.
2. Select **Cisco Catalyst (DNA) Center API**.
3. In **Instance URL**, enter the URL or public IP address of your Cisco Catalyst Center instance. The IP address can also specify a custom port number, example: `12.34.56.78:1234` .
4. Input your username and password, and click the **Continue** button.
## Export to Cisco Catalyst Center
{% embed url="" %}
Hamina Network Planner can export the network design as a file that can be imported to Cisco Catalyst Center (formerly known as Cisco DNA Center or "DNAC").
{% hint style="info" %}
Currently Hamina only supports exporting the floorplan and AP details (name, model, coordinates, orientation, power). It does not export the walls, attenuating objects or network equipment.
{% endhint %}
In Cisco Catalyst Center, there are two ways to import data:
* With a hierarchy file generated in Hamina Network Planner. This generates a `.csv` file, which contains the entire hierarchy including buildings and floors. The following instructions use this method, which is recommended.
* Manually, without a hierarchy file. With this method, you will need to define an exact hierarchy, or Cisco Catalyst Center will fail to import the Floor Maps. Instructions for this method can be found in a [later section of this article](#manual-hierarchy).
#### Exporting from Hamina Network Planner
1. In the Project menu, select **Export Project**.
2. Select **Cisco Catalyst (DNA) Center** from the list, and click the **Continue** button.
3. Define the **Areas**, **Building** name, and choose which floor plans to export. **Sub-areas** can be defined with a `/` symbol.
Since we will be downloading a hierarchy and uploading it to Cisco Catalyst Center, you can define areas, sub-areas, and the building as you see fit (but you may want to consider your existing hierarchy).
4. Click **Download hierarchy** and **Download project.**\
\
**Download hierarchy** will download a **Sites** / **Hierarchy** / `.csv` file, which defines Areas, Sub-areas, Buildings, and Floors.\
\
**Download project** will generate a **Project** / **Floor Maps** / `tar.gz` file, which contains the maps and APs.
#### Importing to Cisco Catalyst Center
1. In Cisco Catalyst Center, click the menu icon.
2. In the menu, click **Design** and then **Network Hierarchy**.
3. In the toolbar along the top, click **Import**, then **Import Sites**.
4. Upload the **Sites** / **Hierarchy** / `.csv` file that was generated in Hamina, and contains definitions for Areas, Sub-areas, Buildings, and Floors.
5. Once the import is complete, you'll see the hierarchy in Cisco Catalyst Center. *Optionally, you can define an address for your new building.*
6. Now that the hierarchy exists, select **Import** > **Import Floor Maps** to upload the **Project** / **Floor Maps** / `tar.gz` file, which contains the maps and APs.
7. Follow the prompts in Cisco Catalyst Center to import the file, preview the import, and view the hierarchy.
8. Click on one of the maps to view it.
### Manually Defining a Hierarchy
It is possible to manually define a hierarchy in Cisco Catalyst Center, and create a Hamina project file that conforms to the Catalyst Center hierarchy. In Cisco Catalyst Center:
1. Create the desired area and sub-area hierarchy.
2. Next to the desired area, select **...** > **Add Building**, and create the building.
3. Next to the newly-created building, click **...** > **Add Floor**.
4. In the building, create each floor that you intend to export from Hamina. *Note: Ignore any warnings amount missing images, as those will be added when the `tar.gz` file is imported.*
5. In Hamina Network Planner, download the **Project** / **Floor Maps** /`tar.gz` file, making sure that the areas, sub-areas, building name, and floor plan names all match Cisco Catalyst Center. *Note: Everything must match, or the import will fail.*
6. In Cisco Catalyst Center, in the toolbar along the top, click **Import**, then **Import Floor Maps**.
7. Import the **Project** / **Floor Maps** /`tar.gz` file. Follow the prompts in Cisco Catalyst Center to import the file, preview the import, and view the hierarchy.
8. Click on one of the maps to view it.
### Updating Access Points
It is possible to update access point models and placements on a floorplan.
1. Make adjustments to the project in Hamina as needed.
2. Export the **Project** / **Floor Maps** /`tar.gz` file from Hamina. *Note: You can either export all floors, or you can choose to only export the floors that need to be updated (recommended).*
3. Using **Import** > **Import Floor Maps**, import the **Project** / **Floor Maps** /`tar.gz` file.
4. Access point locations and models will be updated.
