- Print
- DarkLight
- PDF
HP ThinPro Agent Installation
- Print
- DarkLight
- PDF
This article covers how to install the Edge DX Agent onto HP ThinPro OS devices.
Edge DX supports HP ThinPro versions 7.1, 7.2, 8.0, and 8.1.
Before you begin
You'll need your tenant URL and device registration code. You can find these on the Downloads page.
ThinPro devices use the Linux Agent. The instructions in this article install the latest GA version of the Linux Agent. You can see the latest version on the Downloads page.
Agent installation
Select your ThinPro OS version below.
To install the Edge DX Agent onto a device running HP ThinPro version 7.2, 8.0, or 8.1, run the following script. You must replace <tenant url>
and <registration code>
with the correct values for your organization.
https://downloads.sip.controlup.com/hptpinstallv2.sh <tenant url> <registration code>
Set up a proxy server connection
To set up a proxy server connection at the time of installation, add a proxy
parameter to the following line before running the installation script above, and enter your proxy IP address and port number. For example:
/usr/local/avacee/sipagent tenant=<tenant url> devregcode=<reg code> proxy=10.0.0.1:8080 store_settings_only=1
To set up a proxy server connection for an existing Agent, use the following script and enter your proxy IP address and port number:
fsunlock
systemctl stop avaceesip
/usr/local/avacee/sipagent proxy=10.0.0.1:8888 store_settings_only=1
systemctl start avaceesip
fslock
Update existing agent
To update an existing Agent to the latest GA Agent version, run the following script:
fsunlock
service avaceesip stop
curl https://downloads.sip.controlup.com/avaceesipagent-linux.tar --output ./sipagent.tar
tar -xf ./sipagent.tar -C /usr/local/avacee/
chmod +x /usr/local/avacee/sipagent
chmod +x /usr/local/avacee/RCNotifications
fslock
service avaceesip start
fslock
Additional information
- The ThinPro 7.2 Agent uses a systemd service to auto-start the Agent.
- A writeable area is created through a symbolic link.
- A service file is created.
To install the Edge DX Agent onto a device running ThinPro 7.1, use the following command. Replace <tenant url>
and <registration code>
with the correct values for your organization.
curl https://downloads.sip.controlup.com/hptpinstall.sh | bash -s <tenant url> <registration code>
Running the script above installs the Agent but doesn't start the Agent. The Agent starts and registers the device in your organization only after the device reboots.
If you are creating an image with the Agent, you must create the image before the device reboots and the Agent registers in your organization. This allows the Agent to store unique information about the device the image is installed on, and not the device used to create the image.
Update existing agent
To update an existing Agent to the latest GA Agent version, run the installation script again.
Additional information
The installation script does the following:
- The device is put into a writable mode using fsunlock
- A folder is created on the writable area (/writable/controlup) and is symbolic linked to the non-writable file system (/usr/local/avacee). This allows the Agent to write to /usr/local/avacee and for the content written there to be preserved.
- The standard Linux Agent is downloaded into /usr/local/avacee and is marked as executable.
- The settings needed for the Agent to communicate with the organization are created by running the Agent with the store_settings_only=1 flag.
- The initialization configuration file /etc/init/controlup-edge.conf is created. This file is needed to start the Agent when the device is rebooted.
The steps above allow the Agent to register the device in the organization. Once the device is rebooted, it might take a minute before the Agent becomes active. If it takes longer than 2 or 3 minutes, something has likely gone wrong. In that case, check to see if you have installed the Agent correctly. If the Agent still does connect to your organization, perform the following troubleshooting steps:
- If there is a proxy, check that it is configured.
- Check that the device is able to connect to <tenantname>.sip.controlup.com on https.