Primavera P6™ Compression

Server
Administration Guide
Version 6.2
 2

Copyright © 1999 - 2008 Primavera. All rights reserved.

The software described herein and this documentation is furnished under a Software License Agreement
and may be used only in accordance with the terms of the Agreement.

Except as provided in the applicable Software License Agreement, Primavera assumes no liability resulting
from any omission or inaccuracies in this document or from use of the information obtained herein. Except
as provided in the applicable Software License Agreement, Primavera does not assume any liability arising
out of the application or use of any product described herein. Primavera reserves the right to make changes
to any products described herein to improve reliability, function, or design, and reserves the right to revise
this document and to make changes from time to time in content hereof with no obligation to notify any
person of revisions or changes.

Please send your comments to:

Primavera Systems, Inc.

Three Bala Plaza West
Bala Cynwyd, PA 19004
Telephone: 1-610-667-8600
FAX: 1-610-667-7894
World Wide Web site: http://www.primavera.com

The software products described in this document may not be copied, reproduced, modified, or distributed,
except as indicated in the Software License Agreement. You may not reproduce the printed version of the
User Documentation or other printed materials accompanying the software, except as expressly permitted
in the Software License Agreement or in writing by Primavera. However, you are permitted to reproduce
and distribute as many copies of the electronic version of the User Documentation, in printed and electronic
format, as you reasonably require in support of your use of the software.

U.S. Government Restricted Rights: If the software is acquired for or on behalf of the United States of
America, its agencies and/or instrumentalities (“U.S. Government”), it is provided with RESTRICTED
RIGHTS, as set forth in the Software License Agreement. Use, modification, reproduction, release,
performance, display or disclosure of the software and accompanying documentation by the U.S.
Government are subject to the restrictions set forth in the Software License Agreement.

Trademarks: Primavera, the Primavera sundial, Authorized Representative, Solution Provider, Business
Solutions for a Project-Driven World logos, P6, P5, P3, Primavera Project Manager, Primavera ProSight,
Primavera Contract Manager, Pertmaster, Primavera Cost Manager, Evolve, Primavera Contractor,
Primavera Inspire, Claim Digger and SureTrak are either trademarks, services marks or registered
trademarks of Primavera in the United States and/or other countries. All other trademarks mentioned
herein are the property of their respective owners.

To view the P6 Commercial Notices and Disclosures for Documentation, go to the

\Documentation\<language>\Notices and Disclosures folder on the P6 physical media or download.
 3

Table of Contents
TABLE OF CONTENTS ..................................................................................................................... 3 
PREFACE ......................................................................................................................................... 4 
USING THE ADMINISTRATION GUIDE.............................................................................................. 4 
WHERE TO GET SUPPORT .............................................................................................................. 4 
BEFORE YOU BEGIN........................................................................................................................ 5 
WHAT IS THE PRIMAVERA COMPRESSION SERVER ...................................................................... 5 
OVERVIEW OF THE COMPRESSION SERVER ARCHITECTURE ....................................................... 6 
COMPRESSION SERVER INSTALLATION REQUIREMENTS ............................................................. 7 
BEFORE YOU BEGIN THE INSTALLATION ........................................................................................ 8 
UNINSTALLING PRIMAVERA COMPRESSION SERVER SERVICE .................................................... 8 
CONFIGURING PRIOR TOMCAT INSTALLATIONS.............................................................................. 8 
INSTALLING TOMCAT ON WINDOWS 2003 AND 2008 SERVER ........................................................ 8 
THE INSTALLATION PROCESS PHASES ........................................................................................ 10 
Phase I: Plan your installation ....................................................................................................... 10 
Phase II: Set up your database servers using P6............................................................................ 10 
Phase III: Configure the Compression server ................................................................................ 10 
Phase IV: Configure clients ........................................................................................................... 10 
SERVER INSTALLATION AND CONFIGURATION ........................................................................... 11 
INSTALLING THE COMPRESSION SERVER.................................................................................... 11 
CHANGING COMPRESSION SERVER DATABASE CONNECTION SETTINGS ................................. 18 
TROUBLESHOOTING ...................................................................................................................... 22 
USING THE COMPRESSION SERVER ADMINISTRATION APPLICATION ........................................ 25 
REVIEWING AND MODIFYING COMPRESSION SERVER CONFIGURATIONS ................................ 28 
STARTING AND STOPPING THE COMPRESSION SERVER ............................................................ 30 
UPDATING THE VERSION OF THE COMPRESSION SERVER CONFIGURATION ............................ 31 
COMPRESSION SERVER TELEMETRICS ....................................................................................... 32 
Telemetry item descriptions .......................................................................................................... 32 
CLIENT INSTALLATION AND CONFIGURATION ............................................................................. 35 
INSTALLING CLIENT APPLICATIONS.............................................................................................. 35 
CHANGING COMPRESSION SERVER CONNECTION SETTINGS .................................................... 35 
CONFIGURING DATABASE CONNECTIONS DIRECTLY AGAINST ORACLE ..................................... 40 
CONFIGURING APPLICATION LICENSING ..................................................................................... 41 
 4

