Bridge X

Current Version - 1.0.2

1.0.2 (2019-04-26)

Changes

  • general bug fixes
  • ui fix for display connect issues

While we are working on a fix please see the following instructions on starting up Wifi connection for the current Bridge Image

Force Update

In the bridge UI:

  • Scroll down to the bottom of the UI, which is the footer

    force-update

  • Click on Force Update

force-update-confirm

  • Click on Confirm

**You will see this load screen for a moment

force-update-loading

Once it confirms you should see this screen

force-update-complete

Your Bridge will reboot and now you should be able to connect via Wifi!

You may also be able to refresh the page for the UI and the Wifi connection options to appear, if this doesn't work, please refer to the Force Update instructions above

Video Walkthrough

For a video walkthrough of the setup you can view the video below (it is part of an official Geomining Kit Video):

Three Options to Connect Your Bridge X

Important - Before you begin

Be sure to have an updated SDCard that should have been sent to you. This is the best way to have the latest hardware. If you want to flash the latest image to your SDCard, please refer to the directions by clicking here

First option

  • Connect your Bridge X to a power source

    plug-bridge

  • Connect your Bridge to your Router using an Ethernet Cable

    plug-ethernet

  • Check to see if indicator lights are red and green near the power port

    power-light

  • Check to see if indicator lights are static amber and flashing green at the ethernet port

    ethernet-light

  • Using your computer, point your browser to xyo-bridge.local
  • You should see a text input field to enter and confirm a password with a Continue button

bridge-ui

  • Create a password that you will remember, and the confirm that password. Click Continue to connect the Bridge X

  • Once you connect, you should see a screen similar to this

bridge-dashboard

Use Your Bridge X to interact on the XYO network!

  • You can now click the Wifi icon to connect the Bridge X to your Local Wifi Network
  • You should have your Wifi connection details handy to complete this step.

wifi-icon

  • Next, claim your Bridge X by logging in with your XYO Account - enter your email and password and then click Login

You should now see this screen

claim-bridge

  • Now click Claim to claim your Bridge X!

Second Option (Using Google Chrome or Firefox)

  • Connect your Bridge X to a power source

    plug-bridge

  • Connect your Bridge to your Router using an Ethernet Cable

    plug-ethernet

  • Check to see if indicator lights are red and green near the power port

    power-light

  • Check to see if indicator lights are static amber and flashing green at the ethernet port

    ethernet-light

  • Using your computer, point your browser to app.xyo.network
  • Create a username and password, or if you have already started using the app on either Web or Mobile, log in with your email and password
  • You should now see the main XYO App Dashboard

xyo-app-dashboard

  • Click on the menu icon to the left of Dashboard

xyo-app-menu-icon

  • You should now see a side menu appear

app-side-menu

  • Click on Local Bridges
  • You should directed to a new dashboard so that you can scan for bridges

    scan-bridges-dashboard

  • Click Start Scan
  • The app will take a few moments in scanning for your Bridge X, you will see an indicator for progress
  • Once the app discovers the Bridge, you can verify the name and IP address of your Bridge X
  • Click Connect
  • You are now connected to your Bridge X!

Third Option

NOTE You will need a keyboard and mouse for this option NOTE While the SDCard is loading your screen may appear black for about 30 seconds

  • Connect your Bridge X to a power source

    plug-bridge

  • Connect your Bridge to your Router using an Ethernet Cable

    plug-ethernet

  • Check to see if indicator lights are red and green near the power port

    power-light

  • Check to see if indicator lights are static amber and flashing green at the ethernet port

    ethernet-light

  • Connect your Bridge X to a display of your choice using an HDMI cable

    hdmi-plug

  • Connect a mouse and keyboard to your bridge using the available USB ports
  • You should now see a UI on your display similar to the first option
  • You should see a text input field to enter and confirm a password with a Continue button

    bridge-ui

  • Create a password that you will remember, and the confirm that password. Click Continue to connect the Bridge X
  • To set up Wifi for your Bridge X - click the Wifi icon to connect the Bridge X to your Local Wifi Network

After you connect your Bridge X

  • Go ahead and disconnect the Ethernet from the Bridge X (only after connecting it via Wifi)
  • Check out app.xyo.network for your Bridge's activity
  • Check out our Matrix
  • Try starting up your first Archivist!

Update your Bridge

Downloading and flashing a Bridge X image

First we want to download the latest Bridge X Image

  • Click here to download
  • Double click on the zipped file to expand it
  • You should now see the img file appear in the same folder where the img.tar.gz file appeared
  • Use this img file below using Etcher

Using Etcher (MacOS, Linux, or Windows)

The easiest way to flash our new Bridge image to your current SDCard is by using etcher

  • First we download etcher here
  • You will notice the download button searching for your OS
  • When it discovers it you should see the Download button display your OS, below an example on MacOS

etcher-download-button

  • Once download is complete move the Etcher into your Applications

  • Now, open the application (through your respective search OS function)

  • Here is a MacOS example of the GUI you should see when you open up the application

    etcher-gui

  • Now we can click select image - this will direct you to your respective file explorer where you can find your Bridge X image

  • Once you find it click on it and then click open

  • You can now click on the drive that you just formatted

    select-drive-gui

  • Now we can click Select drive - this will direct you to your respective file explorer where you can find the drive that you formatted

  • Once you find it click on it and then click open NOTE If you did successfully format that SDCard, the GUI may automatically set the drive without you having to find it Your GUI should look something like this before you flash the SDCard (MacOS example)

    flash-gui

  • Now we can click Flash!

  • You will be prompted to enter your device password

  • Once you do, the GUI will change to indciate that the SDCard is currently flashing

    flashing-gui

  • Depending on the current image, this may take from 10 - 18 minutes, go ahead and check out the Matrix while you wait!

  • After Etcher completes the flashing process, it will go into validating the flash

