Difference between revisions of "Diskless LTSP Frontend"

From MythTV Official Wiki
Jump to: navigation, search
(Configure DHCP)
Line 1: Line 1:
This guide is based on Ubuntu 12.04
+
This guide is based on Ubuntu 12.04 and LTSP 5.3.x.  Please update it as needed with other Linux Distribution instructions.
  
There are two parts to this guide.  One part will have commands to install a 32-bit client, the other part will have commands to install a 64-bit client.
+
There are two main parts to this guide.  One part has commands to install a 32-bit client, the other part has commands to install a 64-bit client.  The final two parts are for troubleshooting and maintenance updates.
 +
 
 +
There are many steps involved.  This guide has been written this way so you can slowly work through the process of getting your client installed.  Hopefully it will make it easier for you to customize your own LTSP client.
  
 
When you see this
 
When you see this
Line 111: Line 113:
 
   root@ltsp-server:~# useradd -m mythltsp -G sudo mythtv
 
   root@ltsp-server:~# useradd -m mythltsp -G sudo mythtv
 
   root@ltsp-server:~# passwd mythltsp
 
   root@ltsp-server:~# passwd mythltsp
 +
 +
Update default mythtv configuration settings for your new user
 +
 
   root@ltsp-server:~# su - mythltsp
 
   root@ltsp-server:~# su - mythltsp
 
   $ mkdir .mythtv
 
   $ mkdir .mythtv
Line 117: Line 122:
 
   $ ln -s /etc/mythtv/config.xml config.xml
 
   $ ln -s /etc/mythtv/config.xml config.xml
 
   $ exit
 
   $ exit
 +
 +
=Start of 32 bit LTSP Client Instructions=
  
 
==Create the initial client image==
 
==Create the initial client image==
  
   root@ltsp-server:~# ltsp-build-client
+
   root@ltsp-server:~# ltsp-build-client --arch i386
 
 
=Start of 32 bit LTSP Client Instructions=
 
  
 
==Boot the LTSP client==
 
==Boot the LTSP client==
Line 132: Line 137:
 
   root@ltsp-server-chroot:/# exit
 
   root@ltsp-server-chroot:/# exit
  
==Create a new image==
+
===Create a new image===
  
 
   root@ltsp-server:~# ltsp-update-image --arch=i386
 
   root@ltsp-server:~# ltsp-update-image --arch=i386
  
==Boot the LTSP client==
+
===Reboot the LTSP client===
  
 
Client boots and can now login.  MythTV is not installed
 
Client boots and can now login.  MythTV is not installed
Line 152: Line 157:
 
   root@ltsp-server-chroot:/# exit
 
   root@ltsp-server-chroot:/# exit
  
==Create a new image==
+
===Create a new image===
  
 
   root@ltsp-server:~# ltsp-update-image --arch=i386
 
   root@ltsp-server:~# ltsp-update-image --arch=i386
  
==Boot the LTSP client==
+
===Reboot the LTSP client===
  
 
This time mythtv frontend will be available
 
This time mythtv frontend will be available
  
Now configure it
+
==Now configure the client==
  
 
   root@ltsp-server:~# ltsp-chroot
 
   root@ltsp-server:~# ltsp-chroot
Line 176: Line 181:
 
   root@ltsp-server-chroot:/# exit
 
   root@ltsp-server-chroot:/# exit
  
==Create a new image==
+
===Create a new image===
  
 
   root@ltsp-server:~# ltsp-update-image --arch=i386
 
   root@ltsp-server:~# ltsp-update-image --arch=i386
  
==Boot the LTSP client==
+
===Reboot the LTSP client===
  
 
This time, mythtv frontend should connect to the backend.
 
This time, mythtv frontend should connect to the backend.
Line 200: Line 205:
 
</pre>}}
 
</pre>}}
  
==Boot the LTSP client==
+
===Reboot the LTSP client===
  
This time, mythtv frontend should automatically login and connect to the backend.
+
This time, mythtv frontend should automatically login.
  
 
=End of 32 bit LTSP Client Intructions=
 
=End of 32 bit LTSP Client Intructions=
Line 223: Line 228:
 
   root@ltsp-server-chroot:/# exit
 
   root@ltsp-server-chroot:/# exit
  
==Create a new image==
+
===Create a new image===
  
 
   root@ltsp-server:~# ltsp-update-image --arch amd64
 
   root@ltsp-server:~# ltsp-update-image --arch amd64
  