Preface

Using the Administration Guide

Before you Begin Provides an overview of the components of the Primavera
Compression Server, discusses how to plan an implementation for your organization, and
offers an overview of the process of installing and configuring the compression server.

Server Installation and Configuration Provides the steps for installing the server-
side components of the compression server, including the following:
• Setting up the database connections for the compression server
• Configuring databases
• Configuring compression server settings

Client installation and configuration Provides the steps to install the client-side
components compatible with the compression server, including how to configure your
database connection during or after installation.

Where to get support

If you have a question about using Primavera products that you or your network administrator cannot
resolve with information in the documentation, contact Primavera Customer Support at the times and
locations listed below.

Please provide your Primavera product serial number ready when contacting Primavera. Each interaction is
logged to help Primavera resolve your questions quickly.

Office Time
Hours Telephone FAX E-mail Address*
Telephone Zone
Bala Cynwyd, 8:00–8:00 +1-610-668-3030 +1-610-667-0652 [email protected]
Pennsylvania, ET (Mon–Fri)
USA 9:00–2:00 (Sat)
London, 8:30–6:30 +44-20-8563-5555 +44-20-8563-5543 [email protected]
England, UK GMT (Mon–Thur)
8:30–5:30 (Fri)
Hong Kong GMT+8 8:00–5:00 +852-2111-8299 +852-2111-9477 [email protected]
(Mon–Fri)
*Primavera's Web site at http:/www.primavera.com/customer/index.asp provides support and product
information, such as knowledgebases, file downloads, user group and newsgroup information, and a
product enhancement request form.

All Primavera products are backed by comprehensive support and training.

 5

Before you begin

What is the Primavera Compression Server

The Primavera Compression Server is a layer between the database server and the Project
Management module that compresses data before sending to the client. The basis is that
high latency/low bandwidth networks cause serious degradation in time taken to transfer
data to the client. Figure 1. illustrates the current architecture and Figure 2. illustrates
how the compression server fits into the Primavera architecture. In Figure 1, clients 1 to
N interact with the database server over a WAN. In Figure 2, with a compression server,
the clients still send and receive data over the WAN, but the data from the database
server is compressed on the compression server, and then sent across the WAN to the
clients.

Client #1 DB Server

Client #2
WAN

Client #N

Figure 1. Current architecture

Compressed Data
Compressed Data

Compression
Client #1 Server

Client #2 Uncompressed Data

WAN
DB Server

Client #N
LAN LAN

Figure 2. With compression server

 6

Overview of the Compression Server architecture

