Using EdgeBox requires just three lines of code to get you up and running on the edge. All you need is your laptop or a Linux box, that’s it. Once installed, you can onboard cloudlets, run and deploy edge applications, and test locally without impacting your existing network infrastructure.
Watch the Video:
Linux: Ubuntu 18.04 or macOS: 10.14 (Mojave) or later
MobiledgeX account with login credentials
Docker installed. The MobiledgeX Docker registry is used to connect EdgeBox to the MobiledgeX Console. You will use the same MobiledgeX login credentials to log into the Docker registry for MobilegeX.
Step 1 Install EdgeBox locally on your laptop
At the terminal prompt, type pip3 install edgebox. If you’ve already installed EdgeBox and need to upgrade, typepip3 install --upgrade edgebox.
Log into your MobiledgeX Docker registry by typing in docker login -u <username> docker.mobiledgex.net. The Password prompt will appear.
Once you enter your password, you should see a Login Succeeded message. If you were unsuccessful, try entering your credentials again.
Step 2 Create an EdgeBox
At the terminal prompt, type edgebox create testedge. You can give your EdgeBox any name. For this tutorial, we will name it testedge.
A series of questions will appear in the terminal to complete the EdgeBox configuration process. - Console Host: Use the same username you used to log in to your Docker login.
- Region: Select your desired region closest to you.
- Cloudlet: Use the default or rename it.
- Latitude and Longitude: Provide one for your cloudlet, or use the default. MobiledgeX will then map the geolocation of that cloudlet to applications that want to connect to it.
Note: If you reached this point and the download fails, go back and run the edgebox create command again.
Review your configuration, and if everything looks good, Type Y at the Continue? Prompt. The process to create your cloudlet will begin.
Once you see the Cloudlet is up at the Terminal prompt, the cloudlet is now running on your laptop.
For a list of available EdgeBox commands, type edgebox --help.
Navigate to the Organizations page. You should see an Operator Organization already created, named edgebox-<cloudlet-name>-org.
Click Manage for that Operator Organization and navigate to the Cloudlets menu on the left navigation.
Scroll over to the region where you created your cloudlet and verify that it exists in the map view.
Step 4 Create an Application to Deploy onto the Cloudlet
On the MobiledgeX Console, return to the Organizations page, where you will create the Developers Organization.
Click the right arrow for Developers, as shown below.
The Create Organization screen opens.
Populate all required fields, name your Developer Organization as edgeusertest, and click Create.
Optionally, you can add users to your Organization. Otherwise, skip this step.
Click Return to Organizations.
You are now ready to add your Developer Organization to the cloudlet.
Step 5 Add Developer Organization to Cloudlet
Follow the steps below to add your Developer Organization to your cloudlet.
On the MobiledgeX Console, with the Operator Organization selected, navigate to the Cloudlet Pools menu on the left navigation. You can see from the Cloudlet Pools page that a cloudlet pool was added for your cloudlet, named edgebox-<cloudlet-name>-pool.
Click the Actions menu, and scroll down to Invite Organization. The Organizations page opens.
For Organization, type in the name of the Developer Organization, which was edgeusertest that you previously created.
Click Create Invitation. The invite will be sent out and received by your Developer Organization.
Return to the Organizations page and switch to the Developer Organization by clicking Manage.
Navigate to the Cloudlet Pools menu, where under the Status column, you will see the Pending state. This is the pending invite sent from the cloudlet pool created previously for the Operator Organization.
Under the Actions menu, click Accept, and then click Yes to confirm.
After accepting the invite, the status within the Cloudlet Pools page will change to Accepted.
The Developer Organization can now create applications on EdgeBox.
Step 6 Create and Deploy Applications on EdgeBox
Return to the MobiledgeX Console and navigate to the Apps menu on the left navigation. The Create Apps page opens.
Populate all the required fields.
- Region: Select the same region you specified in Step 2. Create an EdgeBox.