Professional Documents
Culture Documents
Administrator’s Guide
Copyright © Primavera 1999 - 2007. All rights reserved.
While reasonable efforts have been made to ensure the accuracy of this document, Primavera assumes no
liability resulting from any omission or inaccuracies in this document or from use of the information obtained
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. Primavera does not assume any
liability arising out of the application or use of any product described herein; neither does it convey license under
its patent rights or the rights of others.
Computer Software Copyrights: The Primavera software products described in this document may not be
copied, reproduced, modified, or distributed in any manner without Primavera's express written permission.
Use and Disclosure Restrictions: The software described in this document is the property of Primavera
Systems. It is furnished under a license agreement and may be used and/or disclosed only in accordance with the
terms of the agreement.
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. The Software and accompanying documentation are “commercial computer software” and
“commercial computer software documentation,” respectively, pursuant to 48 C.F.R. 12.212 and 227.7202, and
“restricted computer software” pursuant to 48 C.F.R. 52.227-19(a), as applicable. Use, modification, repro-
duction, release, performance, display or disclosure of the Software and accompanying documentation by the
U.S. Government are subject to restrictions as set forth in this Agreement and pursuant to 48 C.F.R. 12.212,
52.227-14 (Alternate III), 52.227-19, 227.7202, and 1852.227-86, as applicable.
Trademarks: Primavera, the Primavera sundial logo, P3, P3e, P3e/c, Primavera Enterprise, Primavera Evolve,
Primavera Expedition, Primavera Project Planner, Primavera TeamPlay, Primavision, PrimeContract, and
SureTrak are either trademarks, registered trademarks, or service marks of Primavera in the United States and/or
in other countries. All other trademarks mentioned herein are the property of their respective owners.
Certain products included in the software require the following disclosures:
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and limitations under the License.
*****
Copyright (c) 2000 The Apache Software Foundation. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
following conditions are met:
1 Redistributions of source code must retain the above copyright notice, this list of conditions and the
following disclaimer.
2 Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the
following disclaimer in the documentation and/or other materials provided with the distribution.
3 The end-user documentation included with the redistribution, if any, must include the following acknowl-
edgment:
"This product includes software developed by the Apache Software Foundation
(http://www.apache.org/)."
Alternately, this acknowledgment may appear in the software itself, if and wherever such third-party
acknowledgments normally appear.
4 The names "Apache" and "Apache Software Foundation" must not be used to endorse or promote products
derived from this software without prior written permission. For written permission, please contact
apache@apache.org.
5 Products derived from this software may not be called "Apache", nor may "Apache" appear in their name,
without prior written permission of the Apache Software Foundation.
THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE
SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
THE POSSIBILITY OF SUCH DAMAGE.
*****
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
following conditions are met:
■ Redistribution of source code must retain the above copyright notice, this list of conditions and the
following disclaimer.
■ Redistribution in binary form must reproduce the above copyright notice, this list of conditions and the
following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of Sun Microsystems, Inc. or the names of contributors may be used to endorse or promote
products derived from this software without specific prior written permission.
This software is provided "AS IS," without a warranty of any kind. ALL EXPRESS OR IMPLIED CONDI-
TIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE
HEREBY EXCLUDED. SUN MICROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL NOT BE
LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN OR ITS
LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT,
SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND
REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF OR INABILITY TO
USE THIS SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES.
You acknowledge that this software is not designed, licensed or intended for use in the design, construction,
operation or maintenance of any nuclear facility.
*****
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
following conditions are met:
■ Redistributions of source code must retain the above copyright notice, this list of conditions and the
following disclaimer.
■ Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the
following disclaimer in the documentation and/or other materials provided with the distribution.
■ Neither the name of JGoodies Karsten Lentzsch nor the names of its contributors may be used to endorse or
promote products derived from this software without specific prior written permission.
*****
Table of Contents
Preface............................................................................................... xiii
Using the Administrator’s Guide....................................................................... xiv
Primavera Documentation ................................................................................. xvi
Where to Get Support ...................................................................................... xviii
Preface
Primavera provides comprehensive, multi-
In this preface project planning and control software, built on
Microsoft SQL Server and Oracle databases
Using the Administrator’s Guide
for organization-wide project management
Primavera Documentation
scalability. Smaller multiuser or stand-alone
Where to Get Support
installations can use Microsoft SQL Server
2005 Express. The Primavera solution includes
the Project Management module, which can
stand alone for project and resource
management or be used with companion
products. Timesheets enables Web-based team
communication and time keeping; the Method-
ology Management module stores methodol-
ogies as templates for new projects;
Primavera’s Web application provides project
analysis across the organization and allows
users to access project management data via
the Internet.
You can also import data from the Contract Manager module to
the Project Management module. Refer to the “Linking the
Project Management and Contract Manager Modules” chapter
of the Project Management Reference Manual or the “Linking
Contract Manager module data” topic in the Project
Management Help.
Primavera Documentation
Primavera documentation consists of printed and online manuals. You can
access online documentation by inserting the Primavera Documentation
CD (CD 3) in your workstation’s CD drive. In the \Documentation folder
on the CD-ROM, open the appropriate industry-specific documentation
folder, then double-click the applicable PDF file to view the information
using Adobe Acrobat Reader (available on CD 3). The following table
describes each manual and lists the recommended readers by role.
Primavera roles are described in “Installation Process Overview” on
page 3 of this manual.
Title Description
Primavera Administrator’s This guide explains how to set up the Primavera server, database, and components;
Guide it also provides an overview of all the components in the Primavera solution. The
guide describes the workflow required to administer the Project Management
module, including setting up security and configuring global preferences. The
Project Management module network administrator/database administrator and
project controls coordinator should read this guide.
Project Management Reference This guide explains how to plan, set up, and manage projects in a multiuser
Manual environment. If you are new to the Project Management module, start with this
guide to learn how to use the software effectively to plan and manage projects.
When you need more detail, refer to the Project Management Help. The project
controls coordinator, program manager, project manager, resource/cost manager,
and team leader should read this guide.
Methodology Management This guide explains how to establish methodologies, or project templates, using
Reference Manual the Methodology Management module. Methodologies enable your organization
to gather its “best practices” and reuse them to create custom project plans in the
Project Management module. If you are new to the Methodology Management
module, start with this guide to learn how to use the software to create base, plug-
in, and activity library methodologies. When you need more detail, refer to the
Methodology Management Help. The project controls coordinator, program
manager, project manager, resource/cost manager, and team leader should read
this guide.
Primavera’s Web Application Primavera’s Web Application Help describes how to create and manage projects,
Help group projects into portfolios, review resource allocation and requirements, and
evaluate budget, performance and ROI for project portfolios. The operations
executive, project controls coordinator, program manager, project manager,
resource/cost manager, and team leader should read this Help.
Timesheets Web-based Help Timesheets Web-based Help describes how to use Timesheets to enter and update
time spent on assignments. Team members should read this Help.
Software Development Kit (SDK) This documentation describes how to use the SDK to connect to the project
Web-based documentation management database. The tables, fields, and stored procedures that you can
access through the SDK are described. Examples are also provided to show how
you can use the SDK to perform several basic tasks, such as creating a new project
or assigning a resource to a project activity. The Project Management network
administrator/database administrator and project controls coordinator should read
this documentation, which is available in your \Program Files\Common
Files\Primavera Common\PMSDK\Doc folder. Double-click the INDEX.HTML
file to open the Table of Contents page.
ProjectLink Help Describes how to use ProjectLink to enable Microsoft Project (MSP) users to
work in the MSP environment while being connected to Primavera's enterprise
features. MSP users can learn how to open/save projects from/to the Project
Management module database from within the MSP application and how to
invoke Primavera's resource management within the MSP environment. Team
members that utilize MSP for daily project maintenance in organizations that use
Primavera for enterprise-wide project planning and control should read this help.
Projects
Portfolios
Methodologies
Documents
For details on the You are not required to install the server-based components as shown here.
configuration requirements of For example, Primavera’s Web application and the collaboration server
each component, see
“Planning Your can be installed on the same server (if necessary), and Job Services can run
Implementation” on page 11. on any computer with a constant connection to the project database.
The planning phase is Phase 1: Plan your Primavera configuration Before you begin the
covered in this part of installation, decide how your organization will implement the Primavera
this guide.
solution. Identify the servers and network hardware you will need to
support the implementation. Install and configure the third-party database
server software (Oracle or Microsoft SQL Server), if necessary. Perform
any upgrade procedures as needed to roll projects from previous versions
into the new version. If you simply will be installing a stand-alone version,
refer to “Installing and/or Upgrading the Stand-Alone Version” on
page 287.
Automatic and manual Phase 2: Configure your Primavera servers Once you have set up
configuration of the databases your network and prepared your servers, you can begin to configure the
is covered in Part 2 of this
guide. servers. Start by setting up the project management and methodology
management databases on the database server. You can choose an
automated or a manual method to complete this process. If you are using
SQL Server Express, you should follow the automated process.
The client module Phase 3: Configure your Primavera client modules Once your
configuration phase is servers are configured and the databases are installed, you can begin to
covered in Part 4
of this guide. install the Primavera client modules on your client workstations according
to your implementation plan. You can then install and configure additional
components as needed for your implementation.
To run the Web Browser version, users simply visit a specified URL, and
the Java applet automatically downloads to their computers; the applet can
then be run in their Web browsers. When many users will need to use
Timesheets, running it as a Java applet can provide great administration
time savings—no client-side installation is required, and software updates
are automatically distributed. The primary disadvantage may be the initial
download time for the applet, which can take up to 20 minutes over a slow
modem connection.
Java Web Start version Timesheets Java Web Start version performs
the same function as the Web Browser version, but this version runs as a
Java application.
The following table lists each client component and the corresponding
server-based components that it requires.
Timesheets 9 9
3
Primavera’s Web Appli- 9 9 9 9
cation
Minimum Client For clients running the Project Management and Methodology
Configurations Management modules
■ 1 x 2.8 GHz or higher Intel processor
■ 1 GB of available RAM or more
■ If installing standalone modules, 575 MB of available hard-disk space
for supporting software, including .NET and SQL Server 2005
Express with Advanced Services (SP2). If upgrading from a prior
release, an additional 40MB of available hard-disk space per module.
■ If installing the Project Management module, 185 MB of additional
hard-disk space
■ If installing the Methodology Management module, 45 MB of
additional hard-disk space
■ Microsoft Internet Explorer 6 (SP2) or 7
■ TCP/IP network protocol
Job Service must run on Windows 2000 Server (SP4) or Windows 2003
Server (SP1).
Oracle
Oracle
Recommended
File
Size
Total 750 MB
Recommended
File
Size
Data 300 MB
Total 450 MB
Overview
Two databases are used to run Primavera:
■ The project management database (PMDB) stores the Project
Management data used by Primavera. It is a required database.
■ The methodology management database (MMDB) stores the
methodologies that can be used as templates when creating new
projects. You must install this database if you will be using the
Methodology Management module.
If you need detailed steps Primavera supports Oracle, Microsoft SQL Server, and Microsoft SQL
on installing Oracle for the Server Express databases. The MS SQL Server or Oracle server software
server and client, or SQL must be installed on the database server(s) before you can create the
Server for the server, database.
contact Primavera
Customer Support.
You can run the database wizard to automatically create a database
structure and load application data into it; or, you can manually configure
the database structures and then run the database wizard to load the
application data.
For additional tips and Oracle considerations Before installing the Primavera database,
considerations related to consider the following:
database performance along
with additional settings, refer
to “Database Administration” ■ If you intend to run Primavera on an Oracle database server, the
on page 57. Oracle client must be installed on each machine that will be accessing
the database server.
■ When you install the Oracle client, the TNSPING.EXE utility is
automatically installed in the \oracle\<ora_home>\bin folder. This
utility must be present for Primavera applications. Do not delete it.
■ Oracle must be run in Dedicated Mode (rather than MTS mode).
■ If you need to use the Euro symbol in any Western European
language, you must use codepage WE8MSWIN1252 or UTF8.
You can run the Database wizard to create a new database from a client
computer or from the server itself. The Database wizard creates any
necessary file structures and users for you.
Run the Database wizard twice: first to create the database structure and
load data for the project management database, then again for the
methodology management database.
11 On the Configure Oracle Users dialog box, accept the default names
for the Oracle administrative user, privileged user, and public user, or
specify the appropriate names. If necessary, choose a different default
tablespace and temporary tablespace from the dropdown list.
You can choose a default tablespace from the dropdown list in the
Default Tablespace field. In the Temporary Tablespace field, use the
temporary tablespace that you created prior to starting this procedure.
13 On the Load Application Data dialog box, click Next to start the
process of loading the database tables with application data.
When the process has completed, the message “Data Loading
Completed” appears. Click Finish to exit the wizard.
15 Run the Database wizard again if you will be using the Methodology
Management module.
Once both sets of application data are installed (Project Management and
Methodology Management), you can begin to install client modules and
additional components. Refer to Part 3 and Part 4 for more information on
configuring the servers and installing client module(s) and additional
components.
Do not use a dash (-) in the database name; it will cause errors.
The data file contains the database tables and procedures. The log file
contains a record of changes. By default, the Database wizard stores
these files in the folder on your server where Microsoft SQL Server is
installed. The database name that you specify is used to name the
files. If you change the location, the destination folder must exist on
the server.
11 On the Load Application Data dialog box, click Next to start the
process of loading the database tables with application data.
When the process has completed, the message “Data Loading
Completed” appears. Click Finish to exit the wizard.
12 Run the Database wizard again if you will be using the Methodology
Management module.
Once both sets of application data are installed (project management and
methodology management), you can begin to install client modules and
additional components. Refer to Part 3 and Part 4 for more information on
configuring the servers and installing client module(s) and additional
components. For information on configuring database settings to optimize
performance, refer to “Database Administration” on page 57.
Overview
Two databases are used to run Primavera:
■ The project management database (PMDB) stores the Project
Management data used by Primavera. It is a required database.
■ The methodology management database (MMDB) stores the
methodologies that can be used as templates when creating new
projects. You must install this database if you will be using the
Methodology Management module.
If you need detailed steps Primavera supports Oracle, Microsoft SQL Server, and Microsoft SQL
on installing Oracle for the Server Express databases. The MS SQL Server or Oracle server software
server and client, or SQL must be installed on the database server(s) before you can create the
Server for the server, database.
contact Primavera
Customer Support.
When you install the Oracle client, the TNSPING.EXE utility is
automatically installed in the \oracle\<ora_home>\bin folder.
This utility must be present for Primavera applications. Do not
delete it.
You can also use a wizard These instructions assume you are an Oracle DBA or are familiar with
that automatically creates administering Oracle databases.
the database structures
and loads the data for you. Create the PMDB Oracle database structures
Refer to “Automatic
Database Install” on 1 Copy the ORPM_INS.SQL script to a local folder.
page 27 for more The script is located on CD 1 in the \install\database\scripts\install\or
information. folder. You must copy the script to a local drive so it can be edited.
Once the database structures are created, you can install the application
data in the PMDB database as described in “Installing the Application
Data (Oracle and Microsoft SQL Server)” on page 53.
If data exists, you must drop the objects in the order they are listed. The
results of each script are spooled to a file with an .LST extension.
For example, ORDP_TAB.LST contains the results of the SQL script of
that name.
Once the database structures are created, you can install the application
data in the MMDB database as described in “Installing the Application
Data (Oracle and Microsoft SQL Server)” on page 53.
If data exists, you must drop the objects in the order they are listed. The
results of each script are spooled to a file with an .LST extension. For
example, ORDM_TAB.LST contains the results of the SQL script of that
name.
See “Client and Server Primavera supports Microsoft SQL Server 2000 and Microsoft SQL
Requirements” on page 16 for Server 2005. These instructions assume you are a DBA or are familiar
more detailed information.
with how to administer Microsoft SQL Server databases.
Before you create the Microsoft SQL Server database structure, you
should first register to the server as a system administrator (SA) and
review the following server-level configuration changes in the Microsoft
SQL Server Enterprise Manager:
■ Max Worker Threads Specify the number of threads used to
support the users connected to the server. The default setting (255)
may be too high for some configurations, depending on the number of
concurrent users. Each worker thread is allocated, even if it is not in
use, which means that if there are fewer concurrent connections than
allocated worker threads, you could be wasting memory resources.
■ Memory Keep the setting as Dynamic. Microsoft SQL Server
dynamically acquires and frees memory as needed, up to the
maximum available memory on your server.
■ Open Objects Keep the setting as Dynamic. This setting determines
the maximum number of objects that can be opened concurrently on
Microsoft SQL Server. The value is set automatically depending on
current system needs. You should not need to change this value.
■ User Connections Keep the setting as 0, which designates Microsoft
SQL Server to adjust the number of simultaneous user connections
allowed based on how many are needed, up to the maximum value.
■ Network Packet Size Set to 16384.
After configuring the server, stop and start Microsoft SQL Server to
ensure that the changes take effect.
Once the database structures are created, you can install the application
data in the PMDB database as described in “Installing the Application
Data (Oracle and Microsoft SQL Server)” on page 53.
You must connect to the server as SA to drop objects. Before running each
script, copy the scripts to a local drive, turn off the read-only attribute of
each file, and edit each script to replace the ??DATABASE_NAME??
parameter in the USE statement with the name of your database (for
example, PMDB). If data exists, you must run the scripts in the order
listed.
Once the database structures are created, you can install the application
data in the MMDB database as described in “Installing the Application
Data (Oracle and Microsoft SQL Server)” on page 53.
You must connect to the server as SA to drop objects. Before running each
script, copy the scripts to a local drive, turn off the read-only attribute of
each file, and edit each script to replace the ??DATABASE_NAME??
parameter in the USE statement with the name of your database (for
example, PMDB). If data exists, you must run the scripts in the order
listed.
Perform these steps twice: first load the data for the project management
database (PMDB), then perform these steps again to load the data for the
methodology management database (MMDB).
After you click Next, the process of clearing the database tables (if
they already exist) and loading them with data starts.
When the data is loaded, the message “Data Loading Completed”
appears.
Once both sets of application data are installed, you can begin installing
other Primavera components and client modules.
Database Administration
Read this chapter to learn how to configure the
In this chapter job scheduler supplied by your RDBMS, how
to optimize performance of your Oracle and
Background Processes and
Cleanup in Version 6.0 SQL Primavera databases, and how to
Configuring the RDBMS configure the native database auditing feature
Scheduler to monitor edits, deletions, and additions to the
Setting Table databases.
Tracking Background Job
Execution
SYMON (System Monitor)
DAMON (Data Monitor)
Improving Oracle Database
Performance
Native Database Auditing
RDBMS Scheduler Since the background jobs are initiated by the job
scheduler supplied by the RDBMS, you need to ensure that the scheduler
for your specific RDBMS is properly configured. See “Configuring the
RDBMS Scheduler” on page 59 for the configuration parameters for your
RDBMS.
SQL Server
The SQL Server 2000 and 2005 jobs use the SQL Agent to schedule jobs.
If you are using SQL Server 2000 or 2005, verify that the SQL Server
Agent service is started on the server and has a startup type of automatic.
Setting Table
Settings Table Overview
The settings table contains name-value pairs that configure the behavior of
the background processes.
■ String. The string data type is a free text value. The most common
string sub-type is interval which represents an interval of time by
combining a numeric portion with a unit portion as depicted in the
table below.
Interval Subtype
■ Namespace: database.cleanup.Usession
■ Setting Name: ExpiredSessionTimeout
■ Value: 2h (two hour interval)
SETTINGS_WRITE_STRING(new value,namespace,settings_name);
The following code snippets for Oracle and SQL server databases
demonstrate how this procedure is used to set the value of the
ExpiredSessionTimeout setting to twelve hours:
Monitoring the High Level Status Settings Each time a job is run
it will update the SETTINGS table for the
setting_name = 'HeartBeatTime.' The job may update this value multiple
times during the execution. The maximum difference between this time
and the current date can be monitored to assure that the job is running
promptly. Refer to the High Level Status Settings table below for
information about the HeartBeatTime setting.
Namespace database.background.Symon
Namespace database.background.Damon
Inspecting the BGPLOG Table You can also track the execution of
background jobs by inspecting BGPLOG table. The BGPLOG table holds
detailed entries from the background processes including informational,
elapsed time, and error entries. Refer to the BGPLOG Table Descriptions
for information about what this table contains.
For example, setting the value to "2d" deletes expired sessions older than
two days.
USESSION_CLEANUP_EXPIRED Settings
Setting Description: Time-out period for normal sessions.
Namespace database.cleanup.Usession
Default Setting 2h
Type Interval
Setting Description: Time-out period for long running sessions based on the
function preformed in the application (i.e. Scheduling, Leveling, Summarizing,
etc.).
Namespace database.cleanup.Usession
Type Interval
Refer to the following table for information about the settings associated
with the BGPLOG_CLEANUP procedure.
BGPLOG_CLEANUP Settings
Setting Description: The oldest records to keep in the BGPLOG table.
Namespace database.cleanup.BackGroundProcessLog
Default Setting 5d
Type Interval
Refer to the following table for information about the settings associated
with the REFRDEL_CLEANUP procedure:
REFRDEL_CLEANUP Settings
Setting Description: The oldest records to keep in the REFRDEL table.
Namespace database.cleanup.Refrdel
Default Setting 5d
Type Interval
Setting Description: Determines whether the procedure will delete all of the
REFRDEL records possible on each pass.
Namespace database.cleanup.Refrdel
Type Boolean
REFRDEL_CLEANUP Settings
Setting Description: Determines whether all of the records are cleaned up.
If the total record count is less than this number then all the records are cleanup
up.
Namespace database.cleanup.Refrdel
Type Numeric
Namespace database.cleanup.Refrdel
Type Numeric
Namespace database.cleanup.Refrdel
Type Numeric
Refer to the following table for information about the settings associated
with the OBSPROJ_PROCESS_QUEUE procedure.
OBSPROJ_PROCESS_QUEUE Settings
Setting Description: Maximum project-level queue records to process on
each run.
Namespace database.obsproj.queue
Type Numeric
Namespace database.obsproj.queue
Default Setting 25
Type Numeric
Namespace database.obsproj.queue
Default Setting 50
Type Numeric
Refer to the following table for information about the settings associated
with the CLEANUP_PRMQUEUE procedure:
CLEANUP_PRMQUEUE Settings
Setting Description: The oldest records to keep in the PRMQUEUE table.
Default is five days.
Namespace database.cleanup.Prmqueue
Default Setting 5d
Type Interval
Setting Description: Determines whether the procedure will delete all of the
PRMQUEUE records possible on each pass.
Namespace database.cleanup.Prmqueue
Type Boolean
Setting Description: Determines whether all of the records are cleaned up.
If the total record count is less than this number then all the records are cleanup
up.
Namespace database.cleanup.Prmqueue
Type Numeric
CLEANUP_PRMQUEUE Settings
Setting Description: Percentage of records to delete on each pass.
Namespace database.cleanup.Prmqueue
Type Numeric
Namespace database.cleanup.Prmqueue
Type Numeric
Refer to the following table for information about the settings associated
with the CLEANUP_LOGICAL_DELETES procedure:
CLEANUP_LOGICAL_DELETES Settings
Setting Description: The oldest logically deleted records to keep in tables.
Namespace database.cleanup.LogicalDelete
Default Setting 5d
Type Interval
Setting Description: Determines whether the procedure will delete all of the
logically deleted records possible on each pass.
Namespace database.cleanup.LogicalDelete
Type Boolean
CLEANUP_LOGICAL_DELETES Settings
Setting Description: Maximum rows to delete on each pass.
Namespace database.cleanup.LogicalDelete
Type Numeric
Refer to the following table for information about the settings associated
with the PRMAUDIT_CLEANUP procedure:
PRMAUDIT_CLEANUP Settings
Setting Description: Should the procedure attempt to clean up PRMAUDIT
records.
Namespace database.cleanup.auditing
Type Boolean
Namespace database.cleanup.auditing
Type Interval
Refer to the following table for information about the settings associated
with the CLEANUP_USESSAUD procedure:
CLEANUP_USESSAUD Settings
Setting Description: The oldest records to keep in the USESSAUD table.
Namespace database.cleanup.Usessaud
Default Setting 5d
Type Interval
Namespace database.cleanup.Usessaud
Type Boolean
Setting Description: Determines whether all of the records are cleaned up.
If the total record count is less than this number then all records are cleanup up.
Namespace database.cleanup.Usessaud
Type Numeric
CLEANUP_USESSAUD Settings
Setting Description: Percentage of records to delete on each pass.
Namespace database.cleanup.Usessaud
Type Numeric
Namespace database.cleanup.Usessaud
Type Numeric
Auditing Levels
Level Description
Level 0 No audit.
Level 3 Full Audit. Audit changes to the data at the column level.
For Oracle, column level changes to blobs are audited.
For SQL server, column level changes to blobs are not
included.
Simple Configuration
There are two configuration procedures available that provide for the
simple control of the auditing feature:
■ auditing_enable(<table_name>, <level>)
■ auditing_disable(<table_name>)
These procedures allow for setting the audit level on an individual table or
the same audit level for all of the tables. However, the simple
configuration procedures do not allow for setting individual auditing levels
for insert, update, or delete operations within a table.
exec auditing_enable(null,3);
The following code snippet enables level one auditing on the task table:
exec auditing_disable(null);
Detailed Configuration
You can configure auditing trigger behavior by changing values in the
settings table that enable or disable the following auditing features:
Operation
0 0 0 No audit.
The following table provides some example uses of the options setting:
Oracle Example: To set the table settings to fully audit insert and
update operations but ignore any delete operations, use the following code
for Oracle:
PRMAUDIT Table
Session Auditing
Activity for the USESSION table is audited with its own trigger and table.
When an application user logs out of the system they logically delete, or
mark, their session record in the USESSION table. One record is written
to the USESSAUD table for each logout. The format of the USESSAUD
table mirrors that of the USESSION table. This audit can be enabled using
the usessaud_enable procedure and disabled using the usessaud_disable
procedure.
Data in the two audit_info columns has a specific format. Each column
audit within the data begins with either ":O" (old data) or ":N" (new data)
to distinguish between the audit of the previous (old) or the changed (new)
value (for BLOB columns the data starts with :BLOBO or :BLOBN).
Directly after this is the name of the column in lowercase. Following the
column name is the length of the audited value in a fixed four character
field. Finally the actual data is placed in the audit record. Updates will
have both an old and new value for each change. Inserts will have only a
new value and deletes only an old value.
The following is an example of the audit record for a change to the TASK
to change the task_code from 'A1010' to 'B102:'
For more information about Java Web Start Java Web Start provides a secure and platform-
Java Web Start, visit the independent deployment of Timesheets using Java Network Launching
http://java.sun.com Web Protocol (JNLP) technology. Java Web Start also ensures that users always
site. launch the most recent version of Timesheets under the correct client-side
JRE version, even if there is more than one JRE version present.
Before performing these steps, you must have already set up the central
project management database.
4 On the Enter Product Key screen, enter the product key located on
the CD 1 label.
5 On the Welcome! dialog box, click Next.
6 On the Choose Components dialog box, choose the components you
want to install. Mark both checkboxes to install the Group Server and
Timesheets Web site on the same server. If you choose to install only
the Group Server, skip to step 10.
7 On the Choose Language dialog box, choose to install Timesheets in
any of the languages listed.
8 On the Choose Web Destination Location dialog box, click Browse
to specify a destination folder for the Web files.
The files will be installed in a folder named \GroupServer\en. If you
chose not to install the Group Server, skip to step 12.
9 On the Help URLs dialog box, specify the location of the Timesheets
Help web site.
You can change the web site values later by manually editing
the proper files. For the Java Web Start version of Timesheets,
edit the timesheet.jnlp file in the \GroupServer\App folder. For
the applet version, edit the erps8x6.html in the
\GroupServer\en folder.
10 On the Choose Database Type dialog box, select the database type.
The database must already be installed and configured.
11 On the Enter Database Parameters dialog box, specify the database
connection parameters.
• The database user name must be a privileged user (for example,
privuser).
• If connecting to Oracle, an Oracle DSN need not be predefined.
Enter the Oracle Service Name (for example, PMDB), which
may have been defined using Oracle’s Net Configuration
Assistant, or refer to your TNSNAMES.ORA file located in
\Oracle_Home\Network\Admin.
• If connecting to Microsoft SQL Server, enter the SQL Server
Database Machine Name, which is the name of the computer on
which the Microsoft SQL Server database is running. In the
Database Schema Name field, type the name of the database
specified when the Microsoft SQL Server database was created,
such as PMDB.
14 If you chose Socket in step 13, the Server Information dialog box is
displayed.
• In the Server Name field, type the name of the computer running
the Group Server.
• In the Port Number field, accept 9002 as the port number, or
specify a port number greater than 1024.
This number is used with the IP address to create a Windows
socket (Winsock) connection between the Timesheets client and
the Group Server. If your organization uses a firewall, this port
must be opened for Internet use.
If you use a port number other than 9002, you must edit the
web.xml file, as described later in this chapter (page 103).
Setup is now complete. You can run the Group Server Administrator to
review or modify additional configuration settings, as described in
“Configuring Group Server Settings, page 108.
Web Server
3 On the Server Information dialog box, specify the URL for the
Group Server servlet, which depends on the application server being
used and its configuration.
For normal transmission using the HTTP protocol, enter http and the
port number to which you have configured your Java application
server to service http requests. Use the following format
: http://<Java app server:port number>/GroupServer/GroupServer.
For example, the URL for a default Tomcat installation is
:http://<tomcat_server_name:8080>/GroupServer/GroupServer
You can manually change the For secure transmission using the HTTPS protocol, enter https and the
URL after Setup by editing port number to which you have configured your Java application
the erps8x6.html file in the
\GroupServer\Language server to service https requests.
folder.For more information,
seepage 102. The default secure port on Tomcat is 8443. In this case, for example,
specify the secure URL as,
:https://<tomcat_server_name:8443>/groupserver/groupserver.
Edit the erps8x6.html File To change the URL specified for the
Group Server servlet during installation, edit the erps8x6.html file as
follows. The erps8X6.html file is located in the language folder within the
Group Server install location. For example, for English, the location is
GroupServer/en/erps8X6.html.
Before:
type=magnus-internal/cgi exts=cgi,exe,bat
After:
type=magnus-internal/cgi exts=cgi,bat
Edit the web.xml File If either of the following conditions exists, once
the GroupServer.war file has been expanded, you must edit the web.xml
file.
■ the Primavera Group Server and Java application server do not reside
on the same machine
■ the Primavera Group Server is not using port number 9002
The web.xml file is located in the \groupserver\WEB-INF folder.
Configure the server and port number to point to the Group Server. This is
the location of the TPGS service that is configured during the initial setup.
<init-param>
<param-name>server</param-name>
<param-value>TPGS_server_name</param-value>
</init-param>
<init-param>
<param-name>port</param-name>
<param-value>9002</param-value>
</init-param>
var ServerName=' ' (unused - this is specified in the web.xml in the Group
Server servlet)
var ServerPortNum=9002 (unused - this is specified in the web.xml in the
Group Server servlet)
var DebugLevel=0;
var Protocol='http';
The URL line in the erps8X6.html file identifies the Web server/port
number that is being protected by SiteMinder. It is through this URL that
the timesheet applet communicates with the GroupServer servlet. For
Single Sign On, all requests for this URL go through the SiteMinder agent
that is running on the Web server. In the Web server, you must configure a
virtual directory to redirect requests received on the virtual directory to the
Group Server servlet.
SiteMinder requires yourfullyqualifiediPlanetservername to be a fully
qualified domain name that can be looked up in a DNS.
If you need to take the server offline to perform system maintenance, click
Take Off-Line.
The Take Off-Line Options dialog box displays the number of users
currently connected to the server. Choose whether to wait for the last user
to exit from Timesheets before taking the server offline automatically, or
specify a number of minutes to wait before the server is taken offline.
When you choose either option, no new users can start Timesheets.
You can type @TIME in the Mark the Send Message to Logged in Users checkbox and type a message.
body of the message, You can specify how often to resend the message. Once the Group Server
which will automatically is offline, all client connections are terminated and future connection
report the amount of time requests are denied.
remaining before the
server goes offline.
For an explanation of each Mark the Show Advanced Properties checkbox to show additional
property and its location in properties that you can change. You should not change these properties
the system registry, see
“Group Server Configuration casually; incorrect settings may prevent the server or operating system
Settings” on page 118. from working properly.
You must first close the TPGS Administrator, then stop and
restart the Group Server (TPGS) service for changes to take
effect.
The Users tab displays the active user names. Click Refresh to refresh the
list of users connected. Click Disconnect User(s) to immediately
disconnect the currently selected user. You can also send a message to one
or more users, for example, a notification before you disconnect them.
Select each user name in the Users area, then type a message in the
Message field at the bottom of the screen. Click Send Message.
To learn how to run How does Java Web Start work? Java Web Start can launch a Java
Timesheets after Java Web application stored on a server by presenting a link in an HTML page to the
Start has been configured,
refer to “Running Timesheets user. When the user clicks the link on the HTML page, Java Web Start
Web Browser Version and detects whether the user has the correct JRE version installed and the most
Java Web Start Version” on recent version of Timesheets cached. If not, Java Web Start automatically
page 393.
downloads the necessary files, then launches Timesheets from the user’s
machine. This enables the user to run the most recent version of
Timesheets with the required version of the JRE without performing a
manual upgrade process. By temporarily hiding, but not overwriting other
versions of the JRE, Java Web Start ensures that other applications that
need those JRE versions will still run.
Java Web Start allows you to launch more than one instance of
Timesheets at the same time. Previously, Timesheets did not
allow multiple instances running at the same time.
.jnlp application/x-java-jnlp-file
Changing the Java Web Start URL If you change the original Java
Web Start URL (for example, to move the Java Web Start Web site), you
have to edit the URL manually in the following three files:
■ Timesheet.jnlp
■ Tsres.jnlp
■ Download.html
Troubleshooting
■ Remember that Apache URLs are case sensitive, even if the user has a
Windows client that does not differentiate.
■ For non-Windows clients, the server IP address has to be mapped to
the server name in the host file.
■ For Windows clients, if the URL with the server name is not
recognized (you see the content of the JNLP file), use the server IP
address in the URL or add an entry for the server in host file.
Select an instance,
then use these tabs
to view properties/
users for that
instance.
Create a new instance Click the New Instance button and specify its
properties. Type an instance name, description, unique port number, and
your privileged administrative database user name and password.
For Oracle:
Provider=OraOLEDB.Oracle;Data Source=Oracle Service Name
For Microsoft SQL Server:
Provider=SQLOLEDB; Data Source=MachineName; Initial
Catalog=DatabaseSchemaName
You can define the Oracle Service Name using Oracle’s Net
Configuration Assistant, or you can refer to your TNSNAMES.ORA file
located in \Oracle_Home\Network\Admin.
Once a new instance is created, it appears in the Services dialog box. You
can start or stop the instances from the Services dialog box. A new
instance has a Manual startup property (does not start automatically after a
reboot).
Set up the Web site for a new instance You must create a new
Timesheets Web site for each new instance. Once a new Group Server
instance is set up in the TPGS Administrator, you must copy the
Timesheets Web site to enable clients to connect to the new instance. For
example, copy the GroupServer Web site folder to a new name,
GroupServer2.
In the GroupServer2 folder, edit the erps8x6.html file to update the port
number. For example, by default, the original Group Server instance has a
port number equal to 9002. In the erps8x6.html file, change the
ServerPortNum variable to match the port number of the newly created
instance (9003), as shown.
Clients can visit the original instance by visiting the index.html file in the
GroupServer folder; clients can visit the newly created instance by visiting
the index.html file in the GroupServer2 folder.
Allow Negative Actuals Yes/No Allow negative actuals when calculated. No - Disallow. Yes -
Allow.
Cycle Seed Yes/No Controls whether or not to cycle the seed used for password
encryption. A seed is a unique, random numeric value, used to
make each encrypted password unique. Set to No when load testing,
where login requests need constant encrypted password values.
Edit Subordinate Yes/No Allow supervisor to modify subordinate resources’ timesheets.
Resources’ Timesheets
Edit Work Product and Yes/No Allow editing of public document path in the Work Product and
Document Details Document Details dialog box in the timesheet client.
Enable Performance Sets Performance Monitor counters based on TPGS server activity.
Counters Use the Windows Performance Monitor utility to view TPGS
performance counters.
Enable Primary Resource to Yes/No If Y, overrides OBS access to edit step’s UDF values. Gives edit
Edit Step’s UDF Values rights to primary resources.
Counters If N, steps can be edited if user has OBS access to the project. The
default value is N.
Greeting Sets the message that appears in the client when first connected to
the TPGS server.
LDAP Connect Timeout 15 The maximum amount of time Group Server will allow for a
connection attempt to an LDAP data store to succeed. This is only
used if the Group Server is configured for LDAP authentication.
Maximum Auto-Fetch Size 2048 Maximum size of blobs (notes/memos) in bytes that will be sent
(bytes) automatically in low bandwidth mode.
Maximum Request Size Largest client TCPIP request that will be accepted by TPGS server.
Port 9002 Sets the TCP/IP port number used by the Group Server to commu-
nicate with the Java client. This port must be opened to the Internet,
or you can change this setting to specify another port that is open to
the Internet. The default value is 9002.
Startup Wait Period 0 Amount of time the TPGS service delays before starting. Use this
(seconds) setting if dependent services (such as a database server service)
need time to start first.
User Inactivity TimeOut 600 Amount of time in seconds a connection can remain idle before
Period being logged off. The default value is 600.
ADO Connection TimeOut 15 Amount of time to wait while establishing a connection before
(seconds) terminating the attempt and generating an error message.
ADO Command TimeOut 30 Amount of time to wait while executing a command before termi-
(seconds) nating the attempt and generating an error message.
ADO RecordSet Cache Size 5 The number of records stored in memory at any given time.
ADO Stalled Check Period 30 Frequency with which the connection is checked for stalled opera-
(seconds) tions.
Apply Session Setting Yes/No Determines whether to execute the SQL command specified in the
Session Setting property. The default value is No.
Auto Translate Yes/No The Auto translate property of the SQL Server ODBC Driver for a
SQL Server Unicode database.
Base Connections 25 (default=10) Default number of database connections that the TPGS server
makes on startup.
Cache Refresh Interval 60 Frequency of the TPGS server for refreshing cached data from the
(seconds) database.
Connect Retry Period 30000 Amount of time to wait before retrying to connect.
(milliseconds)
DB User PRIVUSER User name with privileged access used to connect to the database.
The default value is PRIVUSER.
License Inactivity TimeOut 900 Period that inactive licensed client connections are considered to be
(seconds) bad.
Log Invalid Login Attempts Yes/No Logs invalid login attempts to the event log. The default value is
No.
Log SQL 0 Sets SQL tracing flags for tracing to the event log.
Max Search Result Records 100 Maximum number of records in search results.
Sync Period 60 Period between updating the sync table in the database.
(seconds)
Synchronize ADO Yes/No Blocks other requests while connecting to a database. The default
Connection Creation value is Yes.
Temporary Connections 150 Number of database connections that the TPGS server can make as
demand warrants. These settings determine how many connections
the Group Server has to the database. If you are getting an error
where HRESULT = 8004b002, this indicates the Group Server
cannot handle the load and needs more database connections to
process all requests. A value of 400 is recommended if more than
1000 timesheet users are accessing the Group Server, which will
allow more connections so that TPGS can handle a larger load.
Consideration is also given to the Oracle Server machine.
Verbose Logging Yes/No Determines if verbose logging is enabled when sending error
messages to the event log.
Caching Threads 1 Number of threads that will handle cached transaction processing.
This is the minimum number of caching threads. Cache threads in
the Group Server are
responsible for processing data where the data can be cached. The
Group Server will create up to “Maximum Temporary threads per
CPU” caching threads as needed.
Coalescing Jobs Busy 50 Number of coalesced jobs that determine when the coalescing
Threshold processor is considered busy.
Coalescing Threads 1 Number of threads that will handle coalesced transaction
processing. This is the minimum number of coalescing threads.
Coalescing threads in the Group Server are responsible for
processing jobs which can be coalesced. Coalescing is the act of
taking like requests (e.g., open, update timesheet) and coalescing
them into a single SQL request to satisfy several clients concur-
rently with one DB hit, thus greatly improving performance. The
Group Server will create up to “Maximum Temporary threads per
CPU” coalescing threads as needed.
Coalescing Timeout 750 Frequency that coalesced requests are fulfilled.
(milliseconds)
Connection TimeOut Period 300 Period of inactivity for which attached database
(seconds) connections are assumed to be good.
License Manager Interval 120 Frequency that the license manager is checked for concurrent users.
(seconds)
Message Threads Per CPU 3 (default=1) Number of threads that will handle socket connections from the
client.
This is the minimum number of threads which accept messages
from the client via a socket connection and create jobs to be
processed in the Group Server. The Group Server will create up to
“Maximum Temporary threads per CPU” message threads as
needed.
Maximum Coalescing Size 20 Maximum number of coalesced transactions that can be queued
before they are processed.
Maximum Temporary 15 Maximum number of threads that can be started by each processor.
Threads Per CPU (SMP) MaxTempThreads=CPU>1?MaxTempThreads+(MaxTempThreads
*4/CPU
Thread Inactivity TimeOut 180 Period of inactivity before a temporary thread is shut down.
Period (seconds)
Transaction Threads 1 Number of threads that will handle transaction processing. This is
the minimum number of threads which create transactions in the
Group Server.
Transactions created are either Caching, Coalescing, or Update.
The Group Server will create up to “Maximum Temporary threads
per CPU” transaction threads as needed.
Update Threads 1 Number of threads that will handle update transaction processing.
This is the minimum number of Update threads. Update threads in
the Group Server are
responsible for updating data. The Group Server will create up to
“Maximum Temporary threads per CPU” update threads as needed.
Watch Dog Period 120 Frequency that the TPGS server checks for connection problems.
(seconds)
[Security keys]
Keys Value Description
Accept Filters Filter #1, *.*.*.* TCP/IP client addresses that will be accepted.
Reject Filters Filter #1, *.*.*.255 TCP/IP client addresses that will be rejected.
For the full list of tested To upgrade from myPrimavera 4.1/5.x to version 6.0 of
configurations for Primavera’s Web application
Primavera’s Web
■ Uninstall the current version of myPrimavera.
application, refer to the
testedcfg.htm file in the ■ Install one of the supported application servers.
\Documentation\Technical
Documentation\Tested Tomcat (for Windows and Solaris) is included on CD 2.
Configurations folder on For a list of supported application servers, see “Client and Server
CD 3.
Requirements” on page 16.
■ Install version 6.0 of Primavera’s Web application.
■ Install or upgrade the collaboration server for Primavera’s Web
application (see “Collaboration Setup” on page 175).
For the full list of tested Primavera’s Web application also supports several other application
configurations for servers. For a complete list of supported application servers, see “Client
Primavera’s Web and Server Requirements” on page 16.
application, refer to the
testedcfg.htm file in the
\Documentation\Technical On Windows, it is recommended that you install the application
Documentation\Tested server to a folder with a short name.
Configurations folder on
CD 3. To install Tomcat
■ On Windows, launch the Tomcat installer (apache-tomcat-5.5.20.exe)
located in the \apache-tomcat-5.5.20 folder on CD 2.
■ On Solaris, copy, unzip, and launch the Tomcat installer (apache-
tomcat-5.5.20.tar.gz) file in the \apache-tomcat-5.5.20 folder on CD 2.
For the full list of tested When you choose the “All other supported application servers”
configurations for option, setup copies the myprimavera.war or myprimavera.ear
Primavera’s Web file to the Home folder for Primavera’s Web application. You
application, refer to the must then use the application server’s deployment tools to
testedcfg.htm file in the deploy the myPrimavera WAR file.
\Documentation\Technical
Documentation\Tested
If you choose the “All other supported application servers” option,
Configurations folder on
CD 3. skip Step 5 and proceed with step 6.
For more information about 9 If there is an existing Primavera configuration, on the The installer
configurations, see “Using the has detected . . . dialog box, you can choose whether you want to use
Administration Application”
on page 139. it, or create a new configuration.
For more information, see After installation, you can use the Database Configuration
“Changing Database Setup wizard to choose a different configuration, if necessary
Configuration Settings” on
page 137.
run -c myPrimavera
The database you select during installation stores one or more Primavera
configurations, each one specifying a set of configurable parameters that
determine how Primavera’s Web application operates. During installation,
you select an existing Primavera configuration or create a new one. Later,
you can use the Database Configuration wizard to select a different
Primavera configuration or create a new one.
The installation for ■ To launch the Administration Application remotely, launch a browser
Primavera’s Web and navigate to http://server IP:listenport/ContextRoot/admin.jsp,
application sets the default where serverIP:listenport is the IP address and listen port for the
URLs for remote access to server of Primavera’s Web application. The default context root is
the Administration myprimavera.
Application. You can use
the application server’s
Starting the Administration Application on WebLogic
configuration utility to
change the listen port ■ On Windows, run adminpv.cmd (located in the
number and context root. <myPrimavera_home> directory you specified when setting up
Primavera’s Web application, or choose Start, Programs,
myPrimavera, Administration Application.
■ On Solaris and HP-UX, to launch the Administration Application
locally, change to the <myPrimavera_home> directory you specified
when setting up Primavera’s Web application, then run the
adminpv.sh script.
■ To launch the Administration Application remotely, launch a browser
and navigate to http://server IP:listenport/ContextRoot/admin.jsp,
where serverIP:listenport is the IP address and listen port for the
server of Primavera’s Web application. The default context root is
myprimavera.
To display brief setting descriptions in Tree or Table view, mark the Show
tool tips checkbox. Then, position the mouse over a setting to read the
popup description.
Click to display a
hierarchical view of the
configuration data.
To change a setting
value, triple-click on
the setting name, then
type a new value. On
Windows, you can
also press F2 to
change to Edit mode.
You cannot delete the Factory Defaults configuration. You can delete any
custom configuration, but not all of them. There must always be at least
one custom configuration.
You can delete any database instance associated with a configuration, but
not all of them. Each configuration must have at least one database
instance.
You are not prohibited from deleting the database that was
specified during the database configuration. If you do so, you
will need to run the Database Configuration wizard again (see
“Changing Database Configuration Settings” on page 137).
[MMDB]
DriverName=SQLServer
BlobSize=-1
HostName=jobservice_machine_name
DataBase=MMDB_new
User_Name=
Password=
RowsetSize=128
Through the Administration Application, you can configure the server for
Primavera’s Web application to manage user access to specific databases
by requiring a database parameter in the URL. The database parameter,
which is the name of a database instance, is appended to the Web
application’s server URL and points to that specific database instance.
When users access the URL you specify, the Database drop-down list does
not display in the Login page and they have login access only to the
database instance defined by the database parameter. If users attempt to
access the login page URL without specifying the required database
parameter, a message displays to indicate that the URL is invalid and
directs them to the administrator of Primavera’s Web application.
For example, the following URL would log a user into the database
instance named Sample.
http://serverIP:listenport/login_cmt?db=Sample
For more information, see Database driver configurations The following table lists the
Database.Instance.Driver and database drivers that Primavera’s Web application supports for each
Database.Instance.URL in
“Configuration Settings for application server/database configuration. Use the
Primavera’s Web Database.Instance.Driver configuration setting to specify the database
Application” on page 152. driver you are using.
■ Authentication.Mode
■ Authentication.WebSSO.UserNameHeaderKey
■ Authentication.WebSSO.ContextPathOverride
■ Authentication.WebSSO.ServerandPortOverride
■ Authentication.LDAP.SSLCertificateStore
■ Authentication.LDAP.SSLStorePassword
For more information about this setting, refer to the Application Settings
subsection in the next section, “Configuration Settings for Primavera’s
Web Application”.
[Localization settings]
Localization.SystemLanguage en —
Language for server string constants
Localization.SystemCountry US —
Country for server string constants
[Database Settings]
Database.Instance.Name — up to 32 characters
The name of this database instance.
Database.Instance.Driver — com.microsoft.sqlserver.jdbc.
The class name of the JDBC driver. SQLServerDriver
oracle.jdbc.driver.OracleDriver
Database.Instance.URL — —
The database URL used to establish a connection to the
database.
Oracle example:
jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=(A
DDRESS=(PROTOCOL=TCP)
(HOST=xx.xxx.xxx.xx)(PORT=yyyy)))(CONNECT_DATA=
(SID=zzzz)))
SQL example:
jdbc:sqlserver://xxxx:yyyy;database=zzzz
Database.Instance.PublicGroupId 1 —
The public group ID used to establish a connection to the
database.
Database.Instance.UserName pubuser —
The name used to establish a connection to the database.
Database.Instance.Password pubuser —
The password used to establish a connection to the database.
Database.Instance.CollaborationDomain — —
The collaboration domain name used by Primavera’s Web
application.
[Database Settings]
Database.Instance. TRANSACTION —
SQLServer2000TransactionIsolationLevel _READ_UNCO
The transaction isolation level for SQL Server 2000 databases MMITTED
only. Controls the locking and row versioning behavior of
SQL statements issued by a connection.
Database.Instance.ConnectionPool[aaa]. 4m 4m - 12h
ConnectionPoolResizeRate
The timeout period after which the system will adjust the
number of database connections to be equal to the maximum
number of database connections concurrently used during the
last period.
[PMR] Used for the standard connection pool, which is the
most frequently used connection pool in the Business Rule
Engine.
[PML] Used for the long running connection pool, which is
used in the Business Rule Engine when scheduling long
running jobs.
[PMT] Used for the transactional connection pool, which is
used in the Business Rule Engine when a client transaction is
requested.
Database.Instance.ConnectionPool[aaa]. 1m 10s - 1h
MaintenanceFrequency
The run frequency of the maintenance that ensures leases
have not exceeded the maximum duration.
[PMR] Used for the standard connection pool, which is the
most frequently used connection pool in the Business Rule
Engine.
[PML] Used for the long running connection pool, which is
used in the Business Rule Engine when scheduling long
running jobs.
[PMT] Used for the transactional connection pool, which is
used in the Business Rule Engine when a client transaction is
requested.
[Database Settings]
Database.Instance.ConnectionPool[aaa]. 30s 5s - 2h
LeaseRequestWaitTimeout
The amount of time a request for a database connection will
wait.
[PMR] Used for the standard connection pool, which is the
most frequently used connection pool in the Business Rule
Engine.
[PML] Used for the long running connection pool, which is
used in the Business Rule Engine when scheduling long
running jobs.
[PMT] Used for the transactional connection pool, which is
used in the Business Rule Engine when a client transaction is
requested.
Database.Instance.ConnectionPool[aaa]. 50 5 - 15000
MaxConnections
The maximum number of connections the server will have to
the database.
[PMR] Used for the standard connection pool, which is the
most frequently used connection pool in the Business Rule
Engine.
[PML] Used for the long running connection pool, which is
used in the Business Rule Engine when scheduling long
running jobs.
[PMT] Used for the transactional connection pool, which is
used in the Business Rule Engine when a client transaction is
requested.
Database.Instance.ConnectionPool[aaa].FetchSize 120 —
A hint to the database driver for how many rows to fetch at a
time.
[PMR] Used for the standard connection pool, which is the
most frequently used connection pool in the Business Rule
Engine.
[PML] Used for the long running connection pool, which is
used in the Business Rule Engine when scheduling long
running jobs.
[PMT] Used for the transactional connection pool, which is
used in the Business Rule Engine when a client transaction is
requested.
[Database Settings]
Database.Instance.ConnectionPool[aaa]. 3 3-5
RenewableFreeLimit
The minimum number of connections that should be available
for leases to be renewed.
[PMR] Used for the standard connection pool, which is the
most frequently used connection pool in the Business Rule
Engine.
[PML] Used for the long running connection pool, which is
used in the Business Rule Engine when scheduling long
running jobs.
[PMT] Used for the transactional connection pool, which is
used in the Business Rule Engine when a client transaction is
requested.
[Database Settings]
Database.Instance.GroupServer.Server servername —
GroupServer host machine name
Database.Instance.GroupServer.Port 9002 —
GroupServer host listen port
[Database Settings]
Database.Instance.GroupServer.URL http://servername —
GroupServer servlet URL.
Database.Instance.MethodologyManagement.Name — —
Name of this database instance.
Database.Instance.MethodologyManagement.Description — —
Description of this database instance.
Database.Instance.MethodologyManagement.URL — —
Database URL used to establish a connection to the database.
Oracle example:
jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=(A
DDRESS=(PROTOCOL=TCP)
(HOST=xx.xxx.xxx.xx)(PORT=yyyy)))(CONNECT_DATA=
(SID=zzzz)))
SQL example:
jdbc:sqlserver://xxxx:yyyy;database=zzzz
Database.Instance.MethodologyManagement.UserName — —
The name used to establish a connection to the database.
Database.Instance.MethodologyManagement.Password — —
The password used to establish a connection to the database.
Database.Instance.MethodologyManagement. 1 —
PublicGroupID
The Group ID used to establish a connection to the database.
Database.Instance.MethodologyManagement. MMDB —
DBAlias
The DB Alias name used by the Project Architect job service
to create a project plan from a methodology.
[Database Settings]
Database.Instance.MethodologyManagement. 4m 4m - 12h
ConnectionPool[MMR].ConnectionPoolResizeRate
The timeout period after which the system will adjust the
number of database connections to be equal to the maximum
number of database connections concurrently used during the
last period.
Database.Instance.MethodologyManagement. 1m 10s - 1h
ConnectionPool[MMR].MaintenanceFrequency
The run frequency of the maintenance that ensures leases
have not exceeded the maximum duration.
Database.Instance.MethodologyManagement. 30s 5s - 2h
ConnectionPool[MMR].LeaseRequestWaitTimeout
The amount of time a request for a database connection will
wait.
Database.Instance.MethodologyManagement. 50 5 - 15000
ConnectionPool[MMR].MaxConnections
The maximum number of connections the server will have to
the database.
Database.Instance.MethodologyManagement. 120 —
ConnectionPool[MMR].FetchSize
A hint to the database driver for how many rows to fetch at a
time.
Database.Instance.MethodologyManagement. false true/false
ConnectionPool[MMR].TraceSQL
Trace all SQL sent to the database.
Database.Instance.MethodologyManagement. 3 3-5
ConnectionPool[MMR].RenewableFreeLimit
The minimum number of connections that should be available
for leases to be renewed.
[Database Settings]
ThreadPool.NumThreads 25 2-300
The number of server threads.
[Log Settings]
[Log Settings]
[Performance Settings]
Performance.MonitorHost localhost —
The destination IP or machine name for the performance
monitor packets
Performance.MonitorPort 6990 1024 - 65535
The destination port for the performance monitor packets
Performance.UpdateInterval 1s 250 - 1m
The rate at which the performance monitor packets are sent.
[LicenseService Settings]
[TimestampService Settings]
TimestampService.RefreshRate 1m 15s - 1h
The rate at which the database is queried to determine if a
table change notification is necessary.
[RegistryService Settings]
[NextKeyService Settings]
NextKeyService.RefreshRate 1m 15s - 1h
The rate at which nextkey cache is refreshed.
NextKeyService.MaxCachedKeys 10 1 - 100
Maximum nextkeys to cache per table
[Application Settings]
Application.PrototypeUser — —
Prototype user login used to create and store default
Dashboards and Global Preference settings for new Primavera
Web application users.
Application.TimesheetURL /action/launchTimesheetSe- —
URL for invoking timesheet program emlessly
Application.TimesheetCodebase server/GroupServer —
URL for the timesheet application Web site
Application.JavaPluginURL_IE Defaults to the plug-in —
URL for Internet Explorer users to download Java Plug-in version 1.5.0_10 that is
(JRE). installed during setup.
Application.JavaPluginVersionID_IE —
JRE version used by applets in Internet Explorer
[Application Settings]
Application.DBDropdownKeyword blank —
Keyword to use for enabling database selection control in the
login page. Pass this as a URL parameter db=keyword. Set this
to an empty string if you do not want to require the keyword.
Application.LogoutURL — —
Directs Primavera’s Web application to a specific URL when
the user exits with the Logout/Close icon in the banner of
Primavera’s Web application. Any valid URL can be used. If
no URL is specified, the Web application directs the user to
the launch page of Primavera’s Web application.
Application.CompressAppletCommunication true true/false
Set to true to compress communication between applets and
the server.
Application.CompressHtmlContent true true/false
Set to true to compress HTML-related content generated by
Primavera’s Web application, including .html, .js, and css files,
and Ajax content.
Application.MaxMRUListItems 5 1 - 10
The maximum number of items that can be displayed in a
Most Recently Used (MRU) list.
[Application Settings]
Application.CustomPortletURLUserInfoEncryptionKey — —
Encryption key for custom portlet user password.
[Application Settings]
Application.WebScheduler.SchedulingInterval 5m 1s - 24d
Amount of time the Web Scheduler will wait before sched-
uling the next available job.
Application.WebScheduler.ConcurrentSchedulers 2 0-20
The number of processes (active schedulers) used for sched-
uling on this server. A value of 0 (zero) indicates that sched-
uling will not be performed on this server.
Application.PeriodPerformance.ExecutionInterval 5m 1s - 24d
Amount of time the service will wait before checking for any
period performance jobs.
Application.PeriodPerformance.ConcurrentThreads 2 0 - 20
The number of processes used for the PeriodPerformance
service on this server. A value of 0 (zero) indicates that the
service is not available on this server.
Application.SyncActualThisPeriod.Enabled true true/false
Service for synchronizing actuals and ActualThisPeriod
values. If true, recalculates actual units and costs for
ThisPeriod.
Application.SyncActualThisPeriod.ExecutionInterval 5m 1s - 24d
Amount of time the service will wait before checking for any
SyncActualThisPeriod jobs.
Application.SyncActualThisPeriod.ConcurrentThreads 2 0 - 20
The number of processes used for the SyncActualThisPeriod
service on this server. A value of 0 (zero) indicates that the
service is not available on this server.
[Application Settings]
Application.CollaborationServer.LibraryName — —
The name of the database where library data resides.
Application.CollaborationServer.Collaboration PrimaveraRootContainer —
WorkspaceName
The default collaboration workspace name.
Application.CollaborationServer.Initiation primavera_initiations —
WorkspaceName
The default initiation workspace name.
[Application Settings]
Application.CollaborationServer.AppName primaveraApp —
The default app name used by Primavera’s Web application.
Application.CollaborationServer.PoolSize 20 0 - 2147483647
The number of collaboration connections initialized.
Application.CollaborationServer.PoolUserName PROXYUSER —
The name used to start the connection pool.
Application.CollaborationServer.PoolUserPassword proxyuser —
Password for the user name used to start the connection pool.
Application.CollaborationServer.AdminUserName Admin —
The Admin user with full privileges.
Application.CollaborationServer.AdminPassword admin —
The password of the admin user.
Application.CollaborationServer.CacheUserName CACHEMANAGER —
The user name that enables Primavera’s Web application to
access the application cache.
Application.CollaborationServer.CachePassword cachemanager —
The password that corresponds to the CacheUserName.
[Application Settings]
[Authentication settings]
Authentication.WebSSO.UserNameHeaderKey smuser —
The name of the http header you specified in SiteMinder.
Authentication.LDAP.SSLStore Password — —
The password for the keystore that holds the SSL certificate.
AsynchJobs.PurgeInterval 1h 0 -24d
The frequency at which long running job records will be
removed from the database.
AsynchJobs.GraceTime 1d —
The minimum age of long running job records removed during
purge.
[MailService Settings]
MailService.EmailNotificationServer — —
Hostname or IP address of the E-mail notification server for
Timesheet Approval.
MailService.SmtpPort 25 1 - 65535
The tcp/ip port of the outgoing SMTP server.
MailService.SendInterval 1m 0 - 24d
The frequency at which queued mail messages are sent.
MailService.AuthorizedUser — —
The name of the account to use to send mail from this mail
server.
MailService.AuthorizedPassword — —
The password of the account used to send mail from this mail
server.
IntegrationServer.RMI.CompressionServicePort 0 0 - 65535
The port to use for Compression service mode. A setting of 0
indicates that any available port will be used. If the server will
be accessed across a firewall, you must set this to a specific
port.
IntegrationServer.RMI.SSLServicePort 0 0 - 65535
The port to use for SSL service mode. A setting of 0 indicates
that any available port will be used. If the server will be
accessed across a firewall, you must set this to a specific port.
IntegrationServer.RMI.StandardServicePort 0 0 - 65535
The port to use for Standard service mode. A setting of 0
indicates that any available port will be used. If the server will
be accessed across a firewall, you must set this to a specific
port.
IntegrationServer.RMI.HTTPServicePort 0 0 - 65535
The port to use for HTTP tunneling mode. A setting of 0
indicates that any available port will be used.
IntegrationServer.RMI.HTTPsServicePort 0 0 - 65535
The port to use for secure HTTP tunneling mode. A setting of
0 indicates that any available port will be used.
IntegrationServer.SessionTimeOut 120 1 - 24d
The amount of time after which an idle client connection will
be terminated.
Collaboration Setup
This chapter describes how to install and
In this chapter configure the collaboration server of
Primavera’s Web application.
Preparing the Installation
Installing the Collaboration Server If you are installing the collaboration server
Migrating Worksite MP Server 3.1 for the first time, you must perform all of the
SP1
steps listed in this chapter, except for
Applying the HFB7 Update
migrating from iManage Worksite MP Server
Creating a Collaboration
Configuration v3.1 to v4.1.
Configuration Tasks
If you have already installed the collaboration
Adding the Indexer Service
server (i.e., with the 5.x release of myPri-
Adding Trustees
mavera), then you also need to upgrade your
Enabling Expired Trustees
iManage Worksite MP Server from v3.1 SP1
Adding a Facility
HFB12 Hotfix to V4.1. See “Migrating
Adding a Domain and Admin User
Worksite MP Server 3.1 SP1” on page 181 for
Extend the Collaboration Schema
more information.
Adding Updated Document
Formats
Configuring Primavera’s Web
Application for Collaboration
The Indexer service requires approximately 10% to 20% of the total file
server disk space consumption. For example, if the disk space usage on the
file server is 5 GB, the Indexer disk space requirement would rage
between 500 MB (10%) to 1 GB (20%).
c:\worksitemp4\worksiteserver\bin\win\impmservice -install
If you are installing the collaboration server for the first time, complete the
steps in the section, “Applying the HFB7 Update”.
Before you begin the migration, ensure that your current Worksite MP
Server v3.1 version is 3.1.6.8.2. To verify the version, launch the
Configuration Manager, click Help, About..., and scroll to the bottom of
the window. Also, you should install the 4.1 version of the collaboration
server before migrating; see “Installing the Collaboration Server” on
page 178.
Migrating on Windows
Perform the following to migrate from WorkSite MP Server version 3.1
SP1 to version 4.1:
You may view the results of any command line execution in the
corresponding log files found in the
c:\worksitemp3\mpserver\logs\hostname directory.
1 Make a backup copy of the database and file servers. The default
location for 3.1 file servers is c:/worksitemp.
10 Copy the DAT file for the existing library from the
<31installationdirectory>\worksiteserver\config\objectmodels to the
c:\worksitemp4\mpserver\config\objectmodels directory. The default
name for the extended Primavera data model DAT file is
finalschema.dat. In the following steps, the DAT file will be referred
to as finalschema.dat.
If you plan to create a new library for use by the same server
(either as a local or remote library), you must use the
model_41.dat file or its extensions.
16 (SQL Server Database Only) From the Start menu, open Microsoft
SQLServer Query Analyzer and log in as the database owner (the
default login uses IMANAGE as the name and password).
17 Select the database for the library being migrated.
18 Open and execute c:\worksitemp4\mpserver\31to41\migrate.sql
Disregard the following error messages:
Warning: The table 'con_notification_message' has been created but
its maximum row size (13004) exceeds the maximum number of bytes
per row (8060). INSERT or UPDATE of a row in this table will fail if
the resulting row length exceeds 8060 bytes.
37 Click OK to continue.
This completes the WorkSite MP Server 4.1 migration in a Windows
environment.
Migrating on Solaris
Perform the following to migrate from WorkSite MP Server version 3.1
SP1 to version 4.1:
You may view the results of any command line execution in the
corresponding log files found in the /worksitemp3/mpserver/
logs/hostname directory.
1 Make a backup copy of the database and file servers. The default
location for the 3.1 file servers is c:/worksitemp.
2 Extract the migrate31To41V2.zip migration files from the
\collab\41Upgrade directory on CD3 to the WorkSite MP 4.1
installation directory (/worksitemp4/mpserver by default) and
overwrite existing files when prompted. Ensure that the “Use Folder
Names” option is checked when extracting the files.
If you plan to create a new library for use by the same server
(either as a local or remote library), you must use the
model_41.dat file or its extensions.
16 (SQL Server Database Only) From the Start menu, open Microsoft
SQLServer Query Analyzer and log in as the database owner (the
default login uses IMANAGE as the name and password).
17 Select the database for the library being migrated.
18 Open and execute /worksitemp4/mpserver/31to41/migrate.sql
Disregard the following error messages:
Warning: The table 'con_notification_message' has been created but
its maximum row size (13004) exceeds the maximum number of bytes
per row (8060). INSERT or UPDATE of a row in this table will fail if
the resulting row length exceeds 8060 bytes.
23 Navigate to /worksitemp4/worksiteserver/bin/unix/
24 Start the WorkSite MP 4.1 Configuration Manager:
./imconfigmgr &
25 Start the CMS service in WorkSite MP 4.1 Configuration Manager.
26 (SQL Server Database Only) From the Start menu, open Microsoft
SQLServer Query Analyzer and log in as the database owner (the
default login uses IMANAGE as the name and password).
27 Select the database for the library being migrated.
28 Open and execute /worksitemp4/mpserver/31to41/insertPriv.sql.
37 Click OK to continue.
This completes the WorkSite MP Server 4.1 migration in a Solaris
environment.
1 If necessary, insert/mount CD 3.
2 Launch the installer from the following folder:
\collab\41hfb7\WSMP_Server41SP1HFB7\install.htm
3 On the Update page, click Start Installer.
4 After the download is complete, select the installation language and
review the introduction.
5 Accept the license agreement.
6 When prompted for the existing installation directory, verify that the
path listed is correct. If not, click Choose... and select the base
installation directory (this directory contains the "mpserver"
directory).
7 When prompted for a backup directory, you can leave the default
directory, type the path to a new directory, or click Choose... and
select a backup directory.
9 Delete any temporary files (all files) in the \fxfer directory of your
Worksite MP installation. The default location of this directory is
c:\worksitemp4\<library_name>\fxfer\.
10 Restart the Worksite Process Manager (or restart the service on
Windows). If CMS and Indexer are not set to Auto-Start, restart them
from the Configuration Manager.
The Content Library Creation Wizard creates the database tables and
indices required to run the collaboration server. Click Next to move to the
next step in the wizard. The following information is required:
File Server Path - type or browse to the full path to the location where the
library files should be created and stored (this can be any desired location)
Once the wizard is finished, the new library must be defined as the
Authentication Library.
When all database tables and indices are created, three system
accounts are added: PROXYUSER, CACHEMANAGER, and
TOOLUSER.
When CMS has started successfully, the red square on the CMS
service icon changes to a green arrow.
2 After starting the CMS service, right-click the service name and select
Auto-Start from the menu.
Configuration Tasks
After installing the collaboration server, several configuration tasks are
required to prepare the server for use in the Primavera environment. The
two main interfaces used to configure the collaboration server are the
Configuration Manager and the Library Manager.
This section describes the main configuration interfaces and highlights the
tasks for which each interface is used.
When you set up your WorkSite MP Server, you must run the
Configuration Manager to create a configuration for all the components
that make up a WorkSite MP Server Cluster. The list below denotes the
components that are configured for each WorkSite MP Server Cluster
using the Configuration Manager:
Cluster node
Server node
Services
Library node
■ Facilities
• WorkGroups
■ Library metadata instances
• Metadata classes
• Metadata Relationships
■ Privileges
■ System Configuration
■ Trustee information, including the following:
• Master Realm Settings
• Realms, which include the ability to perform the following tasks:
• Add a Master Realm to the library
• Add individual users, groups, localities, and organizational
units as native trustee nodes under a library’s Master Realm
• Import and synchronize directories from external LDAP
directory services as imported trustee nodes under a library’s
Master Realm
• Add Slave Realms from other libraries
■ System Users
■ Directory frame
■ Display frame
■ Menus
■ Toolbar
■ Look-Up toolbar
■ Clusters
■ Server Cluster
■ Library
■ The tasks that can be performed from these nodes are:
■ Add a Server Cluster
■ Delete a Server Cluster
■ Login to a Library
■ Edit Privileges
4 If you want to enable SSL on the Indexer service, mark the checkbox
next to “SSL Enabled.”
6 Select the library to which you are adding the Indexer service from
the Available list. To select multiple libraries, use Ctrl or Shift.
When the Indexer has started successfully, the red circle on the
Indexer service icon changes to a green arrow.
2 After starting the Indexer service, right-click the service name and
select Auto-Start from the menu.
Adding Trustees
1 Launch the Library Manager according to your operating system:
Windows:Start, Programs, Worksite MP Server 4, Library Manager
Solaris:/worksitemp4/mpserver/bin/unix/imlibmgr
7 Enter a name for the master realm next to RDN (the suggested default
name is “ImanageRealm”), then click OK.
Enter master
realm name.
Click OK when
finished.
8 Expand the Realms node, right-click the new master realm, then
select Add to add a trustee.
RDN
Class
Label
UID
Domain
Adding a Facility
After adding at least one trustee to the master realm, the next step is to add
a default facility.
2 Enter a name for the facility. Select the master realm under the
Trustee Selection Tree, select the new trustee from the Trustee
Selection list, then click Add to move the trustee to the Grants list.
Select the
master realm
Select the
desired trustee
Click Add
Click OK
Select Members
2 Enter the following details for the primavera.com domain, then click
OK:
RDN - primavera.com
Class - Domain
Label - d (changed automatically when Class is changed)
RDN
Class
Label
3 Click on the Libraries tab and uncheck each of the Inherit boxes under
Preferences Facility and Homepage Workspace.
RDN
Class
You should
Label
always select
this option.
UID
Domain
2 Click on the Trustee Managers tab, expand the Trustee Selection Tree,
select the DomainAdmin user under Person Selection, then click Add
to add the user to the Trustee Managers list.
Select the
“DomainAdmin” user
Click Add
Click OK
Select the
primavera.com
domain
Select the
“DomainAdmin”
user
Click Add
Click OK
Select the
primavera.com
domain
Select the
“DomainAdmin”
user
Click Add
Click OK
The path and filename of the log file for your server will use the
cluster name (hostname) of the collaboration server instead of
<cluster>, as shown above.
The log file should end with the following line in the case of a successful
upgrade:
2 Expand the cluster and library nodes to display the library sub-nodes.
3 Expand the Metadata node.
4 Right-click on the Application Formats node and select Add.
5 Enter the values listed on the previous page for one of the document
formats.
To enter data in a “Value” cell, left-click the desired cell and enter the
text required.
If the file format is used frequently, you may want to mark the
IS_INDEXABLE checkbox to enable faster loading of the
specified document format.
Required Settings
The values for certain settings are specific to your installation. Therefore,
the following settings must be modified in the Administration Application
before your collaboration server will properly function in your
environment.
Additional Settings
The remaining collaboration settings can be modified as needed, but
changes are not required to enable collaboration functionality in
Primavera’s Web application.
■ Application.CollaborationServer.Collaboration
WorkspaceName - The default collaboration workspace name.
■ Application.CollaborationServer.Initiation
WorkspaceName - The default initiation workspace name.
■ Application.CollaborationServer.AppName - The default app name
used by Primavera’s Web application.
■ Application.CollaborationServer.PoolSize - The number of
collaboration connections initialized.
■ Application.CollaborationServer.PoolUserName - The user name
used to start the connection pool.
■ Application.CollaborationServer.PoolUserPassword - Password
for the user name used to start the connection pool.
■ Application.CollaborationServer.AdminUserName - The Admin
user with full privileges.
■ Application.CollaborationServer.AdminPassword - The password
of the admin user.
■ Application.CollaborationServer.CacheLimit - The maximum
number of CMS objects that are kept in the application cache.
■ Application.CollaborationServer.StrictDocumentVersioning - If
true, document checkout is restricted to the most recent version of a
document. If false, any document version can be checked out.
■ Application.CollaborationSyncService.
SynchronizationInterval - The interval at which the collaboration
synchronization service will run. The synchronization moves
documents marked for deletion to the collaboration server \trash
folder. Additionally, other collaboration items (e.g., discussions or
issues) that should be removed (e.g., when a project is deleted) are
moved to the \trash folder.
■ Application.CollaborationRecyclerService.Automatic - If true,
enables the collaboration recycler service, which purges deleted
documents and other collaboration items (in the \trash folder).
■ Application.CollaborationRecyclerService.
RecycleInterval - The interval at which the collaboration recycler
service should run.
In addition to the preparations Prepare the Controller and DJS servers for installation and
described in this section, you configuration
must configure the database
for Primavera’s Web Be sure to complete the following tasks before you install and configure
application to run the Project DJS on the Controller and servers:
Architect job service. Refer to
“Configure Primavera’s Web
application to run the Project ■ On the Controller and all DJS servers, define the “Temp” and “TMP”
Architect job service” on variables in Environment variables (both User variables and System
page 146.
variables).
■ Synchronize the system clocks of the Controller and all DJS servers to
have identical time stamps in the log files.
On the server that controls the domain in which the Controller and DJS
servers reside, perform the following steps:
3 On the Controller and each DJS server, add the group you created to
the Local Administrator Group.
4 In the Security tab of the DCOM Configuration dialog, add the group
you created to each Custom permission.
1 From the command line (or Start, Run utility), run dcomcnfg. The
Distributed COM Configuration Properties dialog is displayed.
2 In the Applications tab of the Distributed COM Configuration
Properties dialog, select {9E521861-5A76-11D5-98F4-
00C0F680F1F}, then click Properties.
Make sure the Controller and all DJS servers are set to the
same Authentication Level. If desired, you can set Connect as
the Default Authentication Level in the Default Properties tab of
the Distributed COM Configuration Properties dialog.
6 For each custom permission type, click the associated Edit button and
perform steps 7-9. When you have completed steps 7-9 for all three
custom permission types, continue with Step 10.
The Registry Value Permissions dialog opens.
For access
permissions,
this field says
Allow Access.
For launch
permissions, this
field says Allow
Launch. For
configuration
permissions, this
field says Full
Control.
8 In the Add Users and Groups dialog, select the user group you
previously created (in this example, PrmJobAdmins). In the Type of
Access field, select Allow Access. Click OK.
When you repeat this step for the Use Custom Launch
Permissions option you selected in step 5, select Allow Launch
in the Type of Access field. When you repeat this step for the
Use Custom Configuration Permissions option you selected in
step 5, select Full Control in the Type of Access field.
If you have not performed steps 6-9 for all three custom
permissions (access, launch, and configuration) selected in
step 5, return to step 6. If you have performed steps 6-9 for all
three custom permissions, continue with step 10.
10 In the Properties dialog, Identity tab, select the This User option.
Enter the Password for a user who has administrative privileges on the
machine you are using.
14 In the Properties dialog, select This Account and enter the password
of an administrative user on the Controller.
Steps 12-14 enable the DJS to use the name and password of
the administrator you specified during DCOM configuration as
the launching user for all servers.
1 From the command line (or Start, Run utility), run dcomcnfg. The
Component Services dialog is displayed.
2 In the Component Services dialog, expand the tree in the left panel by
clicking Component Services, Computers, My Computer, DCOM
Config.
Make sure the Controller and all DJS servers are set to the
same Authentication Level. If desired, you can set Connect as
the Default Authentication Level in the Default Properties tab of
the Distributed COM Configuration Properties dialog.
7 In the Properties dialog, Security tab, click the Edit button associated
with Launch and Activation Permissions.
8 In the Launch Permission dialog, Security tab, click Add.
9 In the Select Users, Computers, or Groups dialog, enter the user group
name you created previously (for example, PrmAdmins). Click OK.
10 In the Launch Permission dialog, Security tab, select the user group
you added (for example, PrmAdmins), and select Allow for all
permissions, as shown in the following figure. Click OK.
11 In the Properties dialog, Security tab, click the Edit button associated
with Access Permissions.
13 In the Select Users, Computers, or Groups dialog, enter the user group
name you created previously (for example, PrmAdmins). Click OK.
14 In the Access Permission dialog, Security tab, select the user group
you added (for example, PrmAdmins), and select Allow for all
permissions, as shown in the following figure. Then click OK.
15 In the Properties dialog, Security tab, click the Edit button associated
with Configuration Permissions.
17 In the Select Users, Computers, or Groups dialog, enter the user group
name you created previously (for example, PrmAdmins). Click OK.
19 In the Properties dialog, Identity tab, select the This User option.
Enter the Password for a user who has administrative privileges on the
machine you are using.
Steps 21-23 enable the DJS to use the name and password of
the administrator you specified during DCOM configuration as
the launching user for all servers.
Select Disabled
to disable the
DJS on that
machine. In this
example, the
Controller will
execute jobs on
the servers but
not on itself.
If you have already used the configuration tool, all servers you
previously configured appear in the list of servers (bottom grid
of previous figure).
4 Set the Status (Enabled/Disabled) for the Controller and each DJS
server.
You can disable the DJS on any machine (e.g., if you want to
execute jobs only on the servers and not on the Controller).
However, a disabled machine may still run jobs if no enabled
machine is available (e.g., due to network problems).
After you reboot the Controller and DJS servers, if you modify
the DCOM settings you specified in “Configure DCOM for the
Distributed Job Service on Windows Server 2000,” you must
reboot the machine(s) on which you made the modifications.
My Computer\HKEY_LOCAL_MACHINE\
SYSTEM\CurrentControlSet\Services\PrmJobSvXXXX\Parameters
(where XXXX equals the DB Alias of the database connection).
EstablishDBConnectionRetryCount 3 1-10
Number of times to try to connect to database on startup.
NonRecurringJobRefreshRate 5 1-3600
Frequency (in seconds) in which Primavera’s Web application
jobs are loaded from the database.
For more information about Edit registry settings for summarizer jobs Type 'regedit' in the
summarizer jobs, refer to Start, Run utility to open the Registry Editor. In the Registry Editor,
“About summarizer jobs and
Primavera’s Web application” navigate to the following directory:
on page 279.
My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Primavera.
You can add any of the following settings as D Words and modify the
defaults to the recommended value.
The following settings apply to the Job Service and the Project
Management module. You would typically modify them to
improve performance.
[Summarizer settings]
Valid Ranges/
Setting Name and Description Default
Values
NumProjectsSummarizedAtATime 1 1-xx
Number of projects that can be summarized at the same time by the Job Service
or the Project Management module. To achieve the best possible performance,
Primavera recommends that the value of this setting = 20.
PreQuerySummarizablePct 50 0-100
The percentage threshold that determines how the summarizer will analyze a
project’s need for summarization. If the value of the equation shown below is
less than the threshold, each project is considered for summarization individ-
ually. If the value of the following equation is greater than the threshold, all
projects to be considered for summarization are analyzed simultaneously. The
equation that determines this behavior is:
MaxDurationToSummarize -1 -
The maximum remaining duration or the maximum original duration, in hours,
that an activity or activity assignment can have in order to be summarized. If an
activity or activity assignment has a remaining duration greater than this
threshold, it is ignored during summarization. To ensure that all activities are
summarized, Primavera recommends that the value of this setting = 100000.
[Summarizer settings]
Valid Ranges/
Setting Name and Description Default
Values
[Summarizer settings]
Valid Ranges/
Setting Name and Description Default
Values
RetrySleep 60000 -
The time, in milliseconds, to wait between retry attempts
when there is a connection failure.
MaxRetries 10 -
The maximum number of retry attempts to make when
there is a connection failure.
Or, if you are using Microsoft SQL Server, you can also use your
Microsoft SQL Server installation CD to install the client network utility.
If you are unfamiliar with this process, please contact your database
administrator.
Although you are not Next, uninstall the previous version’s server components. Do not install
prompted to do so, it’s a the new client applications before you remove these components.
good practice to restart
your computer between Uninstalling 5.x versions of Job Services
uninstalling an application
1 Click Start, Settings, Control Panel, Add or Remove Programs .
and installing another
application. 2 Select the Primavera entry and click Change/Remove.
3 On the Welcome screen of the Installation wizard, select Modify.
4 On the Select Features to install screen, unselect Job Services and
click Next.
5 On the Ready to Install the Program screen, click Install.
You can install one or more modules. Each module requires approximately
20 MB of disk space.
4 On the Select Driver Type dialog box, select the driver type for the
Primavera database.
If you are installing the Project Management module, you must
configure the client’s connection to the project management database.
If you are installing the Methodology Management module, you must
configure a connection to the methodology management database. If
both are being installed, you are prompted to configure the project
management database connection first.
If you are working with more than one project management database, you
can run jobs for all of the databases from one Windows 2000/2003 server
machine by installing multiple instances of the Job Service, as described in
this section.
For more information on the If you want to be able to run multiple jobs simultaneously on separate
distributed job service, refer servers, you can install the Distributed Job Service on a controller server
to “Configuring the
Distributed Job Service” on that manages the Job Service and distributes jobs to the Job Service
page 237. servers.
Setup will verify that the user has administrator rights on the
computer. If the user does not have administrator rights, the
Setup wizard will end.
2 On the Job Service Alias dialog box, type the database alias in the
DB Alias field; for example, JSDB. Do not use dashes as part of the
DB alias; otherwise, an error will occur.
Click the More button if you want to add more than one service.
You can create multiple instances of the Job Service, which enables
you to run multiple job services for all project management databases
from one Windows 2000/2003 server machine. Create one job service
instance for each database.
For more information on The Job Service uses the DB alias to connect to the database server.
running jobs on multiple
databases using the Job
Service, see “Running Job
Services on Multiple
Databases” on page 278. 3 Enter or select the program folder.
4 Click Install to begin the installation.
5 On the Select Driver Type dialog box, in the Job Services driver
type field, choose the database server type: Oracle or Microsoft SQL
Server/SQL Express.
6 If you are connecting to Oracle, on the Configure ORACLE
Connection dialog box, in the type the Oracle connect string
(database name), which can be found in the TNSNAMES.ORA file.
If you are connecting to Microsoft SQL Server or SQL Server
Express, on the Configure SQL Server Connection dialog box, type
the database name and specify the server computer name.
7 On the Enter Public Login dialog box, enter your public login
information that was defined by your administrator; for example, a
Username of pubuser, and a group ID of 1.
8 On the Validate Database Connection dialog box, click Next to
validate the database connection.
The DB alias that you specified is created.
11 Click Finish.
In the Project Management module, choose Tools, Job Services. Add the
job service you want to run for that database. To set up another job service
for a second project management database, exit the Project Management
module. Log in again and choose a different project management database
by selecting its database alias. In the Job Services dialog box, add the job
for the currently open database.
Specify a different language for the Job Service You can specify
the output language for Job Service jobs. Complete the following steps to
specify a language other than English.
4 On the Select Driver Type dialog box, select the driver type of your
database server. You can select Oracle or Microsoft SQL Server/SQL
Express.
5 Type the connection information as required for your database type.
If you are configuring Oracle, on the Configure ORACLE
Connection dialog box, type the Oracle connect string.
6 On the Enter Public Information dialog box, enter your public login
information that was defined by your administrator; for example, a
Username of pubuser, and a group ID of 1.
7 On the Validate Database Connection dialog box, click Next to
validate the database connection.
8 On the Connection Successful dialog box, if the connection was
successful, a DB alias named PMSDK was created. Click Finish.
If the connection was not successful, click Back to re-enter the
database information.
Once the SDK is installed on your computer, you can connect to the
project management database using the ODBC DSN. The SDK
documentation is located in your \Program Files\Common Files\Primavera
Common\PMSDK\Doc folder.
Installing ProjectLink
ProjectLink is a plug-in that enables Microsoft Project (MSP) users to
work in the MSP environment while being connected to Primavera's
enterprise features. The functionality enables MSP users to open/save
projects from/to the Project Management module database from within the
MSP application. With ProjectLink, MSP users have the ability to invoke
Primavera's resource management within the MSP environment.
ProjectLink enables users to utilize MSP for daily project maintenance
while also having access to the enterprise capabilities available within
Primavera applications.
Install ProjectLink
Complete the following steps to install ProjectLink.
The user should now be able to access ProjectLink on the local machine.
Be sure you check in any projects that are checked out before
you upgrade the database.
3 Enter the following commands to pump the data from your 4.1
Interbase PM and MM databases to 6.0 standalone databases and
upgrade their schema.
For the PM database, enter a command in the following form:
ca pump /sourcestring:db:ib:sysdba/masterkey@<database
location>pmdb.gdb /targetstring:db:ss:sa/<password>@<SQL server
name>:<PM database name> /auto /verbose /truncate /dbtype:pmdb
For example:
ca pump /sourcestring:db:ib:sysdba/masterkey@C:\Program
Files\Primavera\database\pmdb\pmdb.gdb /targetstring:db:ss:sa/
password@<machine name>\primavera:pmdb$primavera /auto /
verbose /truncate /dbtype:pmdb
For the MM database, enter a command in the following form:
ca pump /sourcestring:db:ib:sysdba/masterkey@<database
location>mmdb.gdb /targetstring:db:ss:sa/<password>@<SQL server
name>:<MM database name> /auto /verbose /truncate /dbtype:mmdb
For example:
ca pump /sourcestring:db:ib:sysdba/masterkey@C:\Program
Files\Primavera\database\mmdb.gdb /targetstring:db:ss:sa/
password@<machine name>\primavera:mmdb$primavera /auto /
verbose /truncate /dbtype:mmdb
1 On the Select Features to install dialog box, mark the checkbox next
to Sample Projects if you want to install sample projects.
2 Select the program folder name in which the Primavera icons will be
stored on the Start menu.
If you make no changes, these icons are stored under Programs,
Primavera.
3 If installing the standalone version for the first time on this computer,
on the Select License File dialog box, in the Select a license file for
the newly created database field, browse to the location of the
LICENSE.TXT file.
4 Click Install to begin the installation/upgrade.
During the installation, the setup program automatically installs and
configures Microsoft.NET Framework and Microsoft SQL Server
Express. The setup also installs/upgrades the project management and
methodology management databases.
For information on running You can also rerun the Setup wizard to recreate a set of
an attended setup, see unattended setup files or to create multiple sets of files for
“Running an Unattended different configurations.
Setup” on page 296.
6 On the Product Code dialog box, enter the product key located on the
CD 1 label.
7 Accept the license agreement.
16 On the Select Driver Type dialog box, choose the database type from
the list in the Project Management driver type field.
17 If users will be connecting using SQL Server, on the Configure SQL
Server Connection dialog box, enter the server host name and the
database name. The host name is the name of the computer or IP
address where Microsoft SQL Server is installed. The database name
was specified when the database was created; for example, PMDB.
If users will be connecting using Oracle, on the Configure ORACLE
Connection dialog box, enter the Oracle connection string; for
example, PMDB.
Running an unattended setup saves you time and effort, and it ensures that
every Primavera client module is configured identically at setup. If the
'setup.iss' (or equivalent) file has been stored on a network server, you can
run the unattended setup from any client computer with a network
connection to that server.
Do not include a space between the f1 and f2 and the quote ".
3 On the What would you like to do? dialog box, choose Configure
my database connections.
4 On the Select Database Alias dialog box, choose the appropriate
database; for example, PMDB.
5 On the Select or Create Alias dialog box, select the alias and driver
type of the database.
If you are changing the alias or database driver, type the new alias (for
example, PMDB) or select the new driver type.
If you change the database connection settings for a DB alias and multiple
modules share that alias to access the database, your changes affect all the
modules that share the alias.
If you want to configure application licensing, you can use the wizard to
connect to the database and store the license in the database. You can store
two types of licenses using the Database Configuration wizard: the new
license you receive from Primavera when you implement a new or
upgraded Primavera installation; or, the incremental license you receive
from Primavera when you purchase additional users for your existing
license.
You can also use the Database Configuration wizard to change the
passwords of module user logins. Note that these logins are not database
logins but are the Primavera logins that are administered using the Project
Management module.
To modify the settings for a login, click the appropriate cell and type the
new value. To add a new login, click Add. To delete a login, select the
login and click Delete. Click Finish to close the wizard.
Authentication in Primavera
Typically, within an organization, user access to software applications is
managed through authentication and authorization mechanisms. Simply
put, authentication is the process of validating user identity and
authorization is the mechanism used to control access to specific resources
or data.
Primavera supports three authentication modes: Native (the original
Primavera authentication scheme), Single Sign On, and LDAP.
■ Native
Native authentication is the default mode for all Primavera modules.
In this mode, when a user attempts to log in to a Primavera module,
authentication is handled directly through the module with the
Primavera database acting as the authority.
■ Single Sign On
Single Sign On authentication, which provides access control for Web
applications, is available for Group Server and Primavera’s Web
application. In this mode, when a user attempts to log in to a
Primavera module (protected resource), a Web agent intercepts the
request and prompts the user for login credentials. The user’s
credentials are passed to a policy server and authenticated against a
user data store. With Single Sign On, a user logs on only once and is
authenticated for all Web applications for the duration of the browser
session (provided that all Web applications authenticate against the
same policy server).
■ LDAP (Lightweight Directory Access Protocol)
LDAP is directory-based authentication and is available for client/
server and Web applications. In this mode, when a user attempts to
log in to a Primavera module, the user’s identity is confirmed in an
LDAP-compliant directory server database.
Process Overview
By default, all Primavera modules are installed using Native
authentication. After you install Primavera client/server modules and
additional components, you can choose a different authentication scheme.
2 Select the database alias you want to provision LDAP information for,
then type the database user name and password.
If you choose Native, the Finish button becomes active so you can
exit the wizard.
For all other authentication mode selections, continue through the
wizard to configure additional information as described in the
following steps.
6 On the General tab, specify the LDAP directory server host name or
IP address, listening port, and Base Directory Node.
For Base Directory Node, specify the location in the directory
information tree (DIT) that is the location from which to start the
search for module users during login. Base Directory Node is also the
location where the provisioning function begins the search for
directory server users.
To use SSL protocol for communication with the LDAP server, mark
the Enable SSL checkbox.
If the LDAP server does not allow anonymous searches, click the
Login tab. Type the user name and password of an LDAP server user
who has search access for the Base Directory Node you specified on
the General tab.
When you are finished configuring the LDAP server, click OK or, to
validate connection with the LDAP server, click Test, then click OK
after a successful connection message.
USER_NAME is a required 7 Select an LDAP server. Then, in the LDAP attribute column, specify
field that must be mapped the term/field in the LDAP store that corresponds to the Primavera
and can not be deleted. Up project management/methodology management database
to four fields can be USER_NAME field.
mapped between the
LDAP store and the project Optionally, specify the LDAP term/field for e-mail address, actual
management/methodology name, and office phone number. To add fields, click Add. To remove a
management database. field, select it and click Remove.
If you are unsure of the correct LDAP terms, check with your
LDAP directory server administrator.
10 To import from an LDIF file, click Load LDIF, then navigate to the
file you want to import and click OK.
To import from an LDAP server, you can run an existing search or
define a new search.
If one or more previously defined searches exist, the name of the most
recently run search is displayed next to the Search Name drop-down
list. To initiate the current search, click Run Search. Results display in
the Available Users section. To specify a new search, click Define
Criteria.
Click to
remove the
current search
results or
currently
selected
users.
After running a search, select the Available users For the selected users, click to compare
you want to add to the Primavera database, then records between the Primavera db and
click the right arrow button. To remove a user from LDAP store. Status is indicated by
the Selected users list, click the left arrow button. background color. White indicates a
Click the double arrows to add or remove all listed match, blue indicates that the db record
users. differs from the record in the LDAP store,
and red indicates that the user record
does not exist in the database.
After provisioning users, 11 When finished importing user information, in the Import LDAP Users
you will need to set up dialog box, click Close. To exit the Authentication Configuration
Primavera user accounts wizard, click Finish.
for the imported users by
assigning security profiles
and licenses through the
Project Management or
Methodology Management
modules.
In Native mode
■ Primavera modules present a login dialog that prompts for a user
name and password. In Native mode, the use of passwords is optional.
In LDAP mode
■ All Primavera modules (Project Management, Methodology
Management, Timesheets, Primavera’s Web application, and Software
Development Kit) require a login password.
Additionally, because passwords are stored and authenticated against
an LDAP directory, the capability for users to change passwords
within a Primavera module is disabled.
Capital
Improvement
Oak
County
Dept of Water/
Sewer
Transport Dept
Major Bridges
Streets
WBS.1
WBS.2
State of PA
Labor Mgmt
President
Dept of Water/Sewer
Transportation Department
Engineering Engineering
Management Management
Division Division
With these structures defined, you can map users to their corresponding
roles in the OBS, which in turn can be assigned to each level in the EPS.
The EPS level to which you assign the OBS determines the nodes/projects
the associated user can access. For example, if you assign an OBS element
to the root node of the EPS, the users associated with that OBS element
can access the projects in the entire EPS. If you assign an OBS element to
one branch of the EPS, the associated users can access only projects
within that branch.
The project profile associated with each OBS element determines which
data items in the projects the user can access. Only one OBS element can
be assigned to each EPS level.
For example, suppose that two project profiles are defined: one that allows
edit access to all data, including administration rights (Project Controls
Coordinator profile), and one that allows viewing and editing of most, but
not all, project data (the Project Management module profile). Joe Nolan,
the President of Labor Management, is assigned to the Project Controls
Coordinator profile. The OBS element, Labor Mgmt President, is assigned
as the responsible manager at the Oak County node of the EPS, indicating
that Joe Nolan has access to all nodes and projects within Oak County.
Capital
Improvement
Labor
Management Oak
President County
Joe Nolan - PCC
DOT Water/
Dept of
Director Sewer
Transport Dept
Tim Ryan - PCC
Major Bridges
Streets
WBS.1
Project Profiles:
Project Controls Coordinator (PCC)
WBS.2
Project Manager (PM)
You can further control the access to projects by assigning OBS elements
at the project and/or WBS level. In the previous example, if Marie Ross is
the Project Manager in the Engineering Division responsible for the
Highway 101 project, you can assign her to that OBS element with a
Project Manager profile. She would then have editing access to just that
project.
As another example, if the Design Team needs access to only the design
portion of the Highway 101 Project. You can assign the Design Team to
just the WBS branch in the Highway 101 project that involves the project
design.
You can assign multiple users to the same OBS element and/or you can
assign each user to multiple OBS elements. This flexibility enables you to
provide access to the same EPS branch or project to more than one
responsible manager (OBS element), and it allows you to control access
by the same user across different EPS nodes and projects.
You first would create another project profile that specifies viewing/
editing rights to just project costs and financial data (Account Manager
profile) and then make the following assignments:
Capital
Improvement
Labor
Management Oak
President County
Joe Nolan - PCC
DOT Water/
Dept of
Director Sewer
Transport Dept
Tim Ryan - PCC
Major Bridges
Streets
DOT
Highway Pine Ave Green Lane Hickory
Project 101 Project Project Project Bridge
Manager
Marie Ross - PM
Jim Harkey - AM WBS.1 Project Profiles:
Project Controls Coordinator (PCC)
Project Manager (PM)
Account Manager (AM)
WBS.2
To designate that Jim Harkey has Project Manager rights to the Pine
Avenue project and Marie Ross has Account Manager rights to the Pine
Avenue project, you would need to add another element to the OBS.
Capital
Improvement
Labor
Management Oak
President County
Joe Nolan - PCC
DOT Water/
Dept of
Director Sewer
Transport Dept
Tim Ryan - PCC
DOT
Project
Manager Major Bridges
2 Streets
Jim Harkey - PM
Marie Ross - AM
Highway Pine Ave Green Lane Hickory
DOT 101 Project Project Project Bridge
Project
Manager
Marie Ross - PM
WBS.1 Project Profiles:
Jim Harkey - AM
Project Controls Coordinator (PCC)
Project Manager (PM)
WBS.2
Account Manager (AM)
With these assignments, Jim Harkey and Marie Ross now have Project
Manager rights to their primary projects and Account Manager rights to
their secondary projects.
Process Overview
Organization-wide project management involves a structured approach to
managing several ongoing projects and teams across multiple locations at
the same time. To ensure good results, up-front planning and coordination
by various members of the organization are essential. Before you can use
Primavera to manage your projects successfully, you must first administer
users and set up structures in the Project Management module, including
the organizational breakdown structure (OBS), enterprise project structure
(EPS), and resource hierarchy. Once users and structures are in place, you
can implement security to restrict and/or provide access to project data.
The Methodology The following steps provide guidelines and a general process for
Management module uses its administering users and security in Primavera. Because the structures are
own security model to control
access to the methodology global across the company, some steps may require information from
management database. See many participants. You can vary the order depending on your company’s
“Setting Security in the implementation plan. Also, some of these processes, such as defining
Methodology Management
Module” on page 370. resource security and user interface views, are optional depending on the
needs of your organization.
3 Set up the OBS for your company and assign each element of the
OBS to the appropriate users and project profiles.
The Project Management Identify your company’s management structure and include the roles
Reference Manual or names of those who will be responsible for the projects and work to
(PMRefMan.pdf) is be completed. See “Setting Up the Organizational Breakdown
available online and can be Structure” in the Project Management Reference Manual for more
accessed from your information. Also, see “Assigning OBS Elements and Project
industry-specific folder in
Profiles” on page 358.
the \Documentation folder
of CD 3. View the
information using Adobe 4 Set up the EPS for your company and assign the responsible manager
Acrobat Reader (available (OBS) to each node.
on CD 3). Identify your company’s project structure, which is global across the
organization. See “Setting Up the Enterprise Project Structure” in the
Project Management Reference Manual for more information.
8 Add projects to the EPS and define the WBS for each project.
Administrators can also set Project managers perform this step. They can further control security
preferences for data in the within their own projects by assigning specific OBS elements to WBS
Project Management module.
See “Defining Administrative levels. See “Setting Up the Enterprise Project Structure” and
Preferences and Categories” “Reviewing Work Breakdown Structures” in the Project Management
in the Project Management Reference Manual for more information.
Reference Manual.
When defining each global profile, the Admin Superuser may designate
that users have the ability to add/delete, edit, assign, or view secure codes.
Secure codes enable privileged users to hide Project, Activity, and
Resource codes from users that do not have security privileges to view
them. Also, users with privileges to Edit Security Profiles can restrict other
users to edit, assign, and view privileges. For example, management could
track project approval processes through secure codes that others cannot
edit or, in some cases, view.
Select a global
profile...
For information on assigning The following table defines each global privilege:
global profiles, see “Adding
Users in the Project
Management Module” on The following table groups global privileges by functionality. The
page 345. privileges are listed in the same order as displayed in the
Security Profiles dialog box. To view the privileges in
alphabetical order in the Security Profiles dialog box, click the
Privileges bar as shown in the previous image.
Edit Global Change Create, edit, and delete Global Change specifications
Definitions available to all users.
View Resource Role View, group/sort, filter, and report on resource and role
Proficiency proficiency. A user must have this privilege to view and
search by resource and role proficiency in Primavera’s
Web application.
Approve Resource Approve submitted timesheets as a Resource Manager.
Timesheets
Import Global Data for Import projects, resources, and roles from XER, MSP,
XER, MSP, XLS, and XLS, and P3 formats. A user must also have the Create
P3* Project within EPS project privilege to import and
create new projects. A user must also be a super user to
update a project from XER, XLS, or P3 formats, or to
import MSP formats using Project Link.
Import XML* Import projects from Project Management module
XML format. A user must also have the Create Project
within EPS project privilege to import and create new
projects.
Edit Global Reports Create, edit, and delete global reports; edit report
groups and global report batches; and save global
reports created or modified by the Report Wizard.
Edit Global Tracking Create, edit, and delete global tracking layouts in the
Layouts Project Management module.
Edit Roles Create, edit, and delete global roles.
Edit Global Activity Edit the name of global activity codes. This privilege
Codes automatically enables you to add, edit, and delete
global activity code values as well.
Add Global Activity Add new global activity codes and code values. This
Codes privilege automatically enables you to edit existing
global activity codes and code values as well.
Delete Global Activity Delete global activity codes and code values. This
Codes privilege automatically enables you to add and edit
global activity codes and code values as well.
Edit Issue Forms Add, edit, and delete issue forms and issue form
categories in Primavera’s Web application. Enables
access to the Issues menu in Primavera’s Web
application.
Edit Global Calendars Create, edit, and delete global calendars and shifts.
Edit Resource Create, edit, and delete resource calendars and shifts.
Calendars
Edit Security Profiles Create, edit, and delete global and project security
profiles.
Add/Edit Global Create, edit, and delete global activity and resource
Activity and assignment layouts, views, and filters.
Assignment Layouts
and Filters
Edit OBS Create, edit, and delete global OBS hierarchy.
Edit Project Codes Edit the name of project codes. This privilege
automatically enables you to add, edit, and delete
project code values as well.
Add Project Codes Add new project codes and code values. This privilege
automatically enables you to edit existing codes and
code values as well.
Delete Project Codes Delete project codes and code values. This privilege
automatically enables you to add and edit project codes
and code values as well.
Edit Resource Codes Edit the name of resource codes. This privilege
automatically enables you to add,
edit, and delete resource code values as well.
Add Resource Codes Add new resource codes and code values. This privilege
automatically enables you to edit resource codes and
code values as well.
Delete Resource Codes Delete global resource codes and code values. This
privilege automatically enables you to add and edit
resource codes and code values as well.
Edit Global Portfolios Create, edit, and delete global portfolios in the Project
Management module and in Primavera’s Web
application.
Add and Delete Secure Create, edit, assign, view, and delete all global and
Codes EPS-level secure activity codes and values, as well as
all global secure issue codes and values.
Edit Secure Codes Edit, assign, and view global and EPS-level secure
activity codes and values, as well as all global secure
issue codes and values.
Assign Secure Codes Assign and view global and EPS-level secure activity
codes and values, as well as all global secure issue
codes and values.
View Secure Codes View global and EPS-level secure activity codes and
values, as well as all global secure issue codes and
values.
Edit User Interface Create, edit, and delete user interface views in the
Views* Primavera Web application. This privilege also grants
you the right to assign user interface views to users in
both the Primavera Web application and the Project
Management module.
View All Global/ Access the SDK in read only mode, without superuser
Project Data via SDK privileges.
Edit Global Resource Create, edit, and delete global Resource Teams and
and Role Teams Role Teams. A Resource/Role Team is a collection of
resources/roles. Resource/Role Teams are available in
Primavera’s Web application.
Edit Resource Curves Create, edit, and delete resource distribution curves.
Edit User Defined Create, edit, and delete user defined fields. Without this
Fields* privilege, you can only view user defined fields. In
Primavera’s Web application, enables access to the
Project User Defined Fields section on the
Administration Home page, where you can create, edit,
and delete project user defined fields.
Add/Edit Global Create, edit, and delete global project and WBS
Project/WBS Layouts layouts. In the Web Portfolio Management module,
and Portfolio Views* create, edit, and delete portfolio views.
Edit Microsoft Project Create, edit, and delete Microsoft Project Templates
Templates used to import/export data from/to Microsoft Project.
Edit Activity Step Create, edit, and delete Activity Step Templates used to
Templates add a set of common steps to multiple activities.
Add Global Issue Create new issue codes and issue code values in
Codes Primavera’s Web application. Enables access to the
Issues menu in Primavera’s Web application.
Edit Global Issue Codes Edit issue codes and issue code values in Primavera’s
Web application. Enables access to the Issues menu in
Primavera’s Web application.
Delete Global Issue Delete issue codes and issue code values in Primavera’s
Codes Web application. This privilege automatically enables
you to add and edit global issue codes and issue code
values as well. It also enables access to the Issues menu
in Primavera’s Web application.
Edit Financial Period Create, edit, and delete financial periods in the
Dates Financial Period dictionary. A user must also be
assigned the Edit Period Performance project privilege
to edit period data.
Edit Global Scenarios* Create, edit, and delete global scenarios in the Portfolio
Management module of Primavera’s Web application.
Edit Global Create, edit, and delete global dashboards in
Dashboards* Primavera’s Web application.
Edit Projects from Add, edit, and delete projects from scorecards in the
Scorecards* Portfolio View portlet and the Portfolio Analysis tab in
the Primavera Web application. To edit project data in a
scorecard, a user must also be assigned the 'Edit Project
Details Except Financials' project privilege. To edit
project cost data in a scorecard, a user must also be
assigned the 'Edit Project WBS Financials' project
privilege. To add a project from a scorecard, a user must
also be assigned the 'Create Project Within EPS' project
privilege. To delete a project from a scorecard, a user
must also be assigned the 'Delete Project Within EPS'
project privilege.
For more information on Project profiles are applied to users via OBS assignments. The Project
assigning users to OBS Management module requires that all EPS and WBS elements, and
elements, see “Assigning
OBS Elements and Project projects, are assigned a responsible OBS. The combination of the project
Profiles” on page 358. profile/user assignment to an OBS assignment, and the OBS assignment to
the EPS/WBS, determines which projects and data the user can access.
Create Project within Create, copy, and paste projects within the EPS.
EPS
Delete Project within Delete, cut, and paste projects within the EPS.
EPS
Summarize Project Summarize data for all projects in the EPS.
Edit Project Details Edit fields in General, Dates, Defaults, Resources, and
Except Financials Settings tabs in Project Details. A user must be
assigned this privilege to select the project baseline.
Store Period Store actual this period values for actual units and costs
Performance in a project’s financial periods. A user must be assigned
the Add/Edit Project Activities Except Relationships
project privilege before you can assign this privilege.
Edit Period Edit period performance values for labor and nonlabor
Performance units as well as labor, nonlabor, material, and expense
costs. A user must be assigned the View Project Cost/
Financials project privilege before you can assign this
privilege.
Maintain Project Add, save, and delete a project’s baselines. A user must
Baselines be assigned this privilege, and the Edit Project Details
Except Financials project privilege, to add a project
baseline in the Project Management module.
Run Baseline Update Update a project’s baselines with new project data
using the Update Baseline utility.
Assign Project Baseline Select the project baseline for a project. A user must
also be assigned the Edit Project Details Except
Financials project privilege to select the project
baseline.
Edit Project Work Create, edit, and delete a project's work products and
Products and documents. In Primavera’s Web application, relate
Documents items to documents, change a document's access level,
add and delete folders, and start project document
reviews. Collaboration functionality is additionally
required to change a document's access level, add and
delete folders, and start project document reviews.
Add/Edit Project In Primavera’s Web application, create, edit, delete,
Template Documents check out, and start reviews for project template
documents. A user needs to have the privilege to 'Edit
Project Work Products and Documents' also.
Collaboration functionality is additionally required to
check out and start reviews for project template
documents.
View Project Costs/ View all monetary values for a project. If a user cannot
Financials view project costs, all features that display monetary
values are replaced by three dashes (---) in the Project
Management module and cannot be edited by the user.
The ability to view resource price/time is controlled by
the View Resource and Role Costs global privilege.
Edit Project Activity Modify a project’s activity codes.
Codes
Add Project Activity Create a project’s activity codes.
Codes
Delete Project Activity Remove a project’s activity codes from the project
Codes database.
Edit EPS Activity Modify EPS-level activity codes.
Codes
Edit Project Reports Edit a project’s reports and edit a project’s report
batches.
Edit Project Activity Create, edit, and delete a project’s activity relationships.
Relationships
If your company’s OBS is At a minimum, each user requires a login name, global profile, and
established, and you know licensing information (component and access level). You can also provide
which OBS elements to additional information about the user, such as an e-mail address and office
associate with each user, phone number.
you can make the
assignments in the Project
Access tab in the Users If your organization centralizes user information in an LDAP
dialog box. See “Assigning directory, you can add Primavera users by provisioning from the
OBS Elements and Project LDAP store. For more information, see “Configuring
Profiles” on page 358. Authentication Modes” on page 305. After you provision users,
you will need to assign each user a security profile and license.
If your company utilizes the Add new users Choose Admin, Users. Click Add. Click the General
Primavera Web tab, type the user’s login name and personal name, then click Password.
application, you may want Type the user’s password, then retype the password to verify it. Click OK.
to create a default If the user will be accessing Timesheets, you can associate the user with a
prototype user before resource in the Project Management module at this time, or you can create
adding new users. The
the link when you add resources. Click the Contact tab and type the user’s
prototype user enables you
e-mail address and telephone number.
to define default
dashboards and global
preference settings that If the Project Management module is running in LDAP
apply to all users of the authentication mode, when you click Add, a dialog appears for
Primavera Web you to enter a user name and verify it against the LDAP store.
application. See “Adding a When you click Test, if the user exists in the LDAP store, the
prototype user and actual name, e-mail address, and telephone number fields are
defining default settings for populated—if you previously mapped those fields through the
the Primavera Web Authentication Configuration tool. To add the user, click Add.
application” on page 356 When you click Test, if the user is not found in the LDAP store, a
for more information. message appears to notify you that the user cannot be added.
For more information, see Assign a global profile A global profile determines a user’s access to
“Defining Global Profiles” on application-wide features, such as resources and roles. The Project
page 332.
Management module requires that each user be assigned a global profile.
Choose Admin, Users. Select the user to whom you want to assign a
global profile. Click the Global Access tab, then select the user’s global
profile.
Choose Admin, Users. Select the user for whom you want to set database
access for licensed users of Primavera products. Click the Licensing tab.
For each component you want the user to have access to, mark the
checkbox in the Named or Concurrent column. If your organization has
both named and concurrent licenses, you can assign a combination of
named and concurrent licenses to a user for different components (e.g.,
named user for Primavera’s Web application but concurrent user for
Project Management); however, a user cannot have both a named and
concurrent license for a single component. Clear the checkbox if a user is
not a valid licensed user of the corresponding Primavera component.
Dashboards
In the Dashboards section of the Primavera Web application, Team
Member-licensed users can create private and multi-user dashboards,
create private and multi-user portfolios, and import appointments.
Dashboard portlets display data for projects the user is associated with that
meet the criteria of the specified Dashboard Filter. Together, a user’s
association with a project, OBS access, and security privileges, determine
the level of view and edit access that is granted to project data. A licensed
Team Member can be associated with a project via OBS access, by
assignment as an activity resource, through invitation to join a project, and
by assignment as activity owner in a Reflection project.
• My Projects
• My Workgroups
• My Activities
• My Risks — Users can view, but not add, risks.
• My Issues — Users without OBS access to a project can view, but
not add, issues. Users with OBS access to a project can add issues
with the required security privilege.
• Communication Center
• My Documents — Users can add private documents only.
• My Events
• My Calendar
• My Reports
• Action Required
• Project and Document Workflows
• Cost Worksheet
• Custom Portlet
Projects
In the Projects section of the Primavera Web application, Team Member-
licensed users can access the Projects Home page, the Project Workspace,
and the Activities tab.
The Projects Home page displays all projects to which the user has OBS
access, all projects in which the user is assigned as an activity resource, all
Reflection projects in which the user is designated as an activity owner,
and all projects the user is invited to. From the Projects Home page, a
Team Member-licensed user can create and edit private and multi-user
activity views.
The Activities tab in the Projects section displays all activities the user is
associated with either as an assigned resource or as an activity owner.
Users who are associated with activities, but who do not have OBS access
rights, can view, print, and export data but can not access features and
functions that change project data. For example, they can not edit activity
data in the table, modify the Gantt chart, or modify activity details. Users
associated with activities who have OBS access to the project and the
required security privileges can access and edit activity details, edit fields
in the activity table, modify Gantt Chart bars, establish relationships, and
view cost information.
• Workgroups
• Custom Portlet
• Contract Manager portlets — Users can view all Contract Manager
portlets if the Primavera Web application is configured to access
Contract Manager and the Primavera Web application project is
linked to a Contract Manager project.
All other Project Workspace portlets are not available to Team Member-
licensed users.
Click Help on the Manage 6 On the Dashboards Home page, click Manage Dashboards to create
Dashboards or Dashboard default global dashboards that will be displayed for each new
Preferences pages for Primavera Web application user. Be sure to select All Users as the
details on creating a access type on the Access tab of Dashboard Preferences to ensure that
dashboard, choosing the each dashboard you create is a global dashboard.
portlets to display in a
dashboard, and specifying
user access.
For more information on You can assign a user an OBS element and a corresponding project profile
project profiles, see “Defining in the Users dialog box when you are adding users, or you can make the
Project Profiles” on page 339.
assignment in the OBS dialog box during or after creating the OBS.
Double-click to select
another project profile. To
grant the user read-write
privileges for all aspects of a
project, select Project
Superuser.
Assign OBS elements and project profiles to users You can also
assign OBS elements and project profiles to a user when you first add the
user. Choose Admin, Users. Click the Project Access tab. Select the user to
whom you want to assign an OBS element and project profile, then click
Assign. Select the OBS element associated with the user, then click the
Select button. A default project profile is associated with the user. Double-
click the project profile to choose another profile from the predefined list.
Once you have added users and associated them with OBS elements and
project profiles, you can define the EPS and assign a responsible manager
(OBS element) to each level. You must specify a responsible manager for
each node of the EPS.
Assign OBS elements to the EPS You can assign the responsible
manager (OBS element) to each level of the EPS when you create the
project structure. Choose Enterprise, Enterprise Project Structure. Select
the EPS node, then click the Browse button in the Responsible Manager
field to select the appropriate OBS element. The users associated with the
responsible manager will have access rights to the selected node and all
nodes/projects within that branch. The specific data that can be accessed
within the projects depend on the project profile that corresponds to the
OBS element.
If more than one user is responsible for the same node of the
EPS, you must assign each of those users to the corresponding
OBS element.
Once the EPS and OBS structures are defined and security is implemented
at the EPS level, project managers can begin to add their own projects to
the hierarchy. To further control security within projects, project managers
can assign specific OBS elements to WBS levels. See “Setting Up the
Enterprise Project Structure” and “Reviewing Work Breakdown
Structures” in the Project Management Reference Manual for more
information.
Users with restricted resource access can still view and edit all
current project resource assignments if they have the proper
project privileges.
You can grant one of the following three types of resource access to each
user:
You can assign only one resource node to each user. Multiple
resource nodes are not supported.
Refer to the “Defining Implementing resource security Before you implement resource
Resources and Roles” chapter security, you must first set up your resource hierarchy in a manner that
in the Project Management
Reference Manual for more enables you to assign users to single resource nodes. For example, you can
information on setting up the use resource security to restrict user’s access to resources who are not in
resource hierarchy. the same department or geographic location. In this case, you would create
a resource hierarchy containing separate branches for each department or
geographic location. Once the resource hierarchy is in place, you can
implement resource security by completing the following steps:
Resource access settings 4 Set resource access for the selected user as follows:
are ignored for Admin
Superusers. Admin • To provide all resource access to the selected user, mark the All
Superusers always have all Resource Access checkbox.
resource access. • To restrict resource access to a single resource node for the
selected user, unmark the All Resource Access checkbox. Then,
click the browse button in the Resource Access field and select a
resource.
• If you do not want the selected user to have any resource access,
unmark the All Resource Access checkbox and be sure there is no
resource selected in the Resource Access field.
You must designate one user interface view as the default view
for new Primavera Web application users. The default view
controls user access to functionality only for new users who are
not assigned to a user interface view. Existing Primavera Web
application users who do not have an assigned user interface
view can continue to access all functionality.
When creating user Creating user interface views is a useful way to enhance security and
interface views in the enable users to more easily access the functionality they use when
Primavera Web performing project work and managing projects. For example, executives
application, provide a may require access to some, but not all, project information. In this case,
name for each user you can create a user interface view named 'Executive' that provides
interface view that enables
access to some or all Portfolios functionality, along with access to the
you to easily identify the
Projects data executives require.
user interface view’s
associated functionality.
A user’s associated license and security privilege settings
always override the settings defined in the user’s assigned user
interface view. For example, if a user has a Primavera Web
Resources license but not a Primavera Web Portfolios license,
the user cannot access any functionality in the Portfolios
section of the Primavera Web application, even if Portfolios
functionality is enabled in the user’s assigned user interface
view. Additionally, if you assign a user interface view to a user
who has only a Team Member license, view settings are
ignored; the functionality available to Team Member-licensed
users is always controlled by the license. For more information
on functionality available to Team Member-licensed users, refer
to “What does the Team Member license enable a user to
access?” on page 351
You can also utilize user interface views to hide Primavera Web
application functionality your organization does not use. For example, if
your organization does not use Primavera Timesheets for time reporting,
you can hide the Approve Timesheets Action Bar item in the Resources
section and the Timesheet Approval tab in the Projects section.
In addition to customizing
the Primavera Web
application interface
using user interface
views, you can create a
prototype user to specify
default dashboards and
global preference
settings. Refer to “Adding
a prototype user and
defining default settings
for the Primavera Web
application” on page 356.
The security model for Methodology Management differs from the Project
Management module. Only one methodology can be open at a time, and
there is no EPS. Users and methodology profiles cannot be assigned to
OBS elements; methodology profiles must be assigned directly to users to
allow the user access to a methodology.
This section discusses the process of creating security profiles and users in
the Methodology Management module.
Select a global
profile...
Edit Work Products and Create, delete, and change work product and document
Documents records.
Edit Reports Create, edit, and delete reports; save reports in the
Report Wizard.
Edit Activity Codes Create, change, and delete global activity codes and
values.
Edit Estimation Factors Create, change, and delete estimation factors.
View Resource Prices View resource prices.
Edit Global Activity Create, delete, and change global activity layouts and
Layouts and Filters filters.
Edit User Defined Create, edit, and delete user-defined fields. Users that
Fields do not have this privilege can view user-defined fields.
Edit Microsoft Project Create, edit, and delete Microsoft Project Templates
Templates used to import/export data from/to Microsoft Project.
Edit Activity Step Create, edit, and delete Activity Step Templates used to
Templates add a set of common steps to multiple activities.
Add new users Choose Admin, Users. Click Add. Click the General
tab, type the user’s login name and personal name, then click Password.
Type the user’s password, then retype the password to verify it. Click OK.
Product licensing You do not need to assign product licensing for the
Methodology Management module. For each license of the Project
Management module that you have purchased, you automatically are
granted one license of the Methodology Management module.
Double-click in the
Global Profile column
and choose the
appropriate profile for
the selected user.
Implementing Timesheets
Project team members can use Timesheets to
In this chapter submit timesheets that update their activities in
the Project Management module. This chapter
Implementation Overview
describes how to configure the Project
Setting Timesheet Preferences
Management module for use with Timesheets
Configuring Resources to Use
Timesheets and how to run Timesheets once it has been
Creating Timesheets for configured.
Timesheets Users
Setting Project-Specific
Timesheets Preferences
Using Overhead Codes
Running Timesheets Web
Browser Version and Java Web
Start Version
Implementation Overview
Timesheets enables project team members to use the web to communicate
timesheet and activity status directly to their organization’s database,
regardless of their location. This ensures that project managers are always
working with the most up-to-date project information, making it easier to
plan resource use or resolve conflicts.
Before you implement Timesheets, first ensure that the following steps
have been completed:
■ Install the project management database, as described in “Database
Installation and Configuration” on page 25.
■ Install a Web server, if one is not already available.
■ Install the Group Server, as described in “Configuring the Group
Server for Timesheets” on page 91.
■ Install the Timesheets Java files on the Web server, as described in
“Installing the Group Server and Timesheets Web Site” on page 93.
■ If you are using Timesheets Java Web Start version, configure Java
Web Start as described in “Setting up Java Web Start for Timesheets”
on page 112.
After the Timesheets files have been installed, use the Project
Management module to perform the following steps, which are described
in more detail in this chapter:
■ Set preferences for how users will use timesheets.
■ Configure resources to use Timesheets.
■ Create timesheets.
■ Set project-specific preferences for Timesheets.
■ Create overhead codes for recording nonproject hours.
For information on approving The Timesheet Approval Level section contains the following options:
timesheets, see the
“Updating, Scheduling, and ■ Auto Submission Choose to indicate that resource timesheets do not
Leveling” chapter in the need to be submitted or approved. Timesheet data are automatically
Project Management
Reference Manual. updated in the database when you apply actuals.
■ Auto Approval Choose to indicate that resource timesheets do not
require management approval. Timesheets are approved automatically
when they are submitted.
■ 1 Approval Level Choose to indicate that resource timesheets
require approval by the resource/cost manager only. If you select this
option, the status of all submitted timesheets remains “Submitted”
until the approving manager changes the timesheet’s status. If you
previously required both project manager and resource/cost manager
approval, and you select this option, the status of all current
timesheets that have received one level of approval changes to
“Approved.”
■ 2 Approval Levels Choose to indicate that resource timesheets
require approval by project and resource/cost managers. If you select
this option, the status of all submitted timesheets remains
“Submitted” until both managers approve the timesheet.
■ Project Manager Must Approve Before Resource Manager If you
choose 2 Approval Levels, mark to indicate that project managers
must approve timesheets before resource/cost managers.
■ Default Resource Manager Approving Timesheets The name of
the manager who approves resource timesheets, unless you specify
otherwise. Click the Browse button to select a new manager.
Set overtime policy You can enable users to enter overtime in their
timesheets. In the Project Management module, choose Enterprise,
Resources, then click the Details tab. Mark the Overtime Allowed
checkbox. Type the overtime factor by which the resource’s standard price
is multiplied to determine the overtime price (standard price * overtime
factor = overtime price).
To create another set of timesheets, reset the batch start and end dates,
select the appropriate timesheet period, then click Batch Create.
You cannot create new timesheets that have start and end
dates that overlap existing timesheet dates.
Mark to allow
resources to view
activities that belong to
inactive projects, to
report activities or
assignments as
completed, and to
choose which activities
they should begin next. Choose whether resources indicate
progress on activities by entering
percentages or units of time remaining.
Run Timesheets
1 To load the Timesheets version from the server, visit the URL where
the Timesheets launch page is located (the server you specified during
installation).
• For Timesheets Web Browser version, enter:
<Web server>/GroupServer/en/Index.html, where /en is the language
subfolder.
For example, http://10.12.14.123/Groupserver/en/index.html.
If the Web Server is not using the default port, you must enter
the port number after the IP address separated by a semicolon
(:).
You will only be prompted to download the Java files the first
time you click the Run Timesheets link.
To upgrade a stand-alone You can upgrade your database automatically using the Database wizard.
installation, see “Installing The wizard runs the necessary scripts to upgrade the database structure
and/or Upgrading the Stand-
Alone Version” on page 287. and an upgrade program to add data required by the new version.
If you are currently running Primavera with Microsoft SQL Server, see
“Upgrading a Microsoft SQL Server Database to Version 6.0” on
page 402.
■ The upgrade will fail if you are using any Oracle version prior to
9.2.0.7.
■ Datafiles in the LOB tablespace (e.g., PMDB_LOB1) should be made
to autoextend. The estimated sizing is not exact, and the database
conversion may fail if the datafiles are a fixed size.
■ If your existing database uses code page WE8ISO8859P1 and you
want to use the Euro symbol, you will need to convert your database
to WE8MSWIN1252 using the following statement:
The wizard runs the necessary scripts to upgrade the database structure
and an upgrade program to add data required by the new version.
You must upgrade both the project management and the methodology
management databases.
Exporting Projects
For information about You can transfer project data from the Project Management module as
importing XER and XML XER files (Primavera proprietary exchange format) or XML files, which
files, see “Importing Projects”
on page 417. can be used with any other Project Management module installation,
regardless of the database type on which it runs. Use the Export wizard to
For information about the export Project Management projects.
tables and fields that are
converted in XER format, see
the XERPROJECTS.PDF When you export project data, some data is not exported,
file, located in the
\Documentation\Technical including timesheets and baselines. You can export secure
Documentation\Data codes and secure code assignments to XML format, if you have
Mapping Docs folder on CD the correct access; however, you cannot export them to XER
3. format. For more information about secure codes, refer to the
“Defining Global Profiles” on page 332.
Data formats 9
XML is an industry-standard format, while XER
is proprietary.
Multiple projects 9
XER supports exporting multiple projects at
once, to a single XER file.
XML exports only a single project to a separate
XML file, at a time.
Job Service 9
XER supports scheduling exports on a regular
basis as services.
XML does not.
Clear the Export checkbox next to each project that should not be
exported, then click Next.
Specify filename and location Type a name for the XER file. To
specify a different location to store the file, click the Browse button. If
you do not specify a folder, the file is stored in the My Documents folder
of the current user. Click Finish to export the project to a single file with
an XER extension.
You must have the appropriate access rights to set up job services. The Job
Service does not interact with the Project Management client when
running jobs. All jobs are run on the server on which the Job Service is
installed.
If multiple projects are open, select the Export checkbox next to the single
project that you want to export. You can select only one project when
exporting to XML format. Then click Next.
Specify filename and location Type a name for the XML file. To
specify a different location to store the file, click the Browse button. If you
do not specify a folder, the file is stored in the My Documents folder of the
current user. Click Finish to export the project to a single file with an
XML extension.
Type a name for the XER file. To specify a different location to store the
file, click the Browse button. If you do not specify a folder, the file is
stored in the My Documents folder of the current user. Click Finish to
export the roles or resources to a single file with an XER extension.
Click to
select the
location
where the
file will be
stored.
Importing Projects
For information on exporting You can transfer project data to the Project Management module as XER
project data, see “Exporting files (Primavera proprietary exchange format) or XML files, which can be
Projects” on page 408.
used with any other Project Management module installation, regardless
For information about the of the database type on which it runs. You can use the Import wizard to
tables and fields that are bring XER or XML files into the Project Management module. You can
converted in XER files, see
the XERPROJECTS.PDF also use a command line (batch) interface to import XER files. You might
file, located in the want to use these methods to quickly restore one or more projects. The
\Documentation\Technical Import wizard guides you through the steps for importing projects.
Documentation\Data
Mapping Docs folder on CD
3. When you import project data, some data is not imported,
including timesheets and baselines. You can import secure
codes and secure code assignments to XML format, if you have
the correct access; however, you cannot import them to XER
format. For more information about secure codes, refer to
“Defining Global Profiles” on page 332.
For information on importing XER files exported from version 4.x of the Project Management
material resources, see module, or from Primavera Contractor 4.1, can be imported in
“Importing Roles or version 6.0 of the Project Management module.
Resources” on page 436.
Security.
XML always enforces individual user security
9
settings, and never violates your security restric-
tions. If there is a security conflict, the import
will try will continue and ignore data that a user
should not have access to; if it is not possible to
continue while ignoring data, the import is
stopped. Security is never bypassed when
updating data.
XER allows updates to all data if you have the
Import Global Data security privilege set.
Exclusive Project Access 9
XML always opens a project as exclusive, and
will stop the import if it cannot gain exclusive
access. This ensures that other users are not
changing data during the import process.
XER accesses projects as shared, which means
other users might be updating data in the middle
of the import process.
Committing Data 9
XML will not commit partial data. If an import
action for a specific transaction fails before all
data is committed, XML rolls back the data;
global and project-specific imports are treated as
separate transactions.
XER can end up with partial commits of data.
Multiple projects 9
XER supports importing multiple projects at
once, from a single XER file.
XML imports only a single project, from a
separate XML file, at a time.
Documents 9
XER supports importing documents that are not
related to collaboration, such as work products
and other documents.
XML does not.
Version Checking 9
XER checks project versions while importing,
and ensures you cannot import projects older
than 2 prior releases.
XML does not; instead, if there is a version
incompatibility, bad data is ignored.
Click the
Browse
button to
select the
file you
want to
import.
Click
Next.
If you include more than Specify import project options An XER file can contain data from
one project in an XER file, several projects. The first column in the Import Project Options dialog box
the relationships between lists all the projects included in the XER file. If a project with the same
the projects are preserved. name already exists in the current installation of the Project Management
External dependencies module, the Match checkbox next to it is marked.
with projects you did not
export are also preserved.
You must select the Create New Project option if you want the
Project Management module to import past period actual data.
If you choose any other option, past period actual values are
not imported. If you select the Create New Project option, past
period actual data will only be imported if the defined financial
periods are exactly the same in both databases.
The Modify Import Configuration dialog box lists the data types for which
you can set options. Mark the Delete checkbox next to a data item to
remove data that exists in the project you are updating, but is not included
in the file you are importing. For example, if several activities are defined
in the project you are updating, but they are not included in the file to be
imported, mark the checkbox in the Delete column to remove the activities
from the project being updated.
Select one of the following in the Action field to indicate how the data
type is updated:
■ Keep Existing Retains data in the existing project and does not
overwrite it with the updated data; adds new data if the record does
not exist.
■ Update Existing Overwrites data in the existing project with updated
data; adds new data if the record does not exist.
■ Insert New Retains data in the existing project and adds any new
data items. For example, if a new role was added in the XER file, but
you don’t want to change the existing roles, choose Insert New to add
the new role to the existing project.
■ Do Not Import Retains data in the existing project and does not
import the updated data.
The action you choose for importing the items in the Activity Data Type
group are dependent on each other. For example, if you choose to update
existing relationships, you must also update existing resource assignments
and activities associated with the relationships.
You will not see this dialog box if the import currency is the
same as the base currency.
Click the
Browse
button to
select the
file you
want to
import.
Click
Next.
Specify import project options An XML file can contain data from
only one project. Select the appropriate import action and click Next.
The Modify Import Configuration dialog box lists the data types for which
you can set options. Mark the Delete checkbox next to a data item to
remove data that exists in the project you are updating, but is not included
in the file you are importing. For example, if several activities are defined
in the project you are updating, but they are not included in the file to be
imported, mark the checkbox in the Delete column to remove the activities
from the project being updated.
Select one of the following in the Action field to indicate how the data
type is updated:
■ Keep Existing Retains data in the existing project and does not
overwrite it with the updated data; adds new data if the record does
not exist and you have the appropriate security privileges.
■ Update Existing Overwrites data in the existing project with updated
data; adds new data if the record does not exist.
■ Insert New Retains data in the existing project and adds any new
data items. For example, if a new role was added in the XML file, but
you don’t want to change the existing roles, choose Insert New to add
the new role to the existing project.
■ Do Not Import Retains data in the existing project and does not
import the new or updated data.
When you import projects with the command line interface, you
can create only new projects, you cannot update an existing
project.
To use the Windows command line interface to import an XER file, do the
following:
Tag Description
Internationalization Notes
If you include non-English characters in the actions.xml file, save the file
as Unicode, and use the XML encoding attribute to specify the language,
prior to the <actions> tag. For example, to specify German or French
encoding:
<?xml version=”1.0” encoding=”windows-1252”?>
If you are using a batch file, use the chcp command to specify the appro-
priate language encoding. See Microsoft.com for details.
Parameter Description
For example:
PM.EXE /username=admin /password=admin /alias=PMDB
/actionScript=c:\somefolder\importprojects.xml /logfile:c:\somefolder\myLog.txt
If any values include spaces, enclose the value in double quotes (“”).
For example:
PM.EXE /username=admin /password=admin /alias=PMDB
/actionScript=”c:\some folder\importprojects.xml”
/logfile=”c:\some folder\myLog.txt”
Processing results are written to the log file, or you can echo them to the
command line interface. Possible results are:
Code Description
0 Success.
1 Invalid alias.
If the command does not include all the required parameters, the PM
module opens.
The data in the import file must match the type being imported.
For example, you cannot import resource data from an XER file
that contains project data.
Select one of the following in the Action field to indicate how the roles or
resources are updated:
■ Keep Existing Retains roles/resources in the global dictionary and
does not overwrite them with the updated data; adds new data if the
record does not exist.
■ Update Existing Overwrites roles/resources in the global dictionary
with updated data; adds new data if the record does not exist.
■ Insert New Retains roles/resources in the global dictionary and adds
any new roles/resources.
You will not see this dialog box if the import currency is the
same as the base currency.
Exporting Methodologies
For more information about Methodologies can be transferred from the Methodology Management
importing methodologies as module as XER files (Primavera proprietary exchange format) and used
XER files, see “Importing
Methodologies” on page 446. with any other Methodology Management installation, regardless of the
database type on which it runs. Use the Export wizard to export
methodologies to XER files; use the Import wizard to bring XER files into
the Methodology Management module. You may want to use these
wizards to quickly back up and restore one or more methodologies. They
should not be used to back up your entire database. The Export wizard
guides you through the steps for exporting methodologies.
Specify filename and location Type a name for the XER file. To
specify a different location to store the file, click the Browse button. If
you do not specify a folder, the file is stored in the My Documents folder
of the current user. Click Finish to export the methodology to a single file
with an XER extension.
Type a name for the XER file. To specify a different location to store the
file, click the Browse button. If you do not specify a folder, the file is
stored in the My Documents folder of the current user. Click Finish to
export the roles or resources to a single file with an XER extension.
Click to
select
the
location
where
the file
will be
stored.
Importing Methodologies
For more information on Methodologies can be transferred from the Methodology Management
exporting methodologies, see module as XER files (Primavera proprietary exchange format) and used
“Exporting Methodologies”
on page 442. with any other Methodology Management installation, regardless of the
database type on which it runs. Use the Export wizard to export projects to
XER files; use the Import wizard to bring XER files into the Methodology
Management module. You may want to use these wizards to quickly back
up and restore one or more methodologies. The Import wizard guides you
through the steps for importing methodologies.
Select the action to take with the imported data If you have a
methodology open when you import, you are prompted to choose an
action. Choose one of the following actions, then click Next:
■ Create a New Methodology The existing methodology’s data
remains the same. A new methodology is created. This action is
performed automatically if no methodology is open when you import.
■ Add into the Current Methodology You can merge the
methodology you are importing within an existing methodology.
Click Next, then select a specific WBS level within the methodology.
The imported methodology is appended to the selected WBS.
■ Replace the Current Methodology The existing methodology is
deleted and replaced with the one imported from the XER file.
The Modify Import Configuration dialog box lists the data types for which
you can set options. Mark the Delete checkbox next to a data item to
remove data that exists in the methodology you are updating, but is not
included in the file you are importing. For example, if several activities are
defined in the methodology you are updating, but are not included in the
file to be imported, mark the checkbox in the Delete column to remove the
activities from the methodology being updated.
Select one of the following in the Action field to indicate how the data
type is updated:
■ Keep Existing Retains data in the existing methodology and does not
overwrite it with the updated data; adds new data if the record does
not exist.
■ Update Existing Overwrites data in the existing methodology with
data; adds new data if the record does not exist.
■ Insert New Retains data in the existing methodology and adds any
new data items. For example, if a new role was added in the XER file,
but you don’t want to change the existing roles, choose Insert New to
add the new role to the existing methodology.
■ Do Not Import Retains data in the existing methodology and does
not import the updated data.
Click OK to save changes to the modified layout configuration. Click
Next.
You will not see this dialog box if the import currency is the
same as the base currency.
The data in the import file must match the format being
imported. For example, you cannot import a project from an
XER file that contains only role or resource data.
Click the
Browse
button to
select the
file you
want to
import.
Click Next.
Select the source data for estimates You use either the actual
effort and cost data from the project or the project’s planned data as the
basis of the methodology’s effort and cost estimates.
The Modify Import Configuration dialog box lists the data types for which
you can set options. Mark the Delete checkbox next to a data item to
remove data that exists in the methodology you are updating, but is not
included in the file you are importing. For example, if several activities are
defined in the methodology you are updating, but are not included in the
file to be imported, mark the checkbox in the Delete column to remove the
activities from the methodology being updated.
Select one of the following in the Action field to indicate how the data
type is updated:
■ Keep Existing Retains data in the existing methodology and does not
overwrite it with the updated data; adds new data if the record does
not exist.
■ Update Existing Overwrites data in the existing methodology with
updated data; adds new data if the record does not exist.
■ Insert New Retains data in the existing methodology and adds any
new data items. For example, if a new role was added in the XER file,
but you don’t want to change the existing roles, choose Insert New to
add the new role to the existing methodology.
■ Do Not Import Retains data in the existing methodology and does
not import the updated data.
Click OK to save changes to the modified layout configuration. Click
Next.
You will not see this dialog box if the import currency is the
same as the base currency.
The data in the import file must match the format being
imported. For example, you cannot import resource data from
an XER file that contains project data.
Double-click to select
the action to take
when duplicate data is
encountered.
Select one of the following in the Action field to indicate how the roles or
resources are updated:
■ Keep Existing Retains roles/resources in the global dictionary and
does not overwrite them with the updated data; adds new data if the
record does not exist.
■ Update Existing Overwrites roles/resources in the global dictionary
with updated data; adds new data if the record does not exist.
■ Insert New Retains existing roles/resources in the global dictionary
and adds any new roles/resources.
You will not see this dialog box if the import currency is the
same as the base currency.
Exporting Projects
For information about the When you export Project Management project data to MPX, MPP, or
fields that are converted, see XML format, you can then import the file into Microsoft Project. MPX
MSPMAPPINGS.PDF or
MPXMAPPINGS.PDF, files can also be imported into other software applications that support the
located in the MPX format. The Export wizard guides you through the steps for
\Documentation\Technical exporting projects. You can convert multiple projects at a time to MPX,
Documentation\Data
Mapping Docs folder on CD MPP, or XML format.
3.
When you export project data, secure codes and secure code
assignments related to the project are not exported. For more
information about secure codes, refer to “Defining Global
Profiles” on page 332.
For additional export The Project Management module does not support exporting
considerations regarding manual assignment values (manual curves) to Microsoft Project
manual assignment values 98. To export manual assignment values, you must have
(manual curves), refer to the
Project Management module Microsoft Project 2000 or later; however, Microsoft Project 2007
Help. is not supported. Microsoft provides a conversion utility to
upgrade your Microsoft Project 98 databases to Microsoft
Project 2002. For more information, refer to
www.microsoft.com/downloads. If you plan to exchange project
data containing manual assignment values with Microsoft
Project, you will achieve the most accurate conversion results
using Microsoft Project 2003. For more information on manually
planning future period assignments, refer to the Project
Management Reference Manual or the Project Management
module Help.
Select export type and project Open the projects in the Project
Management module you want to export. Choose File, Export. Choose
Microsoft Project and select the type of file to which you want to export,
then click Next.
Clear the Export checkbox next to each project that should not be
exported. Double click in the Export File Name field if you want to change
the name and location of the Microsoft Project file. If you do not specify a
folder, the file is stored in the My Documents folder of the current user.
Click Next.
Click the Activity tab in the Modify Template dialog box. In the Export
section, choose the text field to which to export the Activity ID from the
Project Management module. If you choose not to export the Activity ID
to a text field in Microsoft Project (the checkbox is not marked), the
Project Management Activity ID is not exported to Microsoft Project.
Click the Notebooks tab in the Modify Template dialog box. Notebook
fields are defined in the Project Management module in Admin Categories
(choose Admin, Admin Categories, then click the Notebook Topics tab).
These notebook fields can be exported to project, WBS, and activity notes
fields in Microsoft Project.
Click the Custom Field Mappings tab in the Modify Template dialog box.
To export your user-defined fields to a particular Microsoft Project field,
select the user-defined field in the Project Management Field column.
Exporting Resources
For information about the The Project Management module enables you to export only the resources
fields that are converted, see in your resource hierarchy. When you export the Project Management
MSPMAPPINGS.PDF or
MPXMAPPINGS.PDF, module’s resource data to MPX, MPP, or XML format, you can then
located in the import the file into Microsoft Project. MPX files can also be imported into
\Documentation\Technical other software applications that support the MPX format. The Export
Documentation\Data
Mapping Docs folder on CD wizard guides you through the steps for exporting resources.
3.
When you export resources, secure codes and secure code
assignments related to the resources are not exported. For
more information about secure codes, refer to “Defining Global
Profiles” on page 332.
Type a name for the MPX/MPP/XML file. To specify the location where
the file will be stored, click the Browse button. If you do not specify a
folder, the file is stored in the My Documents folder of the current user.
Click to
select the
location
where the
file will be
stored.
Click the Custom Field Mappings tab in the Modify Template dialog box.
Choose Resources from the drop down list. To export your user-defined
fields to a particular Microsoft Project field, select the user-defined field in
the Project Management Field column.
When you import project data, secure codes and secure code
assignments related to the project are not imported. For more
information about secure codes, refer to “Defining Global
Profiles” on page 332.
Select import type and file Choose File, Import. Choose Microsoft
Project, then click Next.
Click Select to choose the files you want to import. If there is a password
on the Microsoft Project file, type the password. If you do not enter a
password on a protected file, the project will not import.
Double click the Import Action field to select how the Microsoft Project
file should be imported:
■ Create New Project The existing project’s data remains the same. A
new project is created. Select the level of the EPS at which the project
should be imported. Click the Browse button in the Import To field to
select an EPS node.
■ Add into Existing Project Click the Browse button in the Import To
field to select a specific WBS level within an existing project. The
imported project is appended to the selected WBS. The existing
project must be open in the Project Management module.
■ Replace Existing Project The existing project is deleted (without
preserving any information) and replaced with the project imported
from the Microsoft Project file. Click the Browse button in the Import
To field to select the project to replace. The existing project must be
open in the Project Management module.
For additional import The MPX file format does not support time-phased data and
considerations related to therefore does not support manual assignment values (manual
manual assignment values curves). When you import an MPX file, if you choose the
(manual curves), refer to the
Project Management module Replace Existing import action and the project you are
Help. replacing contains manual assignment values, all manual
values will be deleted.
Click the General tab in the Modify Template dialog box. The Project
Management module cannot read the currency defined in Microsoft
Project. Click the Browse button in the Select a Currency field to select a
currency to use for values in cost fields. If your currency is not listed,
cancel the Import wizard and add the currency in the Currencies dialog
box (Admin, Currencies). You can also choose to schedule and/or
summarize the project once it is imported.
Click the Activity tab in the Modify Template dialog box. In the Import
section, choose how you want to import milestone activities that have
resource assignments. You can import them into the Project Management
module as Start Milestone activities with associated expenses, or as Task
Dependent activities with associated resource assignments. Then, choose
to import the Task ID from Microsoft Project to the Activity ID field in the
Project Management module or to a selected user-defined text field.
Finally, choose if you want to import MSP’s fixed costs as project
expenses; if you do not choose this option, fixed costs are not imported.
Click the Resource tab in the Modify Template dialog box. Choose
whether you want to import the Resource Initials or the Resource Name
from Microsoft Project to the Resource ID field in the Project
Management module.
Choose whether you want to add a new resource if the resource does not
already exist in the project management module database but is contained
in the Microsoft Project import file. Then, select the level of the hierarchy
at which resources should be imported. Click the Browse button, then
select the resource under which to place all resources from the Microsoft
Project file.
Click the Notebooks tab in the Modify Template dialog box. Project,
WBS, and activity notes from Microsoft Project are imported into
Notebook fields in the Project Management module. Notebook fields are
defined in the Project Management module in Admin Categories (choose
Admin, Admin Categories, then click the Notebook Topics tab). Select the
Notebook fields into which you want to import the Microsoft Project
notes.
Click the Custom Field Mappings tab in the Modify Template dialog box.
You can import information from Microsoft Project into user-defined
fields in the Project Management module. For each Microsoft Project field
you want to import, select a user-defined field in the Project Management
Field column.
Select import type and file Choose File, Import. Choose Microsoft
Project, then click Next.
Click Select to choose the files you want to import. If there is a password
on the Microsoft Project file, type the password. If you do not enter a
password on a protected file, the resources will not import.
Click the Resource tab in the Modify Template dialog box. Choose
whether you want to import the Resource Initials or the Resource Name
from Microsoft Project to the Resource ID field in the Project
Management module. If you select Resource Initials, only one resource is
imported if multiple resources in Microsoft Project use the same initials. If
you select Resource Name, the first 20 characters of the name import
(based on your setting in the Admin Preferences, ID Lengths tab in the
Project Management module).
Choose whether you want to add a new resource if the resource does not
already exist in the project management database but is contained in the
Microsoft Project import file. Then, select the level of the hierarchy at
which resources should be imported. Click the Browse button, then select
the resource under which to place all resources from the Microsoft Project
file.
Click the Custom Field Mappings tab in the Modify Template dialog box.
You can import information from Microsoft Project into user-defined
fields in the Project Management module. Choose Resources from the
drop-down list. For each Microsoft Project field you want to import, select
a user-defined field in the Project Management Field column. The Field
column is sorted by field type.
Export does not support the sub-unit time format. Make sure
the Sub-unit checkboxes are clear in the Edit, User
Preferences, Time Units tab.
Select export format and subject area Open the project in the
Project Management module you want to export. Choose File, Export to
start the Export wizard. Choose Spread Sheet, then click Next.
Select the project to export from a list of open projects. Click Next.
Select a Subject Area in the Modify Template dialog box to modify its
options. In the Columns tab, select the fields to export. The available
options are based on the selected subject area.
In the Modify Template dialog box, click the Filter tab to select the
activities you want to export for the selected subject area. If using more
than one filter, choose to show activities that meet all selection criteria in
each filter, or to show activities that must meet only one selection criteria
in each filter. Select the filter(s) to use for the export file. If necessary,
click Modify to edit the selected user-defined filter. The fields available for
filtering are based on the selected subject area.
Click the Sort tab in the Modify Template dialog box to apply order to the
columns during export. Select the sort order for each field name. Click OK
to save your modifications to the template.
Click Next to define the location to save the export file. Double click in the
File Name field and click the Browse button if you want to change the
name and location of the export file.
Click Next to view the summary information for the export file. Click
Finish to export the project data to an XLS file.
For information about Update unit, cost, duration, percent complete, and date fields
sheet names for subject When updating unit, cost, duration, and percent complete fields, you may
areas, refer to the want to import one updated field at a time into the Project Management
Primavera Project module. For example, you can export the Activities subject area, and
Management module Help. update the activity percent complete and the remaining duration in the
export file. When you import the Excel file, PM updates the activity data.
However, to update other activity values related to the remaining duration
and percent complete, PM needs to know which field was updated first. In
PM, you cannot update these fields simultaneously.
To update unit, cost, duration, and percent complete fields, make a copy of
the export file you want to update.
In the copied file, update the necessary field for an activity. In that activity
row, blank out the remaining fields that are not marked (*) to give it a null
value. As a result, during import, PM will not update the fields with null
values in the project, and PM will calculate the other fields as necessary.
In PM, choose File, Import to import the Excel file into the selected
project. Repeat these steps for each unit, cost, duration, percent complete,
and date field.
Delete a row To delete a row in the exported file, place a “D” or “d” in
the Delete This Row column in the export file. This is placed as the last
column in the export file. When you import, the deleted row is moved
from the project database.
For example, to change the relationship between two activities, select the
row of the relationship you want to modify in the TASKPRED sheet in
Excel. Choose Edit, Copy, and then choose Edit, Paste to place a copy of
the activity row in the same sheet. Change the value in the Relationship
Type field of one of the rows. Type a “D” or “d” in the other row to delete
it. As a result, Project Management adds a new relationship and deletes the
old relationship.
Activities Activity ID
Activity Successor, Predecessor, Relationship Type
Relationships
When you import multiple fields, fields are updated in the order
reflected in the XLSmappings.PDF, not in the order of the Excel
spreadsheet.
For more information on Select import format and file Choose File, Import. Choose
importing, refer to the Spreadsheet, then click Next.
Project Management Help.
Type the location of the XLS file or click the Browse button to select the
file you want to import. Click Next.
Select import type and options Choose the subject areas to import
into the project. Click Next.
Select the project to update The existing project is updated with any
new/modified data in the XLS file. Click the Browse button in the Import
To field to select the project to update. The project must be open in the
Project Management module to use this option.
Click Next to display information about the import file. Click Finish to
complete the import.
Select export type and project Open the project you want to export.
Choose File, Export. Choose Primavera Project Planner, then click Next.
Mark the Export checkbox next to the project you want to export, then
click Next.
Type a four-character
name for the project.
Select planning unit Choose the planning unit (hours or days) that you
want P3 3.x to use to schedule project data. The Project Management
module uses only hourly planning units. If you choose Days, you can
select to export the resource units as hours or days. Click Next.
Choose cost calculation rules You can set several Autocost rules for
the exported project. Default settings are used for all other Autocost rules.
These calculations apply only when the project is scheduled in P3 3.x. You
can change these settings when you open the project in P3 3.x.
You can define work hours in the Project Management module in half
hour increments. The smallest unit in P3 3.x is hour. If one half of an
hour is work time and the other half is nonworktime in the Project
Management module, the entire hour will be nonworktime in P3 3.x.
■ Custom data items The first eight custom data items in the Project
Management module are converted to P3 3.x.
■ Suspend and resume dates In P3 3.x, a suspend date indicates that
an activity is suspended at the end of the specified day. In the Project
Management module, a suspend date indicates that an activity is
suspended at the beginning of the specified day. Due to this
discrepancy, actual and remaining durations are affected for daily
projects. Hourly projects are not affected.
Calculate start-to-start lag from (Early Calculate start-to-start lag from (Actual
Start or Actual Start) start or Early start)
Compute Total Float as (Start float, Calculate total float as (Most critical,
Finish float, or Smallest of start float Start float, or Finish float)
and finish float)
Mark the ‘Create separate projects’ option if you want to import each
selected subproject as an individual project. If you select this option, you
cannot import the master project. For example, in P3 3.x, the project group
APEX contains three subprojects, AUTO, BLDG, and CONV. This group
is converted to three individual projects (APEX is not converted). Before
the import, create an EPS node to select as the location for the converted
projects.
■ Create new project The existing project’s data remains the same. A
new project is created. If the project does not fit within the existing
EPS, create a new level before importing the project. Click the
Browse button in the Import To field to select the level of the EPS at
which the project should be imported.
■ Replace existing project The existing project in the Project
Management module is deleted (without preserving any information)
and replaced with the project imported from P3 3.x. Click the Browse
button in the Import To field to select the project to replace. The
project must be open in the Project Management module to use this
option.
■ Update existing project The existing project is updated with any
new/modified data in the P3 3.x file. Click the Browse button in the
Import To field to select the project to update. The project must be
open in the Project Management module to use this option.
If you chose Create New Project in the Import Action field, click the
Browse button in the Import To field to select the level of the EPS at which
the project should be imported. To keep your projects organized, it is best
to set up a basic EPS before you import projects.
Select location for resources For each project, select the level of the
hierarchy at which resources should be imported. Click in the Import To
field, then click the Browse button. Select the resource under which to
place all resources from the P3 3.x project. To better organize your
resources, it is best to set up a basic resource hierarchy before you import
projects. If you leave the field blank, the Project Management module
creates a root node with the same name as the P3 project. The resource
field is disabled for the Replace Existing Project and Update Existing
Project import types.
Select location for activity logs P3 3.x activity logs are converted to
notes in the Project Management module. Notebook topics are predefined
categories in the Project Management module that help to organize your
project notes. Choose to create a new notebook topic for the notes, or
select from the existing list of notebook topics. To display notes in the
Project Management module, in the Activities window click the Layout
Options bar, then choose Show on Bottom, Activity Details. Click the
Notebook tab.
The Modify Import Configuration dialog box lists the data types for which
you can set options. Mark the Delete checkbox next to a data item to
remove data that exists in the project you are updating but is not included
in the file you are importing. For example, if several activities are defined
in the project you are updating, but are not included in the file to be
imported, mark the checkbox in the Delete column to remove the activities
from the project being updated.
Select one of the following in the Action field to indicate how the data
type is updated:
■ Keep Existing Retains data in the existing project and does not
overwrite it with the updated data; adds new data if the record does
not exist.
■ Update Existing Overwrites data in the existing project with updated
data; adds new data if the record does not exist.
■ Insert New Retains data in the existing project and adds any new
data items. For example, if a new calendar was added in the P3 3.x
file, but you don’t want to change the existing calendars, choose Insert
New to add the new calendar to the existing project.
■ Do Not Import Retains data in the existing project and does not
import the updated data.
The actions you choose for importing the items in the Activity Data Type
group are dependent on each other. For example, if you choose to update
existing relationships, you must also update existing resource assignments
and activities associated with the relationships.
Click to
import the
P3 project.
■ Planning unit You can only convert projects with an hourly or daily
planning unit. Weekly and monthly planning units are not supported.
To display duration units in hours, choose Edit, User Preferences,
Time Units. Choose Durations as the time unit and Hour as the unit.
■ Activity codes The Project Management module contains global and
project activity codes. Global activity codes are provided with the
sample data delivered with the Project Management module. If you
choose to create separate projects (rather than combine them) in the
Import wizard, all activity codes, activity ID codes, and alias codes
from P3 3.x import as global activity codes in the Project
Management module, so they are available to all projects. If you
choose to combine subprojects into one project to import, the activity
codes, activity ID codes, and alias codes import as project-specific
activity codes.
■ Custom data items P3 3.x custom data items are converted to the
following user-defined data items in the Project Management module.
Start On Start On
Expected Finish Expected Finish Date
■ Target projects You can convert target projects just as you would
any other project; however, the target designators are not converted.
To designate a target project in the Project Management module,
choose Projects, Maintain Baselines. Click Add and choose Convert
Another Project to a New Baseline of the Current Project. Select the
converted target project as the baseline for the current project.
Calculate start-to-start lag from (Actual Calculate start-to-start lag from (Early
start or Early start) Start or Actual Start)
Calculate total float as (Most critical, Compute Total Float as (Start float,
Start float, or Finish float) Finish float, or Smallest of start float
and finish float)
Data not converted This section lists the data items that are not
converted from P3 3.x to the Project Management module. Refer to the
Special Considerations section earlier in this section for additional cases.
■ Layouts, filters, Global Change specifications, and report and
graphic specifications Layouts, filters, Global Change
specifications, and report and graphic specifications are not converted
with the project; however, sample data is provided for these items in
the Project Management module.
■ Access rights Access rights are not converted in the Project
Management module. Your system administrator must set up global
and project profiles that determine privileges.
■ Leveling options and leveling priorities Choose Tools, Level
Resources, to set options for leveling in the Project Management
module.
■ Webster time data Time data entered through Webster for Primavera
is not supported in the Project Management module. The actual
values from Webster are imported into the Project Management
module as a lump sum value. However, all actual values are lost the
first time you use Timesheets. To retain the actual values, you must
first run the Timesheet Actualizer utility. Refer to the readme file in
the \Support\Utilities\ folder on CD 3.
Refer to “Appendix C: ■ Financial periods and past period actuals In the Project
Defining Financial Periods” Management module, financial periods are global. Financial periods
on page 567 for more infor-
mation on defining financial and past period actual data are not converted to the Project
periods in the Project Management module because financial periods are project-specific in
Management module. P3. Choose Admin, Financial Periods, to define financial periods in
the Project Management module. After you define financial periods
choose Tools, Store Period Performance, to store past period actuals
per financial period.
[WBS]
WbsAsActCode=[0,1] Choose 1 to enable the import process to import
all WBS codes as a global activity code. The global activity code name
created, P3 WBS - Proj, where Proj is the name of the project group in P3,
will store the WBS values. If this option is set to 0, the WBS will import to
the WBS structure in the Project Management module. The default setting
is 0.
[Settings]
NoUI=[0,1] Choose 1 to remove the GUI screens when using command
line conversions. For example, if you are using a batch file to perform
many conversions, and you do not want any GUI to show, select 1. The
default setting is 0.
[Resource Units]
The conversion process uses the unit of measure for resources in P3 3.x to
determine whether to categorize a resource in the Project Management
module as labor, nonlabor, or material. If a resource in P3 3.x contains one
of the following units of measure, it is converted as a labor resource in the
Project Management module: h, h., hr, hr., hrs, hrs., hour, d, d., day, days,
w, w., wk, wk., wks, wks., week, m, m., mnth, y, y., yr, yr., yrs, yrs., year,
md, md., mds, mds., mh, mh., mhs, mhs.
In the following example, a1, test, and bbb will be added to the default list
above, hrs and hr. will be removed from it and added to the nonlabor list,
and lb, lbs will be added to the default material list:
[Resource Units]
Labor=a1,test,bbb
NonLabor=hrs,hr.
Material=lb,lbs
BlankIsLabor=[0,1,2]
In the following example, the unit strings a1, test, and bbb are treated as
hourly units:
[Resource Units]
HourlyAdd=a1,test,bbb
[UOM Mapping]
UOM1=unit of measure=unit of measure string
Specify the units of measure used in P3 that are equivalent to the unit of
measure specified in the Admin Categories in the Project Management
module.
In the following example, all abbreviations of cubic yard listed in the unit
of measure string will convert to the standard cubic yard (cu. yard) unit of
measure defined in the Project Management module:
[UOM Mapping]
UOM1 =cu. yard=cy, cuyd, cuy, kf
Exporting Projects
For more information about Project data can be transferred from the Project Management module as
importing Primavera XER files (Primavera proprietary exchange format) and used with
Contractor XER files, see
“Importing Projects in XER Primavera Contractor 5.0. Use the Export wizard to export Project
Format with the Import Management module projects to Primavera Contractor 5.0 XER files; use
Wizard” on page 420. the Import wizard to bring XER files into the Project Management
module. The Export wizard guides you through the steps for exporting
projects.
Select export type and project Open the project(s) in the Project
Management module you want to export. Choose File, Export. Choose
Primavera Contractor 5.0, then click Next. Choose Project as the export
type, then click Next.
Mark the Export checkbox next to the project that you want to export. You
can only export one project at a time. Click Next.
Specify filename and location Type a name for the XER file. To
specify the location where the file will be stored, click the Browse button.
If you do not specify a folder, the file is stored in the My Documents
folder of the current user. Click Finish to export the project to a single file
with an XER extension.
Click to
select the
location
where the
file will be
stored.
• Budget data
• EPS Codes
• Financial periods
• Funding data
• Issues
• Issue Codes
• Manual resource curves (manually-planned future period
assignments)
• Multiple critical float paths
• Past period actuals
• Portfolios
• Project Codes
• Resource Shifts
• Risks
• Roles
• Thresholds
• Work products and documents
Exporting Resources
For more information about The Project Management module enables you to export only the resources
importing Primavera in your resource hierarchy to Primavera Contractor 5.0 XER files. Use the
Contractor XER files, see
“Importing Roles or Export wizard to export Project Management module resources to
Resources” on page 436. Primavera Contractor 5.0 XER files; use the Import wizard to bring XER
files into the Project Management module. The Export wizard guides you
through the steps for exporting projects.
Type a name for the XER file. To specify the location where the file will
be stored, click the Browse button.If you do not specify a folder, the file is
stored in the My Documents folder of the current user. Click Finish to
export the resources to a single file with an XER extension.
Click to
select the
location
where the
file will be
stored.
Process Overview
The following steps outline the process for running the PMDB and
MMDB databases in one Oracle instance.
At the end of the process, your database should look like the following:
For PMDB
admuser pmdb_dat1
privuser pmdb_dat1
pubuser pmdb_dat1
For MMDB
admuser1 mmdb_dat1
privuser1 mmdb_dat1
pubuser1 mmdb_dat1
5 Type the Oracle system user name and password to log on to the
database. Also, enter the Oracle connect string.
6 Click Next to accept the name for the Data, Index, and LOB
tablespaces and estimated tablespace sizes.
7 Accept the default location for the Oracle tablespaces, Data, Index,
and LOB.
10 Follow the remaining steps in the Database wizard to create the tables
and load the data. Click Finish to exit the wizard when it has
completed.
3 Enter MMDB as the database alias and select Oracle as the driver
type.
Once you complete these steps, you should be able to run the
Methodology Management and Project Management modules using the
aliases you established, while still connecting to the same database.
Understanding Undo
Use undo to replace project data to its previous state before changes were
made. You can undo edits, additions, and deletions in the Activity and
Resource Assignments windows in the Project Management module.
Undo stores actions that were made to the project database, however,
certain actions will clear the stored actions:
■ Creating projects
■ Opening and closing projects
■ Summarizing data
■ Updating progress
■ Applying Actuals
■ Refreshing data
■ Importing
■ Auto scheduling
■ Logging in as a different user
■ Changing portfolios
For more information on Undo an action Choose Edit, Undo. The latest action stored for undo
using the Undo feature, see will display next to the Undo command. For example, if you add a
the Project Management
module Help. resource assignment to an activity, then choose to remove the assignment
from the activity, the Undo command in the Edit menu will display as
Undo Add Activity Resource Assignment.
Turn off safe deletes To instantly clear deletes from the project
management database when data is deleted, you have to turn off the safe
deletes function. If you are running SQL Server, you can use its
administrative tools to execute SQL commands. In the database, if the
table ADMIN_CONFIG has the following row, a CONFIG_VALUE of 'N'
means turn off safe deletes.
To turn on safe deletes after its been turned off run the
following update statement:
UPDATE ADMIN_CONFIG SET CONFIG_VALUE = 'Y' WHERE
CONFIG_NAME = 'SAFEDELETE' AND CONFIG_TYPE = 'ACTIVE'
To turn off safe deletes after its been turned on run the
following update statement:
UPDATE ADMIN_CONFIG SET CONFIG_VALUE = 'N' WHERE
CONFIG_NAME = 'SAFEDELETE' AND CONFIG_TYPE = 'ACTIVE'
You must have the Edit Financial Period Dates global privilege
to add or edit data in the Financial Periods dialog box. To store
past period actuals for a project’s defined financial periods, you
must have the Store Period Performance project privilege. To
edit past period actual data after storing period performance,
users must have the Edit Period Performance project privilege.
Choose the
timescale for each
financial period in
the batch, along
with the day of the
week you want the
periods to end on.
Click to generate the batch of
financial periods.
All periods start and end at midnight, and the end date must be
at least one day later than the start date; therefore, the shortest
financial period you can create spans two days.
Index
A Check out projects 342
Administer database settings 57 Client modules
Application data changing user passwords 302
installing for Oracle 53 installing 272
installing for SQL Server 53 minimum requirements 16
loading for Oracle 30 uninstalling 4.1 versions 269
loading for SQL Server 35 CMS service, starting 208
auditing Collaboration 5, 175
detailed configuration 83 applying update 198
overview 81 configuration tasks 209
simple configuration 82 configuring Primavera’s Web application 234
Authentication creating a configuration 202
configure for Primavera’s Web application 150 extending the schema 230
configuring 305–320 installing 178
LDAP 104 migrating 181
login procedures 320 migrating on Solaris 189
Native 306 migrating on Windows 181
Single Sign On 106 supported configurations 19
Authentication Configuration wizard 309 Collaboration server
Authentication library, adding 207 overview 5
Automatic database install 27 CONFIGASST.EXE 400, 558
for Oracle 30 Configuration Manager 209
for SQL Server or SQL Server Express database Controller server 238
automatic install 35 configure 258
Custom portlets
password encryption 151
B Customer support xviii
background processing
monitoring 64 D
reading writing setting values 62
Dashboards, team member access to 352
settings table 61
Database
Base currency, setting 31, 54
administration 57
for SQL database 36
automatic upgrade 397
changing configuration settings for Primavera’s
C Web application 137
Check in projects 342 client drivers, installing 268
driver configurations 149
572 Index
accessing from client browsers 136 using Microsoft Project files 461–480
adding configurations 144 Project management database 28, 40
adding database instances 144 administering private logins 302
administration application 139 changing connection settings 300
application server requirements 19 client drivers 268
available Team Member functionality 351 creating
changing database configuration settings 137 on Oracle 41
client requirements 18 on SQL Server 47
collaboration 5 installing application data 53
configuration settings 152 removing
configure from Oracle 43
authentication 150 from SQL Server 49
custom portlets 151 running in same Oracle instance as MMDB 545
for collaboration 234 sample project data 31, 36, 54
to run Project Architect 146 SQL Server parameters 46
database drivers 149 undoing changes 563
defining user access 368 upgrading
deleting configurations 145 on SQL Server 402
deleting database instances 145 Oracle 400
implementing application server plugins 174 Project Management license, description of 349
installation process overview 129 Project Management module
installing 125 adding users 345
installing the application server 128 defining financial periods 567
invited users 351 installing 270
JSP server requirements 20 minimum configuration requirements 16
licensing 349 overview 4
managing access to multiple database planning issues 12
instances 147 Project manager xvi
overview 5 role defined 9
planning issues 15 Project profile
reviewing and modifying configurations 142 assigning
starting the server 133 to OBS elements 359
stopping the server 135 to users 360
upgrading from a previous version 126
creating 339
Web server requirements 20
definitions 339
Primavision
new privileges 398
uninstalling 127
overview 322
Privileges, new in 5.0 398
privileges defined 340
product limits 23
Project Web Site, supported configurations 20
Program manager xvi
ProjectLink
role defined 9
export considerations 408
Project Architect 146
import considerations 475
Project controls coordinator xvi, xvii
installing 270, 285
role defined 9
overview 6
Project data
user access 286
Team Member access to 353
Projects
transferring
checking in 342
between P3 and the Project Management
checking out 342
module 499 exporting
to other Project Management module Microsoft Project format 462, 488
users 407, 440 P3 format 500
to Primavera Contractor users 537–542 XER format 410
using Microsoft Excel files 487–498
576 Index