# Installation guide

## Supported platforms and devices

* i.MX 8 with CCL 4.2 or newer
  * CCpilot V510
  * CCpilot V700
  * CCpilot V705
  * CCpilot V710
  * CCpilot V1000
  * CCpilot V1200
* Core i7 with CCL 4.2 or newer
  * CCpilot X1200
* LinX Software Suite DevEnv
  * v5
  * v6

## Installing Data Engine

### CCL 4

Dataengine can be installed on the target in two different ways. For production use should be installed on the target through a RACU bundle. For development / testing dataengine can be installed on the target manually by manually unlocking `appfs` and unpacking it under `appfs`.

#### i.MX 8

##### RAUC bundle

Please reference the `CC Linux - Using RAUC` documentation on the support web site for more information about how to generate a RAUC bundle.

##### Unlock /appfs for development/testing

1. Open an ssh session to the target:
    <code>ssh ccs\<ip-address></code>
2. Change write permissions of /appfs:
    <code>sudo mount -o remount,rw /appfs</code>
3. Check which version partition /appfs is mounted to:
    <code>rauc status</code>
4. Unmount /appfs:
    <code>sudo umount /appfs</code>
5. Format the partition:
    <code>sudo mkfs.ext4 /dev/\<partition></code>
6. Remount /appfs:
    <code>sudo mount /dev/\<partition> /appfs</code>

##### Unpacking tarball

1. Download the tarball, dataengine-ccl4_\<version>_\<TARGET>.tar.gz, from the support site.
2. Transfer the tar.gz package to device:
    <code>scp dataengine-ccl4_\<version>_\<TARGET>.tar.gz ccs@\<ip-address>:/tmp</code>
3. Open an ssh session to the target:
    <code>ssh ccs@\<ip-address></code>
4. Change directory to `/tmp`:
    <code>cd /tmp</code>
5. Run the following code to unpack it:
    <code>sudo tar xzf dataengine-ccl4_\<version>_\<TARGET>.tar.gz -C /appfs</code>
6. Data Engine will not automatically start at boot. See [Service management](runtime#service-management).

#### Core i7

1. Download the tarball, dataengine-ccl4_\<version>_\<TARGET>.tar.gz, from the support site.
2. Follow steps 2-6 from [i.MX 8](#imx-8).

### LinX Software Suite DevEnv v5/v6

These steps are intended to be performed in the UX Designer VM.

1. Download `dataengine_<version>_amd64.deb` from the support site
2. Double-click on the package to open it with GDebi
3. Follow the instructions to install the package

It's also possible to install the package using the terminal:

``` shell
sudo apt install ./dataengine_<version>_amd64.deb
```

## Troubleshooting

Please refer to our [Knowledge Base](https://support.crosscontrol.com/knowledge-base) for
further information and troubleshooting guides.