Lead Image © Orlando Rosu, 123RF.com

Lead Image © Orlando Rosu, 123RF.com

A TurnKey Linux software evaluation platform

One Good Turn

Article from ADMIN 26/2015
TurnKey Linux comes with more than 100 of the most important free enterprise solutions to create a test environment for evaluating new open source system or business software on a local system, on a virtual machine, or in the cloud.

Administrators are happy in everyday life if they can finish their work with relative ease. Then comes an order from the powers that be to find time on the side to check whether some new application offers the desired functionality and whether it can be integrated seamlessly into the existing architecture.

What decision makers without an appropriate technical background often do not understand is that it is not possible to carry out a careful evaluation "on the side." Setting up such an environment is often associated with considerable effort. You can minimize this effort by using TurnKey Linux.

Rapid development in the IT sector makes it more and more difficult for experts to stay up to date. Evaluating new system versions or business software proves to be particularly difficult and time consuming.

With TurnKey Linux, you can evaluate more than 100 of the most important free enterprise applications on a local test system and operate the environment on a virtual machine or in the cloud. According to the developers, only open source tools are provided to ensure no license problems or restrictions.

TurnKey Linux (TKL) is based on Debian 7.2 and thus provides business applications and security updates for more than 37,500 packages. It is a virtual appliance platform with pre-installed, pre-configured, and immediately deployable applications and software solutions that are compiled with the Linux operating system in a virtual machine. An overview of the pre-installed applications on the homepage of the project website [1] can be limited to content management, web development, issue tracking, and messaging.

TurnKey Linux is managed with the Webmin web-based management interface [2], which provides the essential administrative tools (Figure 1). Webmin also provides backup software that allows you to back up encrypted copies of data, databases, and configuration files, so you can use them elsewhere.

Figure 1: You can manage the TKL system and perform all administrative tasks through Webmin.

The Linux distribution is also very lightweight. The basic system starts at about 150MB and only includes the most important components for operating the environment.

Starting Out with TurnKey Linux

TurnKey Linux version 13.0 has been available since August 2014. All TKL appliances have been based on Debian since version 12.0; whereas previous versions were based on Ubuntu. The predefined applications are, except for a few exceptions, based on the Debian repositories. This means the applications install easily and perform solidly.

Various download packages are available via the project website, and you can use these to run TurnKey Linux on a standalone system or as a VM under a common virtualization solution, such as VirtualBox, KVM, and so on. Installing the various TKL distributions should not pose any major challenges.

After installation, you have various ways to administer the system, to access the TKL appliances, or to install new applications. The easiest way is to access the TKL system using a standard browser from any computer by entering https://<IP-Address>:12320 ; the Webmin interface is at https://<IP-Address>:12321 . In addition to the admin interface, a Java-based file browser is available for editing, uploading, and downloading files.

If you have set up an appliance with MySQL or PostgreSQL support, web-based access to these database systems is also possible at https://<IP-Address>:12322 . To access the TKL system from a Linux or Mac OS X system, you can set up an SSH connection in the terminal with the following command:

ssh root@<IP-Address>

On Windows, you can use PuTTy. Access via SFTP is also possible from a Unix-based operating system with:

sftp root@<IP-Address>

Alternatively, a graphical client such as FileZilla is available for all relevant platforms. TurnKey Linux automatically installs a Samba server and can thus be integrated easily into an existing Windows network.

System Installation

If you have decided to use a virtual appliance, download the appropriate package from the project page [3]. The selection menu lets you switch to different application categories. In addition to the ISO and VM images, you will find packages for other supported platforms.

For example, you can use the ISO image to install a new fully functional Linux system with a desired software set. If you want to use an image under VirtualBox or other virtualization environment, you need to consider a few peculiarities (see the "Using a Virtual Environment" box).

Using a Virtual Environment

The use of a virtual environment like VirtualBox or VMware is one of the easiest ways to set up a TurnKey system. Assuming you already have the appropriate platform, the next step is to install one of the TurnKey packages. The TKL team provides you with two versions that interact well with your chosen environment: a VM-optimized or a generic ISO image. VM-optimized types generally come in two variants:

  • Standard: The ZIP archive containing a ready-to-run VMDK image with a kernel optimized for the VM version.
  • OVF version: The ZIP archive containing the image converted into OVF format, which in particular is supposed to work more reliably with high-end VMware products.

