Documente Academic
Documente Profesional
Documente Cultură
DesInventar Server 9
Version 9.2.11
December 2009.
DesInventar-Web Installation & Operations Guide
Table of Contents
Table of Contents............................................................................................2
Send Us Your Comments.................................................................................3
Installation Overview.......................................................................................4
Introducing DesInventar Server 7................................................................5
DesInventar Requirements...........................................................................6
Internet Connection requirements.............................................................6
Software requirements.............................................................................6
Manual Installation Requirements:.............................................................7
Database requirements.............................................................................7
Hardware requirements............................................................................8
Using the DesInventar Server Installer.........................................................9
Manual Installation of DesInventar..............................................................21
Installation of the Java2 platform software...............................................21
Installation of Tomcat.............................................................................23
Testing the Installation...........................................................................24
Deploying DesInventar Web Application...................................................24
Configuring Tomcat................................................................................26
Appendix A...................................................................................................32
WINDOWS Installation of the Java2 platform software..............................32
Installation of Tomcat.............................................................................36
This product may use or reference software from the following third parties:
Installation Overview
DesInventar-web is a 100% pure Java application running using a JSP (Java
Server Pages) powered interface. As such it requires a Java Virtual Machine
(JVM) and a JSP/Servlet container to run and support al its features, usually the
Apache Tomcat server.
Some other more sophisticated users may want to take advantage of advanced
Database management systems and/or other versions of Tomcat or other Java
Application Servers. Those users should follow the instructions in the Manual
Installation Section.
DesInventar Requirements
There are several requirements to run the System (in this document the word
System is used as a synonym of DesInventar):
Clients:
DesInventar makes intensive use of the connection to Internet. A dial-up
connection to the Internet is considered enough generally for Clients, but
depending on user requirements it can provide a slow service.
Servers:
The DesInventar Server must run in an environment with high Internet
connectivity. In case of an Intranet server, a normal LAN (10/100 baseT) will be
more than enough.
Please note that in many cases DesInventar will require a lot of bandwidth,
which can be an issue especially if DesInventar is to be run in the same
machine that serves another web sites. DesInventar will consume also
processor, memory and database resources.
Software requirements
Being a pure Java application, DesInventar can run in almost any software
platform. It has been tested and successfully run in the several Operating
While Clients of DIS7 can run in almost any version of Windows higher that
Win95, Servers should run at the minimum in one of the following:
Among others, the following Web Servers and Application Servers comply with
these requirements:
Database requirements
- Oracle 8i, Oracle 9i, Oracle 10g, Oracle 10express or Oracle 11.
- MS Access
- MS SQL Server 2000 or higher
- PostgreSQL 7.4 or higher
In theory DesInventar should run MySQL with no problems, but newer versions
hasnt been tested yet.
Hardware requirements
DesInventar requires:
Other JSP/Servlet containers may be used instead of Tomcat, and the application
itself has been built in such a way that its independent of the container, as a
standard Java Web Application.
The distribution CD contains downloads of both Java 2 (JDK 1.5) and Tomcat
(Tomcat 5.1) suitable for DesInventar under Windows environments.
However, if the end system requirements are different, DesInventar should run
with other versions of both the JDK and Tomcat.
This document assumes that an appropriate operating system has been set-up
and configured, as well as the database engine has been installed and its up and
running.
Please note that most configuration issues involve providing DesInventar with
the appropriate drivers and database access parameters. More info on this can
be found in the next few sections.
Start by downloading the Java 2 Standard Edition JDK (Java Development Kit)
from:
http://java.sun.com/j2se
To install the JDK just follow the instructions of the installer. We recommend
installing the JDK in a directory at the root level, with a short name (i.e /jdk1.3),
with no embedded spaces. This will greatly simplify the path and class path
names and will avoid problems caused by spaces in names.
Installation of Tomcat
http://apache.mirrored.ca/jakarta/tomcat-4/binaries
For Windows installations you can use the download of Tomcat 4.1.XX supplied
with the distribution CD.
Configuring and setting up Tomcat requires several steps: deploying the Tomcat
software itself, that must be done after installing the full Java 2 development kit
(JDK 1.3/4), defining the environment variables and modifying/editing several
configuration files.
The procedure to install Tomcat will vary from platform to platform. On Unix like
environments Tomcat is distributed as a gzipped tarball. The gunzip utility will be
needed to decompress and later untar the file. Please refer to the on-line
documentation for more information about this process.
This test can be performed from the localhost machine or from any other
machine using the network name of the computer instead of localhost.
Copying the files: The installation of the software is extremely simple, its just
copying the directory DesInventar in the distribution CD to a suitable place in
the hard disk.
The directory with default properties, /etc/DesInventar with all the files it
contains must be also copied. The folder /etc exists by default in Unix like
environments but it must be created in Windows. The structure
/etc/DesInventar must exist, no matter the OS.
attrib r c:\xxxxx\DesInventar\* /s
OR
attrib r c:\tomcat\webappss\DesInventar\* /s
also:
attrib r c:\etc\DesInventar\* /s
Where xxxxx is the folder where DesInventar was copied, typically under
tomcat/webapps.
Permissions: must be set so that the user running Tomcat and DesInventar
has access to all directories involved. This is especially critical in Unix like
systems :
/etc/DesInventar/*
/usr/local/tomcat/* (or wherever tomcat is installed)
/xxx/DesInventar/* (or wherever DesInventar is installed).
Another issue to consider with Unix-like systems is the permission to use ports
less that 1024. Only the root user can start processes that take these ports.
In addition to these variables the Unix environments usually need the shared
library paths that will allow software components to locate dynamic libraries.
The technique suggested with DesInventar is the later. Example Unix (Linux, to
be specific) scripts can be found in the /xxxxx/DesInventar/WEB-INF/classes
directories.
The administrator will have to customize the according to the settings of the
system and the database and/or indexing engine used.
Each vendor is responsible for supplying these driver files. Oracle supplies them
as zip files, which have to be unpacked and the converted to jar format using the
command jar, supplied with the Java installer.
Configuring Tomcat
There are several configuration files required to run Tomcat (all of them located
in the directory conf under the main Tomcat directory:
The most important parameter set is enclosed between <Context tags. The
name of the application (DesInventar) and the document root (the folder
where DesInventar files were copied into) are defined here.
Example:
NOTE: this example assumes DesInventar was installed in the webapps directory of Tomcat. For
installations on other folders, change the parameter docBase to the fully qualified path of the
installation, including the Drive in Windows systems.
The example context can be erased safely from the server.xml file under the
\tomcat\conf folder. It will have no effect on the document. Erase all lines
between <Context path=/examples . and the next </Context> tag.
For users installing version 4.1.18, a pre-defined server.xml file is supplied with
the distribution CD. This initial configuration file supplied by LA RED contains
tags enabling:
Note that in this example no drive (in the case of a Windows OS) has been
defined. This is possible if all components are installed on Drive C:, which is
recommended.
The main issue with Windows systems is that the NT Service that runs Tomcat
will run ALWAYS from drive C:, making it the default drive. Locating
DesInventar and/or Tomcat in other drives is always possible, but will have
consequences and possibly will involve maintaining redundant properties files
(folder /etc/properties in more than one drive), which is not recommended.
Note that the suggested port (8080) can be changed to port 80 if there are no
other web servers running on that same machine. That would allow the URLs of
the application to run without the :8080 suffix on the URL. Keep in mind that
Unix like OS requires root privileges to start an application that takes ports less
than 1024.
The initial value of these elements is defined during the installation, when a
window with these values is shown.
After all these modifications are done, Tomcat must be restarted to make them
take effect.
In a Windows platform use the Services Panel to restart the server (or stop it
and the start it again):
cd /usr/local/tomcat/bin
./shutdown.sh
./startup.sh
In order to test it, open an Internet Explorer in the web server machine. Type
http://localhost/DesInventar (or http://localhost:8081/DesInventar if you
didnt change the default port) in the address bar, and hit the enter key. If
everything was properly installed, the screen should look like:
NOTE: Is possible that the list of Regions is empty this first time, due to the
lack of database connectivity. See next sections for instructions on how to
configure and connect DesInventar to the database.
Appendix A
Start by downloading the Java 2 Standard Edition JDK (Java Development Kit)
from:
http://java.sun.com/j2se/1.3/download.html
Note there are two packages available: the JRE (Java Runtime Environment) and
the JDK itself. If youre planning to install only DesInventar (no interface, or
interface running on an existing JSP/Servlet container, you may download the
JRE.
If you want to install Tomcat in order to have the web application too, you must
download the full JDK, or use the copy of the JDK supplied in the distribution CD.
To install the JDK just follow the instructions of the installer. We recommend
installing the JDK in a directory at the root level, with a short name (i.e /jdk1.3),
with no embedded spaces.
The user will have to agree with the terms of license from Sun. Note that the
JDK is publicly accessible, and free. Click on Next to get to the License
screen.
Click on Yes button to get to the Folder specification screen. In this screen
you must choose a folder in with setup will install JDK. It suggests a default
name, but it is recommended to specify a shorter name, like jdk1.3. It is also
recommended to install all the software components and application in a
drive different than C.
Leave the Plug-in screen with the default settings and click on Next.
The following screen allows the user to define what sub-components should
be installed. Please select the ones shown below:
Installation of Tomcat
http://apache.mirrored.ca/jakarta/tomcat-4/binaries
Or use the download of Tomcat 4.1.18 supplied with the distribution CD.
Configuring and setting up Tomcat requires several steps: deploying the Tomcat
software itself, that must be done after installing the full Java 2 development kit
(JDK 1.3), defining the environment variables and modifying/editing several
configuration files.
Double-click on the installer icon to start the setup process. It will attempt to find
a suitable Java Development Kit (JDK), which should have been installed
already.
If Tomcat Setup detects successfully a JDK it will pop this screen up:
Installer Options: If you plan to run Tomcat as main Web Server you will want
to specify port 80. Otherwise is recommended not to modify the default HTTP
connection port (8080) options unless another web server or application is
already running using that IP port.
Enter the password for the Tomcat administrator. This password can be later
modified in the /tomcat/conf/tomcat-users.xml file.
The installer will show the operations being performed until the word Completed
is shown, after which the button Close can be clicked on to finalize the
installation.
Immediately after the installation, the environment must be modified (right click
on My Computer, properties, advanced, environment variables) adding two new
variables, JAVA_HOME and TOMCAT_HOME to point to the installation directories
Adding the JAVA_HOME: click on the button New to get this screen:
After setting the value and hitting OK, the environment screen will look like:
Adding the TOMCAT_HOME: click on the button New to get this screen:
Once JAVA_HOME and TOMCAT_HOME have been set up, select from the
System Variables list box the variable PATH, and click on Edit. Modify the value
adding the path to the bin directory of the JDK (C:\jdk1.3\bin). Note paths are
separated using semicolons (;):