One of the most important parts of wireless network design is setting an accurate scale. Hamina Network Planner uses distance to predict how far signal will travel from each access point, eNodeB, and gNodeB. How signal travels through open space (and through Attenuating Objects) is tied directly to distance, so an accurate scale is very important for the accuracy of the design.

Getting The Scale of a Map

There are several ways to get the scale of a map.

1. Using the built-in scale on the map

2. Taking a measurement (long wall, large room, or long hallway)

3. Measuring the length of the building in Google Earth

Using the Built-in Scale

In some cases, image-based maps (such as JPEG's, PNG's, and PDF's) may have a scale marker built-in. If this is true on your map, then congratulations! You have won the network design lottery, and can easily scale your map.

When using a CAD file (such as a DXF or DWG), there is usually a built-in scale that will be applied as soon as you upload the CAD file.

Taking a Measurement

If the map doesn't include a built-in scale (which is very common), then take a measurement of a long wall, long hallway, or length of a large room to find the scale. Most wireless network engineers carry a laser range finder for this task. Hold it up against the wall, point it to the other side of the long room or hallway, and activate the range finger to measure the distance. Once you have the distance, you can proceed to setting the scale.

Google Earth

If you can't easily get on site to take a measurement, then Google Earth is a great alternative. Just like Hamina, it's even in a web browser!

1. Navigate to https://earth.google.com/web/.

3. Use Google Earth's camera controls to center the building. Selecting 2D in the lower right can be helpful.

5. On the building, choose two points that are opposite of each other to measure. It is always a good idea to use the longest part of the building to get the most accurate scale.

7. Click Done to capture the distance, It will remain on-screen in Google Earth until you take further action.

8. You can now proceed to Setting the Scale in Hamina.

Setting the Scale

3. Left-click on the map, where the first point of the measurement was taken. A blue line will appear that follows the mouse pointer.

5. Press the Enter key, or click the Set button to set the scale.

Measuring Distances in Hamina

Once the scale is set, the Scale tool in Hamina can be used to take various measurements in the design. For example, you can use it to see how wide a room is, or see how far apart access points are from each other.

Overview

Projects menu

Lists all of the projects in your Hamina account, and all projects shared with your account. You can also create new projects here. For more information about creating projects, seeCreating and Managing Projects.

Maps/Floors menu

Lists all of the maps or floors in the current project. Floor plans and images are known as maps until they are assigned to a building with the multi-floor tool, at which point they become floors. You can learn more about managing maps, creating buildings, and ordering floors in Managing Maps and Floors.

Legend

Shows a legend for the selected heatmap. Click on the button to access the Heatmap Settings. Learn more in the Heatmapsarticle.

Toolbar

Shows tool groups, depending on which view the project is in, Simulation, Survey, and Live (beta). To open a group, point to it. Click on a tool to select it.

Keyboard Shortcuts and Hotkeys

Individual tools can be selected with a single keyboard hotkey (shortcut) press.

Camera controls

• Plus and Minus - Zooms in and out. This is a pretty inefficient way to zoom in and out though, so be sure to check out Panning and Zooming Maps to learn better ways.

• Zoom to fit - Changed the zoom to fit the entire canvas on screen.

• 3D / 2D - Alternates between 2D and 3D modes. Note that some tools are disabled in 3D mode.

• Switch to mouse mode / Switch to trackpad mode - Changes the behavior of the scroll wheel. See Panning and Zooming Maps for more information.

• Panning - It looks like a control, but it's not! This is just a reminder of how to use the spacebar to pan the map.

Layer controls

The Layer controls allow you to show and hide different types of objects on the map. When they're unchecked, they're still there - just hidden! 🤫

Details Pane

This pane serves several different functions, depending on which tools and objects are selected. For example, with the Access point tool selected, the title of the details pane will be Add access point. Any clicks on the map will place an access point with the settings defined in the Add access point pane.

With the Edit tool selected, clicking on an access point will show the Edit access point pane, where you can make changes to the selected access point. You can learn more in the Access Pointsarticle.

Adding Additional Maps

Additional maps can be added to Hamina in the Floor drop-down menu at the top. Click the Floor drop-down menu, and click the Add a floor button to add additional maps.

Renaming Maps

To rename a map, click on the Floor drop-down, point to the floor, and click Rename.

Map Sorting

In the Floor dropdown, maps are sorted numerically/alphabetically in descending (largest to smallest) order, which causes the floors to be sorted logically in how they would stack up in a building, for example:

• Floor 4

• Floor 3

• Floor 2

• Floor 1

It is possible to further organize maps with additional names, such as the names of buildings.

Map Sorting for Buildings

When floors are added to a building, they are sorted in the map dropdown based on their order in the building, which can override the default map sorting.

Creating a Building

When a map is added to a building, the maps can be stacked up and aligned to form multiple floors.

To add floors to the building for alignment:

1. Ensure that at least one map has the correct scale, and select it with the Floor menu at the top.

2. Click on the Floor alignment tool in the toolbar on the left.

3. In the Floor alignment pane on the left, drag any desired floors into the build area at the top.

4. Drag the floors into the correct order within the building, with the lower floors on the bottom of the list.

Aligning Floors

Floor alignment is accomplished by dragging the yellow map until it aligns with the black map.

• The black map is the the current floor, e.g. the map that is selected with the Floor menu on the top.

• The yellow map is the floor that is currently being moved and resized. The position and scale of the yellow map is changed in relation to the position and scale of the black map. You can change which map you want to move and resize by clicking on other maps in the Floor alignment pane.

Align the floors by identifying common features between floors, such as elevators and stairwells.

Resizing Floors

In addition to clicking and dragging the yellow map around, you can also use the corner handles to resize the map. The yellow map scale will change, respecting the scale of the black map.

Floor Height and Attenuation

The height of each floor and the attenuation of each floor is editable. The attenuation value is for the the space between the current floor and the ceiling of the floor below.

Hamina Network Planner models a static floor thickness of 0.5 meters, and calculates loss on a per-meter basis as the RF travels through the floor.

The input value is the total loss for a vertical RF path through the floor, in other words, the shortest possible path through the floor.

The more oblique (slanted) the RF path through the floor is, the longer a distance the RF must travel to get through the floor, and the more loss the signal will experience.

Floor Holes

Create openings in floors for atriums and lobby's using the Floor Holes tool. This creates a 'hole in the floor' for the currently selected floor. For example, a 4 story building with a ground floor reception lobby open to the roof would need holes added to floors 2, 3 and 4, to create one large opening from the top of the building to the bottom.

Cropping Maps

Hamina Network Planner supports non-destructive map cropping, so you can change the cropping of the map without modifying the original floor plan image. When a crop is applied, it can be changed back at any time.

Cropping a vector-based map image (such as a PDF or CAD file) will also automatically resample the map. For example, if the background map is a very large warehouse with lots of white space, Hamina Network Planner might accidentally crush the resolution to fit the image within 8000x8000 pixels (the maximum map resolution). Applying a crop to remove whitespace will cause the image to resample, which can dramatically improve or completely fix the resolution of the map.

1. In the Maps/Floors menu, point to the desired map and select Adjust.

2. The Adjust floor plan image pane will appear on the right. Click the Crop button.

3. On the map, either click and drag to create a rectangle, or use the handles on the corners of the crop area to select the desired area to crop.

4. At the top center of the select crop area, click the Apply crop area button.

To create a new project, click on the Project drop-down menu, and then the + New project button at the bottom of the menu.

The Create First Project window will appear, which contains several settings.

Project name

Defines the name for the project. If you are working on a named building, this is a good place to put it.

Country

Defines the regulatory domain of the network, and will determine which Wi-Fi channels are available for use.

Environment

Determines how much "blanket attenuation" to apply to the map if the user hasn't placed any walls or attenuating objects.

As soon as any walls or attenuating objects have been drawn on the map, then the predictive model reverts to Free Space Path Loss + Attenuation from Walls + Attenuation from Objects.

Project folder

Projects can be grouped together with folders. You can use folders to group together projects on a campus, by larger project, or by customer.

Sub-folders can be created by adding forward slashes. For example:

Area A / Campus A / Building 1

Area A / Campus A / Building 2

Area A / Campus B / Building 1

Create an Account

To create an account, visit the Hamina instance that is the closest to you.

Hamina Instances

• 🇪🇺 EU Instance: https://eu.hamina.com/

• 🇺🇸 US Instance: https://us.hamina.com/

Create Your First Project

The first time you launch Hamina, it will prompt you to name and save a project.

Upload a Floor Plan

After naming and saving your first project, Hamina will prompt you to either upload a floor plan, or add some notes to the project. You can do either of these at a later time, but most users start with a floor plan.

Supported image types:

• PNG

• JPEG

• PDF

• DWG

• DXF

• TIFF

• WEBP

Hamina supports a maximum image size of 8000 x 8000.

Subscribe to Hamina Network Planner

If this is the first time you've logged into Hamina Network Planner, then you probably don't have a subscription yet. Without a subscription, you can't design networks in Hamina, but you can still do a few things like:

• Add project notes

• Add floor plans

• Set the scale

• Create in/out of scope zones

• Add map notes

• Use the client view

• Invite others to collaborate on your project

If you don't have a subscription, you won't be able to:

• Select the Edit tool

• Draw walls or attenuating objects

• Place or move access points

• Place or move switches or PoE clients

• Create new reports

• Open previous reports

• Retrieve existing online report sharing links

• View or edit the Bill of Materials

To subscribe to Hamina Network Planner, click on the Upgrade button in the upper right, choose between Hamina Network Planner and Hamina Network Planner Plus, and click the Buy button. You will be taken to another page where you can complete your purchase.

To learn about the differences between Hamina Network Planner and Hamina Network Planner Plus, visit the Hamina Pricing page.

Attenuating Objects are similar to walls in that they create obstacles that reduce signal strength in Hamina. Walls are thin, and knock down signal strength by a pre-determined amount (depending on the wall profile). Attenuating Objects, on the other hand, knock down signal strength depending on how far the signal travels through the object. This makes Attenuating Objects much more suitable for modeling things like warehouse shelving, large machinery, or any other semi-solid non-wall objects.

Use Attenuating Objects to model large obstacles. Don't worry about smaller objects like furniture.

Drawing Attenuating Objects

Rectangles

With the left mouse button, click and drag from one corner of the object to the opposite corner, and release the mouse button.

Free-Form Attenuating Objects

1. Much like drawing walls, right-click to begin drawing the attenuating object.

2. Left-click to create each node.

3. When the final node has been placed, right-click to stop drawing and complete the attenuating object.

Custom Attenuating Objects

Measuring Attenuating Objects

Adding or Modifying Attenuating Object Profiles

With the Attenuating Objects tool activated, the Attenuating Object pane will appear on the right. Click the Add or Modify button at the bottom.

The Attenuating Object Editor window will appear. From here, you can:

• Edit existing objects (click on the profile to edit it)

• Duplicate object profiles to create your own (click the Duplicate button in the object profile)

• Create your own (click the Add a custom wall button)

Selecting Heatmaps

You can access heatmap options by clicking on the Expand button in the Legend popover, which is in the lower left corner of the canvas.

When the Legend popover is expanded, the Heatmap settings appear. You can choose the Technology, Heatmap, and Band (for Wi-Fi). The exact available settings depend on whether Simulation, Survey or Live is selected.

The Global settings button in the upper right of the popover reveals more settings, some of which change depending on the technology and heatmap that is selected.

Heatmaps

Wi-Fi

• Coverage

  • Primary - Shows signal strength from the loudest access point.

  • Secondary - Shows signal strength from the second loudest access point, which helps ensure that there are always at least two access points above a certain signal strength threshold. Important for redundancy and smooth roaming performance.

  • Tertiary - Shows signal strength from the third loudest access point, which helps ensure that there are always at least three access points above a certain signal strength threshold. Primary used for Wi-Fi-based real-time location services.

• SNR - The Signal-to-noise Ratio shows how much signal strength there is above the noise floor.

• Interference - Shows the maximum number of interfering APs for any AP with which the client can associate at that given point on the map.

• Data rate - Shows the theoretical maximum data rate available, based on on the SNR.

For Hamina Network Planner Plus users, most Wi-Fi heatmaps maps offer both Downlink and Uplink options.

• Downlink - Shows the heatmap from the client's perspective. For example, Primary Coverage with Downlink selected would show the client's perspective of received signal strength from the access point.

• Uplink - Shows the heatmap from the access point's perspective. For example, Primary Coverage with Uplink selected would show the access point's perspective of received signal from the client.

4G/5G

• RSRP

  • Primary - Shows the signal strength from the loudest base station, in RSRP (Reference Signal Received Power).

  • Secondary RSRP - Shows the signal strength from the second loudest base station.

  • Tertiary RSRP - Shows the signal strength from the third loudest base station.

• SINR - Shows the signal quality in SINR (Signal to Interference & Noise Ratio).

• Downlink throughput - Shows the expected throughput.

All 4G/5G heatmaps maps offer both Downlink and Uplink options.

• Downlink - Shows the heatmap from the client's perspective. For example, Primary Coverage with Downlink selected would show the client's perspective of received signal strength from the base station.

• Uplink - Shows the heatmap from the base station's perspective. For example, Primary Coverage with Uplink selected would show the base station's perspective of received signal from the client.

BLE, Zigbee, and EnOcean

Adjusting Heatmap Settings

To switch heatmaps, configure project requirements, and adjust heatmap settings, click on the Expand button.

Heatmap Thresholds

To divide the heatmaps into multiple colors, Hamina Network Planner uses configurable thresholds. For each heatmap, there is a default division of colors, and labels for each division that can be changed and customized, per project.

The labels can be renamed in the row above legend bar, and the thresholds can be changed and deleted using the row below. Click the + button on the right to add thresholds back in. The maximum amount of thresholds is three, and the minimum is one.

Heatmap Settings

To access more heatmap settings, click the Global heatmap settings in the upper right corner of the Heatmap settings popover.

The contents of the Global heatmap settings popover will vary, depending on:

• The selected view (Simulation, Survey, or Live)

• The selecte heatmap and technology

• Whether the map is being viewed in 2D or 3D

Global Heatmap Settings

• Opacity - Adjusts the opacity of the heatmap, which can be adjusted lower to make the map underneath the heatmap easier to see, or adjusted higher to make the heatmap easier to see.

• Guess Range (Survey view only) - Adjusts the radius around each site survey data point that the heatmap is projected. If a projection contains multiple datapoints, they are combined with a weighted average. Increasing the guess range fills in more gaps in the heatmap, but makes the heatmap smoother (but less detailed) as the projections naturally contain more and more datapoints.
• Client height (Simulation view only) - Adjusts the height of the client devices in the network simulation. By default, Hamina Network Planner simulates a client that is 1 meter off the ground (which is the average height of a client in a user's hand, or on a desk).

Fast ray tracing settings

• Simulated diffraction and reflection effects (Hamina Planner Plus only) - Adjusts the intensity of Fast Ray Tracing effects. For more information, see Fast Ray Tracing.

Other settings

• Display heatmap at client height (3D only) - In 3D mode, by default, Hamina Network Planner places the heatmap on the floor. Enabling this option causes the heatmap to hover off the floor at the height of the client, which may be useful for visualization purposes. This option is only available in 3D.

• Full Building Propagation (Beta) - Without this option enabled, Hamina Network Planner only calculates propagation for the current floor, and the floors above and below the current floor. This usually provides a good balance of speed and accuracy, as most buildings don't see significant signal propagation beyond one floor in either vertical direction. With this option enabled, signal propagation is calculated across all floors in the building, which can be useful for multi-floor atriums, theaters, and stadiums.

• List all APs on mouseover - By default, the Legend only shows the loudest AP on most heatmaps. With this option enabled, all access points will be listed on mouseover.

• Auto-select prediction input - By default, Hamina chooses which model to use for prediction. By disabling this option, you can manually choose which model Hamina should use in both the Simulation tab and Live tab.

Simulation Models

Hamina has several different models for simulations, depending on the view that is selected (Simulation, Survey, Live) and what data is available.

Simulation and Live View (Feature Preview) prediction modes:

• Walls + Objects: Uses free space path loss and attenuation from walls and attenuating objects to simulate propagation.

• Environment Type (PLE): Modifies signal propagation across the entire map, depending on the selected Environment type in the Project settings. Technically speaking, Environment Type changes the Path Loss Exponent (PLE) to cause more loss in open space. Any walls or attenuating objects on the map will be ignored. This model isn't recommended unless there is absolutely no other data source available.

• Environment Learning (AP-AP): With Juniper Mist and Arista (in the Live View beta), measurements are taken between access points to create attenuation on the map.

• Environment Learning (Survey): Site survey data can be used to create attenuation on the map (currently available as a beta feature).

Heatmap Calculations

Hamina Network Planner keeps planning fast, smooth and responsive by calculating heatmaps in stages. The first stage is a relatively low-resolution heatmap, so you get instant (or near-instant) results. Then, Hamina Network Planner opportunistically calculates successively higher-resolution heatmaps until it was reached the maximum resolution for the browser window.

Lower-resolution stages can produce two side effects:

• Blocky and less-detailed heatmaps

• "Holes" in coverage areas such as warehouse aisles

In most cases, these side effects either don't appear, or simply don't matter. In some cases (such as with warehouse aisles), it is necessary to let Hamina Network Planner calculate higher-resolution heatmaps (by simply letting Hamina sit idle for a moment, so it can complete the calculations).

Heatmap Progress Bar

The progress of this calculation is represented with a blue Heatmap Progress Bar along the top of Hamina Network Planner. The progress bar will disappear when the maximum resolution heatmap is completed. It will also reset whenever the calculations start over, for example by changing the viewport or modifying the predictive model (in other words, modifying walls, attenuating objects, or access points).

The calculation is optimized for the current viewport, which is the part of the map that is currently visible in Hamina Network Planner. The viewport changes as you pan and zoom around the project.

Hamina Network Planner will reset heatmap calculations whenever the viewport changes (e.g., by panning and zooming), or whenever the predictive model changes (e.g. by moving an access point or placing a wall). Heatmap calculation is automatically reset and started, so you don't have to think about it - just plan, and we'll take care of the heatmaps for you.

Fast Ray Tracing

Hamina Network Planner Plus includes the option to calculate heatmaps with Fast Ray Tracing, which simulate the effects of diffraction and refraction.

Since FRT (Fast Ray Tracing) heatmaps can take more time to calculate, the heatmap calculation is manually triggered by clicking the Compute FRT heatmap button in the upper right corner.

To disable the FRT heatmap, click the Compute FRT heatmap button again.

Adjusting Diffraction and Refraction Effects

The intensity of simulated diffraction and refraction effects can be adjusted to simulate more or less reflective environments using the Simulated diffraction and reflection effects slider.

The slider is located in the Global heatmap settings popover.

We recommend starting with setting 3, comparing with measurements in the environment (such as a full site survey, or spot-checks from a client device), and adjusting it up or down until the reflectivity more closely matches the real-world measurement.

Being able to quickly zoom in, zoom out, and pan around maps is key to being a fast and efficient network designer. For example, you may need to zoom in to precisely place the start of a wall, quickly pan to another part of the map, place the end of the wall, and then zoom out to see where to draw walls next. We recommend exercising the zoom and pan controls often throughout the design process.

Trackpad and Mouse Modes

Hamina Network Planner offers optimized zoom and pan controls for both trackpads and standard mice with scroll wheels. You can instantly switch modes with the Switch to mouse/trackpad mode button in the camera toolbar on the right.

Trackpad Mode

To pan the map:

• Trackpad: Scroll the map in any direction with two fingers on the trackpad.

• Apple Magic Mouse: Scroll the map in any direction with one finger on the touch surface on the top of the mouse.

• Keyboard + mouse: Hold the space bar, and move the mouse. Release the space bar to stop panning.

To zoom in and out:

• Pinch to zoom in and out.

• (macOS): Hold down the ⌘ key, and two-finger scroll the mouse.

• (Windows): Hold down the Ctrl key, and two-finger scroll the mouse.

Mouse Mode

To pan the map:

• Mouse: Drag the map with the middle or right mouse button.

• Keyboard + mouse: Hold the space bar, and move the mouse. Release the space bar to stop panning.

To zoom in and out:

• Roll the scroll wheel forwards or backwards.

The GPS Coordinates tool allows you to precisely locate the map or building in the project on the globe. This is useful when exporting to some vendors (such as Meraki) which maps and sites on a global map, and use the coordinates to set the country code broadcasted by the access point, and for staying within the constraints of the regulatory domain.

Placing GPS Coordinates

1. In Google Maps, find a location that you can reference both on Google Maps and on the map in Hamina.

2. Right-click on the map, and click on the coordinates at the top of the pop-up menu. They will be placed on your clipboard.

3. Use the GPS Coordinates tool to place the coordinate on the map in Hamina.

4. Paste in the GPS coordinates.

5. Repeat for at least one other coordinate on the map in Hamina.

The Edit tool us used for selecting, editing, or moving objects on the map.

Selecting a Single Object

To select an object, left-click it. Selectable objects include:

• Walls and attenuating objects

• Floor holes, raised floors, and sloped floors

• Scope zones

• Capacity zones

• Access points

• Switches, routers, IDFs, and MDFs

• PoE clients

For most object types, selecting the object will cause an Edit pane to appear on the right.

Selecting Multiple Objects

To select multiple objects, click and drag to make a selection rectangle. Alternatively, hold down Shift while clicking multiple objects, or press ⌘ + A or Ctrl + A to select all objects on the map.

Filtering Objects

When objects are selected, clickable Selection Filters will appear at the top center of the map.

To filter to a specific type of object, click on the associated Selection Filter. This will remove all of the other filters, focusing on the specific object type that you selected.

To remove a specific type of object from the selection, click the X inside the Selection Filter. You can repeat this action to remove any object types from the selection.

Adding Access Points

To add a new access point, click on the Access point tool in the toolbar on the left. This will cause the Add Access Point pane to appear on the right.

In the Add Access Point pane, you can choose the technology, vendor, and model of the access point, as well as the mounting type and height. Then click on the map to place the access point.

Click the Show more expander to view additional options, such as the Access Point Name, Transmit Power settings, Connected via Ethernet selector, and Power allocation (from switch) settings.

Transmit Power

The transmit power of the access point radio is configured as Conducted Power, in other words, the amount of power transmitted by the radio without factoring in antenna gain. The final amount of gain, or EIRP (Equivalent Isotropic Radiated Power) is calculated by adding the Conducted Power and the antenna gain together.

Disabling Radios

Automatically Disabled Radios

The automatic channel planner in Hamina Network Planner runs whenever any changes are made to the predictive model. By default, it will automatically disable radios in the 2.4 GHz band to avoid creating excessive co-channel contention (sometimes called Co-Channel Interference) in the network. This behavior can be changed in the Channel Settings for the project.

When a 2.4 GHz radio has been disabled automatically, the 2.4 GHz channel label will be changed to Off.

Manually Disabling Radios

To manually disable a radio, right-click the channel label beneath the access point on the map, and select Disable.

When a radio has been manually disabled, the channel label will display an X.

Duplicating Access Points

When placing additional access points, Hamina Network Planner will reuse all of the settings from the last selected access point.

1. Select the Access point tool.

2. Click on the access point that you would like to duplicate.

3. Click in an empty place on the map to de-select the access point.

4. The Add Access Point pane will appear on the left, along with the add access point cursor.

5. Click on the map to place additional access points.

Antenna Viewer

Hamina Network Planner includes a built-in antenna viewer for both access points with internal antennas, and external antennas. The viewer shows:

• Horizontal - The 2D, top-down or "Azimuth" pattern.

• Vertical - The 2D, side view or "Elevation" pattern.

• 3D Pattern - A 3D composite of the horizontal and vertical patterns.

• Datasheet gain - The gain of the antenna, according to the datasheet provided by the vendor.

Enabling AP Pattern Viewing

By default, the antenna pattern viewer does not show internal antennas in access points. To enable viewing internal antennas:

1. Open the Account menu in the upper right.

2. Toggle on Internal antenna pattern viewer, and click Save.
3. Now, you can mouse over access points to see their internal antenna patterns.

Downloading Antenna Patterns

For AccelTex, Ventev, and Extreme Networks, antenna patterns are downloadable as an .OBJ file for 3D printing.

For more information about downloading and printing antenna patterns from Hamina Network Planner, check out our blog.

Renumbering Access Points

The access point number is incremented every time a new access point is added to the design. If the user removes some access points, there might be gaps in the numbers.

The Reorganize numbers option will reset the numbering of all access points, switches, and wired clients in a left to right, top to bottom pattern. This will also remove any gaps in the numbers.

To renumber the access points, switches, and wired clients:

1. Click on the Project Menu, then the current project (which will be at the top), and then Settings.
2. Click the Reorganize numbers button.
3. Hamina Network Planner will confirm that the access points, wired clients, and switches have been renumbered.
4. The access point, wired client, and switch renumbering is from left to right, and top to bottom.

Renaming Access Points

Hamina Network Planner uses a name and variable system to programmatically generate names for access points, switches, and PoE clients on the fly. To accommodate this variable system, access point names have two states: Unresolved and Resolved.

An Unresolved Name is the what you see when you are changing the name of an access point, or when you have multiple access point selected. Both the text and the variables will be visible and editable in the name.

A Resolved Name is the final name of the access point, after the text and variables have been applied. By default, Hamina Network Planner access point names resolve to Access Point ${number}.

Variables

You can use Variables to automatically populate the names of access points, switches, and PoE clients. Hamina Network Planner will automatically replace variables with text and numbers when the name resolves. For example, the ${number} field is populated with the access point number.

Variables:

• ${project} - The name of the project.

• ${make} - The make/vendor of the access point.

• ${map} - The current map or floor that the AP is located on.

• ${model} - The model of access point.

• ${number} - The unique number, as assigned by Hamina Network Planner.

• ${switch} - The switch that the AP is connected too.

You can view all of the variables and modifiers directly in Hamina Network Planner by clicking the ? button inside the Access Point Name field.

Editing Access Point Names

Access points can be renamed one at a time, in a manual selection, or all at once (for all access points on the current map).

1. Use the Edit tool to select all of the access points on the current map (usually with command + A or Ctrl + A, and then clicking the Access points filter at the top).

2. Locate the Access Point Name field in the Edit Access Point pane on the right.

3. Enter a new name, including variables.

4. All of the access points will now be renamed, according to the new naming convention that you have applied.

In some cases, you can save a lot of time by using the Auto-draw walls tool in Hamina Network Planner to automatically draw walls on the map! While this can save a lot of time and effort, there are some specific requirements that the map files must meet to be useful for the Auto-draw walls tool.

Compatibility

Separate Layers

Wall types must be on separate layers, for example:

• Interior walls

• Exterior walls

• Windows

• Doors

• Stairwell walls

Often, we see CAD and PDF files that have everything (including walls, furniture, and fixtures) on one layer. When this happens, you can assign materials to individual layers, so Hamina Network Planner can't automatically draw walls.

Vector Graphs (in PDF files)

For PDF files, the floor plans must be drawn with vector graphics. It is not uncommon to see PDF files that use bitmap graphics, which the Auto-Draw Walls tool cannot use. The floor plans in the PDF file must be drawn with vector graphics (which probably means that the PDF was produced with a CAD tool).

Too Much Complexity

Some CAD and PDF files are simply too complicated. For example, they might draw many parallel lines to represent one wall. While Hamina Network Planner tries to account for this, it might not be able to determine where the wall is.

Too Big

Some CAD or PDF files are just too big. If you're working in a warehouse or manufacturing environment, you might find that the environment is just too big for Hamina to handle. Fortunately, those environments typically have lots of repetitive shelves (which are better drawn, copied, and pasted with attenuating objects), or they have relatively few walls that are in straight lines, and are easy to draw. Consider manually drawing large environments such as warehouses, big box stores, and manufacturing facilities.

Automatically Drawing Walls

1. In the Simulation view, in the toolbar, select the Auto-draw walls tool.

2. In the Auto-Draw Walls pane on the right, look through the Choose layer menu to see which layers are relevant to your design. Mousing over each layer will highlight it in yellow on the map. Look for layers such as:

   1. Interior walls

   2. Exterior walls

   3. Windows

   4. Doors

   5. Stairwell walls

3. Click on a layer to select it, and it will turn blue on the map.

4. In the Select material list, choose the material you would like to assign to that layer

5. Repeat the process for all relevant layers. Ignore layers that aren't relevant such as fixtures, furniture, and plants.

6. Once all of the layers are chosen, click the blue Import Walls button the bottom of the Auto-Draw Walls pane.

7. View the results, and see if the Auto-draw walls tool did a good job with your specific CAD or PDF file.

Scope Zones

In Hamina, Scope Zones are used to define where Wi-Fi, Bluetooth and Private Cellular coverage is desired on the map. Using Scope Zones, you can mark which areas are within the scope of the project, and what is beyond the scope of the project.

There are two types of Scope Zone in Hamina:

• In Scope Zones, which defines what parts of the map where network coverage is desired, required, or is otherwise in the scope of the project. This usually includes building interiors, specific suites in multi-tenet buildings, or anywhere that business operations require wireless coverage. In Scope Zones typically encompass an entire building, a significant section of a building, or in the case of an outdoor design, an entire campus area. Any areas outside of the In Scope Zone(s) are automatically considered out of scope.

• Out of Scope Zones, which define what parts of the map where coverage is not desired or required. This could be areas where installing access points is cost prohibitive, such as elevators or stairwells. It could also be places where coverage is simply not needed, such as janitorial closets. Typically, Out of Scope Zones are only used inside of In Scope Zones.

Drawing Scope Zones

We recommend beginning by drawing In Scope Zones, which typically encompass large areas such as:

• The entire perimeter of a single-tenant building (which would automatically exclude the parking lot)

• An entire suite in a multi-tenant building (which would automatically exclude other suites in the building)

• An entire shipping yard, university campus, or downtown area

Next, we recommend drawing Out of Scope Zones inside the In Scope Zone to mark what parts of the map coverage is not desired or required. This typically includes elevator shafts, stairwells, and storage closets.

Drawing Rectangular Scope Zones

To draw a rectangular scope zone:

1. Select the In/Out of Scope Zone tool in the toolbar.

2. With the left mouse button, click and drag diagonally across the map to create a rectangle.

3. Release the mouse button.

4. A rectangular Scope Zone and Scope Zone Toolbar will appear.

Drawing Free-Form Scope Zones

Drawing free-form scope zones allow you to create arbitrary shapes (which is especially useful for drawing the perimeter of a building). Free-form scope zones draw very similarly to walls in Hamina.

To draw a free-form scope zone:

1. Select the In/Out of Scope Zone tool in the toolbar.

2. Left-click on the map to place the first point

3. Left-click elsewhere on the map to place subsequent points

4. After placing the final point, right-click to stop drawing and finalize the amount of points in the free-form scope zone.

Changing the Scope Zone Type

Depending on the size of the zone, Hamina Network Planner will automatically select an In Scope Zone, or Out of Scope Zone. If you'd like to manually change the Scope Zone type:

1. Select the Edit tool from the toolbar

2. Right-click the edge of the Scope Zone

3. The Scope Zone pop-up menu will appear

4. Choose between In Scope Zone and Out of Scope Zone in the pop-up menu

Editing Scope Zones

To edit a scope zone:

1. Select the Edit tool from the toolbar.

2. Click on the border of the Scope Zone that you want to edit.

3. The Scope Zone Toolbar will appear

4. Click and drag points on the Scope Zone to move them. Note: Scope Zone points will have small squares around them.

5. Click away from the Scope Zone to finish editing it.

Hamina includes an automatic channel planner, which runs whenever any adjustments are made to the predictive model, such as adding walls or moving access points.

The channel planner attempts to minimize or remove co-channel interference, uses any available channels allowed in the Channel Settings window.

Opening the Channel Settings

1. Click on any access point on the map.

2. In the Edit Access Point pane, click show more.
3. Click the link to open the Channel Settings window.

Removing Channels

In 2.4, 5, and 6 GHz, it is possible to remove channels from the channel plan. It is very common to remove channels from the 5 GHz channel plan, due to factors such as:

• Neighboring networks already using channels

• Lack of client device support on certain channels (for example, some clients do not support channel 144)

• Lack of access point support on certain channels

• Non-Wi-Fi technologies operating in the same frequency space as some Wi-Fi channels

You can use the Channel Settings window to remove channels from the channel plan but unchecking them, and clicking Save.

Automatic Frequency Coordination (AFC)

Hamina Network Planner Plus integrates with the Wi-Fi Alliance AFC database, so you can query the database during the design phase to see which channels and transmit powers you can use.

Prequisites

• The project country must be set to United States.

• The location defined by the Coordinate markers must be in the United States.

• In the Channel & Network Settings, the Automatic Frequency Coordination (AFC) setting must be enabled.

Setting up Automatic Frequency Coordination (AFC)

1. Set the project country to United States.

2. Using Google Maps, find a precise landmark or location on the map that you can use as a reference point.

3. Right-click the precise landmark or location, and click on the latitude and longitude in the menu tor copy it to your clipboard.

4. In Hamina Network Planner Plus, select the Coordinates tool (which is grouped together with the Scale tool) in the toolbar.

5. Precisely place the Coordinate marker in Hamina in the same location as the reference point on the map.

6. With either Ctrl + V or Command + V, paste the coordinates from Google Maps into the Coordinate marker.

7. Repeat the process a second time in another location on the map.

8. Place a standard power access point on the map.

9. The AFC button will appear new the view controls in the upper right.

In Hamina Network Planner, Capacity Zones are used to add groups of clients to the map, so you can predict how many clients will associate to nearby access point radios, and ensure that no AP radio becomes overloaded.

How Capacity Zones Work

Capacity Zones use the same client roaming algorithm as the Client View to determine which AP radios clients will associate to. When a Capacity Area is drawn on the map, the client types and amount of each client type is evenly distributed throughout the area, and then Hamina Network Planner simulates each client to determine which AP radio it will be the most likely to associate to. The client roaming algorithm also uses initial distribution to spread clients to separate frequency bands (such as 2.4 and 5 GHz).

Creating and Drawing Capacity Areas

1. To draw an area, click on Capacity in the toolbar. The Add Capacity Zone pane will appear on the left.

2. In the Add Capacity Zone pane, you can optionally give the zone a custom name, and define the type and amount of clients.

3. To draw a square Capacity Zone:

   1. With the left mouse button, click and drag diagonally across the map to create a rectangle.

   2. Release the mouse button.

   3. A rectangular Capacity Zone will appear.

4. To draw a free-form Capacity Zone:

   1. Left-click on the map to place the first point.

   2. Left-click elsewhere on the map to place subsequent points.

   3. After placing the final point, right-click to stop drawing and finalize the amount of points in the free-form Capacity Zone.

Editing Capacity Zones

You can change the Capacity Zone name, types of clients, and amounts of clients in a given zone at any time using the Edit tool.

To edit a Capacity Zone:

1. Select the Edit tool from the toolbar.

2. Right-click one of the edges of the Capacity Zone (not necessarily a corner).

3. The Edit Capacity Zone pane will appear. Any edits that you make are saved automatically.

Viewing Capacity Results

When a Capacity Zone is placed on the current map, two additional indicators appear:

• Capacity Indicators underneath each access point.

• Capacity Statistics Pane in the lower left, either in place of, or next to the Legend.

Per-Radio Capacity Indicators

When a Capacity Zone has been placed near an access point, Hamina Network Planner will use the client roaming algorithm to determine how many clients are expected to associate to each radio.

A number will appear underneath each radio channel number, indicating how many clients are predicted to be associated to each radio. If too many clients are associated to the radio, then the indicator will turn red.

Configuring Capacity Thresholds

To configure the per-radio client capacity threshold, click on the Capacity Statistics Pane in the lower right. The Requirements for Capacity Pane will appear on the left, where you can set thresholds for radios in each frequency band.

Capacity Statistics

When a Capacity Zone is placed on the current map, the Capacity Statistics Pane will appear. It has three tabs:

• Radios - Shows how many radios are present on the map for the given frequency band. If the radio is red, that indicates that there are radios that are over capacity. For example, 16/2 indicates that there are 16 radios, but two of them are over capacity.

• Clients - Shows the distribution of all clients on the map, across all of the Wi-Fi frequency bands and all cellular clients.

• Limits - Shows the configured Per-Radio Capacity Thresholds, per Wi-Fi band and all cellular.

The Auto-plan APs tool can be used to:

• Create a rough AP count for budgetary and quoting purposes

• Quickly distribute access points on the map for you to move to your preferred locations

• Create simple wireless network designs

Environments

The Auto-plan APs tool works best in "carpeted" office spaces such as offices, schools, or other environments where access points are mounted to a ceiling of standard height.

Creating an Auto-Plan

Drawing Walls

Adding walls and attenuating objects is an important step in a successful Auto-Plan. Without them, it is possible to rely on the blanket Environment Attenuation (which is determined by the Environment Type in the Project Settings), but only for creating rough estimates for project budgeting and quoting.

Scoping the Project

To understand where to place access points, and where Wi-Fi coverage is required, it is recommended to add Scope Zones to the project.

In Scope Zones typically encompass the building to mark the extents of the building. They may also only encompass a portion of the building or specific area where Wi-Fi is required.

Out of Scope Zones can be used to subtract from a Scope Zone. They are typically used to mark stairwells, elevator shafts, closets, or anywhere else that Wi-Fi is not required.

To learn more about Scope Zones, see Scope Zones.

The Auto-plan APs tool will:

• Only consider the scope of the project

• Will not place APs outside of the project scope

• Will attempt to meet the Primary Coverage requirement on 99+ percent of the scope zone

• Will attempt to meet the Secondary Coverage requirement on 85+ percent of the scope zone (unless the floor plan is very small)

Access Point Configuration

To configure the access points for the design, open the Auto-Plan APs tool.

The Auto-plan APs pane will appear on the right, where you can select an AP model and customize the configuration, such as:

• Color

• Access point make and model (Note: Only omni-directional APs and antennas are supported.)

• Mounting type and height

• Access point name (Tip: variables work great for programmatically populating AP names. See Access Points for details.)

• Transmit power

Running the Auto-Plan

Click the Start the auto-plan button to begin. The Auto-plan APs tool will slosh green paint all over the place iterate through potential designs with a progress indicator in the lower right.

The Auto-plan APs tool will avoid placing APs:

• Near each other

• Near walls

• Near the edges of scope zones

• In line-of-sight of each other.

This should result in a design that usually avoids hallways, places APs near the centers of rooms, and just looks good. 😎

In environments with heavy attenuation (such as concrete walls), the Auto-plan APs tool will add more access points. It is also not unusual to see some small holes in coverage, as the tool attempts to create a balanced network design. The Auto-plan APs tool will never threaten you and in fact, cannot speak. Talk to your doctor to see if the Auto-plan APs tool is right for you.

The Heatmap Legend in Hamina Network Planner shows the current heatmap settings, as well as a variety of other pieces of information depending on the context in the map view.

Mouseover Inspector

The Heatmap Legend features a Mouseover Inspector. It shows details about whatever the mouse is hovering over in the map view. For example, with the Coverage, Secondary Coverage, or Tertiary Coverage heatmaps enabled, the Mouseover Inspector shows the precise signal strength underneath the mouse pointer.

Accessing Heatmap Settings

To quickly access the heatmap settings (which are located in the Adjust requirements pane, click anywhere on the Heatmap Legend.

Viewing Heatmap Statistics

To quickly view statistics about the current heatmap, hover the mouse over the Heatmap Legend. The statistics respect the Scope Zones for the current map or floor.

In the example below, 96% of the floor plan is meeting or exceeding the "High" (green) threshold.

The Client View simulates the roaming behaviors and band preferences of specific client devices, so you can see when the client will most likely decide to roam, and which access point the client will decide to roam to. In most cases, the available clients are simulated using the documented roaming behaviors, as provided by the client vendors.

By knowing which access point a client is most likely to associate to, the Client View also shows useful statistics about coverage, data rate, access point radio capacity.

The Client View tool is available with a Planner subscription, without a subscription when viewing a project, and in web-based reports.

Using the Client View

To activate the Client view tool, click on Client view in the Network section in the toolbar.

In the Client Experience pane on the right, select the desired Wi-Fi or Cellular client from the Client device drop down.

Click on the map to place the client, and view the network from the client's perspective. Click and drag the client across the map to simulate client movement. The client will roam from access point to access point, based on the client's known roaming algorithm.

Client View Details

With the client placed on the map, or being moved around the map, the Client View Details pane will appear.

• The blue dashed line shows which AP the client is currently associated to.

• The thin grey dashed lines show roaming candidates.

Listed in the Client View Details pane:

• Coverage: The current received signal strength by the client. The client is assumed to have a 0 dBi, isotropic (perfectly omni-directional) antenna.

• Data rate: The current expected data rate of the client, which is based on:

  • AP and client spatial streams

  • AP and client Phy types

  • AP and client signal-to-noise ratio

  • Channel width

• Interference: How much co-channel interference the client is experiencing from APs.

• Radio Capacity: Appears whenever the client is near a Capacity Zone, and is a percentage of the AP radio's amount of associated clients and the capacity threshold for the AP radio.

Along the bottom of the Client View Details pane:

• Current band: The frequency band that the client is associated in. Hamina Planner will simulate a client performing an inter-band roam, or roaming to an AP in 2.4 GHz, when no 5 GHz option is available, per the known roaming algorithm of the selected client type.

• The MCS, client spatial streams, and channel width, which is all used to calculate the Data rate.

Client View Settings

The Client Experience pane on the right has additional settings:

• 6 GHz capable: Enables 6 GHz capabilities for the selected client.

• Wi-Fi 7 capable (coming soon): Enables Wi-Fi 7 for the selected client.

• Show association area: Disables the current heatmap, and shows a blue area in which the client will stay associated to the AP. If the area is red, then the client is associated to an AP on a different floor.
• Link direction (only with Hamina Network Planner Plus)

  • Downlink: Displays simulated values as received and measured by the client.

  • Uplink: Displays simulated values as received and measured by the AP.

  • Worstlink: Displays either downlink or uplink, whichever has the worst signal (RSSI for Wi-Fi, or RSRP for Cellular). Worstlink is the default setting.

Below the Show more expander, there are further settings:

• Client height: The height of the client. This setting is linked to the Client height setting in the Adjust requirements pane.

• Noise floor: Sets the noise floor, per band. This setting is linked to the Noise floor setting in the Adjust requirements pane for SNR and Data Rate heatmaps.

• Client transmit power: Sets the transmit power of the client in milliwatts.

• Min. interfering RSSI: Defines the minimum signal strength threshold for an access point to be considered "interfering".

Drawing walls is one of the most important parts of creating a wireless predictive model. The walls help Hamina "see" where the obstructions are, so it can accurately predict signal propagation on the map.

Drawing Walls

2. Left-click once to start drawing a wall segment.

3. Left-click again to place the wall segment.

4. Continue left-clicking to chain multiple wall segments together.

5. Right-click to stop drawing walls.

Automatic Wall Tracing

As a beta feature, Hamina Network Planner can automatically trace walls on floor plans of indoor, "carpeted" space such as offices and schools. In warehouses, manufacturing environments, stadiums, outdoor maps, or on maps of low quality (like those that are meant for indoor navigation, and aren't for architectural or engineering purposes), manual drawing will be required.

Enable Automatic Scale, Scope and Wall Tracing Beta

1. In the Account menu in the upper right, select Preferences.

2. Select the Beta Features tab.

3. Check Enable Automatic Scale, Scope and Wall Tracing beta.

Automatically Trace Walls

1. Upload a new map to Hamina Network Planner.

3. Next, Hamina Network Planner will auto-trace the walls. When the tracing has been completed, a sparkle emoji ✨ will appear on the Walls tool. At this point, open the Walls tool.
4. The Walls pane will appear, where you can select between Draw and Auto-draw. With Auto-draw selected, you can change the material type for auto-detected walls and doors, and see a preview of the automatic walls on the map. When you're ready, click the Auto-draw walls button.
5. Further assign specific wall types by using the Edit tool to click, drag, and select groups of walls. Then use the Edit Walls pane or hotkeys to assign walls with hotkeys as desired.

Custom Wall Types

While Hamina includes some pre-set wall types to get you started, it's a great idea to change the existing profiles, or create your own to make the predictive model as accurate as possible.

Measuring Walls

While the built-in defaults in Hamina are a good starting point, it's a great idea to take measurements of the walls in the real world, and input them into Hamina to increase the accuracy of the design. Modifying walls in one project does not affect your other Hamina projects.

1. Use a piece of hardware to create a 5 GHz network. This could be as complex as an AP-on-a-stick setup, or as simple as a 5 GHz hotspot on a smartphone. The idea is simply to create beacons in the 5 GHz band.

2. Post the AP 3 to 5 meters away from the wall that you want to measure. Signal strength tends to drop off quickly within the first two meters, making it more difficult to get accurate measurements.

3. Use a device that can measure RSSI, such as a Wi-Fi scanner (Wi-Fi Explorer Pro, MetaGeek inSSIDer), real-time packet analysis tool (MetaGeek Tonic), or handheld Wi-Fi measurement device (NetAlly AirCheck G2 or G3), or our very own Hamina Onsite + Oscium Nomad. Take a signal strength measurement on the close side of the wall. Note the signal strength.

4. Take a signal strength measurement on the far side of the wall, and make note of it.

5. Subtract the first signal strength from the second. For example, if you saw -60 dBm on the close side, and -68 dBm on the far side, then you saw 8 dB of loss.

6. If you'd like, take several measurements and average them out before inputting them into Hamina. The more measurements you take, the more accurate Hamina's predictions will be, overall.

We recommend identifying the 3 to 5 most common types of walls in the building, getting measurements for them, and inputting them into Hamina. That should give you reasonable accuracy, without taking too much time gathering data.

Adding and Modifying Wall Profiles

With the Draw Walls tool activated, the Draw Walls pane will appear on the right. Click on the Add or Modify button at the bottom.

The Wall Editor window will appear. From here, you can:

• Edit existing wall profiles (click on the profile to edit it)

• Duplicate wall profiles to create your own (click the Duplicate button in the wall profile)

• Create your own (click the Add a custom wall button)

Importing access points

• Click project name

• From project menu select Import

• Select vendor

• Select the network where you want to import access points from

• Select "Import unused access points from the inventory" if you want to import unassigned access points (not assigned to any location/site/network) from the organization inventory.

• Select "Import unused access points from the selected network" to import unused access points (not assigned to any floor plan) from the network.

• Click import

Matching simulated access points by MAC/serial

• Select an access point from map (after importing access points)

• Click "Show more" from the side menu.

• Select MAC/serial from the "Mac & Serial" field.

The Floor Plan Import/Export feature allows users to seamlessly import and export floor plans to and from cloud infrastructure systems, streamlining the wireless network design, deployment, and remediation cycle.

With this feature, you can easily import existing floor plans into Hamina, enabling you to plan changes to existing networks or just see how the current network performs. Additionally, the export feature allows users to export their designs back to vendor systems.

Export Workflow

1. If the new site is created in Hamina, it will create a new site on the infrastructure.

2. If a matching floorplan doesn't exist, Hamina will export maps from Hamina to the infrastructure site.

3. If the user has planned APs that are MAC-matched in Hamina, it will assign them to the site and place them on the map.

4. For APs that have been placed on map in Hamina but have not been MAC-matched:

   1. If the Utilize unused access points from organization checkbox is checked, Hamina will commission all the non-MAC-matched planned APs to site (by picking APs of matching types from the inventory at random). Note: If there are more planned APs on the floor plan in Hamina than APs of the same type in the vendor inventory, then not all planned APs will be commissioned to the site or placed on the map.

   2. If the Utilize unused access points from organization checkbox is unchecked, only MAC-matched APs will be commissioned to the site and placed on map.

5. If the floor plan on the vendor system has extra APs placed that don’t exist in Hamina, Hamina will remove the extra APs from map. Note: These APs will not be removed from the site, just from the map.

Hamina Network Planner includes integration with Arista, which can be used for Import, Export, and Live View (which is currently available as a beta feature) 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 Arista 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.

To add a network switch, select Network infrastructure under the Network section on the left.

The Add Network Infrastructure pane will open on the right.

Select the applicable Type of network equipment from the drop down.

Optional: Customize the name, number of ports, and power budget for the device.

Click on the map at the desired location to place the specified wired network equipment.

To view power and port usage info, select one of the wired network infrastructure devices on the floorplan. The usage info will be show on the right.

To view power, port, and cabling details for the network click on Power & Cabling Details.

This will provide a detailed power, port, & cabling report for the entire network infrastructure.

Switch Redundancy

In Hamina Network Planner, it is possible to plan the network for switch redundancy, and to quickly simulate the effects of a switch outage on the wireless network.

To plan for switch redundancy:

1. Plan the wireless network, and place switches on the map.

2. Press Ctrl + A or ⌘ + A, and select the Access Points filter to select all of the access points on the map.
3. In the Edit Access Points pane, connect all of the access points to a specific switch.
4. Click on an empty place on the map to de-select all access points.

5. Hold down the Shift key, and click on all of the access points that you would like to connect to another switch. If the Coverage heatmap is enabled, you can see what the selected access points are covering.
6. Back in the Edit Access Points pane, connect the selected access points to another switch.
7. Optionally, assign a different color to all of the APs that are connected to the alternate switch, which makes them easier to identify later.

Viewing Switch Coverage

With the Coverage heatmap enabled, select a switch to filter the heatmap to the access points connected to the switch.

Renumbering Switches

The process for renumbering switches is identical and uses the same function as renumbering access points.

Hamina Network Planner offers a built-in, customizable reporting systems. It can generate a static, traditional PDF report, or a web link to an online, interactive report.

The online, interactive report is essentially a read-only version of Hamina, with full panning, zooming, and interactivity. The report viewer doesn't need a Hamina account or license - they only need a link to the report (and a password, if you choose to password-protect it).

Creating a Report

To create a report in Hamina Network Planner:

1. Click the Reporting button in the upper right. Then, select Create a new Report.
2. A new browser tab will appear. Name the report, and click Create. Note: You can choose a previous report to use as a template.
3. The Reporting Tab will now be visible, where the report can be customized, exported to a PDF, or shared.

Reporting Tab Overview

The Reporting Tab has several sections:

1. Generate PDF - Generate and download a static PDF version of the report.

2. Share Link - Customize and create a link to a live, interactive, web-based version of the report.

3. Pages - Switch between different pages of the report, and hide/show pages to deliver the relevant content to whoever will view the report.

4. Page Title and Description - Customize the title and description of each page in the report. Changing the title here will also change it in the Pages column.

Adding a Custom Logo

In the upper right, you can upload a custom logo, such as your company logo to add branding to your report. You can upload it either by clicking on the field, or dragging a logo to the field.

Hiding and Showing Pages

To switch to a different page, click on the page in the list.

You can hide pages from the final report by hovering your mouse over a page, and clicking the Hide button.

Once a page is hidden, click the Show button to re-enable the page for the final report.

Pages

Summary

Bill of Materials

Lists all of the materials required to complete the project.

Project Notes

The Project Notes page contains a rich text editor that you can use for any documentation purposes within the project.

Online Reports

Online Reports in Hamina Network Planner provide your managers, customers, and project stakeholders with a fully interactive, read-only Hamina Network Planner interface. The user interface is very similar to Hamina Network Planner, except there are no tools, and the report viewer can navigate between heatmaps and views with a simple menu.

The heatmaps and views that the user sees are determined by which pages you show and hide.

Sharing an Online Report

To share an Online Report, click the blue Share button in the upper right.

Next, you'll have the option to create a password for the report. Click the Create links button to create a link.

The report will be available as long as the report exists. You can click the red Revoke links button to make the report no longer accessible.

PDF Reports

If the customer requires a physical deliverable, you can generate a PDF report with the Download button in the upper right. Select Generate PDF to begin the report generation progress, at which point you will see a progress indicator. When the report has finished generating on the Hamina Cloud, the Download PDF button will become available.

With a Hamina Network Planner Plus subscription, Hamina's private cellular network planning capabilities are unlocked. This grants the ability to view cellular heatmaps, place private cellular base stations, and configure frequency use settings.

Spectrum Use Configuration

To configure cellular spectrum use, click on any eNodeB. In the Edit Access Points pane on the left, click the Show more expander. Under Auto-Channel Assignment, click the here link to open the Channel Settings window.

In the Channel Settings window, you can configure:

• Frequency Band

• Frequency Reuse

  • Per Base Station Channel Width

  • Number of Available Channels

  • Subcarrier Spacing for 5G

Supported Bands

Hamina supports the following bands:

• 450-465 MHz (Band 73 TDD)

• 703-803 MHz (Band 28 FDD)

• 791-862 MHz (Band 20 FDD)

• 824-894 MHz (Band 5 FDD)

• 1.71-188 GHz (Band 3 FDD)

• 1.85-1.99 GHz (Band 2 FDD)

• 1.88-19.2 GHz (Band 39 TDD)

• 1.92-2.17 GHz (Band 1 FDD)

• 2.5-2.68 GHz (Band 7 FDD)

• 2.3-2.4 GHz (Band 40 TDD)

• 2.57-2.62 GHz (Band 38 TDD)

• 3.4-3.6 GHz (Band B42 TDD)

• 3.55-3.7 GHz (Band 48 TDD)

• 3.6-3.8 GHz (Band B43 TDD)

• 3.3-3.8 GHz (Band n78 TDD)

• 3.3-4.2 GHz (Band n77 TDD)

• 5.15-5.925 GHz (Band 46 TDD)

Base Station Configuration

Just like with Wi-Fi access points, Hamina supports the selection of eNodeB vendor selection, model selection, and external antenna selection (if supported by the eNodeB).

Antenna patterns for accurately modeled in 3D for all eNodeBs with internal antennas, and for all external antennas.

For eNodeB base stations that support external antennas, Hamina support specifying the mounting type and down tilt of the antenna in degrees. Transmit power at the radio is configurable, and the EIRP is calculated for the antenna.

Mounting, Height, and Downtilt

Also like Wi-Fi access points in Hamina, the height, downtilt are fully configurable, and all signal propagation calculations are calculated in 3D.

4G/5G Heatmaps

Hamina supports the following heatmaps for private cellular planning:

• Max RSRP

• Secondary RSRP

• Teriary RSRP

• SINR

In the Heatmap dropdown, the settings for each heatmap type can be edited by clicking the Adjust requirements link.

For Max RSRP, Secondary RSRP, Tertiary RSRP, and SINR, you can adjust:

• Opacity: The opacity of the heatmap. A lower percentage makes the background map easier to see.

• Client height: The height height that the client device is modeled at, and this the vertical slice that is represented in the heatmap

• Client device: The cellular client type, which changes the amount of spatial streams and generation of cellular technology.

For SINR only, the Cell average load % is also adjustable.

Per-Frequency Signal Propagation

When planning private cellular networks, Hamina Network Planner Plus models RF propagation on a per-frequency basis. In other words, it models the propogation based on the selected frequency of each radio unit. A radio unit using a lower frequency in the band will propagate better than a radio unit using a higher frequency in the band.

Hamina Network Planner includes integration with Aruba Central, which can be used to import maps and access points (including model, name, MAC, serial) into Hamina Network Planner. Then, you can add walls, attenuating objects, and scope zones to simulate the current network configuration in a predictive model.

Generating an API Access Token

1. Log into Aruba Central and select Organization from the side menu.

1. Select the Platform Integration tab.

1. Under the API Gateway section, select Rest API.

1. Select the My Apps & Tokens tab.

1. Select Add Apps & Tokens.

1. Click the Generate button to confirm creating a new token.

1. Find the token you created in the Token List, and click the Download Token link.

1. From the window that opens, copy the value of the access_token field. In the example below, the access token is 1uA87rI5QgI4otIlGh9sqUt8CMACb6A4.

Hamina Network Planner features cloud-to-cloud integration with Cisco Meraki. The integration can be used in several ways:

• Deploy a network - Create a greenfield design in Hamina (including maps, scale, AP locations), and export it to the Meraki Cloud for deployment. This eliminates any duplicate mapping work in the Cisco Meraki dashboard.

• Analyze an existing network - Import a network from Cisco Meraki to Hamina, and see the current running configuration including the map, AP locations, channels, and transmit power. Add walls and attenuating objects to see how the current network looks inside a predictive model.

• Modify an existing network - Export the design from Hamina back to Cisco Meraki to implement any changes such as moving APs, adding APs, or changing AP models.

To get started, you'll need to enable API access in your Meraki organization, and create API keys. Once API access is enabled, our step-by-step instructions will guide you through the process of importing and exporting data between Hamina and Meraki.

Enable API Access in Cisco Meraki

In order to use Hamina integration with your Meraki organization, you have to make sure that API access is enabled in the organization. You can enable API access in Meraki Dashboard portal by navigating to Organization > Settings > Dashboard API access:

Creating API Key

Hamina integration uses Meraki Dashboard user's API key for communicating with the Meraki API. The API key will inherit the same permissions as that account that created the API key.

You can create a new API key from My Profile page in Meraki dashboard.

Importing Floor Plans

To initiate the import process, start by clicking on the import button located under your project name in the left menu. This will open the import modal. From the vendor list, select Meraki and enter your API key. You can also specify the region you want to connect to. Once you have entered the connection credentials, click the Continue button.

If the connection is successful, you will be presented with a list of organizations and networks that you have access to. Choose the organization and network from which you wish to import floor plans. You can also import access points from Meraki inventory or from the selected network.

Next, select the floor plans you want to import. Any floor plans that you have not yet imported will have NEW label next to their name. If a floor plan has already been imported, it will be updated. In addition to the floor plan image, you can choose to import access points along with their locations, current transmit power, and current channel and channel width.

Once you have made your selections, click on the Import button to start the import operation.

Exporting Maps

GPS Coordinates

Maps that are uploaded to Meraki are expected to have a location on the globe. This can also affect aspects of the network, like the country code used by the network. We recommend using GPS coordinates to set the location of the network before uploading to Cisco Meraki.

2. In Hamina Network Planner, in the Scale group, select the GPS coordinates tool.
3. Click on the map to place the GPS coordinate, and paste the latitude and longitude into the lat/long field with Ctrl + V or ⌘ + V.
4. Repeat steps 1-3. Note: While it is possible to export with only one GPS coordinate, two or more GPS coordinates are recommended to correctly orient and scale the map on the globe.

5. Export the map to Meraki. If any selected maps do not include one or more GPS coordinates, a warning will be displayed.
6. Review the results in the Meraki dashboard.

Share a Project

To invite other Hamina users to a project, click on the Share button in the upper right.

From there either:

• enter the email address(es) of the Hamina users that you wish to share the project. For multiple recipients, separate each email address with a comma. Invited users will receive an email notification asking them to approve invite. Once approved, they will have access to the project.

• click the 'Share the project with link' button to receive a password protected shareable URL. You can set an expiry date when the link will cease to function. Anyone who uses the link before expiration will retain access to the project after the link expires.

Teams

In Hamina Network Planner, you can use teams to share projects with multiple users at the same time. Hamina users can be part of multiple teams, and can own multiple teams.

Creating a Team

To create, view, and manage teams, visit the Team view in the Account menu.

Inviting Users to the Team

To create a team, click the Add a team button. You'll be prompted to name the team and choose an icon, both of which can be changed later at any time.

In the To field, enter in the email address of the person you would like to invite, and click Send invite. The user will receive an email inviting them to join the team. In the Hamina Network Planner web app, they will also receive a notification inviting them to join the team.

Managing Team Roles

There are three roles that users can have on a team:

• User - View and edit all projects in the team, see who is in the team.

• Admin - Add and remove users, change membership roles (excluding Owner), rename the team and change the icon.

• Owner - Add and remove users, change membership roles (including Owner), rename the team and change the icon, delete the team. Multiple owners can exist in one team. The last owner on a team can't be removed, so there is always at least one owner.

To change the user's role, click on the role next to the user in the list.

Sharing Projects with Teams

Sharing projects with teams is identical to sharing projects with individual users. In the Share project menu in the upper right, you can click on the search box to see a list of available teams, or you can use the search field to look for a specific team.

Moving Projects to Other Accounts

Using the Project Sharing and Project Duplication tools, you can move projects to another account.

1. In the source account, invite the target account to share the project with the Share button in the upper right.
2. The target account will receive both an email and a notification in Hamina Network Planner where the project can be accepted. In Hamina Network Planner, accept the project in the target account with the Notification button in the upper right, and the Approve button.
3. The project is still owned by the source account, so make a duplicate of it in the Project list with the Duplicate option.
4. Optionally rename the duplicated project in the target account in the Project list in the Settings option.
5. Optionally, remove the old project from the source account.

Introduction

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").

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.

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.

By default, the Connect via Ethernet setting in Hamina is set to Nearest Device, which will cause the access point to be cabled to the nearest network switch. By changing Connected via Ethernet setting to Not connected (mesh), Hamina will enable mesh mode for the selected AP, at which point the mesh link can be visualized.

Mesh terminology in Hamina Network Planner:

• Upstream Mesh AP - The root node/mesh gateway.

• Downstream Mesh AP - The non-root node of the mesh.

Enabling Mesh Mode

To enable single-hop mesh mode in Hamina:

1. Using the Edit tool, select the access point that you would like to enable mesh mode on.

2. In the Edit Access Point pane on the left, click Show more at the bottom.

3. In the Connected via Ethernet dropdown, select Not connected (mesh).
4. The access point will now establish a mesh backhaul to the nearest access point, defaulting to the 5 GHz radio. You can choose a specific Upstream Mesh AP and Mesh Radio as desired.

Configuring the Mesh Link

To configure additional options, click on the Show more expander. This will reveal options to select specific Upstream Mesh APs, and which specific radio should be used for mesh backhaul.

Viewing the Mesh Link

When single-hop mesh mode is enabled, a dashed line appears showing the mesh link and Link Quality Arrows. The Downstream Mesh AP (non-root node) uses a different icon to differentiate it from Upstream Mesh APs (root nodes).

Connection Quality Arrows

Depending on the signal strength of the link, the Connection Quality Arrows will change colors based on the Primary Signal Strength heatmap settings. In other words, they use the same thresholds and colors as the Signal Strength heatmap.

Mesh Connection Quality Details

To view the details about the quality of the mesh link, click on one of the arrows.

The arrow pointing towards the AP shows how well it is receiving across the link. More specifically, it is showing the receive signal strength and data rate from the transmitting AP on the opposite end of the mesh link.

Filtering Access Points and Heatmaps

There are two ways to filter which access points (and which heatmaps) will be visible:

• SSID filter

• Survey path filter

SSID Filter

The SSID filter in the Heatmap settings popover filters which access points are visible (and visualized with a heatmap). If an access point is broadcasting multiple SSIDs, you only need to select one of the SSIDs to make it visible. You can view all access points by selecting no SSIDs.

Survey Path Filter

Selecting the Survey paths tool opens the Survey paths pane on the right.

In the Survey paths pane, you can see each individual survey session that was performed. A survey session might be a Continuous site survey, a group of Line surveys, or a group of points from a Point survey.

Survey sessions are grouped by day, and each session includes:

• Name of the user

• Time of day

• Survey device

• Survey time for the session

• Distance walked for the session

Unchecking a survey point filters the heatmap, but it does not alter the location and visibility settings of access points.

Access Point Locations and Visibility

Access points have three possible states in regards to location:

When an access point is not located, there are two ways to locate it: Reset surveyed AP locations button, and the Place access point tool.

Reset surveyed AP locations button: Located in the Project Settings window, this button will reset the visibility and location states for all surveyed access points in the project.

Place access point tool: When an access point is in the Not located ❌ state, it can be manually placed with the Place access point tool. To activate it, select the Edit tool, right-click on the map, and click Place access point. If the Coverage heatmap is selected, Hamina Network Planner will show a heatmap for each access point on mouseover to assist with manual placement.

Automatically Locating Access Points

If an access point has been Manually Located 🎯, you can revert it to being Automatically Located ✨ in the Edit Access Point pane.

Select the access point with the Edit tool, and click the Auto-locate AP on map button. This also works if multiple access points are selected.

Remove an AP Location

To remove an access point location from the map, select the access point with the Edit tool, and click the Remove AP location from map button. This does not remove the access point or any of it's measurements from the project; it simply hides the access point pin. This also works if multiple access points are selected.

Hamina Network Planner includes integration with ExtremeCloud IQ, which can be used to export from Hamina Network Planner to ExtremeCloud IQ.

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

There are two keys that you can use to authenticate Hamina Network Planner to ExtremeCloud IQ:

• A bearer token, which will expire. For more information, consult Extreme's API key generation documentation.

• A Developer API Key, which can be configured to not expire.

We recommend creating a Developer API Key for ExtremeCloud IQ, which can have a much longer duration.

Generating a Developer API Token

Creating the Developer API token requires two steps:

1. Authenticate with a username and password to generate a bearer token.

2. Perform an API call with the bearer token to generate the Developer API token.

To simplify the process, ExtremeCloud IQ Key Retriever can use your username and password to get a bearer token, and perform the API call to generate a full-access Developer API token that does not expire.

Exporting from Hamina to Extreme IQ

There are two primary ways to export from Hamina to Extreme:

• Choose Matched access points and Unmatched access points. In this case, Hamina will randomly assign access points to the map, with respect for each model.

• Choose Match names to APs before the export. This gives you precise control over exactly which AP goes where.

To match names to APs:

1. Name the access points in Extreme IQ.

2. Use identical names for access points in Hamina Network Planner.

3. Check Matched access points, also Unmatched access points, and Assign unmatched access points by name in Hamina Network Planner.

4. Export from Hamina Network Planner to Extreme.

If Hamina Network Planner is missing an access point or antenna, Hamina Wireless can add it for you. We just need to get some information from the AP or antenna vendor.

Can I add my own AP's and antennas?

The process of adding an access point or antenna to Hamina is pretty technical, specifically requiring our development team to programmatically input the 2D antenna patterns and interpolate them to create 3D patterns for each frequency band.

Unfortunately, this means that you can't add them yourself, but you can email us at support@hamina.com with your request.

1. Email support@hamina.com with your request

2. Hamina will contact the vendor to request antenna patterns and specifications

3. The vendor will reply with the antenna patterns and specifications

4. Hamina will process the 2D patterns to create the 3D patterns, and add them to Hamina

5. The new AP's and antennas will be included in the next production push

What data do you need to add AP's and antennas to Hamina?

Antenna Patterns - We need to get antenna patterns from the vendor in a programmatic format such as a spreadsheet or .CSV file. These usually show gain in dBi, per angle (typically every 1° or 5°), and they have a sheet for each antenna element.

Specifications - We need to get the specifications of the AP or antenna. Usually, everything we need is on the data sheet, but here's a complete list:

• AP model number

• Supported frequency bands (2.4, 5, 6 GHz)

• Supported Phy type in each band (802.11ac, 802.11ax)

• Amount of spatial streams per band

• Max PoE consumption

• Default mounting orientation (Ceiling or wall)

• Peak gain for each antenna

• Is the AP intended for indoors, or outdoors?

• Is the AP omnidirectional, or directional?

• Is there a Bluetooth Low Energy radio present?

• Is there a ZigBee radio present?

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.

2. Select your Organization.

3. In the toolbar on the left, select Organization > Settings.
4. Scroll down to the API Token section, and click Create Token.
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.

Import From Juniper Mist to Hamina

1. In Hamina Network Planner, navigate to the Import page.
2. Select your Region, paste in the key, and click the Continue button.
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.
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.

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.

Hamina Network Planner Plus includes public beta access to integration with NetAlly Link-Live for the purpose of importing site surveys.

Surveys can be performed with NetAlly AirMapper with the following NetAlly handheld devices:

• AirCheck G2

• AirCheck G3

• EtherScope nXG

• CyberScope

• CyberScope Air

Once the surveys have been uploaded to Link-Live, they can be imported to Hamina Network Planner Plus.

Import from NetAlly Link-Live to Hamina Network Planner Plus

1. Open the Project menu, and select Import.
2. In the Import list, select NetAlly.
3. Enter your NetAlly Link-Live username and password (which Hamina Network Planner Plus will use to connect authenticate to Link-Live), and click the Continue button. Note: Multi-factor authentication in Link-Live is not supported by Hamina at this time. You might need to temporarily disable MFA. Sorry about that! 🫠
4. Select the relevant organization, and check any floor plans that you would like to import. Check the import surveys option to include surveys. Click Import.
5. Wait for the import to complete.
6. Once the import has completed, click the Survey tab at the top of Hamina Network Planner Plus.
7. Click on the Legend, and select one or more SSIDs to view.

Users

In Hamina Wireless products, a user is defined as an individual person. Each user needs to have their own subscription. Subscriptions for teams can be provided through a volume license key.

Activating a License Key

Whether you are trying out Hamina, or activating a new subscription, here's how to activate your license. This applies to both Hamina Network Planner, and Hamina Onsite.

1. Click on the Account menu in the upper right, then click Subscription.
2. Click the ... menu next to the license, and click Activate.
3. If you have a subscription with multiple seats, and have any colleagues who need to activate it, use the Copy license key option in the ... menu to retrieve it to share with them.

Volume License Keys

If you have a team of two or more users, you can purchase multiple licenses from a single account. This is often useful for simplifying billing.

Retrieving the License Key

If you purchase multiple licenses, you'll need to retrieve the license key from Hamina, and share it with anyone that you'd like to add to your Hamina organization.

1. Click on the Account Menu in the upper right.

1. In the drop-down menu, click Subscription.

2. In the Subscriptions table, click on the ... menu (elipsis menu) on the right, and click Copy License Key.

Activating the License Key

1. Create an account at https://app.hamina.com. Note: Be very careful to select the instance that your team uses!

2. Sign into your Hamina account.

3. Name and create your first project.

4. Click on the Account Menu in the upper right.

1. In the drop-down menu, click Subscription.

2. Click the blue Use License Key button in the upper right.

Release a License

When a user activates a license, the license is tied to that user for 90 days. After 90 days, the subscription holder (the person who shared the license key) has the ability to Release the user's license, freeing up the seat for another user to activate.

This is useful for when someone leaves your organization, if someone's role changes, or if you just want to keep a small pool of licenses and move them around between users.

To release a license:

1. Click on the Account Menu in the upper right.

2. In the drop-down menu, click Subscription.

3. Find the user with the license you would like to release in the Users list.

4. Click the ellipsis menu (...) to the right of the user.
5. Click Release. Note: The license key must be activated for at least 90 days before this option will be available.

Hamina Network Planner includes integration with Ruckus One, which can be used for Import and Live monitoring purposes.

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

The Live feature will continuously pull in the latest status of the network including switches, access points and radio information.

Generating an API Token

2. From the side panel select Administration > Settings.
3. In the lower right corner of the Settings page, click the Add Token link.
4. This is a good time to retreive your Ruckus Tenant ID. The easiest place to retrieve it is from the address bar, , e.g. https://eu.ruckus.cloud/${my_tenant_id}.
5. Fill in an Application Name, Client secret and Scope.

6. Save the Client ID and Secret, along with the Ruckus Tenant ID you copied in the previous step.

7. Click the Add button.

Import From Ruckus One to Hamina

1. In Hamina Network Planner, navigate to the Import page.
2. Select Ruckus, and input correct Region, Tenant ID, Client ID and Client Secret, and then click the Continue button.
3. Select the venue and floor plans you want to import, and then click the Import button.
4. The background map, access points, and access point details will now appear in Hamina Network Planner, but since there is no scale, a heatmap will not be displayed. Use the Scale tool to add a scale to your project, which will enable heatmaps.
5. To increase accuracy, copy over the transmit power for the 2.4, 5, and 6 GHz radios.

6. By default, Hamina Network Planner will use your selected Environment Type to predict loss in your project. To further increase accuracy, we recommend drawing walls and attenuating objects, which will automatically switch the simulation to Walls + Objects.

Live View

1. The Live View is currently offered as a Feature Preview, and requires a Hamina Network Planner Plus license. Find the option to enable Live Analysis in the Account menu > Preferences > Feature preview tab.
2. Click the Live icon from the middle top tab selection to access Live view, and click the Connect Infrastructure button.
3. elect Ruckus, and input correct Region, Tenant ID, Client ID and Client Secret, and then click the Continue button.
4. Select the venue and floor plans you want to import, and then click the Import button.
5. The background map, access points, access point, switches, and switch details details will now appear in Hamina Network Planner, but since there is no scale, a heatmap will not be displayed. Use the Scale tool to add a scale to your project, which will enable heatmaps.

6. By default, Hamina Network Planner will use your selected Environment Type to predict loss in your project. To further increase accuracy, we recommend drawing walls and attenuating objects, which will automatically switch the simulation to Walls + Objects. To draw walls, attenuating objects, and other relevant map objects such as scope and capacity zones, switch to the Simulation view. When finished, switch back to the Live view.
7. To refresh the Live View, click the Refresh button in the upper right.

Quotes and Purchase Orders

Hamina Network Planner features a built-in quote generation tool, allowing for near-instant quote generation.

Generating a Quote

2. In Hamina Network Planner, either click the Upgrade button, or navigate to the Subscriptions page.
3. Click on the Get Quote button.
4. Click the + buttons to add products, and click the Request Quote button.
5. Add or review your billing and shipping information. Double-check for accuracy, and click the Send a Request button.
6. After a moment, the quote will finish generating and will automatically download as a PDF file.

Managing Quotes

Once you have generated a quote, you'll find it in the Quotes section on the Subscriptions page.

Adding a Purchase Order Number

In the Purchase order # column, hover the mouse over the cell and the Edit button will appear. Click it to enter a custom purchase order number. The purchase order number will then appear on the invoice, when it is sent.

Accepting and Purchasing with a Credit Card

To accept the quote and purchase with a credit card, select the elipsis menu on the quote row and select Purchase.

Cancelling a Subscription

Done with wireless projects, and ready to take a break from Hamina? No problem! It's super easy to unsubscribe.

1. In the drop-down menu, click Subscription.

2. At the bottom of the page, click on the red Unsubscribe button.

Placing Wired Clients

1. To place a wired client, locate the Network section on the left, click on the Network Infrastructure > Client device tool. This will open the Add Client Device pane on the right.
2. In the Add Client Device pane, choose the appropriate type of wired device.
3. Click on the map to place the client device.

Customizing Wired Clients