Professional Documents
Culture Documents
Services
Administrator’s Guide
Version 6.2
Copyright © 1984-2008 Primavera. All rights reserved.
The software described herein and this documentation is furnished under a Software License Agreement and
may be used only in accordance with the terms of the Agreement.
Except as provided in the applicable Software License Agreement, Primavera assumes no liability resulting from
any omission or inaccuracies in this document or from use of the information obtained herein. Except as
provided in the applicable Software License Agreement, Primavera does not assume any liability arising out of
the application or use of any product described herein. Primavera reserves the right to make changes to any
products described herein to improve reliability, function, or design, and reserves the right to revise this
document and to make changes from time to time in content hereof with no obligation to notify any person of
revisions or changes.
The software products described in this document may not be copied, reproduced, modified, or distributed,
except as indicated in the Software License Agreement. You may not reproduce the printed version of the User
Documentation or other printed materials accompanying the software, except as expressly permitted in the
Software License Agreement or in writing by Primavera. However, you are permitted to reproduce and
distribute as many copies of the electronic version of the User Documentation, in printed and electronic format,
as you reasonably require in support of your use of the software.
U.S. Government Restricted Rights: If the software is acquired for or on behalf of the United States of America,
its agencies and/or instrumentalities (“U.S. Government”), it is provided with RESTRICTED RIGHTS, as set
forth in the Software License Agreement. Use, modification, reproduction, release, performance, display or
disclosure of the software and accompanying documentation by the U.S. Government are subject to the restric-
tions set forth in the Software License Agreement.
Trademarks: Primavera, the Primavera sundial, Authorized Representative, Solution Provider, Business
Solutions for a Project-Driven World logos, P6, P5, P3, Primavera Project Manager, Primavera ProSight,
Primavera Contract Manager, Pertmaster, Primavera Cost Manager, Evolve, Primavera Contractor, Primavera
Inspire, Claim Digger and SureTrak are either trademarks, services marks or registered trademarks of Primavera
in the United States and/or other countries. All other trademarks mentioned herein are the property of their
respective owners.
To view the P6 Commercial Notices and Disclosures for Documentation, go to the docs folder of the installation
directory.
iii
Table of Contents
Preface...................................................................................................v
Using this Administrator’s Guide ........................................................................ vi
Where to Get Support .........................................................................................vii
Installing and Configuring P6 Web Services .....................................1
What is P6 Web Services? .................................................................................... 2
System Requirements............................................................................................ 3
Installing P6 Web Services ................................................................................... 5
Deploying P6 Web Services.................................................................................. 8
Changing Database Configuration Settings ........................................................ 11
Enabling Access to P6 Web Services.................................................................. 12
Using the Primavera Administrator Application ................................................ 13
Starting the Primavera Administrator Application ............................................. 14
Reviewing and Modifying P6 Web Services Configurations.............................. 15
P6 Web Services Configuration Settings ............................................................ 19
Configuring Authentication Modes ..................................................43
Authentication Modes......................................................................................... 44
Implementing Non-Native Authentication.......................................................... 45
Choosing an Authentication Scheme .................................................................. 46
Running the Authentication Configuration Wizard ............................................ 47
Configuring P6 Web Services Authentication .................................................... 58
Login/Logout Changes to Support Authentication Modes ................................. 59
Index....................................................................................................61
v
Preface
P6 Web Services enables organizations to
In this preface: integrate Primavera functionality into other
web-based applications using the following
Using this Administrator’s Guide
web services standards: XML (Extensible
Where to Get Support
Markup Language), SOAP (Simple Object
Access Protocol), and WSDL (Web Services
Description Language).
vi Primavera P6 Web Services
Administrator’s Guide
1
System Requirements
P6 Web Services has the following system requirements for installation:
Administrator’s Guide
4 Primavera P6 Web Services
.NET Requirements
■ To use the .NET client code, you must have Microsoft .NET
Framework version 2.0 or later.
Application Servers
P6 Web Services requires one of the following supported application
servers:
■ JBoss 4.0.5
■ BEA WebLogic Server 10
■ IBM WebSphere Application Server 6.1
Before you start the installation, make sure you set the
JAVA_HOME and CXF_HOME environment variables. For
information on setting the CXF_HOME environment variable,
refer to “Apache CXF Requirements” on page 3.
Administrator’s Guide
6 Primavera P6 Web Services
6 Review the contents of the installation, then click Next to begin the
installation.
7 On the Setup and Configuration of the Primavera Database
dialog box, specify the database type.
You can later change the 8 On the Database Configuration dialog box, specify the database
database type through the connection parameters.
P6 Web Services
Database Configuration P6 Web Services requires pubuser access (in the User Name field)
Setup. to the database. The database name, host address, and host port are
specific to your Oracle or MS SQL Server installation. Database
Host Port displays the default port for the database type you
selected. You can edit this port.
Administrator’s Guide
8 Primavera P6 Web Services
Administrator’s Guide
10 Primavera P6 Web Services
The database you connect to during the installation stores one or more
P6 Web Services configurations. Each configuration specifies a set of
configurable parameters that determine how P6 Web Services operates.
The first time you install P6 Web Services, if no configuration exists in
the database, you must create a new configuration. For subsequent
installs, you can choose an existing configuration or create a new one.
After installation, you can use the Database Configuration wizard to
select a different P6 Web Services configuration or create a new one.
Administrator’s Guide
12 Primavera P6 Web Services
Administrator’s Guide
14 Primavera P6 Web Services
Administrator’s Guide
16 Primavera P6 Web Services
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.
For more information, see Database driver configurations The following table lists the
Database.Instance.Driver
and
database drivers P6 Web Services supports for each application server/
Database.Instance.URL in database configuration. Use the Database.Instance.Driver
the “P6 Web Services
Configuration Settings” on
configuration setting to specify the database driver you are using.
page 19.
Application
Database Type Database Driver Default
Server
Administrator’s Guide
18 Primavera P6 Web Services
■ Authentication.Mode
Because one P6 Web Services server instance may control more than
one database, in addition to specifying an authentication mode for a
database through the Authentication Configuration wizard, you use the
Authentication.Mode configuration setting to specify the overall
mode you want to use for the P6 Web Services server. For LDAP
authentication with secure communication (SSL) between the P6 Web
Services server and the LDAP server, two additional configuration
settings are required.
[Localization Settings]
Localization/System Language en —
Language for server string constants
Localization/System Country US —
Country for server string constants
Administrator’s Guide
20 Primavera P6 Web Services
[Authentication Settings]
[Database Settings]
Database/Instance/Name — up to 32 characters
The name of this database instance.
Database/Instance/Schema PMDB —
The schema that will be defined for the database.
Database/Instance/URL — —
The database URL used to establish a connection to the
database.
Oracle example:
jdbc:oracle:thin:@xx.xxx.xxx.xx:yyyy:zzzz
SQL example:
jdbc:sqlserver://xxxx:yyyy;database=zzzz;
x = IP address or hostname
y = database listen port
z = database name
Database/Instance/Public Group ID 1 —
The public group ID used to establish a connection to the
database.
Database/Instance/User Name 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.
Administrator’s Guide
22 Primavera P6 Web Services
[Database Settings]
[Database Settings]
Administrator’s Guide
24 Primavera P6 Web Services
[Database Settings]
[Database Settings]
Administrator’s Guide
26 Primavera P6 Web Services
[Database Settings]
Database/Instance/Methodology Management/Name — —
Name of this database instance.
Database/Instance/Methodology Management/ — —
Description
Description of this database instance.
Database/Instance/Methodology Management/URL — —
Database URL used to establish a connection to the
database.
Oracle example:
jdbc:oracle:thin:@xx.xxx.xxx.xx:yyyy:zzzz
SQL example:
jdbc:sqlserver://xxxx:yyyy;database=zzzz;
x = IP address or hostname
y = database listen port
z = database name
Database/Instance/Methodology Management/User — —
Name
The name used to establish a connection to the database.
Database/Instance/Methodology Management/Password — —
The password used to establish a connection to the database.
Database/Instance/Methodology Management/ 1 —
Public Group ID
The Group ID used to establish a connection to the database.
[Database Settings]
Administrator’s Guide
28 Primavera P6 Web Services
[Database Settings]
Database/Instance/Content Repository/URL — —
Database URL used to establish a connection to the
database.
Oracle example:
embedded://jdbc:oracle:thin:@xx.xxx.xxx.xx:yyyy:zzzz
SQL example:
embedded://jdbc:sqlserver://xxxx:yyyy;database=zzzz;
x = IP address or hostname
y = database listen port
z = database name
[Database Settings]
Database/Instance/Workflow Repository/URL — —
Database URL used to establish a connection to the
database.
Oracle example:
jdbc:oracle:thin:@xx.xxx.xxx.xx:yyyy:zzzz
SQL example:
jdbc:sqlserver://xxxx:yyyy;database=zzzz;
x = IP address or hostname
y = database listen port
z = database name
Administrator’s Guide
30 Primavera P6 Web Services
[Database Settings]
[Log Settings]
Administrator’s Guide
32 Primavera P6 Web Services
[Log Settings]
JBoss on Windows:
<webaccesshome>\WebAccessLogs
JBoss on Red Hat Enterprise Linux:
/mount_point/<webaccesshome>/AppServer/
WebAccessLogs
WebLogic on Windows:
<webaccesshome>\WebAccessLogs
WebLogic on Solaris:
/mount_point/<webaccesshome>/WebAccessLogs
WebSphere on Windows:
<webaccesshome>\WebAccessLogs
WebSphere on Red Hat Enterprise Linux:
/mount_point/WebSphere/AppServer/WebAccessLogs
[Application Settings]
Application/Prototype User — —
Prototype user login used to create and store default
Dashboards and Global Preference settings for new P6 Web
Access users.
Application/Ignore Daylight Savings Time true true/false
Set to false to account for daylight savings time.
Administrator’s Guide
34 Primavera P6 Web Services
[Application Settings]
Application/Logout URL — —
Directs P6 Web Access to a specific URL when the user exits
with the Logout/Close icon in the banner of P6 Web Access.
Any valid URL can be used. If no URL is specified, P6 Web
Access directs the user to the launch page of P6 Web Access.
Application/Compress Applet Communication true true/false
Set to true to compress communication between applets and
the server.
[Application Settings]
This setting is only valid when using JRE version 1.6.0_10 (or
later).
Administrator’s Guide
36 Primavera P6 Web Services
[Application Settings]
[Services Settings]
[Services Settings]
Administrator’s Guide
38 Primavera P6 Web Services
[Services Settings]
[Services Settings]
Administrator’s Guide
40 Primavera P6 Web Services
[Services Settings]
[Tracer Settings]
Administrator’s Guide
42 Primavera P6 Web Services
Authentication Modes
P6 Web Services supports the following authentication modes to
validate user logons:
■ Native
Native mode is the original Primavera authentication scheme and is
the default for all applications. When a user attempts to log on to a
Primavera application, native mode confirms the user’s identity in
the project management or methodology management database.
■ LDAP (Lightweight Directory Access Protocol)
LDAP mode is available for the Primavera Project Management
client module, P6 Web Access, the API, and P6 Web Services. In
this mode, when a user attempts to log on to a Primavera
application, the user’s identity is confirmed in a directory server
database.
Administrator’s Guide
46 Primavera P6 Web Services
Administrator’s Guide
48 Primavera P6 Web Services
Administrator’s Guide
50 Primavera P6 Web Services
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. To use referrals, mark the Chase
Referrals 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 and click
OK after a successful connection message.
Administrator’s Guide
52 Primavera P6 Web Services
USER_NAME is a required 7 Select an LDAP server. Then, in the LDAP attribute column,
field that must be mapped specify the term/field in the LDAP store that corresponds to the
and can not be deleted. Up Primavera 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
manager/methodology name, and office phone number. To add fields, click Add. To
manager database. remove a field, select it and click Remove.
If you are unsure of the correct LDAP terms, check with your
LDAP directory server administrator.
Administrator’s Guide
54 Primavera P6 Web Services
Click to
remove the
current
search
results or
currently
selected
users.
After running a search, select the Available For the selected users, click to compare
users you want to add to the Primavera records between the Primavera db and
database, then click the right arrow button. To LDAP store. Status is indicated by
remove a user from the Selected users list, background color. White indicates a
click the left arrow button. Click the double match, blue indicates that the db record
arrows to add or remove all listed 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
you will need to set up Users dialog box, click Close. To exit the Authentication
Primavera user accounts Configuration wizard, click Finish.
for the imported users by
assigning security profiles
and licenses through the
Primavera Project
Management Module.
Administrator’s Guide
56 Primavera P6 Web Services
Administrator’s Guide
58 Primavera P6 Web Services
In LDAP mode
■ All Primavera applications require a logon 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.
In Custom mode
■ Client/server applications require a logon password. Custom mode
is not supported by P6 Web Services.
Administrator’s Guide
60 Primavera P6 Web Services
Index
A D
Administrator application Database configuration
adding P6 Web Services configurations 16 change settings 11
modify configurations 15 starting wizard 11
starting 14 Database driver configurations 17
using 13 Database instances
Application servers adding 16
configuring HTTP(s) 8 deleting 17
deploying into 8 managing access to multiple 17
supported 4 Database requirements 4
Authentication Deploying P6 Web Services 8
configuration settings 58 into JBoss on Windows 8
Authentication modes into Weblogic 9
choosing 46 into WebSphere 10
configuring 43
login/logout changes 59
overview 44
F
select using LDAP Configuration utility 47 Factory Default configuration 15
B H
BEA WebLogic HTTP(s) 8
deploying into 9
supported version 4 I
IBM WebSphere
C deploying into 10
Configuration settings 19 supported version 4
Configurations 15 Installation 1
adding 16 requirements 3
adding database instances 16
deleting 17 J
duplicating 16 Java JDK 3
Configure authentication modes 43 Java Runtime Environment 3
Configure database settings 11 JBoss
Customer support vii deploying into 8
supported version 4
62 Index
L W
LDAP WSDL (Web Services Description Language) 2
provisioning 56
LDAP authentication
configure servers 47
X
description 44 XML (Extensible Markup Language) 2
login procedure 59
provision user information 52, 56
running LDAP utility 47
N
Native authentication 44
login procedure 59
Non-native authentication, implementing 45
O
Operating systems, supported 4
P
P6 Web Services
authentication 18
authentication, configure settings 58
configuration settings 19
configurations, adding 16
configurations, adding database instances 16
configurations, deleting 17
configurations, duplicating 16
database driver configurations 17
deploying 8
enabling access to 12
installing 1, 5–7
modify configurations 15
overview 2
system requirements 3
Project Management database, supported version 4
Provision LDAP user information 52, 56
R
Running Authentication Configuration Wizard 47
S
SOAP (Simple Object Access Protocol) 2
Supported operating systems 4
System requirements 3
T
Technical support vii