Build and Deploy your own Document Management System with KnowledgeTree DMS on Ubuntu 10.04 LTS Server by krabah

VIEWS: 1,481 PAGES: 44

More Info
									Global Open Versity ICT Labs    Step-By-Step Install Guide KnowledgeTree DMS on Ubuntu 10.04 LTS Server v1.0



                    Global Technology Solutions Institute
            IT System Integration Hands-on Labs Training Manual

       Build & Deploy your own Document Management System with
             KnowledgeTree DMS on Ubuntu 10.04 LTS Server
                                          Kefa Rabah
                               GTS Institute, Vancouver Canada
                                          krabah@gtechsi.org
                                           www.gtechsi.org


Table of Contents                                                                                  Page No.

BUILD & DEPLOY YOUR OWN DOCUMENT MANAGEMENT SYSTEM WITH KNOWLEDGETREE
DMS ON UBUNTU 10.04 LTS SERVER                                                                             2

1.0 Introduction                                                                                           2

Part 1: Install & Configure Ubuntu 10.04 LTS Server                                                        3
  Step 1: Getting Started & Hardware Pre-requisites                                                        3
  Step 2: Update Ubuntu 10.04 Operating Systems                                                            3
  Step 3: Install Webmin                                                                                   3

Part 2: Installing Additional Infrastructure Packages                                                      6
  Step 1: Install OpenSSH Package                                                                          6

Part 3: Configure & Setup DNS Server                                                                       6

Part 4: Download and Install KnowledgeTree DMS                                                            10

Part 2: Adding Users and Groups                                                                           27
  Step 1: Adding New Users                                                                                27
  Step 2: Adding New Groups                                                                               32

Part 5: Uploading and Managing Documents                                                                  36

Part 6: Need More Training on Linux:                                                                      42
  Ubuntu Server Administration Training                                                                   42

Part 7: Hands-on Labs Assignments                                                                         42

Linux Administration Training                                                                             42




A GOV Open Access Technical Academic Publications
Enhancing education & empowering people worldwide through eLearning in the 21st Century
                                                                                                           1
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada

www.globalopenversity.org                               ICT105 – Ubuntu Server Administration Training
Global Open Versity ICT Labs    Step-By-Step Install Guide KnowledgeTree DMS on Ubuntu 10.04 LTS Server v1.0



                   Global Technology Solutions Institute
           IT Systems Integration Hands-on Labs Training Manual

       Build & Deploy your own Document Management System with
             KnowledgeTree DMS on Ubuntu 10.04 LTS Server
By Kefa Rabah, krabah@gtechsi.org                         Dec 8, 2010                        GTS Institute


1.0 Introduction
In this Hands-on Labs session, we’re going to learn how to install and configure the Linux Ubuntu 10.04
LTS (Lucid Lynx) 64-bit server option which we then use to install KnowledgeTree DMS CE. Canonical
has high hopes that Ubuntu 10.04, Lucid Lynx, will easily become the platform of choice for anybody who
intends to build and deploy large-scale infrastructure, whether you're trying to build the next Facebook, or
the next Google, or the next eBay. Ubuntu 10.04 LTS Server Edition: Lean, fast and powerful – Ubuntu
Server delivers services reliably, predictably and economically - and easily integrates with your existing
infrastructure. It has almost 100 open-source and proprietary application providers certifying their
programs on Ubuntu Server Edition. Ubuntu 10.04 includes Alfresco, Ingres, IBM, VMware, Yahoo and
Zimbra. It also includes improved installation and management tools for Ubuntu Enterprise Cloud (UEC)
and Amazon EC2.

KnowledgeTree is PHP-based, open source document management software that is easy to install and
use across a broad range of organizations. The features included in the community edition – including
workflow, version control and audit trails – help manage the document lifecycle, promote collaboration,
reduce paper and ensure compliance. KnowledgeTree Community Edition is licensed under the GNU GPL
version 3.



