Post install setup

After the self-host Somewear service is installed and running, there are some additional setup steps to take. The Somewear CLI tool will be used to perform the following.

• Create an organization.

• Import devices to your organization.

Download the Somewear CLI tool.

The Somewear CLI will be installed on the Somewear service server. Log into the server and then switch to the Pilot user

$ sudo su - pilot

Ruby is required to setup the Somewear CLI tool. Install Ruby if it is not already installed on the server.

$ sudo apt install ruby-full -y

Set your basic core artifact credentials to an environment variable. These credentials will be supplied by the Somewear Labs team.

$ read -rs CREDENTIALS
$ export CREDENTIALS

Run the following command to download and setup the Somewear CLI tool.

$ curl -fsSL https://storage.googleapis.com/somewear-public/cli/install-somewear-cli.rb | ruby

Create the Somewear CLI properties configuration file required by running somewear properties-init. You will first be prompted if you are running the Somewear CLI client directly on one of your Somewear Core nodes, or if you are running it from a remote host. You will be prompted fill in setting required to connect to your Somewear Core instance. Below is an example of running through the setup wizard.

$ 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

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

Import a device to the organization

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