2 - Install & Maintenance Guides

Guides, Instructions and Tutorials

MikroTik Netinstall Recovery

How to resurrect a bootlooping OmniTIK with netinstall

Symptoms

OmniTIK boots up but continually reboots. The LEDs repeat the pattern: device boots up, power eventually turns blue, then 1-5 turn orange and reboots. Rinse and repeat.

Solution

Use netinstall to flash a fresh firmware on the router. This guide assumes Linux, though both Linux and Windows are supported. This should work for any RouterBOARD based device.

❱ netinstall -p ~/Downloads/routeros-mipsbe-6.47.8.npk -i enp0s13f0u2u4u5
Using server IP: 192.168.88.2
Starting PXE server
Waiting for RouterBOARD...
PXE client: CC:2D:E0:17:55:CB
Sending image: mips
Discovered RouterBOARD...
Formatting...
Sending package routeros-mipsbe-6.47.8.npk ...
Ready for reboot...
Sent reboot command

After all this, you should hear a few beeps indicating success. You can now try to connect via ether2 to configure it at 192.168.88.1 as normal.

Chromebook Developer Mode (Getting a terminal)

Chromebooks are good for installs as they are cheap and all you need is a browser and a terminal anyway.

To get a standard terminal you have to put the Chromebook in developer mode: 

This will erase your login info and any local data!

The Chromebook should restart and you can sign is as guest or enter your gmail etc to set up the laptop.

The next time you start your Chromebook-

Crimping

Here are some helpful videos on crimping. Like nearly everyone we use the T-568B standard

Video 1

Video 2

DIY Install Overview

For a DIY ("do it yourself") install we recommend joining our Slack group where you can chat with us.

There is a channel in Slack- #diy-install-support where you can ask questions. We can guide you on what hardware to buy, and what is likely the best connection to a nearby antenna.

