NetModule Router Wiki

User Tools

Site Tools

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]]

Page Tools

app-notes/set-up-lxc.1732288797.txt.gz · Last modified: 2024/11/22 15:19 by gray