Figure 3 provides more detail about the Client/Compression Server architecture.
Primavera reads and writes data using Borland DBExpress technology. Primavera
provides a DBExpress driver that communicates with the compression server. The
compression server does the actual work of fetching and sending requests and response
data. As a result, no change is made in the Primavera client. Instead of a DBExpress
driver connecting to Oracle or SQL Server, the driver connects to the compression server.

On the compression server end, the details of scheduling threads are handled by the BRE
(Business Rule Engine), which is the same engine used in P6 Web Access. For each
client request, a worker thread will perform the necessary work, running the query and
fetching the dataset before returning the data back to the client.

Figure 3. Architectural detail

 7

Compression Server Installation Requirements

• Windows 2003 Server Service Pack 2 or Windows 2008 Server.

• Oracle 11g client on the compression server machine.
• Project Management module version 5.0 Service Pack 3 or later.
• Java 2 SDK, v1.5_13 on the compression server machine. This version is
available online at http://java.sun.com/products/archive/j2se/5.0_13/index.html.
• Tomcat 5.5.20, which is available in the \Tools\Compression Server folder on the
P6 physical media or download. On the Tomcat server hosting the Compression
Server, you cannot deploy another application as a WAR file.
• Minimum 3GB RAM and 2 GHz or more processor (multi-processor
recommended) on compression server machine is recommended.
• The databases should already have appropriate licenses installed using the
database configuration for the P6 Project Management module.
• Install the Primavera DB Express driver on the client machines using the Project
Management module setup.
• Use the Database Configuration utility to configure the Project Management
module to connect to the compression server using HTTP.
• Only the Project Management module is compatible with the compression server.
• Only English is supported as the operating system locale and input language for
the compression server; using other languages may cause errors. Errors can also
occur on the compression server if the Project Management module is not using
English as its operating system locale and input language.
 8

Before you begin the Installation

The P6 Compression Server setup installs a Win32 service. This requires you to
completely uninstall any previous version of the Compression Server.

Uninstalling Primavera Compression Server service

If Compression Server 5.0 was installed manually as a service:

1. Open the Windows Services applet and find the Primavera Compression Server
service.
2. Stop the service.
3. Open a DOS command prompt, and then navigate to the directory where the
Compression Server is installed.
4. Next, at the DOS command prompt, type the following command to uninstall the
service: cssvc.exe /uninstall
5. Once the service is uninstalled, the message “Service uninstalled successfully” is
displayed. Click OK to close the information message box.
6. Delete the cssvc.exe file.
7. Uninstall the Compression Server using Add/Remove Programs (Settings, Control
Panel).

If Compression Server 5.0 was not installed as a service, or 5.0 SP1 or later is installed:
You must uninstall the Compression Server using Add/Remove Programs (Settings,
Control Panel).

Configuring Prior Tomcat Installations

Stop any existing Apache Tomcat service and change the startup type for the existing
service to Manual.

Installing Tomcat on Windows 2003 or 2008 Server

Refer to the instructions in the Apache Tomcat documentation.

Note: When installing Apache Tomcat on a Windows 2008 Server, you may receive an
error, “Failed to install Tomcat5 service. Check your setting and permissions. Ignore and
continue anyway (not recommended)?”
 9

Click Ignore to proceed with the installation.

 10

The Installation Process Phases

Phase I: Plan your installation

Plan your Compression server installation. Identify the network and hardware that you
will need. If required, install and configure database server software (Oracle) as
mentioned.

Phase II: Set up your database servers using P6

(Use the P6 Administrator’s Guide for this phase)
The compression server is compatible with the Project Management module version 5.0
Service Pack 3 or later. We recommend that you setup your database servers using the
P6 setup, or use a copy of a database already configured to work with P6.

Phase III: Configure the Compression server

Install the Oracle 11g client on the compression server machine. Install the Java 2 SDK,
v1.5_13 on the compression server machine.
Install the compression server on the Windows 2003 or 2008 server machine that you
have identified. During the installation, or once it is complete, you can setup the
Compression Server configuration database. The Compression Server configuration
database is a repository of database connection settings normally saved in a special table
in your Project Management database. You can then configure compression server to run
against multiple databases.

