Quadri BIM Server Installation and Configuration

yompmulligrubsInternet and Web Development

Oct 31, 2013 (3 years and 9 months ago)

154 views


Documentation


Quadri BIM Server Installation and
Configuration



Versjon: 0.1

Dato:
31/10/2013

Laget av:
Anne Fauskanger




Quadri BIM Server




Date:
31/10/2013
11

Quadri BIM Server

©

ViaNova Systems AS

Quadri BIM Server

Page
2


Table of Contents




................................
................................
................................
................................
................................
...............................

3

1. INTRODUCTION TO
QUADRI MODEL

SERVER

................................
................................
................................
..

4

2. PREREQUISITES FOR

A
QUADRI MODEL

SERVER
................................
................................
............................

4

3. INSTALL ORACLE 11
G ON WINDOWS

................................
................................
................................
.................

4

3.1

S
OFTWARE REQUIREMENTS

................................
................................
................................
................................
....
4

3.2

H
ARDWARE REQUIREMENTS

................................
................................
................................
................................
................................
.............................
4

3.3

I
NSTALL
O
RACLE
11
G
R1

AND INITIA
L DATABASE

................................
................................
..............................
5

3.4

C
REATE A TABLESPACE

................................
................................
................................
................................
..........
9

4. INSTALL
QUADRI MODEL

SERVER
................................
................................
................................
......................

11

4.1

C
ONFIGURE THE DATABAS
E

................................
................................
................................
................................
..
12

4.2

C
ONFIGURE THE
Q
UADRI
M
ODEL

A
PPLICATION
S
ERVER

................................
................................
..............
12

5. ACTIVATE THE TYPE

REGISTRY

................................
................................
................................
...........................

13

6. INSTALL AND CONFI
GURE APACHE HTTP SER
VER

................................
................................
......................

13

7. SET UP VIRTUAL H
OSTS (MÅ OVERSETTES
DERSOM DEN SKAL VÆRE

MED)

................................
...

15

8. INSTALL AND CONFI
GURE OPEN SSO

................................
................................
................................
...............

17

8.1

I
NSTALL
JAVA

SDK

AND
G
LASS
F
ISH
A
PPLICATION
S
ERVER
................................
................................
........
17

8.2

C
ONFIGURE
JAVA

SDK

AND
G
LASS
F
ISH
A
PPLICATION
S
ERVER

................................
................................
..
21

8.3

I
NSTALL
O
PEN
SSO

................................
................................
................................
................................
..................
22

8.4

C
ONFIGURE
O
PEN
SSO

FOR
A
P
ACHE
A
GENT
................................
................................
................................
.....
22

8.5

C
REATE IDENTITY FOR
A
PACHE
P
OLICY
A
GENT IN
O
PEN
SSO
................................
................................
.....
23

8.6

I
NSTALL
A
PACHE
P
OLICY
A
GENT

................................
................................
................................
.......................
27

8.7

T
EST CONFIGURATION

................................
................................
................................
................................
............
28

9. INSTALL AND CONFI
GURE OPEN DS

................................
................................
................................
..................

28

10. SET UP A NEW SER
VER

................................
................................
................................
................................
..........

28

11. ADMINISTER USERS

AND ROLES
................................
................................
................................
.......................

28

11.1

A
DD NEW USER IN
O
PEN
D
S
................................
................................
................................
................................
.
28

11.2

A
DD NEW ROLE IN
O
PEN
DS

................................
................................
................................
................................
29

11.3

A
DD NEW USER IN
O
PEN
SSO

................................
................................
................................
..............................
29

12. LOGGING CONFIGUR
ATION
................................
................................
................................
................................
.

31

13. SET UP SERVER CO
NNECTIONS

................................
................................
................................
.........................

31

14. DATABASE CACHING

................................
................................
................................
................................
.............

31


Date:
31/10/2013
11

Quadri BIM Server

©

ViaNova Systems AS

Quadri BIM Server

Page
3

Documentation History


Date

Version

Author

Approved by

Description of change

06.05.10

0.1

Anne
Faus
kange
r


TEMPORARY draft

19.09.11

2.0

John
Arthur


Updated installation guide






















Date:
31/10/2013
11

Quadri BIM Server

©

ViaNova Systems AS

Quadri BIM Server

Page
4

1.

Introduction

to
Quadri Model

Server

2.

Prerequisites for a
Quadri Model

Server


This is what you need before starting the installation of a
Quadri Model

Serv
er:



Oracle 11g



Patch

11.2.0.1
.
0

Patch 7


3.

Install Oracle 11g on Windows

3.1

Software
requirements


Vianova is cur
rently using Windows Server 2008

R2.


Refer to Oracle Installation guide for detailed software requirements.

Install Oracle installation patch to l
evel


3.2

Hardware
requirements


Requirement

Value

Physical memory (RAM) for Windows x86


1
6

GB minimum


Virtual memory


Double the amount of RAM


Disk space for Windows x86


Basic Installation Type total: 4.55 GB