Alternatively, you can use a generic ISO image that installs on any computer as a full Linux system or as a VM.

Two adjustments are required to the VM environment for optimal performance. If you use VirtualBox, open the VM settings and enable the advanced option PAE/NX under Settings | System | Processor . This allows the image to address more than 4GB of RAM. The only problem is that NX does not support older hardware. In this case, setting up a complete system using an ISO image instead of a VM is more appropriate.

You should also enable the bridge mode for your VM so that computers from the local network also can access the TurnKey virtual appliance. To this end, in the Network tab of the Settings dialog, set the Attached to item to Bridged Adapter (Figure 2). Because these changes involve modifying the VM environment, they are available immediately when configured.

Figure 2: When using a VM environment such as VirtualBox, the correct network settings for network-wide access to the virtual appliance are essential.

Regardless of the image you ultimately use, the TKL installer, which is based on the Debian installer offers a Guided or Manual installation. To simplify matters, you should choose the guided method, accept the suggested disk partitioning, and confirm further actions such as the system installation and restart. When a success message is sent informing you that the system setup is complete, the appliance installation is complete as well. With the TLK Configuration Console, you can remove the URLs that access the Web interface, Webmin, SSH, and possibly phpMyAdmin access. To access the advanced TKL settings, click Advanced Menu .

To access Webmin, SSH, MySQL, and phpMyAdmin, use the username root without a password. Of course, you should change your username and password later. The access codes for the various applications are different. The username is usually admin or root , and you usually choose the password while installing the appliance. You will find the corresponding information on the application's summary page on the TurnKey project site. For example, if you want to evaluate the NoSQL database system CouchDB, the user name for Webmin and SSH is root and the CouchDB user name is admin . You determine the password when you start it the first time.

Once you have set up a basic TurnKey system with the desired test environment, you can now turn to customizing the environment.

Advanced Appliance Settings

Clicking Advanced Menu in the Configuration Console accesses the advanced TKL settings. In particular, this allows you to customize the network configuration. To do so, choose the Networking console entry, where you can choose whether you want to assign a dynamic or a static IP address to the Linux system. TurnKey Linux uses a dynamic address by default. To assign a static IP address, select StaticIP (Figure 3) and define the IP address, network mask, gateway, and name server.

Figure 3: A first virtual appliance based on TurnKey is installed and available via the web interface.

If you made any changes to the network configuration, reboot the environment via the console with Reboot in the Advanced Menu. The Configuration Console also allows you to Quit or Shutdown the system. If you have closed the console and want to access it again, run the command:


Because The TurnKey Linux environment is web-based, so you need to be familiar with the paths to the web-specific configuration files and executables for your experiments (Table 1).

Table 1

Paths to Important Files

File Path
Configuration Files
apache2.conf /etc/apache2/apache2.conf
apc.ini /etc/php5/apache2/conf.d/20-apc.ini
group /etc/group
memcached.conf /etc/memcached.conf
php.ini (Apache Module) /etc/php5/apache/php.ini
php.ini (CLI) /etc/php5/cli/php.ini
Executable Files
Apache /etc/init.d/apache2, /usr/sbin/apache2
Memcached /etc/init.d/memcached
MySQL /etc/init.d/mysql, /usr/sbin/mysqld
MySQL /usr/bin/mysql
PHP CLI /usr/bin/php, /etc/alternatives/php
PHP 5 CLI /usr/bin/php5
Apache logfiles /var/log/apache2/error.log

Buy this article as PDF

Express-Checkout as PDF
Price $2.95
(incl. VAT)

Buy ADMIN Magazine

Get it on Google Play

US / Canada

Get it on Google Play

UK / Australia

Related content

comments powered by Disqus
Subscribe to our ADMIN Newsletters
Subscribe to our Linux Newsletters
Find Linux and Open Source Jobs

Support Our Work

ADMIN content is made possible with support from readers like you. Please consider contributing when you've found an article to be beneficial.

Learn More”>


		<div class=