Solution
In this Hands-on Lab session, you’ll learn how to setup virtual network on VMware (you may also use any
other virtual machines like MS VirtualPC, Linux Xen, or VirtualBox from Sun). In this lab session, we’ll
concentrate on installing KnowledgeTree DMS on a clean install Linux Ubuntu 10.04 LTS 64-bit Server.
You will learn how to install and configure Webmin to help with configuring DNS server. I’ll also show you
how to setup static IP address which is required for deploying a DNS server. Finally, we’ll go through a
step-by-step process to install KnowledgeTree CE DMS. You’ll also have opportunity to do some
assignment at the end of the lab session. Upon completion of the hands-on lab you’ll have gained a
competency level and a capability to be able to plan design implement and deploy a website solution
using KnowledgeTree DMS.

Assumptions
It’s assumed that you have a good knowledge of Linux Ubuntu OS. If not then you can check this article
which discuses how to install Ubuntu 10.04 LTS 64-bit server:


    1. Step-By-Step Install Guide Ubuntu 10.04 LTS (Lucid Lynx) Server


                                                                                                             2
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada

www.globalopenversity.org                               ICT105 – Ubuntu Server Administration Training
Global Open Versity ICT Labs    Step-By-Step Install Guide KnowledgeTree DMS on Ubuntu 10.04 LTS Server v1.0




Part 1: Install & Configure Ubuntu 10.04 LTS Server

Step 1: Getting Started & Hardware Pre-requisites
Ubuntu runs on inexpensive, commodity hardware. To support a small practice like OSCAR EMR, web-
server or ISP hosing using IPConfig etc., we recommend a minimum configuration of 200Gb Disk, 2Gb
RAM, and a 2GHz Intel Dual Core CPU. For maximum subsystem compatibility, we suggest that you
install the 32bit version of Ubuntu. If you are purchasing a computer to run Webserver, one option is to
order the machine with Ubuntu pre-installed.

In this Hands-on Labs, it’s assumed that your target computer is connected to the internet. After installing
the operating system, log into your machine and ensure you perform software updates to bring your
systems up-to-date.


Step 2: Update Ubuntu 10.04 Operating Systems
It is useful to update your system with the latest components and system patches. The first command
below asks Ubuntu to update its database of available packages, and the second command installs the
latest packages based on your current configuration. We run the upgrade command twice to ensure that
any packages that may have post-upgrade dependencies also have an opportunity to be upgraded.

1. From the command line, enter the following commands, one at a time.

    $ sudo apt-get update
    $ sudo apt-get -u upgrade

    Note 1: The sudo command is used to run privileged operations on the Ubuntu platform. The first
    time you run the command, it will ask for your password. Subsequently, it will not ask for your
    password again for a short period of time (typically 15 minutes).

    Note 2: apt-get is the program Ubuntu uses for managing the system’s packages. When used to
    manipulate the core packages of the operating system, it needs to be run in conjunction with the sudo
    command.

2. We’re done with this section

3. You’re now ready to begin any other application installation as desired!


Step 3: Install Webmin
Webmin is a web-based interface for system administration for UNIX. Using any modern web browser,
you can setup user accounts, Apache, DNS, file sharing and much more. Webmin removes the need to
manually edit Unix configuration files like /etc/passwd, and lets you manage a system from the console
or remotely.Currently There is no Webmin package in the Ubuntu repositories. This tutorial will
explain how to install Webmin in Ubuntu Intrepid Ibex
                                                                                                           3
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada

www.globalopenversity.org                               ICT105 – Ubuntu Server Administration Training
Global Open Versity ICT Labs    Step-By-Step Install Guide KnowledgeTree DMS on Ubuntu 10.04 LTS Server v1.0




You can install Webmin for your server web interface to configure Apache2, MySQL, FTP, DNS servers
and many more. Now we will see how to install Webmin on Ubuntu 10.04 LTS.

Preparing your system
1. First you need to install the following packages

    sudo aptitude install perl libnet-ssleay-perl openssl libauthen-pam-perl
    libpam-runtime libio-pty-perl libmd5-perl apt-show-versions

2. Next, get "libmd5-perl" (this is deprecated and not in 10.04 repositories – more on that can be
   read here)

    wget http://ftp.debian.org/pool/main/libm/libmd5-perl/libmd5-perl_2.03-1_all.deb


    then install

    sudo dpkg -i libmd5-perl_2.03-1_all.deb

