Installation and maintenance manual

foreheadsobstinacySoftware and s/w Development

Aug 15, 2012 (4 years and 11 months ago)

230 views

Installation and maintenance manual



INDEX







1. INTRODUCTION

2. REACHES

3. SOFTWARE REQUIREMENTS

5. INSTALLATION

5.2. DATABASE INSTALLATION

5.3. INSTALACION DEL CONTENERDOR WEB

5.3.1. INSTALLATION OF TOMCAT AS SERVICE

5.4. VIRTUALCAMPUS SCHEMA IN
STALLATION

5.5. INSTALLATION OF THE RESOURCE POOL

5.6. MODULE CLIENT FILE UPDATE

5.7. VIRTUAL CAMPUS INSTALLATION USING NETBEANS

5.7.1. SET UP THE APPLICATION

5.9.2. COMPILING SOURCES

5.8. BY STARTING THE SERVER

6. MAINTENANCE

6.2. DATABASE BACKUP

6.3. BAC
KUP POOL OF RESOURCES





1. INTRODUCTION



This document shows the steps for the installation of the VirtualCampus 3D
platform different processes required for system maintenance.



2.
SCOPE



The installation steps are based so that the application is i
nstalled on a
Windows 2000, XP, Server 2003 and Vista, you can install 3D VirtualCampus
on other operating systems, but these steps are outside the scope of this
document.



3. SOFTWARE REQUIREMENTS

The VC3D Web Part requires a container Apache Tomcat 6.0
Web application
or a container that supports Servlet specification/JSP 2.5/2.1 respectively, also
requires a System Manager database PostgreSQL 8.3.5 or higher

The operating system must have installed JDK 1.6 or higher may be Linux, Unix
or Windows version

of the system depends on the systems supported by the
Web archive and database system, can be installed on separate using systems
servers different operational required in this case the database server does not
have the JDK installed.

The client component

requires that the user has installed JRE 6.0 java or
higher.

The application was designed using Internet Explorer and FireFox may work in
other browsers that are supported, as the client operating system can be
Windows XP, Windows 2000, Windows 2003, Linu
x or MAC OSX.


4. HARDWARE REQUIREMENTS


The server hardware requirements are limited by three factors:



The requirement of minimum to run WEB applications contain hardware
this defines the container selected for installation.




Minimum hardware requirements

to run the version of PostgreSQL
database engine selected for installation.




The number of users (vertical scalability)


The client requires minimum:



256 MB (preferably 512 MB) RAM




A minimum processor with a 1 GHz Core or more than one core




The video of

the video card driver must be installed and support OpenGL
(it can be integrated).




100 MB of free space on disk (to store the cache of Java Web Start) or
more this depends on the number of geometries using the virtual tour.




5. INSTALLATION



5.2. INST
ALLATION OF THE DATABASE



The first step is to unzip the downloaded file (this is usually a file in zip format),
which contains other four files:



• postgre
-
8.2. msi: his name will vary, depending on the version of
PostgreSQL that you downloaded (postgr
e+versión +. msi).



• postgre
-
8.2
-
int. msi: this is the main file of the installation. Similar to the
previous file name also varies depending on the version of the program.



• Readme.txt: File read me with details relating to the installation.



• up
grade.bat: process to update previous versions already installed on
your computer.



To perform a new installation of PostgreSQL, the first two files will only be
required.



Once you have the files already uncompressed in the same folder, postgre
-
8.2msi
runs. The file will launch the installer, which prompted the selection of
one of the languages available:





Apart from the language, you can save a detailed log of the installation by
checking the checkbox at the bottom of the screen. Once you have sel
ected the
language, press the Start (start) button to advance the installation.
At this point,
the application will run the file postgre
-
8.2
-
int.msi.



This screen displays a message welcome where recommends the user to close
all running applications befor
e you continue with the installation.




To move the installation, simply click Next) button.



The installer displays a screen where we can view a text information and
installation instructions.