Phase IV: Configure clients

1. Install the Project Management module on a client workstation. During
installation, you can configure a connection to your regular Oracle database. The
Project Management module setup installs the necessary compression server
client drivers (DbExpprc.dll and libjnbzip2.dll) into your System32 folder. This
will also install the necessary entries into the Dbxconnections.ini and
Dbxdrivers.ini files.
2. Use client DBConfig to setup a connection through the compression server.
 11

Server Installation and Configuration

Installing the Compression Server
• On the P6 physical media or download site, browse to the \Tools\Compression
Server directory and double-click the CompSvrIns.exe file to begin the
installation.

• Accept the licensing agreement and click Next.

 12

• Browse to the Oracle home location. Make sure your environment variable path
points to the correct location where Oracle is installed. Also, specify the location
of the Tomcat 5.5.20 server.
 13

• Browse to the directory where you want to install Compression Server. Click
Next.

• Click Next to confirm the install location and begin the installation.
 14

• Setup your database username and password settings. Pubuser is the default
username and password. Enter the Oracle Connection String / TNS entry (Alias),
 15

Oracle Host IP address, Oracle Host port and Public Group ID. Choose a
database with a valid P6 schema . If the Database Host Address pertains to a
compression sever dedicated connection then make sure you review and execute
the steps under Network Settings for Compression Server in the Changing
Compression Server Database connection settings section of this
Administration Guide.

• After the initial installation, the Database Configuration tool shows an existing
configuration. You may choose the Create a New Configuration option to type an
appropriate name for the new configuration. If there is no configuration
information in the database you will not see the following screen during the initial
setup. In this case a default configuration will be saved to the database.
 16

• Click OK. Then click Finish to complete installation.

17
 18

Changing Compression Server Database connection

settings

• The Database Configuration wizard enables you to change the Compression

Server connection settings that you specified during installation. The database you
connect to during the Compression Server installation stores one or more
Compression server database configurations. Each Compression Server
configuration specifies a set of configurable parameters that determine how the
Compression Server operates. Once Compression Server is installed, you can
select an existing Compression Server configuration or create a new one.

• To run the Database configuration wizard, choose Start, Programs, Primavera,

Compression Server, Database Configuration.
 19

Network Settings for Compression Server

You can configure the network settings for the compression server and database server to
function more efficiently in a multi-user setting. The compression server needs to
communicate with the Project Management (PM) clients and the database server
concurrently, with as little network impediments as possible. For example, if the
compression server machine uses only one network interface card (NIC), a potential risk
for switch collision could lead to poor performance. To avoid this risk, we suggest using
at least two NICs for the compression server. One NIC should be used for the data
transfer with PM clients and another NIC for the communication with the database
server.

One NIC may be sufficient for smaller deployments or databases.

To avoid unwanted routing, you can configure the NICs you are using for the PM clients
and database on separate subnets. Also, the routing table should not have any entries
configured for routes between the two NICs.

The example below shows one possible way to configure the network for the
compression server. All configurations must meet the following two requirements:

1. One NIC should serve data transferred between the Compression Server and PM
clients. For example, you can use an IP address that is accessible to every one in the
corporate network of the organization.

2. The second NIC should serve data transferred between the Compression Server and the
DB Server. As an example, the following configuration meets this requirement:

The IP address of the second NIC should not be accessible from any other machine in the
corporate network of the organization, except the DB server machine. This minimizes
traffic on the second NIC and also ensures the fastest possible connection between the
Compression Server and the Database server. To achieve this, we recommend using an IP
address with a subnet not visible in the corporate network. In the example below,
changing the IP address to 10.12.63.XX would make the second NIC visible only for the
subnet 63.
 20

We also recommend that the DB Server machine uses a dedicated NIC for the
compression server connection. This connection will support the traffic of uncompressed
data for all PM clients. If the expected traffic through this connection is low, then the DB
Server machine can use one NIC with IP multiplexing. The routing table of the DB server
should not have any entry configured for routes between the two NICs.