3. Now download the latest Webmin using the following command or from here

    sudo wget http://garr.dl.sourceforge.net/sourceforge/webadmin/webmin_1.441_all.deb


4. Now we have webmin_1.441_all.deb package install this package using the following command

    sudo dpkg -i webmin_1.441_all.deb

5. This will complete the installation.

    Note: Ubuntu in particular don’t allow logins by the root user by default. However, the user created at
    system installation time can use sudo to switch to root. Webmin will allow any user who has this sudo
    capability to login with full root privileges.

6. Now you need to open your web browser and enter the following

    https://your-server-ip:10000/         or       https://your-server-name:10000/

    Note: Accept the security warnings and alerts. Now you should see similar to the following screen,
    see Fig. 1. Enter your credentials used earlier when you installed the system and then click login.




                                                                                                           4
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada

www.globalopenversity.org                               ICT105 – Ubuntu Server Administration Training
Global Open Versity ICT Labs    Step-By-Step Install Guide KnowledgeTree DMS on Ubuntu 10.04 LTS Server v1.0




                                                                       Fig. 1


7. After login if you want to configure Apache2, DNS server etc. you need to click on Servers on your
   left-hand side you should see many servers that are ready to configure, as shown in Fig. 2.




    Fig. 2: Webmin admin page


8. Click Logout link to exit Webmin

9. We’re done with this section


                                                                                                           5
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada

www.globalopenversity.org                               ICT105 – Ubuntu Server Administration Training
Global Open Versity ICT Labs    Step-By-Step Install Guide KnowledgeTree DMS on Ubuntu 10.04 LTS Server v1.0




Part 2: Installing Additional Infrastructure Packages
These instructions are written for an audience comfortable with invoking instructions from the command
line and GUI option. If you are capable of installing the user friendly Ubuntu GNU/Linux operating system
or any other Linux distros, then you should be able to follow along with ease.


Step 1: Install OpenSSH Package
In order to support secure remote connections to your server, you will need to install the OpenSSH
package. This package will come in handy in the future to support administrative tasks on the system. By
default this package is already installed in the Ubuntu server option.

1. To install OpenSSH, issue the following command:

    $ sudo apt-get install openssh-server -y

2. To log into a remote computer that is running OpenSSH, you use the ssh username@hostname
   command, replacing username with a valid user name on the computer you are trying to log into, and
   replacing hostname with either the fully qualified host name (e.g. example.com) of your server, or
   it’s IP address (e.g. 192.168.83.40).



Part 3: Configure & Setup DNS Server
In this section it’s assumed that you know how to install and configure a DNS Server on a Linux machine,
if not, then check out our excellent Hands-On Labs training manual, entitled “Using Webmin and Bind9 to
Setup DNS Server on Linux” to get you started. Here we’re going to use Webmin and Bind9 to deploy a
DNS Server.

1. Before setting up DNS server, do ensure that you configure your network interface to static IP
   address, in case IP address is set to: 192.168.83.40.

2. Next, Edit "/etc/hosts" file to reflect the correct hostname, as shown in Fig. 4.




                                                                                                           6
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada

www.globalopenversity.org                               ICT105 – Ubuntu Server Administration Training
Global Open Versity ICT Labs    Step-By-Step Install Guide KnowledgeTree DMS on Ubuntu 10.04 LTS Server v1.0




                                                                                               Fig. 4


3. Edit "/etc/resolv.conf" file to reflect the correct namesearch, domain and search, as shown
   in Fig. 5.




                                                                  Fig. 5


4. Now follow the article’s hands-on lab manual to setup and configure your DNS server.

5. You can also start/stop/restart your DNS server via command-line as follows:

    sudo /etc/init.d/bind9           start/stop/restart

6. Next. fire-up your browser and point it to Webmin admin page: http://localhost:10000. Next click on
   Servers link on the left-hand pane and then click BIND DNS Server. On the right pane, scroll down to
   the Existing DNS Zones heading, as shown in Fig. 6.




                                                                                                           7
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada

www.globalopenversity.org                               ICT105 – Ubuntu Server Administration Training
Global Open Versity ICT Labs    Step-By-Step Install Guide KnowledgeTree DMS on Ubuntu 10.04 LTS Server v1.0




                                                                                        Fig. 6