For DIY, you must still fill in our join form. This will give you an Install Number (or request number) which you will need when you are ready for an install to request a Network Number (or NN) in order to be able to configure your devices for your install. It will also get you in our system so we can give you advice and look for line-of-sight connections, as well as put you on the map. (We are working at automating the process so you can use the Install Request number and the system will automatically allocate a Network Number for you. For now you need to request it via #diy-install-support or via the email your received with your Request Install Number)

For a quick check of line-of-sight you can use our line-of-sight tool. Put in your address and it will show you which hubs you might be able to connect to.

Here is a list of equipment we typically use. Remember to use outdoor ethernet cable, and securely mount your antennas on j-pipes or secured masts. Masts should be strong metal as plastic PVC pipes will bend.

Our general install advice is here in the docs

When you are ready, here's how to configure your devices.

We ask you, if you can, to support NYC Mesh with a monthly subscription. Donating helps maintain, operate, and expand NYC Mesh so, just like you, others can benefit from the network.

Equipment

To connect to NYC Mesh, you will need to install wireless networking equipment on a rooftop or outside a window. This page lists a range of equipment and tools that are commonly used for typical installations. Before assembling any equipment, first carry out a site survey and make an install plan to narrow down the equipment you really need. For detailed information about specific routers, visit the hardware docs.

You can download a handy checklist of the equipment listed on this page here.

For DIY installers: To get help figuring out which essential equipment you need for your installation, first familiarize yourself with the equipment below and then reach out to the NYC Mesh community on slack on the #diy-install-support channel.

For volunteer installers: Prior to any install, make sure you have access to the equipment listed below. If you are missing any equipment needed for an install, reach out to install leaders on slack on the #install-team channel to ask to borrow them. Shared tools are available and we can purchase, order and ship networking equipment (routers, cable, connectors, etc.) to your address.

Networking Equipment

Product Name Product Photo What it's used for Where you can get it Cost              
Laptop (charged) alt text Configuring outdoor and indoor routers, reading docs and install plan Bring your own
Outdoor router(s) (pre-configured) alt text Connecting to a node Order online or collect from mesh room stock (refer to specific product page in hardware docs)
Power Over Ethernet (POE) adapter and power cable alt text Providing power to the outdoor router and passing data to and from indoor router Comes packaged with the outdoor router
Indoor router alt text Connection point for user's devices Order online or collect from mesh room stock $20+
CAT5e cable (outdoor-rated, grounded and shielded) alt text Passing power and data between outdoor router, indoor router and power outlet Available from online retailers in different spool lengths - recommended product $130-150/1000ft
$90-110/500ft
$20-30/100 ft
RJ45 pass through connectors (metal, with grounding loop) alt text Gets crimped onto the ends of the CAT5e cable to provide power and data interface Available from online retailers - recommended product $0.34/connector
Two Ethernet patch cables alt text Connecting routers to POE injector, battery pack, laptop Available from online retailers - recommended product $1.5-2 per <=3ft cable
Portable battery pack with three-prong power outlet (charged) alt text Providing power to outdoor router while surveying for signal Available from online retailers - recommended product (less expensive) / recommended product (better features) $50 for 11,600 mAh
$150 for 46,400 mAh
Gigabit USB/Thunderbolt to Ethernet adapter alt text Connecting laptop without an ethernet port to outdoor router (not needed if connecting wirelessly) Available from online retailers $15

Tools

Product Name Product Photo What it's used for Where you can get it Cost
Ethernet cable crimper (pass through) alt text Attaching RJ-45 connectors to CAT5e cable Online retailers - recommended product $44
CAT5e cable stripper alt text Stripping CAT5e cable Online retailers (included in crimping all-in-one kit) - recommended product $25 for crimping all-in-one kit
Ethernet cable tester alt text Testing that Ethernet cable has been correctly crimped Online retailers - recommended product $10
Spare 9v battery alt text Replacement in case tester is left on Online retailers - recommended product $10
Scissors alt text Cutting CAT5e cable and cable ties Hardware store tools aisle
Needlenose pliers alt text Clamping CAT5e cable ground wire, pulling cable through holes Hardware store tools aisle - recommended product $12
Cordless hammer drill alt text Drilling holes, inserting screws, securing pipe clamps Hardware store tools aisle
Hex socket drill bits (3/8" for hose clamps and 1/4" for masonry screws) alt text Tightening hose clamps, inserting concrete screws Hardware store drill bits aisle
Carbide-tip masonry drill bit (5/32") alt text Drilling holes in concrete or masonry for inserting masonry screws Hardware store drill bits aisle
Cobalt / titanium drill bit (1/4") alt text Drilling hole for CAT5e cable to pass through steel window frame Hardware store drill bits aisle
Hammer alt text Driving in concrete nails Hardware store tools aisle
Concrete nail alt text Starting a hole in concrete or masonry (makes drilling easier) Hardware store nails aisle
Phillips Precision Screwdriver (No. 1) alt text Assembling Litebeam Router Included in crimping all-in-one kit, Hardware store tools aisle
Adjustable crescent wrench (6") alt text Assembling J-pipe mount Hardware store tools aisle
Vise grips alt text Removing stuck drill bits Hardware store tools aisle

Mounting Equipment

Product Name Product Photo Field Photo What it's used for Where you can get it Cost
Small diameter (28) hose clamp alt text alt text Securing the router to a thin mast or pipe Comes with outdoor router, hardware store plumbing aisle
Large diameter (88) hose clamp alt text alt text Securing the router or mast to a large pipe or window guard Hardware store plumbing aisle
J pipe antenna mast alt text alt text Mounting to a wall or parapet Online retailers - recommended product / 10-pack
L pipe antenna mast alt text alt text Orienting an SXT router up and down Online retailers - recommended product
Concrete screws (3/16" hex head CSH316134) alt text alt text Securing mast mounts to concrete or masonry Hardware store screws and anchors aisle
Washers (1/4" hole diameter) alt text alt text Securing mast mounts to concrete or masonry Hardware store fasteners aisle
Zip ties alt text alt text Securing ethernet cable Hardware store electrical aisle
Cable staples alt text alt text Securing ethernet cable to an indoor wall Hardware store electrical aisle
Cable fastener clips alt text alt text Securing ethernet cable to an outdoor vertical surface Hardware store electrical aisle or online retailers - recommended product

Miscellanious supplies

Product Name Product Photo What it's used for Where you can get it
Electrical tape alt text Pulling cable through holes Hardware store adhesives aisle
Weather stripping (9/16" thick or greater) alt text Sealing the bottom of a window when the CAT5e cable is run over the window frame Hardware store insulation aisle
Rubberized waterproof sealant alt text Sealing gaps and holes to prevent water infiltration Hardware store adhesives aisle
WD-40 or other oil alt text Drilling through thicker metals Hardware store
Small brush and dustpan alt text Sweeping up cable ends and metal shavings from drilling through window frame Online retailers
Biodegradable wet wipes alt text Cleaning dirty hands Online retailers - recommended product
Small garbage bag alt text Disposing of garbage Reuse a shopping bag
Hand truck alt text Transporting cable reel box and equipment bag in and out of subway stations - stair-climbing model is ideal! Online retailers, larger hardware stores
Backpack alt text Transporting equipment safely up ladders - slim backpacks are the safest! Many places

Safety gear

Product Name Product Photo What it's used for Where you can get it
Safety Glasses alt text Eye protection while drilling Hardware store apparel aisle
Thick-soled shoes or work boots alt text Protection against sharp objects on rooftops Work wear store
Sunblock and hat (in summer) alt text Preventing sunburn Pharmacy
Cold weather apparel (in winter) alt text Preventing frostbite Clothing store
Water and a snack alt text Staying hydrated and preventing fatigue Grocery store
First aid kit alt text Treating minor injuries Pharmacy
Fully-charged cell phone alt text Communication in case of lockout, team communication, providing mobile hotspot Charge at home

Etiquette

As a volunteer installer, you are the public face of NYC Mesh! Courtesy, respect, friendliness and professionalism will give new members a great first impression of our organization and will encourage them to become active contributors to our community.

Before the install:

When you arrive at the node site:

When meeting the installee member, introduce yourself by name and explain how you plan to carry out the install. Ask them if they have any questions and confirm that they will be able to host you for the expected duration of the install. Be polite and friendly!

Be sensitive to cultural and social differences, such as:

For rooftop installs, ask your installee member to lead you to their roof. If they are unable to do so, ask them to explain how to access the roof and request that they point out any hazards.

Ask your installee member to show you around their apartment. Ask where the bathroom is in case you need to use it. Remember to respect the member’s privacy.

Discuss options for cabling into the apartment with your installee member during your initial tour of their apartment. Ask for permission before carrying out any drilling.

Consider taking your boots off inside the apartment. Some apartments insist on this, and also your boots are probably dirty. Molten tar on roofs is a big problem in summer and will stick to everything. Snow in winter will melt.

During the install:

The install leader will assign tasks as per volunteers abilities. Minimal time should be wasted.

At the end of the install:

Link NYC Kiosk (Kiosk Node)

There are currently ongoing discussions with LinkNYC with the goal of having a deeper and more persistent connection to their network. Information on this page may become out of date in the near future. For updates see #linknyc on the slack

We do not install LinkNYC Kiosk repeaters as they are not as reliable as a mesh connection. We still support DIY kiosk repeaters through our Slack group.

If you are too far away from an access point to get a good connection, you can use a directional router to connect to Link NYC. We recommend using a Mikrotik SXTsq G-5acD international version. The LinkNYC kiosks use DFS channels which, although legal and FCC approved, aren't supported in some USA versions of hardware.

To use the SXTsq 5 ac you need to get the international version and configure it according to our detailed instructions.

Here is the link to buy the SXTsq. Make sure to specify international.

With all these gateways we get lots of questions about security. As always, https (used by most web sites) is a secure way to transmit information across wifi.

Juniper Quick Start Guide (Mikrotik vs Juniper)

This guide is intended to be a quick start guide to working with Juniper routers. It is intended that NYC Mesh volunteers who know their way around RouterOS can use this guide to complete the same common actions on a Juniper router.

To Do:

Login and Access Terminal:

MikroTik: Navigate to the router's IP. Enter username and password.

image.png

Juniper: SSH to the router's IP. Username is root. Type cli and hit enter.

ssh root@10.69.19.34
Password:
Last login: Tue Jan 16 22:17:47 2024 from 10.97.227.158
--- JUNOS 21.4R1.12 built 2021-12-17 14:37:27 UTC
root@nycmesh-1934-core:RE:0% cli
{master:0}
root@nycmesh-1934-core>

List Interfaces:

MikroTik: Click Interfaces to see interface list and status.

image.png

Click a specific interface to see individual status, including port status.

image.png

Juniper:

Juniper represents configuration separately from the current status. For configuration and layout of the network:

root@nycmesh-1934-core> show configuration interfaces
xe-0/0/0 {
    description "Grand St OLT1 Port 1";
    ether-options {
        802.3ad ae0;
    }
}
xe-0/0/1 {
    description "Grand St OLT1 Port 2";
    ether-options {
        802.3ad ae0;
    }
}
xe-0/0/2 {
    description "Grand St OLT2 Port 1";
    ether-options {
        802.3ad ae1;
    }
}
xe-0/0/3 {
    description "Grand St OLT2 Port 2";
    ether-options {
        802.3ad ae1;
    }
}
xe-0/0/4 {
    unit 0 {
        family ethernet-switching {
            interface-mode access;
            vlan {
                members mesh;
            }
        }
    }
}
xe-0/0/5 {
    unit 0 {
        family ethernet-switching {
            interface-mode access;
            vlan {
                members mesh;
            }
        }
    }
---(more)---

For statistics and live info:

root@nycmesh-1934-core> show interfaces
Physical interface: gr-0/0/0, Enabled, Physical link is Up
  Interface index: 650, SNMP ifIndex: 502
  Type: GRE, Link-level type: GRE, MTU: Unlimited, Speed: 800mbps
  Device flags   : Present Running
  Interface flags: Point-To-Point SNMP-Traps
  Input rate     : 0 bps (0 pps)
  Output rate    : 0 bps (0 pps)

Physical interface: ip-0/0/0, Enabled, Physical link is Up
  Interface index: 649, SNMP ifIndex: 515
  Type: IPIP, Link-level type: IP-over-IP, MTU: Unlimited,
  Speed: 800mbps
  Device flags   : Present Running
  Interface flags: SNMP-Traps
  Input rate     : 0 bps (0 pps)
  Output rate    : 0 bps (0 pps)

Physical interface: pfe-0/0/0, Enabled, Physical link is Up
  Interface index: 654, SNMP ifIndex: 509
  Speed: 800mbps
  Device flags   : Present Running
  Link flags     : None
  Last flapped   : Never
    Input packets : 0
    Output packets: 0

  Logical interface pfe-0/0/0.16383 (Index 565) (SNMP ifIndex 510)
    Flags: Up SNMP-Traps Encapsulation: ENET2
    Bandwidth: 0
    Input packets : 0
    Output packets: 0
    Protocol inet, MTU: Unlimited
    Max nh cache: 0, New hold nh limit: 0, Curr nh cnt: 0,
    Curr new hold cnt: 0, NH drop cnt: 0
      Flags: User-MTU
    Protocol inet6, MTU: Unlimited
    Max nh cache: 0, New hold nh limit: 0, Curr nh cnt: 0,
    Curr new hold cnt: 0, NH drop cnt: 0
      Flags: Is-Primary, User-MTU

Physical interface: pfh-0/0/0, Enabled, Physical link is Up
  Interface index: 653, SNMP ifIndex: 508
  Speed: 800mbps
---(more)---

List DHCP leases:

MikroTik: Click IP > DHCP Server, then click the Leases tab

image.png

Juniper:

root@nycmesh-1934-core> show dhcp server binding
IP address        Session Id  Hardware address   Expires     State      Interface
10.70.188.20      2536927     00:18:dd:0a:19:a7  510         BOUND      irb.12
10.70.188.19      3215990     00:d2:b1:58:87:46  263         BOUND      irb.12
10.70.188.64      282708      02:27:22:da:a6:7c  521         BOUND      irb.12
10.70.188.26      2533153     0c:62:a6:ad:ab:c5  337         BOUND      irb.12
10.70.188.192     334522      18:e8:29:26:ef:25  518         BOUND      irb.12
10.70.188.217     2778822     18:e8:29:59:f5:ab  586         BOUND      irb.12
10.70.188.241     2536920     18:fd:74:58:20:2e  321         BOUND      irb.12
10.70.188.202     2536918     18:fd:74:cb:d0:2d  311         BOUND      irb.12
10.70.188.21      3207138     18:fd:74:ef:6d:8a  506         BOUND      irb.12
10.70.188.132     3217186     1c:91:80:c8:51:d3  10          BOUND      irb.12
10.70.188.47      50490       28:29:86:5a:f4:15  533         BOUND      irb.12
10.70.188.197     2536785     28:29:86:6a:51:82  487         BOUND      irb.12
10.70.188.24      2536919     28:76:10:1e:35:8e  386         BOUND      irb.12
10.70.188.183     3213552     3a:e0:38:60:bb:91  198         BOUND      irb.12
10.70.188.172     2416730     3c:9b:d6:75:c8:f8  571         BOUND      irb.12
10.70.188.107     3216907     56:9d:3f:a6:d7:0f  57          BOUND      irb.12
10.70.188.193     2604196     5c:e9:31:7c:56:ff  537         BOUND      irb.12
10.70.188.130     3217152     5e:48:5d:5b:79:90  415         BOUND      irb.12
10.70.188.129     3217128     5e:8f:1b:e9:16:8a  2           BOUND      irb.12
10.70.188.44      1931696     60:22:32:4f:2b:fe  380         BOUND      irb.12
10.70.188.136     3217238     62:45:45:e2:0a:39  500         BOUND      irb.12
10.70.188.240     2857437     68:d7:9a:76:d4:f7  316         BOUND      irb.12
10.70.188.203     331465      68:d7:9a:a2:07:10  453         BOUND      irb.12
10.70.188.188     3213574     6a:5c:64:e1:8c:d4  439         BOUND      irb.12
10.70.184.90      3026881     70:a7:41:3e:aa:91  522         BOUND      irb.11
10.70.184.65      2953063     70:a7:41:3e:ab:d5  331         BOUND      irb.11
10.70.187.244     2730465     70:a7:41:3e:ab:f9  336         BOUND      irb.11
10.70.187.178     2476746     70:a7:41:3e:ac:51  589         BOUND      irb.11
10.70.184.93      3027863     70:a7:41:3e:ac:71  318         BOUND      irb.11
10.70.188.93      170763      70:a7:41:42:76:31  300         BOUND      irb.12
10.70.188.45      781270      74:83:c2:9c:92:fc  394         BOUND      irb.12
10.70.188.215     1945827     74:83:c2:c0:bb:90  582         BOUND      irb.12
10.70.188.36      2825439     74:83:c2:c3:d1:75  354         BOUND      irb.12
10.70.188.134     3147069     74:83:c2:c3:d1:83  533         BOUND      irb.12
10.70.188.86      25849       74:ac:b9:0c:9a:1d  360         BOUND      irb.12
10.70.188.161     71710       74:ac:b9:72:3f:33  454         BOUND      irb.12
10.70.188.75      2857433     74:ac:b9:b9:92:cc  559         BOUND      irb.12
10.70.188.53      2857440     74:ac:b9:bc:a7:2a  500         BOUND      irb.12
10.70.188.49      2857438     74:ac:b9:bc:ab:83  346         BOUND      irb.12
10.70.187.109     2182001     78:45:58:06:3c:9b  516         BOUND      irb.11
10.70.187.27      573697      78:45:58:06:3c:a5  549         BOUND      irb.11
10.70.187.31      573715      78:45:58:06:41:94  510         BOUND      irb.11
---(more)---

Show Device Address:

MikroTik: Click IP > Addresses.

image.png

Juniper:

Every Layer 3 (IP) network is attached to an irb which in turn is attached to a VLAN, unlike RouterOS where the IPs are attached to the interfaces directly, irrespective of Layer 2 interface type.

root@nycmesh-1934-core> show configuration interfaces irb
unit 0 {
    family inet {
        dhcp {
            vendor-id Juniper-qfx5100-48s-6q;
        }
    }
}
unit 10 {
    description "mesh bridge";
    family inet {
        address 10.69.19.34/16;
        address 10.70.189.1/24;
    }
}
unit 11 {
    description "Grand St OLTS";
    family inet {
        address 10.70.184.1/22;
    }
}
unit 12 {
    description "Grand St OOB";
    family inet {
        address 10.70.188.1/24;
    }
}
unit 51 {
    description nycmesh-1932-af24-227;
    family inet {
        address 10.70.251.18/30;
    }
}
unit 115 {
    description nycmesh-1933-mlq1-407;
    family inet {
        address 10.70.251.69/30;
    }
}
unit 202 {
    description nycmesh-1933-af60lr-7512;
    family inet {
        address 10.70.251.9/30;
    }
---(more)---

Each irb would then be attached to a VLAN, which in turn gets attached to interfaces.

root@nycmesh-1934-core> show configuration vlans
default {
    vlan-id 1;
    l3-interface irb.0;
}
grandstolts {
    vlan-id 11;
    l3-interface irb.11;
}
grandstoob {
    vlan-id 12;
    l3-interface irb.12;
}
mesh {
    vlan-id 10;
    l3-interface irb.10;
    isolated-vlan sectors;
}
nycmesh-1932-af24-227 {
    vlan-id 51;
    l3-interface irb.51;
}
nycmesh-1932-lhg60-2463 {
    vlan-id 500;
    l3-interface irb.500;
}
nycmesh-1933-af60lr-7512 {
    vlan-id 202;
    l3-interface irb.202;
}
nycmesh-1933-eh8010-5916 {
    vlan-id 302;
    l3-interface irb.302;
}
nycmesh-1933-mlq1-407 {
    vlan-id 115;
    l3-interface irb.115;
}
sectors {
    vlan-id 15;
    private-vlan isolated;
}

...which then get attached to interfaces (see above).

Post Install (New Member Form)

This is a template form to print and leave with members with their WiFi information, install/node number and other details. It also provides links to our support channels if they have any issues.

Our Mesh Guide also includes a page to write down this information. Otherwise writing the WiFi information on a piece of paper is also acceptable.

Remember to write down the administrator (management) password for WiFi router. This is important if the member needs to change their WiFi password later. (Most installers have a standard password that they use, but it's helpful to have a record so we don't need to reset the router if we don't know it)

NYC Mesh Post Install Form

Common Issues and How to Avoid Them

Alignment and wind

We've had many antennas lose alignment in the wind. There's a few simple things you can do to prevent this-

  1. Use a socket and drill to tighten hose clamps fast. It's hard to get the hose clamp tight with a screw driver. A socket and drill will get it really tight. You'll need a socket set that has both american and metric sockets.

  2. Put one layer of electrical tape under the hose clamp. This can help stop slipping, especially on smooth j-pipes like the Ubiquiti ones.

  3. Make sure pipe mounts can't twist by putting a bolt through them. You'll need a set of metal drill bits (such as titanium) and some 2 1/2" long 1/4" bolts.

If you can move the LiteBeam with your hands, it will also move in the wind. Larger antennas, like the LiteBeam LR need even more care to stop them  from moving in the wind.

Bad crimps

Ethernet testers aren't perfect so you need to check your crimps visually-

  1. Wires are in correct order!
  2. All wires are pushed all the way to the end
  3. All pins are pushed down after crimping (important!)
  4. The cable jacket is just inside the RJ-45

If the first three things are correct the cable will work! The jacket being inside the rj-45 gives it a bit more strength.

It is possible that the cable tester will wrongly say it is fine even if the wires aren't at the end and the pins aren't all down.

The crimping tool's job is to push the pins into the wires. Look at the pins before and after crimping and you should see that they are all pushed down by the same amount. Some crimping tools are incompatible with the toughcable jacket and are unable to push the pins down evenly. We recommend this crimper

Not enough cable

To save carrying a full box of cable many installers take a roll of cable (and occasionally not enough)

Here’s a short guide to help:

  1. Tough cable is marked every meter. Each box is 305m so if the end says 255m you have 50m left
  2. 50 meters of cable is enough to do an average install
  3. Each floor adds about 3 meters to the length
  4. Member’s floor info is now on the schedule to help with calculation
  5. Each extra apartment adds about 20m + floor calculation
  6. 100m is the max length for Cat5 cable. (data loss and voltage loss is too much)
  7. If you have a roll, you can measure one loop and multiply by the number of loops

1 meter = 3 feet

OmniTik power problems

The biggest confusion with OmniTiks is that one model has POE out (OmniTik POE) and one doesn't. They both look the same. There is obscure print near the ethernet ports that will tell you if it is ethernet out. OmniTik POE has a much larger power injector and this must be used to power it. If you accidentally power it with a smaller adapter it will work but the LiteBeam will occasionally reboot.

Sometimes the OmniTik won't automatically power the LiteBeam. You can force on the power by going to Webfig>Interfaces>ether5 and select "PoE Out: forced on". Also check that you are using the correct power injector for the Omni as this can also cause this problem. If the "PoE Out" option is missing you have the wrong kind of OmniTik!

Use electrical tape to tape the small DC power cable to the white injector after plugging it in. This often comes undone causing all sorts of problems. The DC power cable is the same as the tp-link DC cable, and will break the tp-link if you plug it into that instead.

The OmniTik should plug directly into a wall, not a power strip to avoid accidental power loss.

Query

This page works best in incognito/private window mode!

This is for installers to query our install spreadsheet. This is password protected.

If you have trouble running this script, try using an incognito (private) window in your browser

This uses simple matching for addresses. Type the number and street name, e.g. "123 Smith St". Don't enter a complete address! For NN, install number and email it uses exact matches.







Safety

Growing the mesh is important, but so is staying safe to install more nodes. These are general safety guidelines intended to address more common hazards on an install, but keep an eye out for risks even if they are not covered here.

What to Bring to Site

In addition to standard installation equipment, bring the following gear to ensure safety on site:

Traveling to and from Site

Be aware of your surroundings at all times. If you feel unsafe traveling to a particular location, consider meeting up with co-installers beforehand and traveling together.

Site Survey

alt text

Ask your member to tell you about any hazards on site.

During your site survey, note potential hazards and tell your fellow installers. These may include:

Working with Others

Take responsibility for your own safety first but make sure to watch out for your co-installers.

If you are an install team leader, understand the capabilities of your fellow installers and assign tasks they are comfortable doing.

Inform your fellow installers of any medical conditions that could impact the install.

If you are asked to do something you find unsafe, respectfully decline the task and propose an alternate method.

Weather

Read the weather forecast the day of the survey. If there is a high likelihood of poor conditions, cancel the install.

In case of heavy rain, thunder or lightning, leave the roof immediately and cancel the install.

During hot weather, stay hydrated and protect your skin with sunblock. Take breaks indoors or in the shade. Recognize the signs of heat exposure, such as dizziness, nausea, headache, confusion, and rapid, shallow breathing.

During winter, tread carefully to avoid slips and falls on ice. Stay away from icy patches when possible.

During cold conditions, protect your skin with appropriate outerwear and take breaks indoors to warm up. Recognize the signs of cold stress, such as uncontrolled shivering, slurred speech, clumsy movements, fatigue and confused behavior.

During windy conditions, keep lightweight equipment inside a bag so that it does not blow off the roof.

References and further reading:

Avoiding Falls

alt text

Rooftops present various falling hazards. Exercise caution while working on rooftops at all times.

Ask your member about any hazards in advance of entering the rooftop.

Move carefully and watch where you are walking at all times. Try to avoid stepping backwards.

Keep yourself and your equipment away from the edge of the roof whenever possible.

Step carefully over or around loose cables, debris and other tripping hazards.

Don’t grasp or put any weight onto unstable parapet walls or fences.

Do not step on, lean against or put any weight on skylights. Do not place any equipment on skylights.

When working near the edge of the roof, maintain visual awareness of the edge at all times. Do not work facing away from the edge.

Keep off steeply pitched surfaces.

References and further reading:

Access Hazards and Confined Spaces

alt text

Understand egress (exit) routes from the rooftop space. If there is a door or a hatch, make sure that it does not lock behind you. Prop open if necessary.

Avoid entering confined or narrow spaces.

References and further reading:

Fixed Ladders to the Rooftop

Inspect the ladder prior to using it. Make sure it is secured to the wall and that rungs are stable and not slippery.

Only one person on the ladder at a time.

When climbing through a narrow passage, make sure to take off any loose-fitting clothing. If carrying a backpack, ensure you have enough clearance behind you.

Always maintain 3-point contact (i.e. only let go and move one hand or one foot at a time). Do not carry anything that compromises your ability to grip the ladder or could cause you to become imbalanced.

Work together with your co-installer to pass equipment up to the top or bottom of the ladder. Inform your co-installer of the weight of anything you are passing to them. Make sure they securely grip the equipment before letting go.

Face the ladder when climbing.

References and further reading:

Temporary Ladders

Inspect the ladder prior to using it. Use the ladder only on a stable and level surface..

Always maintain 3-point contact. Do not carry anything that compromises your ability to grip the ladder or could cause you to become imbalanced.

Never stand on the top step, the paint tray, or thin support struts on the back which are not meant to be stepped on.

The proper angle for setting up a straight ladder (not the self-supporting A-frame type) is to place its base a quarter of the working length of the ladder from the wall.

Do not place a ladder on boxes, barrels or other unstable bases.

If using an extension ladder, make sure the locks are engaged on both sides.

References and further reading:

Electrical and Cable Safety**

alt text

The equipment used in a typical install is classified as low-voltage beyond the electrical outlet adapter. Low-voltage electrical circuits still present a shock hazard.

While the shock from a low-voltage cable may not cause serious injury by itself, it could cause you to jump or lose balance, which could result in a fall.

Learn to identify high-voltage electrical equipment and stay away from it.

Be careful to not cut or drill through concealed piping or wires. Make a small inspection before starting to cut or drill.

Keep cables away from power wires, lightning rods, transformers, hot pipes and mechanical rooftop equipment such as air conditioning units. These things can get hot and melt the coating off our cables.

Never install wiring during electrical storms.

Use tools with non-conducting handles.

Make sure to secure cable to rooftop and wall surfaces, and keep it out of the way as much as possible. Do not create a tripping hazard for your member or other building users.

Make sure to clean up cable sheathing after stripping. A pet or child might eat them if left on the floor.

References and further reading:

Drill Usage

Inspect the drilling area before starting to identify any objects that might get in the way, such as electrical cables, nails or staples.

Get a secure footing when operating the drill. Do not overreach.

Select the correct bit. (See installation slide deck)

Make sure you are using the right bit for the material you are drilling into and ensure the drill bit is in good condition.

Tighten the chuck securely.

Use eye protection, especially when drilling through metal. Metal will shred, and shards could fly into your eye.

Keep the drill away from water. Move the drill to a dry location if it starts to rain.

Clean the drill bit after operation.

Report any damage or defects to the tool owner if you are borrowing it.

References and further reading:

Moving furniture

Coordinate the moving of any heavy furniture with the member.

Before moving anything, plan the move and communicate the plan it to your member or fellow installer. Consider where you will pick it up, where you will move it and identify any tripping hazards.

Make sure nothing will fall off the furniture you are moving or that moving the furniture will not cause something else to fall.

Get as close to the load as possible. While lifting upwards, keep your back straight and your knees bent, and do not twist your body.

Do not lift anything that is too heavy for you to pick up in a smooth motion.

If moving any outdoor items (for example air conditioner supports), pick up cautiously as there may be insects underneath.

References and further reading:

Asbestos

Buildings in New York City may contain asbestos. Learn how to identify materials that may contain friable asbestos and avoid exposure (see link below).

Asbestos is considered to be not dangerous unless damaged or disturbed, which can release fibers into the air.

A general rule of thumb is to assume asbestos may be present in homes built before 1980.

Materials that commonly contain asbestos include:

Learn how to visually identify asbestos. Here is one resource: https://web.archive.org/web/20220821044546/https://merryhill.co.uk/what-does-asbestos-look-like/

References and further reading:

Liability

The property owner may face liability for any injury. Maintaining safe work practices helps protect your member as well as yourself and your fellow installers!

Read more about homeowner liability here: https://realestate.findlaw.com/owning-a-home/homeowner-liability-safety.html

Further Reading

Typical Install Diagrams

The purpose of these diagrams are to give a technical overview of the routing of a typical mesh node, as shown on the Typical Installations Page.
There are two installation types that are generally seen in the mesh network:

Omnitik and a LiteBeam:

Most notes on the mesh have both an OmniTik and a LiteBeam on the roof. The LiteBeam provides the uplink connection back to a local hub node (which has sector antennas to which the LiteBeam connects). The Omnitik provides local connections to other nodes (which may or may not have their own LiteBeams) and provides routing and switching for that node's members.

NOTES

 

OmntiTik by itself (omni-only):

Nodes which are located next to an existing node may sometimes be installed without a LiteBeam. These "omni-only" nodes rely on the nearby node(s) for their connection to the rest of the network. 

In the example below, nodes A, B and D have LiteBeams that connect to a nearby hub, while node C is "omni-only". Node C relies other nearby nodes to connect to the rest of the network (while also serving as an intermediate "bridge" node between A,B and D).

ClusterExample.png

Generally we try to ensure there are at minimum two nodes with LiteBeam in each "cluster" to ensure there is a backup if the main uplink node goes down.

Omni-only_Install.png

NOTES

Typical Installs

Please read our FAQ if you haven't already.

The intention of this page is not to be technical but rather give to the non-technical person an understanding of a typical installation.

NYC Mesh is an "over the air" network. The aim is to connect rooftop to rooftop using different types of equipment based on geography and topology. And in doing so, to expand NYC Mesh network coverage to the next block and so on*. The idea of NYC Mesh is to share the connectivity with neighbors, share resources, share equipment, share the network. Create a community of communities connecting to each other.

NYC Mesh typically uses two categories of equipment.

*Note: In some cases, such as large buildings we may use fiber to connect but would setup a rooftop "hub" to expand the network to surrounding neighbors.




 

1.- Connect to a hub or supernode (one apartment - no roof-to-roof expansion). Such installation does not allow expansion of the Mesh network, nor allow sharing with neighbor community

A typical installation has a LiteBeam antenna on the roof. From that antenna an ethernet cable is run to the apartment. (note: the antenna is sometimes referred to as the outdoor router).

photo       photo

Depending on the roof it can be mounted on an old TV antenna pole, on an added pole, a wall, a chimney, or any existing infrastructure.

photo photo photo photo

In the apartment any type of WiFi router can be installed. We install a TP-Link router.



 

2.- Connect to a hub or supernode (one or several apartments - with roof-to-roof expansion). Allow Mesh network expansion and sharing with the neighbor community

To allow others to connect to your rooftop LiteBeam router we need to add an ethernet router and an access point. For this we usually use an OmniTik mounted on the same pole or it can be mounted somewhere else on the roof. The OmniTik will give you wifi on your roof and also allow 4 other apartments to connect with ethernet.

photo      

The OmniTik is an Omnidirectional (360°) antenna. It has about 2-3 block radius. We connect the Litebeam to the OmniTik and apartments to the OmniTik via ethernet.

photo photo photo

OmniTik not located next to the Litebeam
photo

Other rooftops can connect to the OmniTik by using another Omnitik if they are close enough or we use, in some cases, an SXT.

This setup as a major benefit. It allows the devices to mesh with each other. If an other Omnitik is installed in a 2-3 blocks radius they will connect to each other and create a mesh, thus improving reliability and allowing a) the Mesh network to expand, and b) the neighbor community to use it to access internet.



 

3.- A good rooftop can be "beefed up" to allow for more connectivity.

If the rooftop is interesting (at a good location, it's high enough, etc) we may install "sectors" or other type of equipement. Sectors are antennas that communicate via Ubiquiti's AirMax protocol and have a longer range than an OmniTik. Additionally, we may connect to two hubs, etc....

Here are four examples.

photo photo photo photo



 

4.- A building can connect to another building with an OmniTik using a different antenna

A building can connect to another building with an OmniTik using a SXT antenna. It can then serve one or several apartments.

photo photo



 

Those are typical installations. Other setups are possible and in use throughout NYC Mesh.

For the most up-to-date overview of the entire install process, check out the Install Training Presentation.

Siklu Alignment

Alignment Process

Under Construction

Video: How to use Link Budget Calculator

Video: Siklu Etherhaul Antenna Alignment

Coarse Alignment

Coarse alignment should be done after mounting the antenna.

Video: Coarse Alignment

Fine Alignment

The Siklu radiation pattern has multiple "lobes," a bit like two concentric donuts (side lobes) around the center target (main lobe).  These are effectively "lumps" in signal strength emitted by the antenna.  Like a mountain top there are many local peaks, but only one true highest point. 

image.png

Video: Aligning Large Form-Factor Radios

To align the Siklu: 

Alignment Tool

image.png

A system of digital output multimeter and logging software can aid in the alignment process.  This software creates a Grafana graph of the signal strength / lobes, removing the need to manually record with pen and paper.

Video: Using a Digital Multi-Meter to Perform Fine Alignment

Software: 
Hardware

TP4000zc multimeter (Ask Andy to borrow the meter + cables)

See Also:

Siklu, before its aquisition by Ceragon in December 2023,  had a very helpful technical support staff.  Since then, a lot of the Siklu documentation has disappeared from the website, only a support email is provided.  Luckily the Siklu YouTube channel still exists, we still have some guides squirreled away in this Master Drive Folder.  Notably:

Ubiquiti Unifi AP Adoption Guide (WORK IN PROGRESS)

Introduction (Why we need to do this)

Ubiquiti WiFi access points need a controller (Unifi) to be configured, as they can't operate as standalone devices.
For the mesh, this controller resides on a virtual machine in the SN3 data center.

In a "normal setup" in an office building or somewhere, the AP devices are all on the same LAN and are plugged into a Unifi switch, so they will be auto-detected by the controller and can easily be adopted. 
This intended setup rarely happens on the mesh, as the AP may be on the other side of the city from the controller, with various firewalls and filters in between. This means the device won't automatically find the controller and the controller won't be able to adopt the device, so your fancy new WiFi access point remains a paperweight.

However there is a way to help the process along...
We do this by logging into the device (SSH) and telling it where the controller is located (it's IP address). Once this is done the device will announce itself to the controller and can usually be adopted without issue.

Note: You can't adopt WiFi Mesh AP devices via a wireless only connection. You need to connect them with a wired interface first to adopt them, then you can unplug them and move them to their final location. They will then be able to operate in a WiFi mesh setup using another AP as their uplink.

Prerequisites:

You will first need to know the IP address of the Access Point. If you're plugged into an Omni, this can usually be found by looking in IP > DHCP Server > Leases Tab. Look for a device called "Unifi" or "UAP-Pro" or something like that. Write down what IP it has and set it to a static IP while you're at it.

If you can't find the device in the leases tab, you may need to Torch the port to find the IP. 
Go to Interfaces > Interface List and click the interface to which the AP is connected. (ether3 on the Omni or whatever)
Click "Torch" in the top menu bar, then click "Start".
At the bottom of the screen you will see a list of connections on that port. Usually the IP of the access point should show up in the "src" column, though there may be a couple others, so wait a second and choose the most prominent IP.

Next you will need a computer from which you can SSH
Pretty much any windows/mac/linux computer will work:

Instructions
  1. Once you you have the terminal open, type ssh ubnt@<device IP address> and hit enter.
    You may need to type "yes" to accept the unknown SSH certificate.
    When prompted for a password the default is "ubnt"
  2. Execute the command, and you are done with SSH.
    set-inform http://unifi.nycmesh.net:8080/inform

     

  3. Log into https://unifi.nycmesh.net:8443
  4. Switch to the correct "site"
  5. Find the new AP and adopt it only when you are within the correct "site"
  6. After the adoption process completes (may take a minute), set the name of the device based on the convention you see in place
  7. Update the device if needed
  8. Review the assigned SSIDs and add/remove as needed.
Example SSH Session
root@localhost:/home/james# ssh ubnt@10.96.116.50
ubnt@10.96.116.50's password: 


BusyBox v1.25.1 () built-in shell (ash)


  ___ ___      .__________.__
 |   |   |____ |__\_  ____/__|
 |   |   /    \|  ||  __) |  |   (c) 2010-2023
 |   |  |   |  \  ||  \   |  |   Ubiquiti Inc.
 |______|___|  /__||__/   |__|
            |_/                  https://www.ui.com

      Welcome to UniFi UAP-AC-Mesh!

********************************* NOTICE **********************************
* By logging in to, accessing, or using any Ubiquiti product, you are     *
* signifying that you have read our Terms of Service (ToS) and End User   *
* License Agreement (EULA), understand their terms, and agree to be       *
* fully bound to them. The use of SSH (Secure Shell) can potentially      *
* harm Ubiquiti devices and result in lost access to them and their data. *
* By proceeding, you acknowledge that the use of SSH to modify device(s)  *
* outside of their normal operational scope, or in any manner             *
* inconsistent with the ToS or EULA, will permanently and irrevocably     *
* void any applicable warranty.                                           *
***************************************************************************

UAP-AC-Mesh-BZ.6.6.55# set-inform http://unifi.nycmesh.net:8080/inform

Adoption request sent to 'http://unifi.nycmesh.net:8080/inform'.  Use UniFi Network to complete the adopt process.
 
UAP-AC-Mesh-BZ.6.6.55# Connection to 10.96.116.50 closed by remote host.

Omni PoE Diagram

img_5675.jpg

Sending email notifications to members

This guide details the process to send emails to all the members that will be affected by maintenance work or other tasks that may cause an outage or slow speeds for members. The goal is to notify members ahead of time to ensure they are not caught by surprise during the outage. This also avoids taking up volunteers time chasing support issues that turn out to just be another team of volunteers working on a rooftop.

Getting the list of NN's

There are a few ways to retrieve the list of NN's that need to be notified of an outage.
In some situations only one NN will be affected, like it you are taking one building offline. That's easy, one NN to notify.

Otherwise you can use tools like Outage Simulator and Node Explorer to determine which nodes will be affected by an outage.
Generally, it's better to over-notify than under-notify, so we are usually pretty liberal with our notification emails.

image.png

Retrieving the member emails from MeshDB using SQL Explorer

MeshDB allows you to retrieve all the emails for individual members with a few simple steps. 

Access the SQL Explorer tool located at https://db.nycmesh.net/explorer/.
You'll need a login to Mesh DB, so either request one in #meshdb on slack or find a friend who has one.

Select the "Email from NN" query and click the Play button. This will open the query in a new window where you can go ahead and make changes.

Copy of the query fuction

SELECT meshapi_member.primary_email_address
FROM meshapi_member
WHERE meshapi_member.id IN
    (SELECT meshapi_install.member_id
     FROM meshapi_install
     WHERE meshapi_install.status = 'Active'
     AND meshapi_install.node_id IN
        (SELECT meshapi_node.id
         FROM meshapi_node
         WHERE network_number IN (1384, 350, 7016, 136, 1440)))

image.png

Edit the numbers in the query to the NN's you need, then click "Refresh" to run the query again.

image.png

Scroll to the bottom of the page and copy the list of emails.

image.png

You can also use the "Download" button to save the output as a .csv or .json for importing into other tools.

image.png

Sending the emails

There are several ways to send emails to a group of members. The method we've currently settled on is using a volunteer's @nycmesh email address, CCing support@nycmesh.net and BCC'ing the email's of the affected members.

This method uses an @nycmesh email so the email appears formal, while still coming from the individual volunteer's personal email, so they can respond to any questions or follow up if needed. By CC'ing the support email, we ensure that if a member Replies-All to the email (which we usually mention in the email) then a ticket will be opened in OSTicket for tracking and other volunteers to provide support.

Once you send the email, a ticket will immediately be opened in OSTicket for you (as you CC'd the support email).
It's helpful to the other volunteers to log in and close this ticket as soon as you can, so no other volunteers get confused and try to respond to you.

At some point we could also consider using MailChimp to send a template email to an uploaded .csv list of emails.

Here are a few previous emails that can be used as templates and modified.

Planned maintenance outage


Node 552 Planned Maintenance Outage

Hello NYC Mesh Member.

You are receiving this email because you are a mesh member at Node 552.
We are writing to you to inform you of a planned maintenance outage that will occur tomorrow, September 24th, 2024 between the hours of 10am to 12pm

You may experience slower speeds and/or your connection may go offline for a short period (expected to last between 5-15 minutes) during this window as our volunteers conduct maintenance and upgrades to your buildings mesh equipment.
This brief interruption will allow us to upgrade your building's core router and install additional equipment required to connect other shareholders in your building to the mesh.

We appreciate your patience while we conduct these upgrades and apologize for any inconvenience.

If you have any questions or issues, please reach out to us by reply-all to this email which will open a support ticket. One of our volunteers will be happy to answer any questions you may have.

You can also reach out to us via our normal support channels as well:
Email: support@nycmesh.net - Phone: 833-NYC-MESH (692-6374)
Slack: https://slack.nycmesh.net (message us in the #support channel)

Thank You,

Lydon Thorpe
Volunteer Install Technician

Fiber Optics

Fiber Optics

Fiber Safety

1. Intro

1.1 Description

Although fiber is a relatively safe material to work with, there are some hazards to be aware of. These hazards can be particularly troublesome since bare fiber is microscopic and transparent; it is nearly impossible to detect if you lose track of your scraps.

They come in two forms:

  1. fiber scrap
  2. fiber shard

1.2 Details

There are some details to keep in mind while reading this page:

  1. The fiber cable refers to the glass fiber, cladded and wrapped by both inner and outer jackets.
  2. Bare fiber refers to the glass core that is left after stipping the outer and inner jackets as well as the cladding.
  3. The cable is spooled in the package; the curvature is a hazard as the cable will bend back quickly when straightened out.
  4. Bare fiber is extremely fragile.
  5. Positioning the fiber on the cleaver or splicer is a delicate operation. The fiber is likely to poke a hard surface and bend, leading to breakage. If not careful when unclamping the cable, it will jump out of the tool and back into shape as mentioned in (3).
  6. Once fiber gets in your body, it may never leave as it neither decays or get broken down by the immune system.
  7. Using a microscope to locate fiber is only possible on skin and is extremely challenging due to the scale, the elasticity of skin, and uneven surface of the skin.
  8. The hazards can also affect others who are currently in the space or will be in the future.

2. Fiber Scrap

2.1 Description:

A piece of fiber scrap is a segment of bare fiber which gets created while cleaving or accidentally breaking bare fiber. Scraps can break down into smaller segments or into shards. They are the easier pieces to keep track of due to their length. If a scrap disapears, shining a flash light at different angles on a surface will produce a segment shaped glimmer if it hits a scrap.

As shown in the pictures bellow, the amount of light and angle at which it hits the scrap affects the visibility. Note that these are two different pieces of scrap, which were found by closely inspecting the surfaces using a flashlight.

scrap across table scrap on table scrap on chair

2.2 Hazards:

There are two ways in which scraps are hazardous; pricking and snapping.

2.3 Potential consequences

3. Fiber Shards

3.1 Description:

Fiber shards are microscopic glass shrads; similar to fiberglass dust. They are nearly impossible to track due to their size; the smallest shards can be measured in micrometers (1 micrometer is 1/1000th of a millimeter).

3.2 Hazards:

2.3 Potential consequences

4. DOS AND DON'TS

DO:

DON'T:

5. RECAP

Hazard origins

Cleaving
-> scrap
-> shards

Cutting cable
-> shards

Snapping scrap
-> scrap
-> shards

Stripping jacket/cladding
-> shards

Hazards

Scrap
-> pricking
-> ingestion

Shards
-> inhalation
-> ingestion
-> skin, eye contact

Potential Health Consequences

Ingestion -> inflamation, internal hemorage

Inhalation -> airway inflamation

Pricking -> infection

Skin, eye contact -> inflamation

Bonus

Although risks are low for a few installs, over the long run, some installers may want to take more precautions. An extremely safe setup for the most risk averse of installers would be a DIY fume extractor. This setup is compact and mitigates all of the hazards mentioned in the previous sections.

The plexiglass walls contain any dust in a small area, the gloves protect the installer's skin and clothes, and the negative presure fan ensures proper ventilation. In addition, hooks and magnets can be used to keep some tools organized and permanently inside the container (e.g. stripping tool, tzeezers, alcohol pads...). In order to perform a splice near the ceiling, some mechanism needs to be used to strap the container atop a ladder (unless the installer considers a baker scaffolding affordable and convenient)

Equipment list:

  1. 6 18*24 acrylic sheets + acrylic cement + small hinges OR large, clear plastic box (plastic box may not be as practical as custom acrylic box)
  2. 4 inch hole saw
  3. 4 inch pvc pipe
  4. plastic epoxy
  5. 2 worm clamps (for the gloves on the extractor)
  6. gooseneck arms with aligator clips
  7. nonslip pads
  8. arm-length gloves
  1. vaccum/fan with ~40ft 4 inch vent hose
  2. 4 worm clamps (2 for window adaptor to fan, 2 for fan to extractor)
  3. portable ac window adapter

6. Resources

Fiber Optics

Nyc Mesh Fiber Background And Splicing Guide

NYC Mesh Fiber Background and Splicing Guide

​ These are notes collected by @JohnB from the fiber splicing class taught by Zach Giles at the NYC Mesh room on July 19, 2022. I took notes on my phone, so some of the information might be missing/inaccurate. ​

Theory

Fiber Splicing Guide

​

Resources

Fiber Optics

Fiber Splicing Tutorial

1. Intro

These instructions assume only the required tools are used, and minimal precautions taken; no assumptions about safety equipment or convenient tools.

There are 7 procedures to perform in the splicing process; roughly in the following order:

  1. setup
  2. strip cable to bare fiber
  3. cleave bare fiber
  4. fuse
  5. test
  6. apply heat to shrink sleeve and tube
  7. clean up

Procedures 2 and 3 will be performed twice; once for each of the two cables. However, one side will need to have more outer jacket stripped off to make room for the shrink sleeve; to move it out of the splicer. The side on which the sleeve will be is refered to as Side With Sleeve (SWS), and the other as Side WithOut Sleeve (SWOS). Note that the sequence will be strip SWS, cleave SWS, position SWS in splicer, AND THEN strip SWOS, cleave SWOS and position SWOS in splicer. That sequence minimizes the risks of mishandling each cable, which could result in one or both of 1) a fiber splinter and 2) breaking the bare fiber; either of which could require starting the process over for that cable since even if the bare fiber did not break, if it has been cleaved, poking any surface could ruin the cut.

During procedure 4, the fibers may need to be repositioned multiple times to align the fiber correctly. This is because, as noted in the fiber safety page (detail 3 to consider), the cable is curved; making this part challenging since the cable needs to be positioned straight and precisely.

Procedure 5 is performed before 6 since it would be a waste of time and resources to shrink the shrink sleeve and the shrink tube if the splice needs to be redone.

2. Steps with pictures

Bellow are pictures taken through out the splicing process. (the ordering numbers come from the detailed list in the next section)

  1. Stripping the outer jacket of SWS:

  1. Stripping the inner jacket of SWS:

  1. Positioning the stripped SWS in the cleaver:

  1. Positioning the cleaved SWS in the splicer:

16-17) Stripping the outer and inner jackets of SWOS:

  1. Positioning the cleaved SWOS in the splicer:

  1. Read splicer screen to view the quality of the splice and an estimate of signal loss:

  1. Test splice:

  1. Place shrink sleeve over the fused, bare fiber and move the whole to the splicer's heating compartment to shrink the sleeve:

  1. Verify that the sleeve has in fact shrunk (may need to heat 1-3 times):

The result:

3. Detailed list of steps

3.1 Prep

  1. prepare all the equipment required; includes tools and any PPE.

  2. cut shrink tube (20cm).

  3. prepare shrink sleeve.

  4. mark location to cut on cable from each side.

  5. slide shrink tube down either cable.

3.2 Begin Process

  1. Take a cable from either side; this cable will be the side with the shrink sleeve (SWS), the other will be the side with out the sleeve (SWOS).

  2. Strip outer jacket of SWS (12cm) and cut kevlar.

  3. Slide shrink sleeve over inner jacket of SWS.

  4. Strip inner jacket of SWS (2cm) into sharps container.

  5. Strip cladding of SWS into sharps container and apply alcohol pad.

  6. Cleave SWS.

  7. Use tweezers to pick up fiber fragment and drop into sharps container; verify that the segment was indeed in the tweezers all the way to the sharps container, and that it fell in the container before putting the tweezers down.

  8. Position SWS in fusion splicer.

  9. Use tape to clean any potential glass pieces around and between cleaver and sharps container (if they are not moved before cleaving the other side, this can be done after the second cable is cleaved).

  10. Take SWOS.

  11. Strip outer jacket of SWOS (5cm) and cut kevlar.

  12. Strip inner jacket of SWOS (2cm).

  13. Strip cladding of SWOS and apply alcohol pad.

  14. Cleave SWOS.

  15. Use tweezers to pick up fiber fragment and drop into sharps container; verify that the segment was indeed in the tweezer all the way to the sharps container, and that it fell in the container before putting the tweezers down.

  16. Clamp SWOS and position it in fusion splicer (clamp to reduce movement when removing the splicer clamp; due to cable curve).

  17. Use tape to clean any potential glass pieces around and between cleaver and sharps container.

  18. Fuse cables.

  19. Connect cable ends to testing devices and test signal loss.

  20. Carefully release each cable from splicer clamps.

  21. Slide shrink sleeve over exposed fiber and place in splicer's heating compartment; sleeve should cover each side roughly 3cm from joint.

  22. Heat 2-3 times.

  23. Slide shrink tube over shrunk sleeve; the shrink tube must leave no inner jacket exposed.

  24. Shrink shrink tube with lighter while adjusting grip to ensure the shrink tube cools straight; may consider using solder clamps for this step.

3.3 Clean and pack up

  1. Use tape to clean each piece of equipment and put them back in toolbox

  2. Fold tape in half, sticky side in, to trap any potential glass pieces.

  3. Dispose of tape and pack up the rest of equipment.

4. Template

In order to strip jackets quickly and precisely the installer should make a template, such as the one shown bellow.

stripping template

Note that the template in the picture is crowded to illustrate the instructions in section 3; a color coded stick may be easier to work with.

Stick template example (1 dash = 1cm):

< - - - -0- - - - >< -1- >< -2- - >< - - -3- - - - >< - - - -4- - - - >

0: no color -> 8cm; Space for palm of hand.

1: green -> 2cm; Strip inner jacket of both SWS and SWOS.

2: white -> 3cm; green + white = 5cm to strip SWOS outer jacket.

3: yellow -> 7cm; green + white + yellow = 12cm to strip SWS outer jacket.

4: black -> 8cm; green + white + yellow + black = 20cm to cut shrink tubing.

The following pictures show the measurements used to determine the lengths. Note that template lengths are longer to leave ample room for errors.

The pictures show that:

cleaver pads under ruler

shrinksleeve on ruler

splicer measurement

Fiber Optics

Fiber to the Apartment

The first step is to screw the ONT into the wall in a convenient place using drywall achors. The ONT we are currently using is the Ubiquiti UF-WiFi6-US

Only use white fiber inside apartments, never yellow or any other color. This is to better blend in with the wall. We have custom made 3mm white fiber with termination at one end.

Once the ONT is screwed into the wall, plug in the terminated end of the white fiber. Now you are ready to run the fiber to the exit point (usually above the front door). You first run the fiber down to the top of the baseboard and then along to the nearest corner, attaching it to the wall with silicone or staples. You run the cable up the corner to the ceiling and follow along the corner of the ceiling to the exit point using silicone or staples along the way.

Ufiber ONT

As always with fiber, don't do any hard bends! Let the fiber curve around corners.

There is no loose fiber in the apartment, just a service loop above the door. All the fiber is locked down with silicone or staples the whole way. Any loose fiber will result in service calls. Excess fiber is pulled back into the apartment and left as a service loop above the door. Trim the yellow raceway fiber down before splicing so it one foot from the entry point. Use excess white fiber to enable the splice.

At the exit point you drill a small hole (6mm?) and feed the unterminated end of the fiber through to the raceway. The fiber will be spliced outside of the apartment either with a fusion splicer or with a mechanical splice. The hole must be sealed after you're finished!

The new ONT has a built in router so install it near a power outlet and you are done. You will need to log into the OLT to configure the router

The older model ONT is powered by connecting it to a POE injector, and connecting the data port to a TP-Link/Archer home router.

Support

[to be expanded!]

Fiber support is fairly straightforward. First do the usual test of the wifi router to eliminate that as the problem. Next test the signal going into the ONT by unplugging the connector and connecting it to your meter.

Test db of signal using an OTDR or optical power meter (OPM). The signal should be between -22db to -10db. Less than -24db and the signal is too weak. -8db is the highest limit that will work.

If the signal is outside of the range of -22 to -10 you need to look for where signal loss is occurring. This is typically the splice in the raceway or damaged fiber that has been bent.

Light fiber with red test signal using the OPM or OTDR. This is done from the hallway access box.

Look for loss along the way, especially in the raceway splice. Redo splice if signal loss is there. If the cable is damaged elsewhere, splice around the damage.

Fiber Optics

Fiber install guidelines

In order to avoid problems with fiber install quality, the following guidelines should be followed:

Physical Installation

Drilling, Mounting etc

Physical Installation

Concrete Drilling

Tips

Physical Installation

Non-Penetrating Roof Mounts/Stands

EZ NP-72-200 (Amazon):

Model: EZ NP-72-200
Manufacturer:
 Easy-Up
Link:
 Amazon Link
Price:  175$

PXL_20240114_171102647.jpgPXL_20240114_205023878.jpg

PXL_20240114_164337980.jpg

Cheaper stand, includes a mast as well. Feels solid enough for a LiteBeam + Omni, AF60LR, WaveLR or other medium sized antenna. Would probably be reluctant to mount something heavy like a AF24 on it. Maybe mounted low would be fine.

Can hold a max of 8 concrete blocks. (Without stacking them)

Comes with a nice thick recycled (I think) black rubber mat to protect the roof, which is slightly larger than the frame of the stand.

Not the biggest fan of the design. Mast is offset, not centered on the base so there's one direction in which the stand is more likely to topple over. The frame has 3 arms, with a 4 sided base. Should have had 4 arms extending to each corner of the base.

Also whoever decided that filling the box with packing peanuts was a good idea deserves to be fired. Can't open the box on a roof or anywhere windy for fear of packing peanuts going everywhere.

The stand has a collar for mast at the top, but attaches to the bottom of the mast with hole drilled through and a screw. Has some amount of leveling adjustment, but not as much as stands with two collars. Has 3 adjustment bolts per collar.

The mast comes with the tripod and collar parts already assembled, which saves time and confusion. The base is made of angled metal. All screws are the same size, so no worries about mixing them up. Gloves are highly recommended for assembly, lots of sharp metal edges.
Instructions don't have a picture. That would be nice to have.


Wade Antenna NPRM-2:

Model: NPRM-2
Manufacturer:
 Wade Antenna
Link:

Product Page Link
Anixter (Supplier Purchase Link)

TVAntenna.com (Supplier Purchase Link)
Price:  233.50$ (TVAntenna.com)
371.00$ (Anixter previous quote/purchase)
Assembly Instructions:
 Link

IMG_20230727_183359465.jpgPXL_20230703_193112501.jpg

PXL_20230526_194413233.jpgPXL_20230526_200452000.jpg


Made in Canada and there's somewhat limited places to purchase it. Last time we purchased from Anixter, but TVAntenna.com seems to have better prices.
Doesn't include a mast.

Can hold 12 concrete blocks max without stacking them, 6 per side.
Used this stand to hold a AF24 + Sectors at Sunset Park Library. Would trust this stand for larger antennas, though would still not mount a Siklu or anything that requires precision alignment. It still has some flex and will probably have issues with alignment on super narrow bandwidth antennas.
Also this stand has wind loading charts from the manufacturer, to plan the amount of concrete blocks required.

Has flanges at the top and bottom to hold the mast. Allows angle adjustment/leveling of the mast by adjusting the 4 bolts on each collar. The bottom flange prevents the bottom of the mast from hitting the roof directly. This stand has 4 arms that extend down from the top flange to the 4 corners of the base.

Assembling this stand can be a little tricky. The instructions are pretty good, though it uses 4 different sizes/lengths of bolts, which are not interchangeable. Need to pay close attention to which bolts should be used where. The bolts are somewhat cheap, we managed to shear one of them during the assembly when we wrenched down too tight. The stand comes completely disassembled.
Getting the arms attached to the upper collar and then lined up with the holes in the frame was somewhat difficult. Had to bend the arms a little bit to get stuff to align as the factory bends were not exactly right. (somehow...)

There is a rubber map (additional 19.50$) which protects the roof under the stand. It's a little thin, white and could be a bit more beefy but it seems to do the job. Not sure how well it's going to hold on in the weather, will need to check back in a year or so. Could probably just buy a recycled rubber sheet of the right size that would be tougher.

Physical Installation

Unistrut mounting

STRUT CHANNEL.pdf

image.png

Physical Installation

Window Drilling Guide

All of our installs usually require getting a cable from the outside to the inside of a building eventually... Drilling through the window frame or lip is the most common way to do this, as it's much easier than drilling through a thick brick wall.
This guide is intended to share knowledge and help familiarize new installers with the types of windows that are common in NYC buildings, along examples of techniques. Many installers find the idea of drilling holes in someone else's house to be daunting, so following along on installs and seeing how other lead installers do it as well it a great supplement to this guide.

 

Brooklyn Standard Window (Metal Frame):

We call this the Brooklyn Standard Window as it's very common in the pre/post war brownstones around Brooklyn. It can be identified by the large lip on the bottom inside of the window, they are usually metal and usually black. They also usually open at both the top and bottom.

These windows tend to have a lot of play and big tolerances in the bottom sliding pane, meaning that by drilling through the metal lip at the bottom of the window, you can pass the cable through and the window will generally still close and lock. 
The metal lip on the bottom can be drilled from both the inside or outside.


<Insert Photo of Brooklyn Standard Window here>


Below is a variation of the Brooklyn Standard Window (that's also white), this time with a piece of wooden trim on the inside. This trim prevents you from drilling from the inside out, without making a big mess of the trim. The track for this situation is drilling a horizontal hole through the metal lip from the outside in, then meeting it with a hole drilled downwards at an angle through the trim.
PXL_20240203_193525256.jpgPXL_20240203_193509382.jpg

The end result still looks good though, and the hole is drilled low enough in the lip that the window can still close and lock. The holes are caulked shut and the cable is arranged nicely with a cable clip. The member was also informed that they could paint the cable white to match if they wished to do so.

PXL_20240203_194249630.jpg

 

Plastic Frame Windows:

A lot of newer buildings have new plastic framed windows. These windows often have a plastic or wood frame on the inside and sometimes have a metal flashing on the outside. The frames around the sliding pane are also often hollow on both the sides and bottom. (This can be checked by tapping with your hand and listening for a hollow sound)

The plastic frames are easy to drill, so often it's possible to drill the frame around the window, so you don't have to worry about the window closing on the cable. However if you do need to drill the bottom lip you must make sure to drill as low as possible so the cable lies flat on the bottom frame. These windows have much less play to work with, so there's a possibility of it not locking shut once the wire is run though. 

Example of a plastic window with a hollow frame. Was able to drill through the bottom frame of the window which is hollow inside. 

PXL_20240203_174306806.jpg
Drilling straight through will the inside hole as low as possible on the bottom frame of the window.

PXL_20240203_174323988.jpg
Drill bit existed through existing drainage hole on the outside of the frame, so a bit messy outside hole. Can be sealed with caulk, but as it's an existing (and intentional) drainage hole, it's not necessary. Caulk the inside hole around the cable to prevent cold drafts getting in.

PXL_20240203_174337610.jpg

<Insert photos of hole drilled through the side frame of a plastic window>

Side Opening (New fancy windows):

These windows are really problematic due the fact that there are usually very small frames, so there's no where to drill a hole though without impacting the function of the window or being too close to the glass (risk of breaking it).
Most of these windows will also not seal/latch shut properly with anything running through them. You end up with a big gap open around 3 sides of the window which will let in a ton of air and the member probably wont approve of. 

In most cases the best way to deal with these new windows is to just find a new point of entry or just drill through the wall.

<insert photo of crappy modern window that's impossible to drill>

 

 

 

 

 

Install Planning and Surveys

Surveying and planning installs

Install Planning and Surveys

Taking Panorama Photos

A direct line of sight to a Supernode or hub node is required to connect to NYC Mesh. To help the install team determine whether a line of sight is possible, we ask new members to provide a panoramic photo of the view from their rooftop. We use these photos to identify an existing hub/node to which your building can connect.

Where to find the panorama photo function on your phone

Most cell phone cameras have panoramic photo capability in camera mode.

iPhone

On iPhones, this feature will be a scrollable option on the bottom of the camera screen.

alt text

Android

On Android phones, this feature may be listed under “more” or “...”.

alt text

Taking a good panorama image

Rooftop panorama images should show as much of the surrounding skyline and other buildings as possible. We are looking to see if any of our existing hubs or supernodes are visible from your rooftop. For this reason please take your panorama photos from the highest point on the roof if possible (and safe!).

If you are also willing and able, please feel free to annotate cardinal directions (North, South, East, West) and other nearby landmarks (nearby streets, lower Manhattan, midtown, prospect park, etc) This helps our volunteers get their bearings and figure out which direction your photos are looking.

Best practices for roof panoramas

Best practices for DIY window panoramas

Examples of good panorama photos

alt text alt text alt text

231-north.jpg

13379-pano.png

Examples of unusable panorama photos

image0(2).jpeg
Photo taken in the evening, too dark. Can't see anything.

pano-glare.jpg
Too much glare from the sun. Need to re-take photo closer to midday.

Screenshot_20230129_064318.png

Photo is too low quality, can't see any details. (May need to re-take photo with a better camera or try re-sending as an attachment instead of inserting into the email.)

Install Planning and Surveys

Surveys

Site surveys

Site surveys for large buildings help us determine if wireless connection is possible and how we will run cable to apartments. Take photos at each step as you go through the building.

Mounting points on roof

Identify the best mounting points on the roof.

Bandwidth test

Take a battery and do a bandwidth test to the hub or hubs that they are planning to connect to

(This might not be possible if the mounting point is in the water tower)

Conduit or drop point for cable from roof to basement

For large buildings we need to run cable from the roof to the basement. Try to identify existing conduits we can use. We can't use ISP's conduits, unless the building owns them.

Telecom closet access

All large buildings have a telecom closet in the basement. This is one place we might put a panel and run our cables from there.

Raceways into apartments

Hallways often have conduits running where the wall meets the ceiling. This is called a raceway. See if this is owned by the building and we can use that.

Unused wiring that we could use.

Often there is unused or abandoned wiring that we can use. This might be ethernet, coax or even fiber. This will save a huge amount of time and money if we can identify that.

Documentation

When finished, write up a google doc of the survey with embedded photos. We often share these as pdf's with the interested building managers.

Hotspot Omni Configuration Guide

This guide applies to a specific Omnitik device that is configured for use as a mobile WiFi hotspot at outreach, tabling and other community events.

This configuration and guide is not applicable to general use devices around the mesh and shouldn't be applied to rooftop omni's. Please use the standard omni configuration on the Omnitik 5 POE AC page instead.

We often host tables at fairs, farmer's markets and other community events to do outreach for the mesh. For these events it is useful to have equipment to show interested folks what a typical mesh install looks like. 

image.png

We also often set up the equipment to be functional and broadcast the usual -NYC Mesh Community WiFi- network for visitors at the event to use. This serves as an outreach and advertising tool for the mesh, as folks will see the available WiFi network on their phone and may be interested in visiting our table to learn more about us.

We have a pre-configured Omntik for this task with a unique configuration that makes this easy for volunteers to set up and run. This Hotspot Omni is usually stored with our other outreach/marketing materials at the mesh room.

Explanation of the configuration

Once turned on, an omni with the hotspot configuration will automatically create a public  WiFi network ("-NYC Mesh Community WiFi-") when supplied with an internet connection on ether1.
Any internet connection will work, be that a cellphone hotspot (details below), an SXT/LiteBeam to another NYC Mesh node,  or connecting to an existing public WiFi network (re-broadcasting it).

Devices can connect to the Hotspot Omni via:

The omni configuration runs a DHCP client on ether1 to grab an IP from whatever device is providing an internet connection. It also runs a DHCP server on the mesh bridge interface for client devices to connect.

It should play nice with other omni's around the mesh, so there's no worries about turning it on in areas where it might automatically mesh with nearby rooftops. (It can use nearby mesh nodes as its internet source if desired)

How to setup Ethernet tethering on an android phone

You can use an android phone to provide an internet connection for the Hotspot Omni. This will use your data plan for devices on the public WiFi, so you should have a unlimited data plan or be aware of the possible high data usage this may entail.

You will need a USB-C ethernet dongle, preferably one which will also let you charge your phone at the same time, as having your phone providing the internet connection uses a lot of battery.

image.png

Steps to follow:

  1. Provide power to the omni and wait for it to turn on.
    • You can use a 28v or 24v POE brick to power the omni, or a drill battery adapter for mobile deployments.
  2. Connect the USB C to Ethernet adapter to the Android phone.
  3. Connect an Ethernet cable from the adapter to ether1 (via the POE injector).
  4. Open settings on the phone and go to “Network & Internet” > “Hotspot & Tethering” and turn on “Ethernet Tethering” (The adapter/cable must be connected or this option will be grayed out)
  5. The omni will get a DHCP IP from the phone (via the DHCP client on ether1).
    • Other devices can now connect to wired or wireless networks and will received IPs from the DHCP server. There is a limit of 64 IPs/devices.

Backup/Example of the configuration script:

Hotspot Omni configuration script

<In progress>