The IP address of the second NIC, or the second IP of a single NIC, must have the
same unknown (invisible) subnet as the second NIC of the compression server. In the
example above, the IP would say 10.12.63.YY.

This configuration is the equivalent of using a direct crossover patch network cable
between the compression server and the database.

If the DB Server machine uses a dedicated NIC for the compression server connection,
the applications that need to connect directly to the database may have to use another
NIC. In order to inform these applications about the fact that the parameters of the
compression server connection to Oracle can not be used for direct connection, you have
to add a new entry in the ADMIN_CONFIG table of the configuration database.
 21

The following steps are required only if your database server is configured to support
more than one network interface card (NIC) and uses an IP address that is not public.

1. Using SQL*Plus, run the following SQL command on the database server:

INSERT INTO ADMIN_CONFIG (CONFIG_NAME, CONFIG_TYPE,

CONFIG_VALUE)
VALUES('CompressionServerPublicConfig', 'CS.ORA',
'IP_ADDRESS:port_no:SID'); COMMIT;

Note that the SID is the SID of the database server, and the IP_ADDRESS:port_no is the
database server’s public NIC IP address and port number.

2. Next, run the following SQL command to delete the existing

INTERNAL_PLUGINS configuration from the ADMIN_CONFIG TABLE.
This step is necessary only if the INTERNAL_PLUGINS configuration
currently exists in the ADMIN_CONFIG TABLE:

DELETE FROM ADMIN_CONFIG WHERE UPPER(CONFIG_NAME)=

'MYPRIMAVERA.BRE.INTERNAL_PLUGINS'; COMMIT;
 22

Troubleshooting

Compression Server users are receiving “Socket Error #10054…” messages:

Java offers the Socket.setSoLinger method to control how long a socket lingers, that is,
the amount of time a socket waits to close when there is still unsent data. Compression
Server uses this setSoLinger method. The value is controlled via the Compression Server
Administrator application, under the \Configurations\Custom\Primavera Configuration\
Compression Server\SocketLingerTime setting.

For more information on the Administrator application, see page 25.

By default, the SocketLingerTime value is 2s (2000ms). For noisy networks, 2s may not
be sufficient, resulting in the socket closing before the data is fully read. Users will then
receive the following error message:

Error: Socket Error #10054 Connection reset by peer. Received data is invalid!

To avoid this error, Primavera recommends that you adjust the SocketLingerTime setting
to a higher value and restart the Compression Server from the services dialog. You will
need to set the value according to how noisy your network is. For example, during in-
house testing, increasing the SocketLingerTime setting to 10s on a network with a 5%
packet loss eliminated the error messages and loss of data.

Since sockets tend to be open longer with higher settings in this parameter, there
could be a slight loss of performance.

For more information on the Socket.setSoLinger method, please visit

http://mindprod.com/jgloss/socket.html.

Compression server does not start:

Normally “Primavera Compression Server TC” service will start automatically after
successful installation. Start “Primavera Compression Server TC” from services dialog to
launch the server JVM, setting the thread stack, initial heap, and maximum heap for an
average hardware. If you do not have enough memory on the compression server
machine, the service may not start when installation is completed.
See jakarta_service_xxxx.log at Tomcat home logs folder.

You may see errors like “Error occurred during initialization of VM -- Could not reserve
enough space for object heap.”

In this case, the administrator should edit –Xms and -Xmx parameters. To do this,
complete the following steps:
 23

1. Double click PCSTCw.exe in the Tomcat Home\bin folder, then choose the Java tab.

2. Change the –Xms and -Xmx parameters (Initial memory pool and Max memory Pool –
default 1200MB each) equal to the largest available contiguous chunk of the available
physical memory, but no more than 2GB. Setting -Xms and -Xmx to the same value
increases predictability by removing the most important memory sizing decision from the
virtual machine.