Once you have read, you click the Next button to adv
ance to the next step.



At this point, the application allows you to configure the installation path and the
components.




By clicking on the icon with the design of the hard disk, you may select the
following options:



• Install the component and a
ll the elements that are inside of it.



• Install that component.



• Not to install this component.



• Install on a network component, and all items that are inside of it.



• Install the component in a network.



In this case, all completely must
be installed on the local hard disk.

The installation path can be anyone you want, but you carried out on a path
without spaces.

Once configured everything above, you will press the Next button to advance to
the next step.

At this point, the installatio
n will reach service configuration.

You should leave the check box, which indicates that PostgreSQL will be
installed as a service marked.




It should provide a name to the service (Service name), a name, domain and
password for account (Account name,
Account domain Account password
respectively).
In order to avoid any incorrect password, you must repeat the
field verify password (Verify password).



Once all the data are completed successfully, click Next.

Two warnings for screen appear at this time.





The first will warn you that the user does not exist, which asks whether you
want to create that account. In this particular case, shall issue an affirmative
answer.



Obviously, there might be the case that the user already exists, to which the
inst
aller will not display this message.



It may be the case that the application considers that the password provided is
too short. In this case, the following appears:




If you answer Yes, the installer will create a password for the account to create.
On the other hand, if you select No, the account will be created with the
password previously provided.



The next step will define various fundamental aspects for the operation of 3D
VirtualCampus with PostgreSQL:




The checkbox at the top of the scre
en must be marked.

Keep the same port (PostgreSQL has as a port by default the 5432).



Indirizzi (address) field check box also must be marked.

Keeps the C Locale field option and UTF
-
8 is selected as the encoding
(Enconding).



The following defines
the data of the superuser access. By default named
(Superuser name) is postgres, and in addition shall add him a password
(Password) which will need to enter in the Password (again) field.



Once you have completed all the data, once again you click next
to advance to
the next step of the installation:





Here is what languages installed. If the above steps have been carried out
successfully, the installer will make it possible to choose both the first and the
last option (PL/pgsql and PL/Java respectiv
ely). Once marked both, moves to
look like the following configuration:





Now you can define what contributions you want to install. In addition the
Adminpak will have to install the cutting. Once selected, moves to the next step
by pressing the Next b
utton.



This screen reports that PostgreSQL is now ready to be installed.




The progress bar will indicate the status of the installation anytime.
After the
installation is complete, the following message is displayed:




This warning indicates that
the installation has been successful. At this point,
you must click the Finish button to complete the installation.



5.3.


INSTALACION DEL CONTENERDOR WEB



Installation of Tomcat in Windows can be easily using Windows Installer. Its
interface an
d functionality is similar to another Assistant based installers, with
only a few themes of interest requires that this installed J2SE 6 JRE or higher.



1.

The Windows Installer can be downloaded from the following url:




http://opensource.become.com/Apache
/Tomcat/Tomcat
-
6/v6.0.18/bin/Apache
-
Tomcat
-
6.0.18.exe

2.

Once you have downloaded run setup apache tomcat 6.0.18. exe




3.

Accept the Apache license.




4.

Follow the steps that indicates the installation wizard.




a.

Normal installation type.


b.

Destination directory

(by default)


c.

Port 8080, enter a password for the account admin management.


d.

previously installed JDK or JRE selection.


e.

Finally press the button install.




5.3.1. INSTALLATION OF TOMCAT AS SERVICE



Tomcat is installed as a service for Windows NT / 2 k/
XP regardless of the type
selected configuration. Using chekcbox service as autostartup configuration
sets the service car boot, so Tomcat start automatically when Windows starts.
For optimal security, the service must be run as a user with reduced
permiss
ions.



5.4. INSTALLATION OF SCHEMA VIRTUALCAMPUS



Create a user called virtualcampus using pgAdmin III that comes with postgres
section Login Roles.



After the creation of the role, select the menu "Tools > restore", a screen like
this:



Select the b
ase_de_datos.backup that comes with VirtualCampus 3D file and
press "OK", this will create the initial database schema, brings by default a user
administrator changes the key this user in the "Users" table virtualcampus
database using the pgAdmin III.



5.
5. INSTALLATION OF THE RESOURCE POOL



The pool of resources must be installed on disk with insufficient available space
preferably disk "D", different from the system.



Copy the "pool" folder to drive D, you must not modify any file content, this pool
is

the client module, consider this step as module installation client that will be
downloaded by the user.



5.6. THE CLIENT MODULE FILE UPDATE



When you compile the client module and you want to update the module jar,
copy all the files generated in the f
older "build/lib" except for the files
"virtualcampus
-
test
-
*" since they are only used to load in standalone mode
application when is developing, you must copy virtualcampus
-
client.jar and the
libs and update them all at the same time, if does it fail sign
ature verification
when visitors try them to download, always update all this are not modified all
this in order to maintain the same signature for all the jars in compile time.




Note: Do not delete the certificate gislersoft, this certificate is respon
sible for
signing the resources that can be downloaded.



5.7. VIRTUAL CAMPUS INSTALLATION USING NETBEANS



VirtualCampus 3D can be installed as a war file, but this implies making many
manual changes to the file to modify the web.xml, we recommend from
Ne
tBeans and directly using fonts.



5.7.1. CONFIGURE THE APPLICATION



Before compiling the application we must specify the Web application some
configuration data, select the web.xml file for editing in NetBeans:




We need to change the context parameter
s available in the web.xml these
context parameters allow us to configure the VirtualCampus 3D
environment:


DB_DRIVER:
Do not change it (only VirtualCampus by now supports
postgresql)

DBHOST:
Place the IP or DNS server database.

DBPORT:
No lo modifique (Po
r ahora VirtualCampus solo soporta postgresql).

DB_NAME:
Nombre del esquema de base de datos.

DB_USER:
The role name or user of bond.

DB_PASS:
The role password

MAX_ROWS_PER_PAGE:
Number of rows to deploy to different modules
module administrative.

SMTP_HOST:
SMTP server to send e
-
mails
.

SMTP_USER, SMTP_PASSWORD, STMP_ACCOUNT
:
The account SMTP.

WEB_HOST:
Place the IP or DNS of the Web server.

RES_ *:
Directory of the pool, verify that they match the pool installation.

WEB_PORT:
Port used to access the application

Web.

SEC_*,PATH_TO_CLIENT_CONFIG,PRIVATE_PATH_*:
Referencias a los
directorios del pool, verifique que coincidan con la instalación del pool. (Tenga
en cuenta en cuales debe usar doble slash, slash al final y un solo slash)





5.9.2. COMPILE THE SOURCES



Before you compile the project make sure that Apache Tomcat not this started,
open the project virtualcampus
-
web sources (trunk/virtualcampus
-
web), when
East press opened the project "Clean and Build".



Note: You may need to resolve the references to th
e libreiras, see the
NetBeans manual to learn how to do it, is a procedure that allows to link the
libraries.





5.8. STARTING THE SERVER



You must first start apache tomcat, we opened the "Apache monitor", select the
icon of the "Apache monitor" give r
ight click "Start service".




See the Tomcat startup window
:





We once the service is started, press the "Run Main Project" borón this
institutional





6. MAINTENANCE



6.2. THE DATABASE BACKUP



To perform a database export enter pgAdmin III, selec
t the database
virtualcampus, then right click and choose the option "Backup...".




A window will appear like this:




Save the file on the drive where you want to back up, this screen allows you to
perform various types of backup, we recommend two back
up format
"COMPRESS" and "PLAIN" format.



6.3. BACKUP THE RESOURCE POOL



Back up to the resource pool whenever you back up the database, since only
back up the database does not guarantee that this backing objects 3d avatars
uploaded by the administrator

to the system, then full backup of the "pool"
folder.