Advanced Installation Types total: 4.92 GB


Video adapter


256 colors


Processor for Windows x86


2 Ghz

minimum




Refer to Oracle Installation guide for detailed hardware requirements.


3.3

Install Oracle
11gR1

and initial database




Run
I
\
Utvikling
\
Qua
dri Model Server
\
Install
\
Oracle

\
win64_11gR2_d
atabase
\
database
\
Setup.exe
)



Date:
31/10/2013
11

Quadri BIM Server

©

ViaNova Systems AS

Quadri BIM Server

Page
5



Choose Installation location.




Choose Create Starter Database to have the installer create an initial database


Date:
31/10/2013
11

Quadri BIM Server

©

ViaNova Systems AS

Quadri BIM Server

Page
6




Type a system password.




Date:
31/10/2013
11

Quadri BIM Server

©

ViaNova Systems AS

Quadri BIM Server

Page
7



Verify that the prerequisite checks succeed, if not verify and confirm




Date:
31/10/2013
11

Quadri BIM Server

©

ViaNova Systems AS

Quadri BIM Server

Page
8



Optionally
enable Oracle Configuration Manager Registration




Date:
31/10/2013
11

Quadri BIM Server

©

ViaNova Systems AS

Quadri BIM Server

Page
9



Install Oracle






3.4

Create a tablespace




Start SQL Plus (Start


Programs


Oracle


Application Development


SQL Plus )




Log on with username SYSTEM.

(The password where created during installation)




Run the command:

CREATE TABLESPACE NSERVER DATAFILE 'd:
\
OrclData
\
tbs_nserver.dat' size
1G AUTOEXTEND ON MAXSIZE UNLIMITED;


This will create a tablespace name "NSERVER" and a datafile 'd:
\
OrclData
\
tbs_nserver.dat'

Initial size is 1 GB

And it will grow

unlimited


For detailed information on CREATE TABLESPACE:
http://download.oracle.com/docs/cd/B19306_01/server.102/b14200/statements_7003.htm


Date:
31/10/2013
11

Quadri BIM Server

©

ViaNova Systems AS

Quadri BIM Server

Page
10


(For testing p
urposes and in case of mistake)

Drop Tablespace

To drop a tablespace:

DROP TABLESPACE NSERVER INCLUDING CONTENTS AND DATAFILES;

Warning: This will delete the tablespace "NSERVER" including all content and remove the
datafile.


3.5

Installing the Oracle 11g Pat
ch

Run the Oracle 11.2.1.0 patch
in the directory:

I:
\
Utvikling
\
Quadri Model Server
\
Install
\
Oracle Install
\
10155838
\


Open the Readme.html file as shown below.



Follow the installation instructions for the patch in the readme file.


Date:
31/10/2013
11

Quadri BIM Server

©

ViaNova Systems AS

Quadri BIM Server

Page
11

4.

Install
Quadri Model

S
erver




Download the
Quadri Model

Server

The
Quadri Model

Server installation may be downloaded from the
Quadri Model

Server
Build page:

http://www.vianovasystems.com/vnsweb/NServ
erBuild/overview.asp




Run
Quadri Model Server
.exe.



Prerequisites:

1.

VC 2008 x64 Redistributable

2.

Apache 2.2.17 HTTP Server installation

The installer will
search for and prompt thee user to install the above prerequisites if th
ey are not
available. Note t
hat if Apache is already installed but all services have been removed, then the
installer will prompt to repair or remove Apache. Choose repair in this case.


5.

Install and
configure

Apache HTTP Server

Apache is installed, start the Apache Service Monitor fr
om the control panel. This provides an
overview of the apache services running. One service will be available per Quadri Model Server
instance (or schema).



Date:
31/10/2013
11

Quadri BIM Server

©

ViaNova Systems AS

Quadri BIM Server

Page
12









Click Install


You have to accept the license agreement




In the Ser
ver Information dialog, type the correct information:


Network Domain
. Enter the DNS domain in which your server is or will be registered in.
For example, if your server's full DNS name is server.mydomain.net, you would type
mydomain.net here.


Server Name
. Your server's full DNS name. From the example above, you would type
server.mydomain.net here.


Administrator's Email Address.

Enter the server administrator's or webmaster's email
address here. This address will be displayed along with error messages to
the client by
default.


For whom to install Apache

Select for All Users, on Port 80, as a Service
-

Recommended if you'd like your new Apache to listen at port 80 for incoming traffic. It

Date:
31/10/2013
11

Quadri BIM Server

©

ViaNova Systems AS

Quadri BIM Server

Page
13

will run as a service (that is, Apache will run even if no one is lo
gged in on the server at
the moment) Select only for the Current User, on Port 8080, when started Manually if
you'd like to install Apache for your personal experimenting or if you already have another
WWW server running on port 80.







Click Next


The i
nstallation type
. Select Typical for everything except the source code and libraries
for module development.

Date:
31/10/2013
11

Quadri BIM Server

©

ViaNova Systems AS

Quadri BIM Server

Page
14