We recommend a value no greater than 1024 kilobytes for the –Xss (-Xss1024k). The
default maximum stack size used by C code is sufficient for the native implementation of
the compression library.

For more information, refer the following:

FAQ about the Java HotSpot VM

http://java.sun.com/docs/hotspot/PerformanceFAQ.html#22

FAQ ABOUT SUN ONE[tm] APPLICATION SERVER PERFORMANCE

What's a good way to size the heap?
http://java.sun.com/docs/performance/appserver/AppServerPerfFaq.html
 24

Tuning Garbage Collection with the 5.0 JavaTM Virtual Machine

http://java.sun.com/docs/hotspot/gc5.0/gc_tuning_5.html

Tuning Garbage Collection with the 1.4.2 JavaTM Virtual Machine

http://java.sun.com/docs/hotspot/gc1.4.2/
 25

Using the Compression Server Administration

Application

• As the system administrator, you can use the Compression Server Administrator
application to review, modify, add, and delete Compression Server
configurations. Primavera configurations are stored in the Compression Server
database specified during installation. These configurations contain all of the
settings used to run the Compression Server.
• Only administrators should use the Compression Server Administrator application
to modify configuration settings.
• Choose Start, Programs, Primavera, Compression Server, Administrator to run the
Compression Server Administrator application.
• Type the database User Name and Password (privuser by default) and click OK.

• Select the correct configuration that was chosen while installing the Compression
Server, for example, .\Configurations\Custom\Primavera CompSvr Config.
• To upgrade the selected configuration to the latest version, right-click and choose
Update to latest version.

Note: Primavera strongly recommends that you create a new configuration when
you install the Primavera Compression Server. However, if you choose to upgrade an
existing 5.0 SP1 or earlier configuration, refer to “Updating the version of the
Compression Server configuration” later in this guide for additional required steps.
 26

• Next, create one or more databases that the compression server can load data
against on behalf of the Primavera Project Management clients. Expand the
database folder. Right-click on the Instance folder and choose Duplicate. In our
example, this creates a Duplicate instance of LONDON10, the configuration
database. You can modify this copy to be any database you may need for the
compression server.
• For connecting the compression server to any DB server, edit the URL parameter
under Database\Instance. To edit this field, triple-click it or press the F2 key.

Then start editing the following fields to have appropriate values of New DB.
o Name
o Description
o URL (Remember that a Database is always referred to by its SID name
and IP address).
o UserName
o Password
 27

o Public Group ID
• In order to create and configure multiple database connections, you can duplicate
a database instance as many times as you need.
 28

Reviewing and Modifying Compression Server

Configurations

• Another set of important parameters available through the Compression Server

Administrator application is the set of parameters controlling the Compression
Server performance. In most situations the default settings are enough.
• These settings are found under the Compression Server node.

• The following table summarizes these settings

 29

Variable Name Value Min Max Tool tip

TelemetryUserName csadmin Telemetry user name
TelemetryPasswordName csadmin Telemetry password
DefaultPort 80 0 65535 Port value for the Project
Management module.
DefaultJobDelay [ms] 0 0 125 Scheduling delay of a
compression job. For
networks with high
latency (>250ms) if using
huge compression buffers
(>512KB) a job delay
may be acceptable in
order to speed-up jobs
that return a lot of Blob
data.
CompressionBufferSize 262144 16384 4194304 Size of the main
[bytes] compression buffer.
Larger the buffer, better
the compression ratio. For
2GIPS machines
compression speed is
1KB/ms. Each
compression job uses
memory up to 12 times
the size of the main
compression buffer.
IpBufferSize [bytes] 64156 4096 131072 The socket send buffer
size for PM client
connection.
FetchSize 254 0 255 Number of rows in a
database data block.
JobMaxTime [ms] 1800000 60000 14400000 Maximum time allowed
for a job to complete.
TaskMaxTime [ms] 300000 10000 14400000 Maximum time allowed
for a compression task to
complete. A job consists
of one or more
compression tasks.
UseThreadPoolForRequests false false true When CPU goes beyond
95% the thread pool may
respond with 25ms to
600ms latency. This may
have negative impact on
performance. Creating
UseThreadPoolForResponses false false true and garbage-collecting
threads may provide
better performance on
Windows machines in this
case.
SOCKET_LINGER_TIME [ms] 2000 0 30000 Socket linger time.
TransactionMaxInactive 900000 60000 720000 The Timeout interval for
Interval [ms] an inactive session that
has a pending database
transaction.
 30

