TKL LXDE Client Workstation Read Me

TKL Core / LXDE Client Workstation

This is patch was based off the previous work and comments of many different people in the TKL community:
http://www.turnkeylinux.org/forum/general/20100813/tklclient-core-development-ideas-and-feedback-please
http://www.turnkeylinux.org/forum/general/20101006/tklpatch-tklclient-core
http://wiki.turnkeylinux.org/Whiteboard/TKL_Client

To start off using this version of the TKL/LXDE Client workstation, you may want to do some of the following:

Set the timezone
Use Webmin for System Administration
Reset Your Password
View and set network settings
Set a Custom TKL Desktop Graphic
Setup and configure TKLBAM
Install the VirtualBox Virtual Machine Manager
Install Other Apps
Install Other Apps with Synaptic
See Other Documentation on the development of this patch

Set the timezone for your computer and sync it with a time server

From the menu, use either: Preferences > Time and Date
or: TKL_Workstation > TKL_Admin > System Configuration

Return to start

Webmin for System Administration

With the default web browser, you can use Webmin for system administration.
use: TKL_Workstation > TKL_Admin > Local Webmin Config
Return to start

Reset Password

Set a new password for your account. The first time through, you're probably using a default password.
From the menu, use either: Preferences > Users and Groups
or: TKL_Workstation > TKL_Admin > Local Webmin Config
or: TKL_Workstation > TKL_Admin > System Configuration
Return to start

View and set network settings

To view and set network settings for this workstation,
From the menu, you can use: TKL_Workstation > TKL_Admin > ConfConsole
or: TKL_Workstation > TKL_Admin > Local Webmin Config
Return to start

Custom Desktop

You can customize your Desktop Wallpaper and taskbar "start" icon. There are pre-loaded TKL graphics files that will come up when you browse.
Wallpaper = Right click the desktop > Desktop Preferences, browse for the wallpaper you'd like to use.
Icon = Right click the taskbar start icon > Menu Settings, browse for the icon you'd like to use

These were created by Jomy Muttathil in this post: http://www.turnkeylinux.org/forum/general/20101008/tklclient-core-appearance
Return to start

TKLBAM Administration

You can access Turnkey Linux's Backup and Migration tool - TKLBAM - through the Webmin Console.
use: TKL_Workstation > TKL_Admin > Local TKLBAM Webmin Config

You need to enter your TKL HUB API key here in order to get the service working. You can access or setup your HUB account here:
https://hub.turnkeylinux.org/
The TKLBAM tool has many capabilities. As a basic tool, it has the ability to backup your workstation for you.
Return to start

VirtualBox Virtual Machine Manager

You may want to install and use the Virtual Box application to run and manage virtual machines?
Virtual Box will let you run the virtual appliances that you can download from the Turnkey Linux website.
From the menu, use: TKL_Workstation > TKL_Install > Application Installer

Virtual Box can run both .vmdk and .ovf versions of the appliances.
See this documentation on how to run the virtual machines:
http://www.turnkeylinux.org/docs/installation-appliances-virtualbox

Return to start

Install Other Apps

There are many other apps that you can download and install. A few install scripts are pre-installed on this workstation.
From the menu, look here: TKL_Workstation > TKL_Install > Application Installer

Return to start

Install Apps with Synaptic

A more standard way to install apps is through the Synaptic package manager.
It is a graphical tool that is similar in function to Add/Remove Programs in MS Windows.
From the menu, use: Preferences > Synaptic Package Manager

Return to start

Other Documentation on the development of this patch

Menu Items locations
Screen Savers and Screen Locking
lxterminal not working correctly
GKSU added to system config utilities
Removing Packages that you don't want
Installing a Graphical Login Manager
TKLBAM Settings
TKLBAM ID Reset
Some of the beter LXDE reference links that I found
Ideas for LXDE usage and applications

TKL Workstation Menu Items

The Items in the TKL_Workstation menu (Script files and the Desktop shortcuts that point to them) are available in the /usr/local/bin and the /usr/local/share/applications folders.
Return to Other Documentation

Screen Saver and Screen Lock

There are a few items that didn't come auto-configured with the base install of lxde. Screen lock and screen savers were two that I wanted to have. I've added in screen savers via the xscreensavers apt package and that auto-enables screen savers and the taskbar screen lock icon.
Return to Other Documentation

lxterminal not working for normal user

Every install of LXDE that I've done has had a broken "lxterminal" link for user's other than root.
The error looks something like "X: user not authorized to run the X server, aborting...." when you launch a normal terminal window.
I googled for a fix and it appears to be a common bug with LXDE
You can Ctrl+C to cancel the error and the terminal will work after, FYI
If Anyone knows of a fix for this, please let me know

Return to Other Documentation

GKSU added to system config utilities

I edited many of the icons for the system tools menu and added a "gksu" call to the front of them. This forces the user to enter the root user password when launching the menu items. It is a bit more inconvenient to login everytime you use one of the tools, but it didn't make sense to me to launch the tools if the user account didn't have permission to change anything. With the gksu call, you can use the tool to actually make changes to the workstation.
Return to Other Documentation

Remove Packages

The root user can remove packages that they no longer wish to use at any time through a command line similar to:
$ apt-get purge openssh-server
or through the synaptic GUI package manager (which is similar to the Windows "Add/Remove Programs" control panel app).
I've also included a system administration choice that can remove the "Server-Like" apps that come pre-configured with TKL Core.
It can be found at: TKL_Workstation > TKL_Admin > System Configuration
Return to Other Documentation

Graphical Login Package

For system boot, I left the default confconsole display in place. It's possible to install a graphical login package (like gdm, kdm, xdm, etc.) if you want.
This will give you a more "Workstation-style" graphical user/pass login prompt at boot.
There is an install choice for the "Slim" graphical login package: TKL_Workstation > TKL_Install > Application Installer
If you do install a login manager, you'll probably want to disable confconsole at boot and remove the "startx" call in the user .bashrc file. You can look at the install patch folder for Slim for more details. /usr/local/share/tkl/SlimInstall/conf
Return to Other Documentation

TKLBAM Settings

There are a few config files and changes in place to take into account the way that TKLBAM works.

A few of the things that have been addressed are restore settings for apps with custom repos and public encryption keys, like Google Chrome and Virtual Box.
Also, there are settings to exclude backing up certain directories, such as the Chrome executables.

Here are a couple of good links on this topic:
http://www.turnkeylinux.org/blog/tklbam-hooks
http://www.turnkeylinux.org/forum/support/20110101/tklbam-seems-not-work
Return to Other Documentation

TKLBAM ID reset script

There is a TKLBAM ID reset script in the System Administation menu
TKL_Workstation > TKL_Admin > System Configuration
There may be times that you wish to dis-associate the workstation from it's current backup tree. You can use this script to automate the process of deleting the current ID and creating another new one to backup to.
This method was based on this post: http://www.turnkeylinux.org/forum/support/20111101/migrate-turnkey-ami-another-aws-account
Return to Other Documentation

Some of the beter LXDE reference links that I found

http://lxlinux.com/
http://wiki.lxde.org/en/LXPanel
http://pclosmag.com/html/Issues/201010/page07.html
http://lkubaski.wordpress.com/2012/06/29/adding-lxde-start-menu-and-desktop-shortcuts/
http://forum.lxde.org/viewtopic.php?f=8&t=31300

Return to Other Documentation