Select Typical and click Next




Select Installation folder and click Next




Click Install to complete the installation







Date:
31/10/2013
11

Quadri BIM Server

©

ViaNova Systems AS

Quadri BIM Server

Page
15

5.1

Installing the Quadri
Model Server


Now follow the instructions from the wizard to install the Quadri Model Server.


5.2

Configure

the
Quadri Model

Server


Start the
Apache Services Monitor (either from the Task bar or Start Menu):




Stop the Apache2.2 Service shoould be running

by default after the installation.


5.3

Set up a new server

To create a new server (or database schema) first navigate to the “conf” folder of the installation
directory. Then
follow the steps in the following steps:


Date:
31/10/2013
11

Quadri BIM Server

©

ViaNova Systems AS

Quadri BIM Server

Page
16

5.4

Create the Apache service

1.

Copy the example

file “
ServiceTemplate
.conf” and rename the file [NEW SERVER
NAME].conf

2.

Set the desired port to listen on by changing the
[
LISTEN
PORT]
field. Ensure that an

unused

port is chosen; otherwise it will not be possible to start the service
.

3.

Edit the new file,
replacing
the [DB_NAME] field with the name of the Quadri Model
Server Schema in the Oracle database, often Quadri.

4.

Replace the text string [SCHEMA] with the name of the new server instance.

5.

Replace the text string [SCHEMA_PSW] with the password of the new

server instance.

6.

Close and save the file and open a command line window to the same folder.

7.

Run Create_Service
.cmd from the command line.

8.

Open the Apache Service Monitor:


The new service should now be shown in the monitor.

5.5

Create the database schema

9.

Op
en a CMD prompt and make [INSTALLDIR]
\
src
\
Server
\
SQL
\
CreateTestSchema
the current folder


10.

Run the command:

createTestSchema.cmd ORCL NSERVER password SYSPASSWORD


ORCL = Oracle database ID. (Database name used when install Oracle)

NSERVER = username / sche
ma name to create

PASSWORD= password to create for user NSERVER

SYSPASSWORD = Password for user SYSTEM on ORCL


Logfile is placed in:

[USERSPROFILE]
\
src
\
Server
\
SQL
\
CreateTestSchema
\
CreateTestSchema.log


5.6

Activate the type registry on the server

Start the

Fe
atureCatalogue editor in the Novapoint 19 installation.

1.

Open an appropriate feature catalogue file.

2.

Choose Tools
-
>Activate Feature Catalogue on Server, a dialogue should appear.


Date:
31/10/2013
11

Quadri BIM Server

©

ViaNova Systems AS

Quadri BIM Server

Page
17

3.

Press the Skip button in the bottom right hand corner to bring up the dialogue

screen shown
below.




Fill in the form with the IP address, port number, username and password (for administrators), then
press the “Start” button to activate the Feature Catalogue on the server.

Note that this process can
take from 20 minutes to half a
n hour so
please
be patient!

6.

Administer users and roles

The current system for handling users and roles requires some manual work. Future versions of the
Quadri Model Server will be provided with a dedicated application for managing users and roles.


To ad
d or remove users from the
full
list of
users available to a project, open the file:

[INSTALL DIR]
\
src
\
CreateTestSchema
\
users.sql


Open the users.sql file in a text editor

and add copy the last row and paste as a new line. Then edit
the
username and passwo
rd in the new line.

Note that new users
must be added before creating a
new server schema.


7.

Logging
configuration

The directories where logging information is stored

are set in the following files upon installation of
the solution:


Running logs:

[INSTALL
DIR]
\
Quadri Model Server
\
logs


New server (schema) installation logs:

[APACHE INSTALL DIR]
\
Apache2.2
\
logs

8.

Set up server connections

To add server connections in Novapoint19, open the Server Manager
.

This should bring up a logging
dialogue:


Date:
31/10/2013
11

Quadri BIM Server

©

ViaNova Systems AS

Quadri BIM Server

Page
18



Choose Modify

list of servers

from the drop
-
down list of servers as shown above.

A new dialogue will appear allowing editing of server properties:



Choose an existing server from the list and choose “Copy” from the
actions buttons to create a new
server copying. Not
e that
LatestApproved.Server

is provded by default. When the new server has
been created, Edit the name as it appears in the server list. Note that only the name up to the first
dot should be changed, i.e. the new name should be [NEW SERVER].Server
.xml.


F
ill in the Alias and Servername

and Port fields

in the “Server” tab on the right hand side of the
dialogue. Note that the Servername is the IP address of the server.


Note that you need to restart Novapoint DCM in order for the new server to be registered
in the
system.


Date:
31/10/2013
11

Quadri BIM Server

©

ViaNova Systems AS

Quadri BIM Server

Page
19



From the View ribbon, choose
,
Server Explorer. A list of available servers should appear in the right
hand panel. Right click on the desired server to log on. Once logged in, a list of available projects
will appear in the Server Explore
r. Right click on the desired project

and choose Open from Server
to create a new workset for the project.