HP ThinPro Agent Installation

To install the Edge DX Agent onto a device running ThinPro 7.2, use the following script. Replace <tenant url> and <reg code> with the correct values for your organization.

fsunlock
pkill sipagent
mkdir -p /writable/controlup/avacee
ln -s /writable/controlup/avacee /usr/local
mkdir -p /writable/controlup/ControlUp
ln -s /writable/controlup/ControlUp /usr/local
curl -o /usr/local/avacee/sipagent https://downloads.sip.controlup.com/avaceesipagent-linux
chmod +x /usr/local/avacee/sipagent
curl -o /usr/local/avacee/RCNotifications https://downloads.sip.controlup.com/RCNotifications
chmod +x /usr/local/avacee/RCNotifications
/usr/local/avacee/sipagent tenant=<tenant url> devregcode=<reg code> store_settings_only=1

cat <<EOF > /writable/etc/systemd/system/avaceesip.service
[Unit]
Description=ControlUp Edge DX Service
[Service]
ExecStart=/usr/local/avacee/sipagent
WorkingDirectory=/usr/local/avacee/
[Install]
WantedBy=multi-user.target
EOF
systemctl daemon-reload
systemctl enable avaceesip
systemctl start avaceesip
fslock

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
systemctl stop avaceesip
curl -o /usr/local/avacee/sipagent https://downloads.sip.controlup.com/avaceesipagent-linux
chmod +x /usr/local/avacee/sipagent
curl -o /usr/local/avacee/RCNotifications https://downloads.sip.controlup.com/RCNotifications
chmod +x /usr/local/avacee/RCNotifications
systemctl start avaceesip
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:

1. The device is put into a writable mode using fsunlock
2. 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.
3. The standard Linux Agent is downloaded into /usr/local/avacee and is marked as executable.
4. The settings needed for the Agent to communicate with the organization are created by running the Agent with the store_settings_only=1 flag.
5. 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:

1. If there is a proxy, check that it is configured.
2. Check that the device is able to connect to <tenantname>.sip.controlup.com on https.