==Boot the LTSP client==
+
===Reboot the LTSP client===
  
 
Client boots and can now login.  MythTV is not installed
 
Client boots and can now login.  MythTV is not installed
Line 243: Line 248:
 
   root@ltsp-server-chroot:/# exit
 
   root@ltsp-server-chroot:/# exit
  
==Create a new image==
+
===Create a new image===
  
 
   root@ltsp-server:~# ltsp-update-image --arch amd64
 
   root@ltsp-server:~# ltsp-update-image --arch amd64
  
==Boot the LTSP client==
+
===Reboot the LTSP client===
  
 
This time mythtv frontend will be available
 
This time mythtv frontend will be available
  
Now configure it
+
==Now configure LTSP Client==
 
 
  root@ltsp-server:~# ltsp-chroot
 
  
 
Update the settings for your backend, DBHostName and DBPassword will have to be changed.
 
Update the settings for your backend, DBHostName and DBPassword will have to be changed.
  
 +
  root@ltsp-server:~# ltsp-chroot
 
   root@ltsp-server-chroot:/# vi /etc/mythtv/mysql.txt
 
   root@ltsp-server-chroot:/# vi /etc/mythtv/mysql.txt
  
Line 267: Line 271:
 
   root@ltsp-server-chroot:/# exit
 
   root@ltsp-server-chroot:/# exit
  
==Create a new image==
+
===Create a new image===
  
 
   root@ltsp-server:~# ltsp-update-image --arch amd64
 
   root@ltsp-server:~# ltsp-update-image --arch amd64
  
==Boot the LTSP client==
+
===Reboot the LTSP client===
  
 
This time, mythtv frontend should connect to the backend.
 
This time, mythtv frontend should connect to the backend.
Line 291: Line 295:
 
</pre>}}
 
</pre>}}
  
==Boot the LTSP client==
+
==Reboot the LTSP client==
  
This time, mythtv frontend should automatically login and connect to the backend.
+
This time, mythtv frontend should automatically login.
  
 
==Optional: Install NVIDIA drivers==
 
==Optional: Install NVIDIA drivers==
Line 308: Line 312:
 
   root@ltsp-server-chroot:/# nvidia-xconfig
 
   root@ltsp-server-chroot:/# nvidia-xconfig
  
==Boot the LTSP client==
+
===Reboot the LTSP client===
  
 
This time, the LTSP client should be using the NVIDIA drivers.  If you can't see the edges of your screen, you have a condition called "overscan".
 
This time, the LTSP client should be using the NVIDIA drivers.  If you can't see the edges of your screen, you have a condition called "overscan".
Line 320: Line 324:
 
   root@ltsp-server-chroot:/# exit
 
   root@ltsp-server-chroot:/# exit
  
==Create a new image==
+
===Create a new image===
  
 
   root@ltsp-server:~# ltsp-update-image --arch amd64
 
   root@ltsp-server:~# ltsp-update-image --arch amd64
  
==Boot the LTSP client==
+
===Reboot the LTSP client===
  
 
You should now see the full menus on around the edges of your screen.
 
You should now see the full menus on around the edges of your screen.
Line 330: Line 334:
 
=End of 64 bit LTSP Client Instructions=
 
=End of 64 bit LTSP Client Instructions=
  
 +
=Make MythTV Frontend Automatically Start=
  
 +
  root@ltsp-server:~# su - mythltsp
 +
  $ cd .config
 +
  $ mkdir autostart
 +
  $ cd autostart
 +
  $ vi mythfrontend.desktop
  
 +
{{code_box|mythfrontend.desktop|<pre>
 +
[Desktop Entry]
 +
Type=Application
 +
Exec=/usr/bin/mythfrontend
 +
Hidden=false
 +
NoDisplay=false
 +
Name=mythTV frontend
 +
Comment=Record, playback and watch TV.
 +
</pre>}}
  
 
= Troubleshooting =
 
= Troubleshooting =
Line 343: Line 362:
 
Run these commands to implement a fix
 
Run these commands to implement a fix
  
 +
  root@ltsp-server:~# ltsp-chroot
 
   root@ltsp-server-chroot:/# apt-get install compizconfig-settings-manager
 
   root@ltsp-server-chroot:/# apt-get install compizconfig-settings-manager
 
   root@ltsp-server-chroot:/# exit
 
   root@ltsp-server-chroot:/# exit
  
==Create a new image==
+
===Create a new image===
  
 
   root@ltsp-server:~# ltsp-update-image --arch=i386
 
   root@ltsp-server:~# ltsp-update-image --arch=i386