SessionMaxInactiveInterval 720000 60000 720000 The Timeout interval for

[ms] an inactive session.

• From the performance tuning standpoint other sections of interest would be

o Threadpool
o FetchSize
• For debugging the following sections are of interest
o Log\HtmlLogger\Severity\SeverityLevel (the default is error. Setting
SeverityLevel to debug makes the log very verbose)

Starting and Stopping the Compression Server

The installer will start the Compression Server as a Win32 Local System service under
Tomcat. In the Windows Services applet, the display name is “Primavera Compression
Server TC.” In the Task Manager, you will see tomcat5.exe.

You can stop, pause or restart the Primavera Compression Server service using the
Action menu.
 31

Updating the version of the Compression Server

Configuration
During Compression Server installation, if you choose an existing configuration (for
example, Primavera Configuration), you will see the message displayed below. Click Yes
to upgrade the configuration.

You can also upgrade the configuration using the Administration application. Refer to
“Using the Compression Server Administration Application” earlier in this guide.

Note: Primavera strongly recommends that you create a new configuration when
you install the Primavera Compression Server. However, if you choose to update an
existing 5.0 SP1 or earlier configuration, complete the steps below.

If you choose to update an existing 5.0 SP1 or earlier configuration:

1. From the Start menu, choose Programs>Primavera>Compression

Server>Administrator.
2. Enter a valid username and password (e.g., privuser).
3. In the Administration application, expand the updated configuration.
4. Expand the CompressionServer folder.
5. Right-click on SocketLingerTime and choose Revert to default value.
 32

6. Click Save Changes.

7. Close the dialog.
8. Restart Primavera Compression Server TC in services dialog.

Compression Server Telemetrics

Primavera customers requested to have the following new features for compression
server.

1. To monitor overall health of compression server.

2. To monitor the health of each user’s session within the server.
3. To delete the selected user sessions in a Compression server by an administrator.
4. To set the compression server in a standby state for administration maintenance
purpose.

In order to meet these requests, the compression server is now deployed as a WAR file
under Tomcat web server. By going to the following site, you can view basic telemetrics
of the compression server: http://host:port/compressionserver/telemetry/summary

where host is the machine name of compression server

port is tomcat port by default 8080

You can login to an advanced control page with configurable username and password.
Default username and password are csadmin/csadmin. Password is case sensitive.

When a load balancer (specific for the user environment) requests following URL:

http://host:port/compressionserver/telemetry/summary?textfile=true

the load balancer gets summary page details in the same order as the summary page, with
memory in KB and all durations in ms.

Telemetry item descriptions

Summary page

Machine Name
The value is a string representing the compression server host name.

Standby
The value is a Boolean Yes/No representing the standby state of the compression server.
Note: The Standby state can be used in a load balancer.
 33

Available Memory
The value represents the amount of free memory in the Java Virtual Machine that runs
compression server.

Total Memory
The value represents the total amount of memory in the Java Virtual Machine that runs
compression server.

Number of Pending Transactions

The value represents the number of pending database transactions.

Number of Sessions
The value represents the total number of client sessions in the compression server.

Number of Active Sessions

The value represents the number of client sessions that have connections involved in
pending database activity.

Minimum Session Inactive Duration

The value represents the minimum duration of inactivity across all the client sessions at
the moment of page loading.

