Applicable Products:
- 64-bit x86 processor NAS series
- 64-bit ARM processor NAS series
- Container Station 2.6.0 or later
Solution
Follow the steps below to convert the LXC containers to LXD containers.
Important
- The LXD container converted from the LXC container does not support the duplicate function.
- The static IP address will be reconfigured to DHCP IP address during the LXC to LXD conversion process.
- Since the original LXC container was running in privileged mode, the LXD container converted from the LXC container will run in privileged mode as well.
Stop and Export LXC Containers
- Launch Container Station.
- Stop the LXC containers that are planned to convert.
- Navigate to Export page.
- Click + Export container. Select the LXC containers that are planned to convert and click Export.
The LXC container that are planned to convert will be successfully exported for backup purposes.
Convert LXC Containers to LXD Containers
1. Access system via SSH connection with “admin” account.
See Also
How to Work with Containers in TrueNASLinux Containers - LXD - Has been moved to CanonicalEverything you need to know to about karate kataWhat is LXD (Linux container hypervisor)? | Definition from TechTarget2. Navigate to the Container Station installed location.
- QTS[~]#cd /share/CACHEDEV*_DATA/.qpkg/container-station/
- Hero[~]#cd /share/ZFS*_DATA/.qpkg/container-station/
Note: CACHEDEV*_DATA and ZFS*_DATA depend on where Container Station is installed.
3. Navigate to the tool location.
[~]#cd ./usr/bin/
4. Input conversion commands, refer to Conversion Commands at the end of document.
Specified LXC containers will be converted to LXD containers successfully.
Start and Check the Converted LXD Container
- Navigate to Container page.
- Start the converted LXD containers.
- Check the LXD container data integrity.
The LXD container data will be the same as the source LXC container.
Conversion Commands
Usage
$ ./qmigration-tool_0.1.0_amd64 migrate lxd [OPTIONS]Options
| Name, shorthand | Description |
|---|---|
| --name | Specify the LXC container name to be converted. |
| --delete | Remove the source LXC containers after conversion. |
Examples
Convert a specified LXC container.
$ ./qmigration-tool migrate lxd --name ubuntu-bionic-1Convert all LXC containers.
$ ./qmigration-tool migrate lxdConvert and remove a specified LXC container.
$ ./qmigration-tool migrate lxd --name ubuntu-bionic-1 --deleteConvert and remove all LXC containers.
$ ./qmigration-tool migrate lxd --delete