Quick setup guide

Sign up to Alef

As an enterprise, you must make a request to sign up for edge connectivity from Alef. Please contact support@alefedge.com to help you with that proceess, When your sign up request is accepted, Alef creates a master account for you. On creation of your master account, you will receive your API key and Account ID from Alef via the provided e-mail. Once you have your Account ID and API key you are ready to set up your first private edge mobile network.

Before you start

1. Check List
2. Connect

Full Network provisioning

Required information:

• RAN Info
• Network Info
• Edge Location info

Prerequisties

• Customer Admin account
• Customer Site provisoned

info

You will be using the Alef Mobile Network API to carry out the tasks in this section. This is a basic config, Refer to the API reference documentation to learn more about the API and explore the full schema.

You can use the following POST request body with the /connectivity/v2/networks/network endpoint to create and configure your complete Network.

Expand here to see the Network creation POST request body and response.

Request

curl -X 'POST' 'https://api.alefedge.com/connectivity/v2/networks/network' \
  -H 'Authorization: Bearer <JWT TOKEN>' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d ' {
   "name": "Alef Demo Mobile",
   "mobile-core": {
     "name": "My-First-EPC",
     "generation": "4G",
     "mode": "Classic",
     "plmn": [
       {
         "mcc": "315",
         "mnc": "010",
         "tac": "[1-3]"
       }
     ],
     "mobile-network-name": "AlefMobile",
     "mme": {
       "ip-addr": "127.0.0.1",
       "name": "my-first-mme"
     },
     "apn": [
       {
         "dnn": "internet",
         "ueip": "192.128.1.0/24",
         "gateway": "192.128.1.1"
       }
     ],
     "dns-list": [
       {
         "dns": "8.8.8.8"
       },
       {
         "dns": "1.1.1.1"
       }
     ],
     "enb-ip-subnet": "192.128.2.0/24"
   },
   "mobile-gateway": [
     {
       "name": "Edge-Gateway-1",
       "edgelocation": "PHI-1",
       "tac": "3",
       "sgw-ip": "168.53.1.250/30",
       "generation": "4G"
     }
   ],
   "ran": [
     {
       "name": "My-First-RAN",
       "site_id": "66993642310e8d77a42ed780",
       "ran-ip-subnet": "168.53.1.0/24",
       "generation": "4G",
       "mobile-access-point": [
         {
           "ip-addr": "168.53.1.25",
           "mac-address": "48:BF:74:1E:4C:FD",
           "name": "RAN-1",
           "access-point-id": "id-45",
           "cell": [
             {
               "cell-id": "138189306"
             }
           ],
           "manufacturer": {
             "name": "Baicells",
             "cbrs-sas-account": "Goodle"
           },
           "geolocation": {
             "latitude": 90,
             "longitude": 180
           }
         }
       ]
     }
   ]
 }'

Response

{
  "core": {
    "account_id": "66992fb6310e8d77a42ed77a",
    "name": "My-First-EPC",
    "generation": "4G",
    "mode": "Classic",
    "plmn": [
      {
        "mcc": "315",
        "mnc": "010",
        "tac": "[1-3]"
      }
    ],
    "mobile-network-name": "AlefMobile",
    "mme": {
      "ip-addr": "127.0.0.1",
      "name": "my-first-mme"
    },
    "apn": [
      {
        "dnn": "internet",
        "ueip": "192.128.1.0/24",
        "gateway": "192.128.1.1"
      }
    ],
    "dns-list": [
      {
        "dns": "8.8.8.8"
      },
      {
        "dns": "1.1.1.1"
      }
    ],
    "enb-ip-subnet": "192.128.2.0/24",
    "_id": "66c7553603ffb584d8338c4a",
    "__v": 0
  },
  "ran": [
    {
      "account_id": "66992fb6310e8d77a42ed77a",
      "name": "My-First-RAN",
      "site_id": "66993642310e8d77a42ed780",
      "generation": "4G",
      "mobile-core-id": "66c7553603ffb584d8338c4a",
      "number-of-access-points": 1,
      "ran-ip-subnet": "168.53.1.0/24",
      "mobile-access-point": [
        {
          "name": "RAN-1",
          "access-point-id": "id-45",
          "cell": [
            {
              "cell-id": "xyz"
            }
          ],
          "ip-addr": "168.53.1.25",
          "mac-address": "string",
          "manufacturer": {
            "name": "Baicells",
            "cbrs-sas-account": "Goodle"
          },
          "geolocation": {
            "latitude": 90,
            "longitude": 180
          }
        }
      ],
      "_id": "66c7553603ffb584d8338c4e",
      "__v": 0
    }
  ],
  "gateways": [
    {
      "account_id": "66992fb6310e8d77a42ed77a",
      "name": "Edge-Gateway-1",
      "mobile-core-id": "66c7553603ffb584d8338c4a",
      "generation": "4G",
      "edgelocation": "PHI-1",
      "served-ran-ids": [
        "66c7553603ffb584d8338c4e"
      ],
      "tac": "3",
      "sgw-ip": "168.53.1.250/30",
      "_id": "66c75ae54333dcc27fbce39d",
      "__v": 0
    }
  ],
  "edgepoint": {
    "account_id": "66992fb6310e8d77a42ed77a",
    "name": "Alef Demo Mobile",
    "mobilecore_id": "66c7553603ffb584d8338c4a",
    "mobilegateways": [
      "66c75ae54333dcc27fbce39d"
    ],
    "ran_ids": [
      "66c7553603ffb584d8338c4e"
    ],
    "_id": "66c75ae64333dcc27fbce3b0",
    "__v": 0
  }
}

tip

Take a note of the returned object IDs _id for your Network elements, as you will need it for future reference. It will be an alphanumeric string, something like 66c75ae64333dcc27fbce3b0.