Optimium Remote Server

Why Remote Server?

Optimium supports remote runtime profiling on the target hardware, allowing users to utilize their powerful host PC as cross compilation & optimization machine, while their target device only executes the cross compiled binary during optimization.


How To Install

Linux

To install Optimium Remote Server, type command below:

$ cd OPTIMIUM_SDK/optimium_runtime
$ ./install_runtime.sh \
    --remote your-account@target-device \
    bin native xnnpack

This command installs Optimium Remote Server on your target device.

The command uses SSH and SCP to install Optimium Remote Server and will ask for your SSH password if needed.

If you do not use SSH, please refer here to install files manually.

After installing Optimium Remote Server, update PATH environment variable on your target device so that the Optimium Remote Server could work properly.

export PATH="$PATH:$HOME/.local/bin"
Android

To install Optimium Remote Server on your target device, type command below.

$ cd Optimium_SDK/optimium_runtime
$ ./install_runtime.sh --adb bin native xnnpack

If you connected multiple Android devices on your host PC, you should add --serial flag with serial ID of the device to install Optimium Remote Server.

$ cd Optimium_SDK/optimium_runtime
$ ./install_runtime.sh --adb --serial 12345678 bin native xnnpack

ℹ️

How do I get the serial of my Android device?

Open a terminal and type adb devices -l. Strings in first row of the list are serial ID of devices.


How to Launch

Linux

After installing Optimium Remote Server, open terminal on your remote device and type command below.

optimium-remote-server

Optimium Remote Server will start and wait for the connections.

Optimium Remote Server uses port 32264 for default listening port. You can change it by using --port PORT option.

# assume that you uses port number 12345
optimium-remote-server --port 12345

To list up all available flags, add the --help flag in the command line.


Android

After installing Optimium Remote Server, open terminal on your host PC and connect to the target device with Android Debug Bridge(ADB).

Move to the parent folder of the path where Optimium Remote Server is installed. Default installation path is /data/local/tmp/.local.

# Move to /data/local/tmp, where is parent folder of /data/local/tmp/.local
cd /data/local/tmp

Configure environment variable and launch Optimium Remote Server.

export PATH="$PATH:/data/local/tmp/.local/bin"
optimium-remote-server

Optimium Remote Server will start and wait for the connections.

Optimium Remote Server uses port 32264 for default listening port. You can change it by using --port PORT option.

# assume that you uses port number 12345
optimium-remote-server --port 12345

To list up all available flags, add the --help flag in the command line.