Line 352: Line 372:
 
   root@ltsp-server:~# ltsp-update-image --arch amd64
 
   root@ltsp-server:~# ltsp-update-image --arch amd64
  
==Boot the LTSP client==
+
===Reboot the LTSP client===
  
 
After the LTSP client has booted, login using the mythltsp user
 
After the LTSP client has booted, login using the mythltsp user
Line 362: Line 382:
 
#Check "Legacy Full Screen" support.
 
#Check "Legacy Full Screen" support.
  
==Create a new image==
+
===Create a new image===
  
 
   root@ltsp-server:~# ltsp-update-image
 
   root@ltsp-server:~# ltsp-update-image
  
==Boot the LTSP client==
+
===Reboot the LTSP client===
  
 
Mythtv frontend should now use the full screen.
 
Mythtv frontend should now use the full screen.

Revision as of 01:51, 28 December 2013

This guide is based on Ubuntu 12.04 and LTSP 5.3.x. Please update it as needed with other Linux Distribution instructions.

There are two main parts to this guide. One part has commands to install a 32-bit client, the other part has commands to install a 64-bit client. The final two parts are for troubleshooting and maintenance updates.

There are many steps involved. This guide has been written this way so you can slowly work through the process of getting your client installed. Hopefully it will make it easier for you to customize your own LTSP client.

When you see this

 root@ltsp-server:~#

It means the commands should be executed on the LTSP server.

When you see this

 root@ltsp-server-chroot:/#

It means the commands should be executed on the LTSP server, but after you have run the chroot command ltsp-chroot. Chroot is type of isolated environment.

Contents

Assumptions

  1. Your mythtv server has an IP address of 192.168.1.100
  2. Your mythtv frontend is diskless, it will use a dhcp client address of 192.168.1.150
  3. You will create a new user called mythltsp
  4. Your mythtv server resolves DNS queries
  5. Your default router IP is 192.168.1.1
  6. Your mythtv server is not already serving DHCP
  7. You mythtv frontend has a mac address of 87:01:2a:ab:08:56


Install the LTSP Server Software

 root@ltsp-server:~# apt-get install ltsp-server-standalone

Configure DHCP

Installing the ltsp server software will create a dhcpd config file /etc/ltsp/dhcpd.conf

You already have dhcpd running, this new file will override it.

Dhcpd is used to provide the client frontend with an IP address.


Script.png /etc/ltsp/dhcpd.conf
authoritative;

# This will be the subnet your client will use.  Your server must have an interface serving this range.
subnet 192.168.1.0 netmask 255.255.255.0 {

    range 192.168.1.150 192.168.1.200;
    option domain-name "example.com";
    option domain-name-servers 192.168.1.100;
    option broadcast-address 192.168.1.255;
    option routers 192.168.1.1;
#    next-server 192.168.0.1;
#    get-lease-hostnames true;
    option subnet-mask 255.255.255.0;
    option root-path "/opt/ltsp/i386";

    if substring( option vendor-class-identifier, 0, 9 ) = "PXEClient" {
        filename "/ltsp/i386/pxelinux.0";
    } else {
        filename "/ltsp/i386/nbi.img";
    }

  host mythfront {

    # tftp client hardware address, mac address of your LTSP client
    hardware ethernet 87:01:2a:ab:08:56;

    # Dedicated IP address for your LTSP client
    fixed-address 192.168.1.150;

    # Uncomment the line below if your client is 32-bit
    # filename "/ltsp/i386/pxelinux.0";

    # Uncomment the line below if your client is 64-bit
    filename "/ltsp/amd64/pxelinux.0";

  }

}

Restart DHCP

 root@ltsp-server:~# service isc-dhcpd-server restart

Build client settings

Script.png /etc/ltsp/ltsp-build-client.conf

# ubuntu-desktop and edubuntu-desktop are tested.
# Ubuntu 12.04 LTS working perfectly with Unity and Unity 2D.
FAT_CLIENT_DESKTOPS="ubuntu-desktop"

# This uses the server apt cache to speed up downloading.
# This locks the servers dpkg, so you can't use apt on
# the server while building the chroot.
MOUNT_PACKAGE_DIR="/var/cache/apt/archives/"


Script.png /etc/ltsp/ltsp-update-image.conf
#configuration file for ltsp-update-image
# Do not compress the client image. Comment out the line below to enable again.
NO_COMP="-noF -noD -noI -no-exports"

