> For the complete documentation index, see [llms.txt](https://docs.hamina.com/hamina/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hamina.com/hamina/live/juniper-mist.md).

# Juniper Mist

Learn how to import and export maps, access point locations, and access point settings to and from Juniper Mist.

Hamina Network Planner includes integration with Juniper Mist, which can be used for both Import and Export purposes.

The **Import** function will bring the map, scale, and access points (including model, name, MAC, serial, transmit power, channel, and channel width settings) into Hamina Network Planner. Then, you can add walls, attenuating objects, and scope zones to simulate the current Juniper Mist network configuration in a predictive model.

The **Export** function rapidly deploys a new site, or updates an existing site directly from Hamina Network Planner. This removes the need for any repeat map-based deployment work - all of the mapping work is automatically copied directly from Hamina Network Planner.

## Generating an API Token

1. Log into [manage.mist.com](https://manage.mist.com).
2. Select your Organization.
3. In the toolbar on the left, select **Organization** > **Settings**.<br>

   <div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2FQEhFrvqiY52ZRTxArGdD%2FSettings.png?alt=media&amp;token=6aacee79-f5ba-47c3-8b62-362791e8acbf" alt="" width="375"><figcaption></figcaption></figure></div>
4. Scroll down to the **API Token** section, and click **Create Token**.<br>

   <div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2FjdKTAywaFpc849lxgGvg%2Fcreate_token.png?alt=media&amp;token=0a5f22ea-4234-4b7d-a514-43076c4f355e" alt="" width="355"><figcaption></figcaption></figure></div>
5. Name the token, and select a permissions level for it. To import a site and use the Live View, either **Helpdesk**, **Network Admin**, or **Super User** is required. *Note: For monitoring with the Live View, the Observer permission doesn't have enough permissions to perform all client monitoring, and you will receive some authentication error message.*
6. Click **Generate Token** and then copy the token that appears in the **Key** field.<br>

   <div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2FmLN3rrXJvRL1XAG9JyjV%2Fgenerate_token.png?alt=media&amp;token=24cf4433-bc8f-4689-bcb1-6c15544b3d95" alt="" width="375"><figcaption></figcaption></figure></div>

## Import From Juniper Mist to Hamina

1. In Hamina Network Planner, navigate to the **Import** page.<br>

   <div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2FBisoNkbPryFgsrkqMDWk%2FImport.png?alt=media&amp;token=7bd98ccf-e886-46c7-a370-405a8d71ab69" alt="" width="563"><figcaption></figcaption></figure></div>
2. Select your Region, paste in the key, and click the **Continue** button.<br>

   <div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2FUgiGOIMonq0zjmYnZb5O%2Fpaste_key.png?alt=media&amp;token=ab95fa0d-5cdb-40d0-8427-e975f42cb9d3" alt="" width="563"><figcaption></figcaption></figure></div>
3. Select the **Organization** and **Site** that you wish to import, and place a check mark next to any **floor plans** you wish to include in the import. Click the **Import** button.<br>

   <div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2FKGH0afC87wot17ebZzmp%2Fimport.png?alt=media&amp;token=f501a4c7-f948-4f64-aec3-c1a6d1acc889" alt="" width="563"><figcaption></figcaption></figure></div>
4. Add relevant walls, attenuating objects, and scope zones. You can now see what your current Juniper Mist configuration looks like, inside a predictive model.

   <figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2FxUT6cp6sOkyGTsOpsFX6%2Fmist_design.png?alt=media&amp;token=e6e97a80-6b81-475e-a29f-67f7b196be0f" alt=""><figcaption></figcaption></figure>

### Change Image

In Juniper Mist, you can use the **Change Image** feature in the Juniper Mist **Live View** to swap out the background map. When attempting to re-import from Juniper Mist to an existing project in Hamina Network Planner, Hamina will not upgrade the background map. You will need to delete the map/floor in Hamina, and re-import for the new image to appear.

## Exporting from Hamina to Juniper Mist

Using the Export function in Hamina, you can deploy a network to Juniper Mist including the background map and AP locations.

<div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2Fsyx5LcT8d3pRxDCZXKjV%2FExport.png?alt=media&amp;token=d1a68cac-c59d-4020-b5f8-1c1afa2bc5b1" alt="" width="563"><figcaption></figcaption></figure></div>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.hamina.com/hamina/live/juniper-mist.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
