Overview
1 Download and Install Pulse Agent
2 Onboard Gateway using BASIC Authentication

Steps
Download and Install Pulse Agent
1 Login to Pulse Console if you are not already (link)
2 Username: [First Name Initial][Last Name]@pulse.local
Password: VMware1!

3 Click Gear Icon and Select Downloads

4A Right-click the 'Pulse Agent(x86_64) Download' link
4B Select Copy Link Address

5 SSH to your Virtual Gateway (local Ubuntu Virtual Machine using MacOS Terminal or Windows Putty Client) and issue the following commands
ssh username@[IP address]

6 su up
sudo su

7 cd /tmp
curl -o iotc-agent.tar.gz (paste in download link from your clipboard)

8 Extract the downloaded tarball, change into the expanded directory and run ./install.sh
tar -xvf iotc-agent.tar.gz
cd iotc-agent
./install.sh

9 Reboot your Virtual Gateway
reboot

10 (Optional) Ping your Gateway while waiting for it to reboot
ping [ip address]
Onboard Gateway using BASIC Authentication
1 Once your Gateway is back online, SSH to it
ssh [username]@[your vm’s ip address]

2 su up and enter password
sudo su

3 Confirm that the Pulse Agent is running (note that you may see errors in your output - these are expected at this time)
service iotc-agent status

(Press Q or CTRL-C to break out of the service status view)

4 Change into the Pulse Agent bin directory
cd /opt/vmware/iotc-agent/bin

5 Run the DefaultClient with the help parameter to examine commands that are available (note the various ‘enroll’ options near the top).
./DefaultClient help | more

(Press Q or CTRL-C to exit, or press any key to continue scrolling)

6 Cat the following file to indicate the syntax you should type to onboard your gateway (this file was created when you ran the vGatewayPrep.sh script earlier). Replace ‘kosborn’ with your username
cat /home/kosborn/workshop/onboardSyntax.txt

7 Type (or Copy/Paste) the output from the previous step to Onboard your Gateway. (Note that your syntax will not match what is shown here):
./DefaultClient enroll --auth-type=BASIC --template=vGatewayTemplate-Ken-7 --name=vGateway-Ken-7 --username=(your assigned Pulse IoT Center User Name@pulse.local)

8 ‘Status of enroll response: 0’ indicates that the Gateway was successfully registered and enrolled in the Pulse Console.

9A Return to the Pulse Console (Chrome Browser) and select Devices
9B Enter [FirstName]-[Number] in the Search filter field and note that your Gateway is now present and Enrolled
9C Click on your Gateway

10 Note the Basic information that is present (Friendly Gateway Name, Unique Id, Template that the Gateway was enrolled via, etc.)

11 Select Properties and note the information that is present (this information is being populated via the Pulse Agent on the Gateway and is customizable. We can - and will later in this workshop - send in additional Properties like Docker information, etc.).

12 Select Metrics and expand the Utilization Graphs (note that it can take 10-15 minutes for your Metrics to start populating, proceed to the next step for now)

13 Select Connected Devices and note that we currently have no IoT Connected Things associated with the Gateway (we will add a Virtual IoT Sensor as well as Docker Containers in later Workshop lessons)


<Thank you - this concludes our ‘Onboard Gateway' Lesson>