Once Somewear Core is installed and running, use the Somewear CLI to create your Organization and bring your devices onto it. This page covers all three steps: installing the CLI, creating an Organization, and importing a device.

What you’ll need

• A completed Single Instance or Multi-Instance install, with Somewear Core running.
• SSH access to the Core server.
• The admin username you want to own the new Organization.

Install the Somewear CLI

1. Log in to the Core server and switch to the pilot user:

   sudo su - pilot

2. Install the Somewear CLI using the Pilot CLI:

   pilot install-somewear-cli

3. Run the setup wizard to create the CLI’s configuration file:

   somewear init

   The wizard asks whether you’re running the CLI directly on the Core host (local) or from a remote machine (remote), then walks you through the remaining properties. A local run looks like this:

   $ somewear init
   Are you running the Somewear CLI directly on the Somewear Core host or a remote host?
   Enter 'local' or 'remote' [local]: local
   Creating new Somewear CLI configuration file at ~/.config/somewear/somewear.properties...
   Enter a value for each property
   username: somewear-admin
   
   Configuration file created.

Create an Organization

Run:

somewear organization create --name "<Your organization name>" --owner-username "<Your admin username>"

Replace <Your organization name> and <Your admin username> with your own values. The named user becomes the Organization’s owner.

Import a device

Run:

somewear device import -d '<Serial>,<IMEI>' --emss --org-name "<Your organization name>"

Replace <Serial> and <IMEI> with the device’s serial number and IMEI, and <Your organization name> with the Organization you just created. Repeat this command for each device you’re bringing onto the Organization.