Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
app-notes:set-up-lxc [2024/11/22 15:19] – [Set up and use an LXC container] grayapp-notes:set-up-lxc [2025/01/23 13:32] (current) – [2. Test LXC installation and set up further] gray
Line 3: Line 3:
 ===== Goal ===== ===== Goal =====
  
 +Installing an LXC container. Images for the routers are available from the Jenkins website.
  
 +===== Prerequisites =====
 +
 +  * NetModule Wireless Router with wireless connection
 +  * NetModule Software [[https://share.netmodule.com/public/system-software/4.8/4.8.0.103/|4.8.0.103]] or newer
 +  * A license is required for the LXC container
 +  * Not available for legacy products NB1600, NB2700, NB3700, NB3710
 +
 +===== - Set up the LXC Contianer =====
 +
 +Activate the LXC container on the router 
 +
 +{{:pictures:lxc_aktiv.png?800|}}
 +
 +In the second step the image of the LXC container in this case Debian.
 +
 +{{:pictures:lxc_install.png?800|}}
 +
 +The easiest way to do this is to install the whole thing over the Internet. However, the router requires a mobile connection to the Internet.
 +
 +From a Jenkins server you get the current image for the container
 +
 +* Jenkins Server Page image-debian / [[https://jenkins.linuxcontainers.org/view/Images/job/image-debian/|Link]]
 +
 +The "''armhf''" tab is important here
 +
 +Here you can get a Debina image for ''buster, bullseye or bookworm''.
 +
 +{{:pictures:lxc_jenkins.png?800|}}
 +
 +If you click on the circle with the green rakes, you will be taken to the software. What else is important is that the circle and rakes must be green.
 +
 +{{:pictures:lxc_link.png?800|}}
 +
 +The image is the "''rootfs.tar.xz''" which is required. With a right click you can copy the link.
 +
 +It would be structured like this:
 +
 +''https://jenkins.linuxcontainers.org/view/Images/job/image-debian/architecture=armhf,release=bookworm,variant=default/lastSuccessfulBuild/artifact/rootfs.tar.xz''
 +
 +When the "Apply" button is pressed, Debian will be installed.
 +
 +===== Other LXC container images =====
 +
 +Two more LXC images are currently being offered on the Jenkins server. 
 +You can use an Alpine or Ubuntu image for the container.
 +
 +* Jenkins Server Page image-alpine / [[https://jenkins.linuxcontainers.org/view/Images/job/image-alpine/|Link]]
 +
 +* Jenkins Server Page image-ubuntu / [[https://jenkins.linuxcontainers.org/view/Images/job/image-ubuntu/|Link]]
 +
 +
 +===== - Test LXC installation and set up further =====
 +
 +Under the console you can first check whether the installation has been carried out.
 +
 +<konsole>
 +~ $ cd /mnt/storage0/lxc/guest0
 +/mnt/storage0/lxc/guest0 $ ls
 +bin    dev    home   media  opt    root   sbin   sys    usr
 +boot   etc    lib    mnt    proc   run    srv    tmp    var
 +/mnt/storage0/lxc/guest0 $ 
 +</konsole>
 +
 +This file must be available under this directory structur
 +
 +<konsole>
 +~ $ lxc-info guest0
 +Name:           guest0
 +State:          RUNNING
 +PID:            20493
 +CPU use:        1.49 seconds
 +BlkIO use:      20.00 KiB
 +Memory use:     7.22 MiB
 +KMem use:       1.20 MiB
 +~ $ 
 +
 +</konsole>
 +
 +The LXC container is set up and already started.
 +
 +Set up the LXC container further. A network interface is enabled here. 
 +
 +{{:pictures:lxc_netzwerk.png?800|}}
 +
 +The container has now also been assigned an IP address.
 +
 +<konsole>
 +~ $ lxc-info guest0
 +Name:           guest0
 +State:          RUNNING
 +PID:            2255
 +IP:             192.168.1.149
 +CPU use:        1.57 seconds
 +BlkIO use:      4.00 KiB
 +Memory use:     6.29 MiB
 +KMem use:       1.18 MiB
 +Link:           virt0
 + TX bytes:      2.28 KiB
 + RX bytes:      853 bytes
 + Total bytes:   3.11 KiB
 +~ $ 
 +</konsole>
 +
 +Always assign a fixed IP address for the LXC container via the DHCP server.
 +
 +{{:pictures:lxc_ip_adresse.png?800|}}
 +
 +Log in to the LXC container and test whether it can access the Internet.
 +
 +<konsole>
 +~ $ lxc-attach guest0
 +root@LXCNAME:~# ping heise.de
 +PING heise.de (193.99.144.80) 56(84) bytes of data.
 +64 bytes from redirector.heise.de (193.99.144.80): icmp_seq=1 ttl=244 time=42.4 ms
 +64 bytes from redirector.heise.de (193.99.144.80): icmp_seq=2 ttl=244 time=31.0 ms
 +64 bytes from redirector.heise.de (193.99.144.80): icmp_seq=3 ttl=244 time=27.1 ms
 +--- heise.de ping statistics ---
 +3 packets transmitted, 3 received, 0% packet loss, time 2005ms
 +rtt min/avg/max/mdev = 27.116/33.504/42.432/6.505 ms
 +root@LXCNAME:~# 
 +</konsole>
 +
 +The container is installed and set up. Now you can set up further tools on the container.
 +
 +----
 +
 +=== Use this link to return to the SNMP setup ===
 +
 +* Back to SNMP setup / [[app-notes:set-up-snmp]]