Maximum Session Inactive Duration

The value represents the maximum duration of inactivity across all the client sessions at
the moment of page loading.

Average Transaction Duration

The value represents the average time spent in database transactions across all the
existing client sessions since the start of compression server.

Maximum Transaction Duration

The value represents the maximum time spent in database transactions across all the
existing client sessions since the start of compression server.

Advanced Control page

Application Name
The value represents the name of the client application that uses a compression server
session.
 34

Client identifier
The value represents the client’s HDD serial number concatenated with the client’s IP
address.

Database Name
The value represents the SID used by the client’s database connection.

Database User Name

The value represents the user name used by the client’s database connection.

Average Transaction Duration

The value represents the average time the database connection spent in a transaction since
the session creation.

Minimum Transaction Duration

The value represents the minimum time the database connection spent in a transaction
since the session creation.

Pending Transaction Duration

The value represents the time spent by the database connection in the pending
transaction. If there is no pending transaction this value is 0.

Pending Request Duration

The value represents the time spent by the database connection for serving the current
client request. If there is no pending request this value is 0.

Inactive Duration
The value represents the elapsed since the end of serving the last client request.

Pending Request Data

The value represents the text of the latest request. If there is no pending request this value
is an empty string.

Put Compression Server in standby mode/Start Compression Server

A toggle link that changes the status of Standby mode of compression server on summary
page.
Note: The compression server can only be started from the Windows Services dialog.

Delete
Click to delete the selected compression server client sessions.

Logout
Click to logout of the advanced control page.
 35

Client Installation and Configuration

Installing Client Applications

Run the Primavera setup on your client machine and accept the default prompts to install
the Project Management module.

Changing Compression Server connection settings

• Instead of directly connecting to the PM database, the Project Management
module will be connected to a compression server, with the database specified
along with it. To configure the settings, you can run the DBConfig utility.
• The DBConfig utility for the Client is run during the Client installation. Choose
Start, Programs, Primavera, Help and Utilities, Database Configuration to run this
utility.

• Choose Configure My Database Connections.

 36

• Select the database alias you want to use for the Project Management database
(PMDB). Click Next.

• Select an alias name or type a new one in the Database Alias field. For example,
type PMDB _PE and select Primavera Compression Server from the Driver Type
list. (For a direct database connection, choose Either Oracle, Microsoft SQL
Server/MSDE.). Click Next.
 37

• Type the Database Instance Name of the database you want to access in the
Compression Server Database Name field, and the IP address of the Compression
Server machine in the Host Name/IP Address field. Note that we pick an instance
that has the oci connection string specified in the configuration.
• Make sure that the Database you choose here is configured as a Database Instance
by the Compression Server Administration application.
• You may type a different Port number, except 1521 which is used by an Oracle
database. Make sure the port you specified in the Compression Server
Administration Application is the same port you enter here. Compression server
listens by default on Port 80. You can change the port using the Compression
Server Administration Application.

In general, if you only use one Primavera Database and this was configured during
the Compression Server installation, you should not have any need to run the
Compression Server Administration Application to configure additional databases.
 38

• Next, you must validate your settings.

 39

• Click Next to test the database connection. If the connection isn’t successful,
click Previous to modify your settings.
• If prompted to configure Methodology Manager, click Cancel.
 40

Configuring database connections directly against

Oracle
• To configure new database connections either directly to Oracle or to the
Compression server, choose Start, Programs, Primavera, Help and Utilities,
Database Configuration, to run the database configuration utility.

• To configure the client against Oracle directly, run Database Configuration utility
until you reach the screen that specifies the database alias:

• Choose the Oracle Driver type. Next, enter the Oracle connection parameters
as you would have done in earlier Primavera versions.
 41

Configuring Application Licensing

• Use the client DBConfig utility to configure your application license. Choose
Start, Programs, Primavera, Help and Utilities, Database Configuration to run the
database configuration utility.