Set up Thin Client user

This account is created on your LTSP server. The LTSP client will use it to login.

 root@ltsp-server:~# useradd -m mythltsp -G sudo mythtv
 root@ltsp-server:~# passwd mythltsp

Update default mythtv configuration settings for your new user

 root@ltsp-server:~# su - mythltsp
 $ mkdir .mythtv
 $ cd .mythtv
 $ ln -s /etc/mythtv/mysql.txt mysql.txt
 $ ln -s /etc/mythtv/config.xml config.xml
 $ exit

Start of 32 bit LTSP Client Instructions

Create the initial client image

 root@ltsp-server:~# ltsp-build-client --arch i386

Boot the LTSP client

Try to login, if you get an error that gnome failed to load

 root@ltsp-server:~# ltsp-chroot
 root@ltsp-server-chroot:/# apt-get install gnome
 root@ltsp-server-chroot:/# exit

Create a new image

 root@ltsp-server:~# ltsp-update-image --arch=i386

Reboot the LTSP client

Client boots and can now login. MythTV is not installed

Update repositories the client can use

 root@ltsp-server:~# cp /etc/apt/sources.list /opt/ltsp/i386/etc/apt/sources.list
 root@ltsp-server:~# cp /etc/apt/sources.list.d/* /opt/ltsp/i386/etc/apt/sources.list.d/

Install MythTV Frontend

 root@ltsp-server:~# ltsp-chroot
 root@ltsp-server-chroot:/# apt-get update
 root@ltsp-server-chroot:/# apt-get install mythtv-frontend
 root@ltsp-server-chroot:/# exit

Create a new image

 root@ltsp-server:~# ltsp-update-image --arch=i386

Reboot the LTSP client

This time mythtv frontend will be available

Now configure the client

 root@ltsp-server:~# ltsp-chroot

Update the settings for your backend, DBHostName and DBPassword will have to be changed.

 root@ltsp-server-chroot:/# vi /etc/mythtv/mysql.txt

This assumes you have a link from your local user home dir to the /etc/mythtv config dir

eg.

 /home/mythltsp/.mythtv/mysql.txt -> /etc/mythtv/mysql.txt
 root@ltsp-server-chroot:/# exit

Create a new image

 root@ltsp-server:~# ltsp-update-image --arch=i386

Reboot the LTSP client

This time, mythtv frontend should connect to the backend.

Enable auto login

 root@ltsp-server:~# vi /var/lib/tftpboot/ltsp/i386/lts.conf


Script.png /var/lib/tftpboot/ltsp/i386/lts.conf
[Default]
# Auto Login
LDM_AUTOLOGIN = True
LOCAL_APPS = True
LDM_SESSION = "lightdm-gtk-greeter"

[192.168.92.120]
LDM_USERNAME = mythltsp
LDM_PASSWORD = mythltsp

Reboot the LTSP client

This time, mythtv frontend should automatically login.

End of 32 bit LTSP Client Intructions

Start of 64 bit LTSP Client Instructions

Create the initial client image

 root@ltsp-server:~# ltsp-build-client --arch amd64

Boot the LTSP client

Try to login, if you get an error that gnome failed to load

 root@ltsp-server:~# ltsp-chroot
 root@ltsp-server-chroot:/# apt-get install gnome
 root@ltsp-server-chroot:/# exit

Create a new image

 root@ltsp-server:~# ltsp-update-image --arch amd64

Reboot the LTSP client

Client boots and can now login. MythTV is not installed

Update repositories the client can use

 root@ltsp-server:~# cp /etc/apt/sources.list /opt/ltsp/amd64/etc/apt/sources.list
 root@ltsp-server:~# cp /etc/apt/sources.list.d/* /opt/ltsp/amd64/etc/apt/sources.list.d/

Install MythTV Frontend

 root@ltsp-server:~# ltsp-chroot
 root@ltsp-server-chroot:/# apt-get update
 root@ltsp-server-chroot:/# apt-get install mythtv-frontend
 root@ltsp-server-chroot:/# exit

Create a new image

 root@ltsp-server:~# ltsp-update-image --arch amd64

Reboot the LTSP client

This time mythtv frontend will be available

Now configure LTSP Client

Update the settings for your backend, DBHostName and DBPassword will have to be changed.

 root@ltsp-server:~# ltsp-chroot
 root@ltsp-server-chroot:/# vi /etc/mythtv/mysql.txt

