Registering BT Tablet SBC’s

Registering BT Tablet SBC’s

This document is a how-to guide showing the steps for registering Tablet mac’s/SBC’s on Unity and Hexnode, issues that may arise and the steps to resolve too. When a Tablet Mac registration request comes in from BT-Staging for a Tablet SBC follow the steps below.

See Stage 1A - 2A if registering to a Unit in the field.

Stage 1 - Unity

• 1. Remove the colons and search for the Mac in Unity in the search field. If the Mac profile or a Unit containing the mac appears. Open it and skip to step 9

  2. If the search returns nothing? It could be set as a retired Mac in a Unity Profile or it has never been registered. 

  3. Go to the DB and and open the unit_pcs table and search for the Mac using the Filter Rows field. Again, without the colons. Ask a Tech Level 2 member to do this if needed.

  4. The Mac should appear. And you can use the unit_id to locate it on Unity. Navigate to any Unit on Unity and overwrite the unit_id at the righter most end of the address with the five character unit_id, hit enter and the Unit profile containing the Mac/SBC will open. If the Mac doesn’t appear? It has to be registered a-fresh on Unity.

  5. Go back to Unity and navigate to the Spares directory in the BT Staging section. Click “Units” on the vertical menu on the left hand side.

  6. You will see the drop-down in the “Location” section. Click this and Select “ “BT Staging”

  7. Then Click “Spares” and the Spares section opens.

  8. Click “New Unit” and the pop up opens. Populate the fields “Name” and “Mac Address” with the Mac address, again without the colons. Click “Create” and the Mac/SBC should appear in the Unit profile if the Mac/SBC is online. If it doesn’t appear it will appear when it comes online. Keep the Mac Profile tab open. It’s best to have a couple of Unity Tabs open when doing this.

  9. At this point you can move the Mac/SBC into the BB unit of choice. Best to use a BB that hasn’t got an active Mac/SBC in it. If that’s not possible, retire the active Mac/SBC in the BB unity profile.

  10. In the “open search field” at the top, enter BB- and the entire list of BB units will show. Select an inactive BB(one that has the red icon) and the BB profile will open.

  11. Go back to the tab with the Mac profile that has the Mac/SBC in it that you need to Move to the BB. Select the Mac/SBC and Highlight it. 

  12. Click Move and the pop up opens.

  13. In the Select Location dropdown select “Test Units”

  14. And Using the Unit dropdown select the BB you’ve chosen in step 10.

  15. Click Move.

  16. Refresh the BB Unity profile and the Mac/SBC will be gone.

  17. Navigate back to the tab with the BB unit you’ve moved the Mac/SBC to. Refresh and you will see it as the active Mac/SBC.

The Tablet Mac/SBC is now set to the BB unit on Unity.

Stage 2 - Hexnode

• 1. If you are not already logged into Hexnode? Login.

  2. Click on “hexnode mdm” at the top left corner of the page.

  3. You will see the Activity Feed section on the right hand side. The Tablet will be on this list, near the top with a label “ Magna Android Device”

  4. Start from the top of the list down and check each Magna Android Device till you find it. If you don’t find it. Ask BT-Staging to power-cycle the Tablet SBC.

  5. Click on the Magna Android Device link.

  6. When in the Magna Android Device profile page you will see a horizontal menu “Device Summary, Device Info, Security etc” Click on Device Info.

  7. Scroll down and check the Ethernet Mac to see if it corresponds with the Mac you need to set on Hexnode.

  8. If the Mac is not the one you want. Go back to the Activity Feed, go to the next Magna Android Device on the list and check the Ethernet Mac. Use steps 2 to 7 to do this.

  9. When you locate the mac you want, scroll back to the top of the profile page.

  10. You will see the Android icon graphic with the Magna Android Device label to its right. It’s at the top left under hexnode mdm.

  11. Overwrite the Magna Android Device label with the BB unit label you’ve chosen in Stage 1 and click enter or click the “correction mark” symbol icon.

  12. While in the same profile page, on the horizontal menu “Device Summary, Device info etc” Click Action history and you will see the applications, configuration and policies have installed.

Tablet Mac/SBC is now set on Hexnode, you can follow up with BT.

Stage 3 - Move to Spares on Unity.

• 1. Navigate to the BB unit you’ve registered the Mac/SBC to.

  2. Select the Mac/SBC and Click Move Mac/SBC.

  3. In the Select Location dropdown select Spares.

  4. In the Unit dropdown select the specific Mac from the list and click Move.

  5. Refresh the page and the Mac/SBC will be gone.

  6. Search for the Mac/SBC in the search field, click on the Mac returned in the search and the Mac/SBC will be in the profile.

Stage 4 - Overwrite the BB label on Hexnode.

• 1. Navigate back to Hexnode and search for the BB unit in the search field and Click on the returned result 

  2. Overwrite the BB label next to the Android icon with the Mac address, including colons.

  3. Click Enter or Click the “correction mark” symbol icon.

Congratulations you’ve successfully set a Tablet on Unity and Hexnode.  

Stage 5 - Setting the Tablet on Hexnode and Unity for Onsite BT 

Only use this Stage if your setting a Tablet/Mac/SBC on Unity and Hexnode to a Unit that’s in field for a BT Streethub onsite engineer  : 

• 1. Follow the same steps in Stage 1. Only difference is that you are registering it to a UK-012345-T reference ID instead of a BB-012345-T reference ID.

  2. Locate the old Tablet/Mac/SBC on Hexnode that the replacement Tablet/Mac/SBC needs to be set to. Use the search field at the top right, search for the Tablet using the UK-012345-T reference ID.

  3. It should be showing offline for “days”.  

  4. Click the “Actions” drop down menu and select “Disenroll”  

  5. You will be prompted for a UserName and Password, enter these and proceed.

  6. Click “Action History” on the horizontal menu and watch for Disenrollment completion.

  7. When that’s complete, click the”Actions” drop down menu again and mark as disenrolled.

  8. Search for the Mac including the colons in the search field and it should show. If the Mac is not returned in the search, use steps 2 to 7 in Stage 2 to locate it.

  9. Overwrite the label beside the Android icon with the UK-012345-T reference ID.

  10. Click on the “Actions” drop-down.

  11. Select Change Owner and a pop up appears.

  12. You will see the “Select User” field, Click this.

  13. Search for the Area Location of the Unit(get this on Unity) from the list and Click Assign.

  14. Get the BT-Streethub onsite engineer to test the dialer and make a call.

Congratulations you’ve registered a Tablet fitted to a Unit out in the field.

Stage 6 - Tablet is offline on Hexnode or shows Maintenance Mode  

      on-screen.

• 1. If the Tablet is offline or shows Maintenance mode on-screen. Get the onsite engineer to power-cycle the unit, followed by a power-cycle of the Tablet and it should ping Hexnode. Always monitor “Last checked-in”

  2. If the above power-cycle doesn’t bring it online. Get the engineer to disconnect the power and network to it. Power-cycle the unit and reconnect. 

  3. If the above power-cycle doesn’t bring it online, send a pingTest using the Continuous Ping Network Connection Test knowledge article :

https://docs.google.com/document/d/1iVDPi97LN_F4OQXHnSRkQmnOZkFbuGDKsQ61DjuBYdk/edit

• 1. Advise the BT-Streethub engineer if the pingTest is timing out and follow up with BT Streethub. 

Author : Seán Behan