flashing-gui

  • Once that is completed, you can eject the SDCard and install it in your Bridge X

While we are working on a fix please see the following instructions on starting up Wifi connection for the current Bridge Image

Force Update

In the bridge UI:

  • Scroll down to the bottom of the UI, which is the footer

    force-update

  • Click on Force Update

force-update-confirm

  • Click on Confirm

**You will see this load screen for a moment

force-update-loading

Once it confirms you should see this screen

force-update-complete

Your Bridge will reboot and now you should be able to connect via Wifi!

You may also be able to refresh the page for the UI and the Wifi connection options to appear, if this doesn't work, please refer to the Force Update instructions above

Advanced Option for MacOS or Linux

  • First insert your SDCard into your chosen dongle USB to SDCard reader

Next we want to download the latest Bridge X Image

  • Click here to download
  • Double click on the zipped file to expand it
  • You should now see the img file appear in the same folder where the img.tar.gz file appeared

Now we flash the image

  • Open your Mac's disk utility and navigate to 16gb disk NORELSYS 1081
  • Click Erase
  • Select ExFAT as your format for the new partition
  • Check for successful erase
  • Click on the info button in the disk utility
  • Scroll down to the parent disks
  • Take note of the parent disks name

Go into a terminal window

  • Navigate to the image
    • In downloads (or wherever you keep your downloads) .img file
  • Enter this command
  sudo diskutil unmountDisk /dev/<your parent disks name>
  • Then install image to the Bridge
  sudo dd if=./xyobridge.img of=/dev/<your parent disks name> bs=1m
  • Once that is completed, you can eject the SDCard and install it in your Bridge X

Updating the Bridge through unattended upgrades

Once we have set up our Bridge X it would be a good idea to check on and complete upgrades

There are two ways that we can do this

  • First, enter this command to execute commands on your Bridge
  ssh bridge@<ip address of your bridge>
  • You will be prompted to enter a password, you will enter the default password for the Bridge filestore - geohacker
bridge@<ip address of your bridge>'s password:
  • Then enter this command
sudo apt update
  • Enter the device password again for the Bridge - geohacker
[sudo] password for bridge:
  • You should see the Bridge pulling the latest from the repo
Hit:1 http://repo.xyo.network/repos/apt/raspbian stretch InRelease
Hit:2 http://raspbian.raspberrypi.org/raspbian stretch InRelease
Get:3 http://archive.raspberrypi.org/debian stretch InRelease [25.4 kB]
Fetched 25.4 kB in 1s (15.0 kB/s)
Reading package lists... Done
Building dependency tree
Reading state information... Done
31 packages can be upgraded. Run 'apt list --upgradable' to see them.
  • Now run this command to upgrade
sudo apt upgrade
  • You will be prompted on whether you would like to continue with the upgrade
The following packages will be upgraded:
<packages to be upgraded will be listed here>
31 upgraded, 0 newly installed, 0 to remove and 0 not upgraded.
Need to get 106 MB of archives.
After this operation, 303 kB disk space will be freed.
Do you want to continue? [Y/n] y

This upgrade includes a lot of downloading and unpacking of new packages, so please be patient with the process

You should see a progress bar

Progress: [ <percent complete>%] [#################################################################################################################################..........................................................]

Once it completes, you are all set with your upgrade. Be sure to visit the Bridge X App to verify that it is still functioning

You can also use this command after sudo apt update to execute an unattended upgrade

sudo unattended-upgrades -d

The confirmation output after this upgrade process should look like this

+ @xyo-network/bridge.pi@0.123.0
updated 1 package in 71.157s
xyo-bridge-pi is ready
All upgrades installed
InstCount=0 DelCount=0 BrokenCount=0
Extracting content from '/var/log/unattended-upgrades/unattended-upgrades-dpkg.log' since '2019-04-18 22:08:09'

Congrats you have upgraded your Bridge X! Refer back to the beginning of this guide for how to set up your Bridge X

A note on changing the Bridge's linux default password

If you don't want our default password to run your bridge, you are more than welcome to change it

  • First, enter this command to execute commands on your Bridge
  ssh bridge@<ip address of your bridge>

NOTE you can change the password to your Bridge filestore by entering this command

sudo passwd bridge

You will then get a prompt to enter the current password (geohacker)

[sudo] password for bridge:

Enter a new password

Enter new UNIX password:

Then confirm this new password

Retype new UNIX password:

After the password is confirmed you will see this message and you may continue operating on the Bridge with your own password

passwd: password updated successfully

Adding an archivist

Use the Bridge X UI

  • Scroll down on the dashboard to your connected archivists - you will see that we have one connected which is XYO's Archivist

archivist-gui

  • Click +Connect More Archivists

You should see a Add Archivist modal pop up on your screen

  • Enter the IP Address or DNS Name
  • Enter the Port number
  • Click Save

add-archivist

  • Once we save the information, we should now see another Archivist under Connected Archivists

connected-archivists

We have now connected an Archivist to the Bridge X using the Bridge's native UI!

Changelog

Version - 1.0.1

1.0.1 (2019-04-23)

New Features

  • add ui component for last resort update (for large scale bridge issues)
  • add ui to display current npm and apt versions

Changes

  • about tag in footer is new location for force update and last resort
  • general bug fixes

Version - 1.0.0

1.0.0 (2019-04-18)

Changes

  • more consistent force update of bridges
  • general bug fixes

Made with ❤️ by [XY - The Persistent Company] (https://xy.company)

Last updated on 4/30/2019
← Archivist AppSentinel X →