This assumes you have a link from your local user home dir to the /etc/mythtv config dir

eg.

 /home/mythltsp/.mythtv/mysql.txt -> /etc/mythtv/mysql.txt
 root@ltsp-server-chroot:/# exit

Create a new image

 root@ltsp-server:~# ltsp-update-image --arch amd64

Reboot the LTSP client

This time, mythtv frontend should connect to the backend.

Enable auto login

 root@ltsp-server:~# vi /var/lib/tftpboot/ltsp/amd64/lts.conf


Script.png /var/lib/tftpboot/ltsp/amd64/lts.conf
[Default]
# Auto Login
LDM_AUTOLOGIN = True
LOCAL_APPS = True
LDM_SESSION = "lightdm-gtk-greeter"

[192.168.92.120]
LDM_USERNAME = mythltsp
LDM_PASSWORD = mythltsp

Reboot the LTSP client

This time, mythtv frontend should automatically login.

Optional: Install NVIDIA drivers

Note: if your main LTSP server is 64 bit and your LTSP client is also 64 bit this step will work. If your LTSP client is 32 bit you will need to work out how to install the 32 bit version of the nvidia driver.

 root@ltsp-server:~# ltsp-chroot

You must mount proc or you will get errors when you install the nvidia drivers

 root@ltsp-server-chroot:/# mount -t proc proc /proc
 root@ltsp-server-chroot:/# apt-get install linux-headers-`uname -r`
 root@ltsp-server-chroot:/# apt-get install nvidia-current nvidia-settings
 root@ltsp-server-chroot:/# nvidia-xconfig

Reboot the LTSP client

This time, the LTSP client should be using the NVIDIA drivers. If you can't see the edges of your screen, you have a condition called "overscan".

Edit /etc/X11/Sxorg.conf

Add this to the bottom of the "Screen" section

   Option         "metamodes" "DFP-0: nvidia-auto-select +0+0,DFP-1: 1920x1080 { ViewPortIn=1920x1080, ViewPortOut=1820x1020+45+30 }"
 root@ltsp-server-chroot:/# exit

Create a new image

 root@ltsp-server:~# ltsp-update-image --arch amd64

Reboot the LTSP client

You should now see the full menus on around the edges of your screen.

End of 64 bit LTSP Client Instructions

Make MythTV Frontend Automatically Start

 root@ltsp-server:~# su - mythltsp
 $ cd .config
 $ mkdir autostart
 $ cd autostart
 $ vi mythfrontend.desktop


Script.png mythfrontend.desktop
[Desktop Entry]
Type=Application
Exec=/usr/bin/mythfrontend
Hidden=false
NoDisplay=false
Name=mythTV frontend
Comment=Record, playback and watch TV.

Troubleshooting

Make MythTV use the full screen when it launches

There is a known issue with mythtv launching and not using the full screen. A Compiz bug that was reported here:

 http://code.mythtv.org/trac/ticket/9589

Run these commands to implement a fix

 root@ltsp-server:~# ltsp-chroot
 root@ltsp-server-chroot:/# apt-get install compizconfig-settings-manager
 root@ltsp-server-chroot:/# exit

Create a new image

 root@ltsp-server:~# ltsp-update-image --arch=i386

or

 root@ltsp-server:~# ltsp-update-image --arch amd64

Reboot the LTSP client

After the LTSP client has booted, login using the mythltsp user

Run the ccsm tool.

  1. Under CompizConfig Settings Manager, go to "Utility"
  2. Go to "Work arounds"
  3. Check "Legacy Full Screen" support.

Create a new image

 root@ltsp-server:~# ltsp-update-image

Reboot the LTSP client

Mythtv frontend should now use the full screen.

Maintenance Updates

Kernel Updates

If you apply a kernel update to your LTSP server you need to run this command to update your client

 root@ltsp-server:~# ltsp-update-kernels

Create a new image

 root@ltsp-server:~# ltsp-update-image

MythTV Updates

 root@ltsp-server:~# ltsp-chroot
 root@ltsp-server-chroot:/# apt-get update
 root@ltsp-server-chroot:/# apt-get upgrade mythtv-frontend

Create a new image

 root@ltsp-server:~# ltsp-update-image

General OS Patch Updates

 root@ltsp-server:~# ltsp-chroot
 root@ltsp-server-chroot:/# apt-get update
 root@ltsp-server-chroot:/# apt-get upgrade

Create a new image

 root@ltsp-server:~# ltsp-update-image