7. Next, configure the DNS server, and when done, you should have a modified Existing DNS Zones
   with two additional icons, as shown in Fig. 7.




                                                                                      Fig. 7



8. Now open a new terminal window and test that your DNS server is configured correctly using "dig"
   and "nslookup" commands, as shown in Fig. 8 and 9 respectively.




                                                                                                           8
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada

www.globalopenversity.org                               ICT105 – Ubuntu Server Administration Training
Global Open Versity ICT Labs    Step-By-Step Install Guide KnowledgeTree DMS on Ubuntu 10.04 LTS Server v1.0




                                                                                                         Fig. 8


9. And similarly for "nslookup", as shown in Fig. 9.




                                                                                        Fig. 9


10. We’re done with this section


                                                                                                                  9
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada

www.globalopenversity.org                               ICT105 – Ubuntu Server Administration Training
Global Open Versity ICT Labs    Step-By-Step Install Guide KnowledgeTree DMS on Ubuntu 10.04 LTS Server v1.0




Part 4: Download and Install KnowledgeTree DMS
You may download & install the latest KnowledgeTree version as usual, by performing the following
procedure:

1. Download latest stable version as follows:

    cd /tmp
    sudo wget http://internap.dl.sourceforge.net/sourceforge/kt-dms/ktdms-oss-3.4.6-linux-installer.bin

2. Before the installation can begin, you need to change the permissions on the installer to allow it to run,
   as follows:

    sudo chmod +x ktdms-oss-3.6.1-linux-installer.bin

3. With that done, it is time to begin installing KnowledgeTree. To do this, run:

    sudo ./ktdms-oss-3.4.6-linux-installer.bin

4. You should now be present with the Welcome to the KnowledgeTree CE Setup Wizard, as shown in
   Fig. 10. Click Forward to continue.




                                                                                     Fig. 10
                                                                                                          10
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada

www.globalopenversity.org                               ICT105 – Ubuntu Server Administration Training
Global Open Versity ICT Labs    Step-By-Step Install Guide KnowledgeTree DMS on Ubuntu 10.04 LTS Server v1.0




1. From Fig. 11, License Agreement screen, read and accept the license and then click Forward to
   continue.




                                                                                     Fig. 11


2. From Fig. 12, Installation directory screen, accept the default selection, or change as desired and
   then click Forward to continue.




                                                                                                         11
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada

www.globalopenversity.org                               ICT105 – Ubuntu Server Administration Training
Global Open Versity ICT Labs    Step-By-Step Install Guide KnowledgeTree DMS on Ubuntu 10.04 LTS Server v1.0




                                                                                       Fig. 12


3. From Fig. 13, Web Server Port screen, accept the default selection, and then click Forward to
   continue. Change to port 8080 if the default port 80 is already used!




                                                                                                         12
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada

www.globalopenversity.org                               ICT105 – Ubuntu Server Administration Training
Global Open Versity ICT Labs    Step-By-Step Install Guide KnowledgeTree DMS on Ubuntu 10.04 LTS Server v1.0




                                                                                          Fig. 13


4. From Fig. 14, Enabling SSL support screen, accept the default selection or change as desired, and
   then click Forward to continue.




                                                                                                         13
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada

www.globalopenversity.org                               ICT105 – Ubuntu Server Administration Training
Global Open Versity ICT Labs    Step-By-Step Install Guide KnowledgeTree DMS on Ubuntu 10.04 LTS Server v1.0




                                                                                          Fig. 14



5. From Fig. 15, Generate an SSL Certificated screen, accept the default selection or change as
   desired, and then click Forward to continue.




                                                                                                         14
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada

www.globalopenversity.org                               ICT105 – Ubuntu Server Administration Training
Global Open Versity ICT Labs    Step-By-Step Install Guide KnowledgeTree DMS on Ubuntu 10.04 LTS Server v1.0




                                                                                          Fig. 15


6. From Fig. 16, MySQL Information screen, accept the default selection or change as desired, and
   then click Forward to continue.




                                           
								
To top