WCInstall Config Guide
WCInstall Config Guide
Configuration Guide
Windchill ® 10.0 M050
February 2014
Copyright © 2014 PTC Inc. and/or
and/or Its Subsidiary Companies. All Rights Reserved.
User and training guides and related documentation from PTC Inc. and its subsidiary companies (collectively
"PTC") are subject to the copyright laws of the United States and other countries and are provided under a
license agreement that restricts copying, disclosure, and use of such documentation. PTC hereby grants to the
licensed software user the right to make copies in printed form of this documentation if provided on software
media, but only for internal/personal use and in accordance with the license agreement under which the
applicable software is licensed. Any copy made shall include the PTC copyright notice and any other
proprietary notice provided by PTC. Training materials may not be copied without the express written consent
of PTC. This documentation may not be disclosed, transferred, modified, or reduced to any form, including
electronic media, or transmitted or made publicly available by any means without the prior written consent of
PTC and no authorization is granted to make copies for such purposes.
Information described herein is furnished for general information only, is subject to change without notice, and
should not be construed as a warranty or commitment by PTC. PTC assumes no responsibility or liability for
any errors or inaccuracies that may appear in this document.
The software described in this document is provided under written license agreement, contains valuable trade
secrets and proprietary information, and is protected by the copyright laws of the United States and other
countries. It may not be copied or distributed in any form or medium, disclosed to third parties, or used in any
manner not provided for in the software licenses agreement except with written prior approval from PTC.
UNAUTHORIZED USE OF SOFTWARE OR ITS DOCUMENTATION CAN RESULT IN CIVIL
DAMAGES AND CRIMINAL PROSECUTION. PTC regards software piracy as the crime it is, and we view
offenders accordingly. We do not tolerate the piracy of PTC software products, and we pursue (both civilly and
criminally) those who do so using all legal means available, including public and private surveillance
resources. As part of these efforts, PTC uses data monitoring and scouring technologies to obtain and transmit
data on users of illegal copies of our software. This data collection is not performed on users of legally licensed
software from PTC and its authorized distributors. If you are using an illegal copy of our software and do not
consent to the collection and transmission of such data (including to the United States), cease using the illegal
version, and contact PTC to obtain a legally licensed copy.
Important Copyright, Trademark, Patent, and Licensing Information: See the About Box, or copyright
notice, of your PTC software.
3
Installing Using the PTC Solution Installer ........................................................... 128
Selecting the Installation Type............................................................................ 129
Installing a Standalone Product or Component .................................................... 130
Specifying the User (UNIX Only) ........................................................................ 130
Providing Details for System Notifications and Information Exchange .................... 130
Specifying the Installation Directory .................................................................... 131
Entering the Web Server and Servlet Engine Settings .......................................... 132
Specifying Language Settings............................................................................ 133
Selecting the Database Size .............................................................................. 134
Entering Your Database Information ................................................................... 135
Selecting Data Loader Settings .......................................................................... 140
Entering Your LDAP Settings ............................................................................. 141
Entering Administrative Settings......................................................................... 150
Specifying Optional Product Settings .................................................................. 152
Creating Product Icons or Links.......................................................................... 152
Selecting Staging Directory Options ................................................................... 153
Copying CDs or CD Images to the Staging Area .................................................. 154
Reviewing the Installation Overview ................................................................... 154
Locating Post-installation Steps for Your Products ............................................... 155
Installing a File Server Remote Site........................................................................... 157
File Server Management Utility Overview ............................................................ 158
Installing a File Server Remote Site Using PSI .................................................... 158
Completing Configurations - Manual Steps ................................................................ 161
Completing the Configuration Overview .............................................................. 162
All Solutions ..................................................................................................... 162
Windchill Integrations for Embedded Software ........................................................... 191
Bugzilla and Atlassian JIRA Configuration........................................................... 192
Subversion and IBM Rational ClearCase Configuration........................................ 192
Windchill PDMLink ............................................................................................ 201
Windchill ProjectLink ......................................................................................... 202
Windchill CAPA ................................................................................................ 203
Windchill Nonconformance ................................................................................ 205
Optional Products ............................................................................................. 206
What’s Next Summary ............................................................................................. 255
Other Product Installations and Configurations .................................................... 256
Administrative Activities..................................................................................... 256
About Software Maintenance ............................................................................. 256
Database Initializing and Data Loading...................................................................... 259
Before You Begin .............................................................................................. 260
Starting the Web Server, Servlet Engine, and Windchill Servers............................ 260
Setting the Number of Starting Method Servers ................................................... 261
Creating the Database Schema ......................................................................... 262
Update the Windchill Database .......................................................................... 264
Loading Base and Demonstration Data............................................................... 264
Executing Post-Dataload Steps.......................................................................... 271
Contents 5
Set Authentication in the MapCredentials.xml File................................................ 347
Update the Apache Configuration....................................................................... 349
Verify Your Changes ......................................................................................... 350
User and Group LDAP Attribute Value Mapping ................................................... 350
Configuring Security Labels...................................................................................... 359
About Security Labels ....................................................................................... 360
Security Labels Example Configuration............................................................... 366
Before You Begin .............................................................................................. 368
Configuration Steps .......................................................................................... 370
Additional Configuration Concerns ..................................................................... 393
Best Practices for Security Labels and Agreements ............................................. 403
Installation Logs and Troubleshooting ....................................................................... 405
Installation Log Files ......................................................................................... 406
Troubleshooting Your Initial Installation ............................................................... 407
The PTC Solution Installer Global Registry.......................................................... 422
Loading and Mounting the CD-ROM on UNIX ............................................................ 424
Determining the SCSI ID of the CD-ROM Drive ................................................... 425
Loading and Mounting the CD-ROM Locally........................................................ 426
Loading and Mounting the CD-ROM Remotely .................................................... 427
Recovering an Installation ........................................................................................ 430
Starting and Stopping Windchill ................................................................................ 431
Starting and Stopping Apache and the Windchill Method Server ........................... 432
Using a URL to Access Windchill........................................................................ 433
Running Windchill as a Windows Service............................................................ 434
7
Technical Support
Contact PTC Technical Support through the PTC website, or by phone, email, or
fax if you encounter problems using this product or the product documentation.
The PTC eSupport portal provides the resources and tools to support your PTC
Windchill implementation:
https://www.ptc.com/appserver/cs/portal/
For complete details, see the PTC Customer Service Guide:
http://www.ptc.com/appserver/support/csguide/csguide.jsp
You must have a Service Contract Number (SCN) before you can receive technical
support. If you do not know your SCN, see “Preparing to contact TS” on the
Processes tab of the PTC Customer Support Guide for information about how to
locate it.
Documentation for PTC Products
You can access PTC documentation using the following resources:
• Windchill Help Center —The Windchill Help Center includes all Windchill
documentation. You can browse the entire documentation set, or use the search
capability to perform a keyword search. To access the Windchill Help Center,
you can:
○ Click any help icon in Windchill
○ Select Help ▶ Windchill Help Center from the Quick Links menu at the top
right of any Windchill page
○ Use the following link to access all PTC help centers:
https://www.ptc.com/appserver/cs/help/help.jsp
• Reference Documents website—The Reference Documents website is a library
of all PTC guides:
http://www.ptc.com/appserver/cs/doc/refdoc.jsp
A Service Contract Number (SCN) is required to access the PTC
documentation from the Reference Documents website. If you do not know
your SCN, see “Preparing to contact TS” on the Processes tab of the PTC
Customer Support Guide for information about how to locate it:
http://www.ptc.com/appserver/support/csguide/csguide.jsp
When you enter a keyword in the Search Our Knowledge field on the PTC
eSupport portal, your search results include both knowledge base articles and PDF
guides.
Comments 9
1
Planning a Solution Installation
This section contains information required before you install your solution.
Before you install your solution, be sure you have the most up-to-date version of
this manual. It will be posted on the PTC Web site:
https://www.ptc.com/appserver/cs/doc/refdoc.jsp
11
Installing Windchill PDMLink on a Pro/
INTRALINK 10.0 System
If you are upgrading Pro/INTRALINK 10.0 to Windchill PDMLink select the
Update to Existing Install option in the PSI, and then select Upgrade Pro/Intralink to
Windchill PDMLink . During this process you are asked to create or load a database
schema and base or demo data; this panel can be ignored. Windchill PDMLink
shares the same schema and base data as Pro/INTRALINK 10.0, so there is no
need to install additional schema or base data when installing Windchill PDMLink
on top of Pro/INTRALINK 10.0.
Upon completing the Windchill PDMLink installation thePro/INTRALINK 10.0 is
replaced by Windchill PDMLink in the Windchill version.
If you have customized or otherwise modified yourPro/INTRALINK 10.0
installation, consult the chapter "Managing Customizations" in the Windchill
Customization Guide before installing Windchill PDMLink.
Creo View
Creo View Client and Creo View Thumbnail Generator are installed using the PTC
Solution Installer.
There are additional components of Creo View which are located on product-
specific CDs and require a separate installation. Some of these products may
require an additional purchase from PTC. Refer to the Creo View Adapters
Installation and Configuration Guide for installation instructions for the following
products:
• Creo View Adapters
• JT Adapter
• Creo View Document Support
• Collective Document Support (Stellent libraries)
Windchill ESIwith
ESIwith TIBCO
If you are installing Windchill ESIand your implementation will use the bundled
TIBCO software, there are three steps you need to complete in order to use Wind-
chill ESI:
1. Install TIBCO using the Middleware Installation and Configuration Utility
(MICU) and record the location of the tibjms.jar file before you initiate the
PTC Solution Installer (PSI).
2. Install Windchill PDMLink and Windchill ESIusing the PSI.
3. Complete post-PSI configurations to configure Windchill ESI to Oracle
Applications or SAP. Refer to your Windchill ESI documentation for
information on post-PSI configuration information.
To install TIBCO and configure ESI to ERP (steps 1 and 3), refer to the Windchill
Enterprise Systems Integration Installation and Configuration Guide - Oracle
Applications or the Windchill Enterprise Systems Integration Installation and
Configuration Guide - SAP for more information. This guide only contains
instructions for step 2.
ERP Connector
If you are installing ERP Connector, the following steps need to be completed in
order to use ERP Connector:
1. Install Windchill PDMLink and ERP Connector using the PSI.
2. Complete post-PSI configurations to configure ERP Connector. For
information on post-PSI configuration information, refer to the ERP Connector
Administration Guide.
Local Installation
If the WBR host and gateway server are both installed on the same machine as
your Windchill solution, as in the following graphic, then the PTC Solution
Installer is run only once, and automatically installs the components in the proper
sequence.
Two Machines
If the WBR host is installed on a separate machine from the WBR gateway server
and your Windchill solution, as in the following graphic, then the PSI must be run
twice: first to install the host on its machine, and second to install the gateway
server and the Windchill solution.
Three Machines
If the WBR host, gateway server, and your Windchill solution are all installed on
separate machines, as in the following graphic, then the PSI must be run three
times: first to install the host, then to install the gateway server, and lastly to install
your Windchill solution.
Other Pre-Installation
Pre-Installation Considerations
Other considerations before you begin your installation:
• The Windchill Directory Server already be installed and configured before you
begin installing any Windchill Business Reporting components.
• If you are installing Windchill Business Reporting on Red Hat Linux 5.X, you
must have the system library files installed before installing Windchill Business
Reporting.
Note
There is no dependency between the client and server installations. They can be
installed in either order.
Note
The hostnames and RMI port for your Windchill PartsLink server and client must
be known prior to installation.
Option Default Description
RMI Registry Port for 10011 Valid range is 1024–
Windchill PartsLink 65535
Refer to Installing Windchill Solutions on page 49 for instructions on installing
Windchill PartsLink.
Replication
Windchill replication increases the productivity of Windchill users by reducing
their time to access content data. The users access content data stored on more
rapidly accessible external vaults known as replica vaults. Replica vaults store
content data that has been replicated from slower external vaults or from the
Windchill database.
The Windchill user's experience in accessing replicated and non-replicated
information is identical except for the improved access time. The Windchill user's
only explicit interaction with Windchill content replication is setting preferences in
a graphical interface.
A Windchill site (also known as a cluster) is a group of hosts with one URL. For
the purpose of content replication, a site can play the role of master site, replica
site, or both. When a site is playing the role of a master site, content can be
replicated from database storage, from external storage, or both to one or more
replica sites. When a site is playing the role of a replica site, content can be
replicated to it from master sites.
A master site stores vault and folder configuration information for each of its
replica sites. Replica sites retrieve vault configuration information on startup or an
update of the information is pushed from the master site on its startup or sent
explicitly by the master site administrator.
Note
You must complete this step during the master server installation. Otherwise, you
will need to perform manual steps to set it up later.
4. Click each installer link and download the files into the folder you created
earlier in this procedure.
5. Extract the contents of each ZIP file.
6. Continue to Installing a File Server Remote Site on page 157.
Note
After you have installed the File Server remote site, you must complete the
post-installation steps in the Completing Configurations - Manual Steps on
page 161 chapter.
Software Matrix
A software matrix on the PTC Web site lists the combinations of platforms,
operating systems, and third-party products that are certified for use with Windchill
PLM Connector on Windows. Refer to the Reference Document page. Select your
product from the Product list, select the current release from the Release list, select
Software Matrix from the Document Type list, and select Windchill PLM Connector
Software Matrix from the list of matrixes.
Server Prerequisites
Ensure that the following prerequisites have been met before installing the
Windchill PLM Connector server software on a Windchill server.
• Ensure that Windchill PDMLink, or Windchill PDMLink with Windchill
ProjectLink is installed and configured on the Windchill server.
• Check to ensure that at least 60 MB of disk space is available for the
installation.
• Check to ensure that you have the necessary credentials to login to Windchill
as Site or Organization Administrator.
Note
The Solution option creates a new installation on one or more machines with
your choice of optional products (like Windchill PLM Connector), platform
components, and configuration options. See the configuration section of the
PSI installer guide to determine if any manual configurations are necessary for
Windchill PLM Connector.
• Choose Update Existing Installation when you are installing a optional product,
like Windchill PLM Connector server software, onto an existing Windchill
installation.
Note
The Update Existing Installation option allows you to install a product onto an
existing installation, add an additional language or install a Windchill software
update.
PTC supports Oracle Enterprise Edition and Standard Edition software. This
chapter guides you through the process of installing and setting up Oracle for
Windchill.
Note
Select a version of Oracle that is supported with this release. For more information
about the products supported with this release, see the software matrix (available
from http://www.ptc.com/appserver/cs/doc/refdoc.jsp.
Note
If you are installing the bundled Oracle software, you do not need to install the
database software before running the PTC Solution Installer (PSI).
25
About Oracle
PTC provides these guidelines to assist you when installing the Oracle Relational
Database Management System (RDBMS) software. In all cases, follow the
instructions in the Oracle Database Installation Guide for detailed platform specific
instructions (user authentication, memory, process tuning, and so on).
The Oracle server can be installed either on the same machine as Windchill or on a
remote machine. By default, when the server software is installed, Oracle also
installs the client software on the same machine. If you install Windchill on a
different machine than the Oracle server and if you plan to customize Windchill
and generate Data Definition Language (DDL) scripts, then you must also install
the Oracle client software on the same machine as the Windchill server. Also, if
you install Windchill on a different machine than the Oracle server, you must run
the PTC Solution Installer (PSI) on the Oracle server before installing your
Windchill solution.
Included in this chapter are instructions for an Oracle server installation (whether
on the Windchill server machine or on a remote machine), and an Oracle client-
only installation for the Windchill server machine.
Note
You do not need to install the Oracle client software unless you are planning to
customize Windchill and generate DDL scripts.
Oracle is delivered on the Oracle DVDs and it is installed using the Oracle
Universal Installer. If you are using the PTC-bundled Pro/INTRALINK — Oracle,
it is installed using the PTC Solution Installer (PSI).
Note
If you have not entered an email address, click Yes on the Email Address Not
Specified popup window.
5. Select Install database software only and click Next .
6. Select Single instance database installation and click Next .
7. The default language is English. Select the language for your database and
click Next .
8. Select Enterprise Edition
9. Click on Select Options and clear all components.
10. Enter the Oracle Base . This is the base directory for the Oracle software.
Installing Oracle 27
11. Enter the Software Location . Oracle recommends that this be within the Oracle
base directory.
12. Click Next .
13. For UNIX, select the OSDBA and OSPER groups for operating system
authentication and click Next .
14. The prerequisite check verifies that your system meets the needs of installation
and configuration of Oracle. The installer lists any unsatisfied requirements.
Click Next .
15. The summary window displays the options you chose. Review your selections
and click Finish .
16. Once the installation has finished, click Close to exit.
Note
For UNIX, be sure to run $ORACLE_HOME/root.sh as the root user.
Post-Installation
Post-Installation Activities
After installing the Oracle software, perform the following activities as needed to
ensure that your system is ready to proceed with database creation (for Oracle
server) and Windchill installation.
Installing Oracle 29
Removing Previous Versions of Oracle
If you have installed an upgraded version of Oracle you may remove the older
version. However, before removing your older version you may want to verify that
the new version has been installed properly. The following checks should confirm
that Oracle has successfully upgraded:
• Connect to the database using the new Oracle environment settings, such as
ORACLE_HOME or PATH
• Verify the database version.
• Verify the connection with Windchill
If the Oracle upgrade has been successful you may remove the older Oracle
version by using the following procedure:
1. Navigate to the following location:
cd <ORACLE VERSION HOME>/deinstall
2. Run “deinstall”.
UNIX
For Oracle 11.2.x.x:
/u01/app/oracle/product/11.2.0/
Also, when Oracle is installed, it typically places two Java Runtime Environments
at the beginning of the PATH variable. This placement interferes with Windchill
installers, which rely on the Java 1.6 SDK. After installing Oracle, make sure that
your 1.6.x Java SDK is positioned in your PATH variable before any JREs the
Oracle installer may have added.
For additional information about language setting options, see the Oracle
installation documentation.
Windows
Click Start ▶ Programs ▶ Oracle - OraDb10g_home1 ▶ Configuration and Migration
Tools ▶ Net Configuration Assistant
Unix
At the command prompt enter the following:
<Oracle>/bin/netca
where <Oracle> is the directory location where you installed Oracle.
Perform the net services configuration procedure appropriate to an Oracle server or
client, as described in the sections Installing Oracle Server Software on page 27
and Installing Oracle Client Software on page 28.
For additional information about this configuration assistant, refer to the Oracle
Database Installation Guide.
Installing Oracle 31
For detailed descriptions of each screen and option, see Installing a Standalone
Product or Component on page 127.
Perform the following on the Oracle database server:
1. Launch the PTC Solution Installer. For more information, see Launching the
PTC Solution Installer on page 50.
2. Choose the installer language. For more information, see Installing Using the
PTC Solution Installer on page 128.
3. Read the Before You Begin panel and click Next .
4. Read the PTC Customer Agreement panel and confirm that you have legal
authority to install the software as described in the section titled Installing
Using the PTC Solution Installer on page 128.
5. Select the Solution Installation type and click Next . For more information on
installation types, see Selecting the Installation Type on page 51.
6. Select the Standalone Product or Component and click Next .
7. Select Oracle Configuration .
8. Under Oracle Configuration , select Create Database . In addition, you can
select Create Windchill Installation Database User Account . The latter can be
done during your Windchill installation on the Windchill server, but the
database must be created on the Oracle server now. For more information, see
Installing a Standalone Product or Component on page 130.
9. Select the installation directories. For more information, see Specifying the
Installation Directory on page 58.
10. Select the Base Data Language . For more information, see Specifying
Language Settings on page 62.
11. Select the database size. For more information, see Selecting the Database Size
on page 62.
12. Enter your database settings. For more information, see Entering Your
Database Information on page 63.
13. Choose whether to use a staging area. For more information, see Selecting
Staging Directory Options on page 81.
14. If you are using a staging area, copy the Oracle Configuration files from the
"Windchill 3rd Party Software" CD to the staging directory. For more
information, see Copying CDs or CD Images to the Staging Area on page 81.
15. Review the installation overview and click Install . For more information, see
Reviewing the Installation Overview on page 82.
You can now continue installing your Windchill solution on the Windchill server.
Select a version of SQL that is supported with this release. For more information
about the products supported with this release, see the Windchill Software Matrices
(available from http://www.ptc.com/appserver/cs/doc/refdoc.jsp).
Note
Microsoft SQL Server is supported only on Windows systems.
33
About SQL Server
PTC has provided these guidelines to assist you when installing the SQL Server
software. In all cases, follow the installation instructions outlined in the Readme.
htm file, which is located in the Servers directory of the SQL Server software CD.
You can also access this document by selecting Read the release notes on the
Autorun panel of the SQL Server installer.
SQL Server can be installed either on the same machine as Windchill or on a
remote machine.
SQL Server is delivered on the SQL Server CDs and is installed using the SQL
Server installer.
• Required Filegroups:
○ PRIMARY
○ BLOBS
○ INDX
○ WCAUDIT
• Database schema name and schema owner must be identified by same name
• SQL Server logon, user, and schema must be identified by same name
• Default schema for database user must be identified by same name
• Database user must be a member of the db_owner role, or have similar
privileges
Note
The Default Instance is the name of the machine on which SQL Server is
installed. Instance ID should be the same as Instance Name .
For example:
When the update statement is executed and the index size exceeds 900 bytes
wt.pom.DatastoreException: A SQL error has occurred for the statement
"UPDATE WTUser SET blob$entrySetadHocAcl=?,disabled=?,classnamekey
domainRef=?,idA3domainRef=?,entrySetadHocAcl=?,eventSet=?,inherited
Domain=?,name=?,repairNeeded=?,markForDeleteA2=?,
updateStampA2=?,modifyStampA2=?,updateCountA2=updateCountA2+1 WHERE
((idA2A2 = ?) AND (updateCountA2 = ? ))" Database system message follows:
Nested Exception is: java.sql.SQLException: [ptc][SQLServer JDBC Driver]
[SQLServer]Operation failed. The index entry length of 2000 bytes for the
index ’WTUser$COMPOSITE’ exceeds the maximum length of 900 bytes.
41
Overview
This section provides an overview of the things you should know before installing
your Windchill solutions.
• Verify that you have the most recent version of this guide and other installation
documentation. The latest versions can be downloaded from http://www.ptc.
com/appserver/cs/doc/refdoc.jsp.
• Get familiar with how the PTC Solution Installer works, what each installation
type does, and the order of installation for the database and the products the
installer supports. Refer to the Getting Started with Windchill Installation and
Configuration Guide for more information.
• Review this manual to understand the software requirements, the values you
must enter into the PTC Solution Installer install your products, and any
manual steps you must perform to complete your installation.
For complex environments that include the use of firewalls, alternate
authentication, or multiple servers, use the Windchill Advanced Deployment Guide
in conjuction with this guide.
Windows
You must have administrative privileges to install.
UNIX
You must log in as a root user and use the PTC Solution Installer (PSI) Solution
installation type to install Apache (HP-UX only) as a standalone component.
On HP-UX, after the installation of Apache is complete, go to the parent directory
where Apache is installed (/opt/hpws22) and recursively change the ownership of
the Apache directory to the user that will be installing Windchill. For example:
chown -R <user that will install Windchill> Apache
After installing those components, you can log in as a non-root user and use the
PSI’s Solution installation type to complete your installation.
If you choose to reference an existing Apache web server during your installation,
the PTC Solution Installer (PSI) references the components as the user that is
installing each component. For example, if you execute PSI and install Apache as
The client (browser) to the Windchill server connection can use a pure IPv6
connection.
There are manual instructions in this guide to configure Apache and Sun Java
System Web servers. IIS Web servers do not require special instructions to make
them IPv6 compliant. An IPv6 protocol stack must be installed on the server, but
these instructions are outside the scope of this document.
Overview ..................................................................................................................50
Installing Using the PTC Solution Installer....................................................................50
Optional Product Settings...........................................................................................82
This chapter describes how to use the PTC Solution Installer to install Windchill
solutions.
49
Overview
Note
If you have installed Pro/INTRALINK, installing Windchill PDMLink serves to
upgrade your installation to Windchill PDMLink. If you have customized or
otherwise modified yourPro/INTRALINK installation, consult the chapter
"Managing Customizations" in the Windchill Customization Guidebefore installing
Windchill PDMLink.
Verify that you have done the following before continuing with the installation
process:
• Completed any necessary steps in the chapter Before Using the PTC Solution
Installer on page 41
• Installed the database software using the instructions in either Installing Oracle
on page 25 or Installing SQL Server on page 33
To upgrade Pro/INTRALINK to Windchill PDMLink use the following procedure:
1. Launch the PTC Solution Installer.
2. Click Update Existing Installation and click Next .
3. Select the Pro/INTRALINK instance of the installation and click Next .
4. Select Upgrade to Windchill PDMLink and click Next .
5. Complete the regular installation procedure.
UNIX
setup
Note
If you need to choose a different installation type after clicking Next , cancel the
installation and re-start the PTC Solution Installer.
Note
If you plan to use a Web server other
than Apache, PTC highly recommends
that you install the bundled Apache
Web server to initially test your
Windchill solution. After testing your
solution with Apache, use the
documented procedures to reconfigure
your solution to use the other Web
server. Testing your installation with
Apache takes very little additional time
up front and generally saves a great deal
of time in troubleshooting if anything is
not working properly with the other
Web server.
Windchill Directory Server Windchill Directory Server is an LDAP-
compliant enterprise directory that is
bundled with Windchill solutions.
Database Configuration
The database configuration screen allows you to configure the database for your
Windchill solution:
PATH=/usr/bin:/usr/local/bin:/usr/sbin:/sbin:/usr/
local/sbin:/usr/ucb:/usr/ccs/bin:$ORACLE_HOME/ bin:$PATH
LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH
SHLIB_PATH=/u01/app/oracle/product/11gR2/lib:$SHLIB_PATH
LIBPATH=/u01/app/oracle/product/11gR2/lib:$LIB_PATH
You can change each individual subdirectory to meet your needs. By default, all
products and components are installed under the Base Installation Directory. You
can change this by editing the installation directory in any given field. To continue
propagating changes throughout all installation paths, enter further changes under
the Base Installation Directory field.
Note
For HP-UX machines, the Installation Directory for the Apache Web Server should
only be installed in the following location:
/opt/hpws22/apache
Oracle
SQL Server
Oracle
Option Description
Enable extended character sets check Select the check box for every language
box. except for English.
A cleared check box is the default,
which means English is the default
language.
Oracle Server Installation Directory Create a new installation directory if
you are installing the PTC-bundled Pro/
INTRALINK - Oracle.
If you have installed Oracle, set the OR-
ACLE_HOME system environment
variable to the Oracle installation
directory.
Note
Your password cannot include special
characters (! @ % ^ & * ( ) + = \ | ` ~ [ {
] } ; : ' " , < > ?). If your site’s password
policy requires special characters, create
a temporary password now and man-
ually change it to include special char-
acters post-installation. For more
information, see Changing the Database
Password
on page 165.
Confirm Oracle User Password for Enter the password again to verify the
Windchill password.
Option Default Description
charac- A cleared check box is the
Enable extended charac- Select the check box for
ter sets check box. default, which means every language except for
English is the default English.
language.
Oracle Server Installation <ORACLE _HOME> is Create a new installation
Directory the default if the variable directory if you are instal-
is not set. ling the PTC-bundled Pro/
INTRALINK - Oracle.
Set the ORACLE_HOME
system environment varia-
ble to the Oracle installa-
tion directory.
Oracle Database DNS <hostName>.<domain> Defines the fully qualified
Registered Host Name machine name of the
SQL Server
Creating a Windchill database user account and dabase objects remotely is not
supported for SQL Server using PSI. To accomplish this option for SQL server,
PSI must be run on the SQL Server host and the SQL Server Configuration option
must be selected to create a database and user. Then, PSI must be launched again
from the Windchill Server host. Select Configure to an existing user on an existing
database for SQL Server and fill in the fields with the SQL Server values used
during the database creation step on the database host.
For more information on creating a User on SQL Server, see Installing a
Standalone Product or Component on page 127.
Note
Your password cannot include special
characters (! @ % ^ & * ( ) + = \ | ` ~ [ {
] } ; : ' " , < > ?). If your site’s password
policy requires special characters, create
a temporary password now and man-
ually change it to include special char-
acters post-installation. For more
information, see Changing the Database
Password
on page 165.
Confirm SQL Server User Password for Enter the password again to verify the
Windchill password.
Option Default Description
SQL Server Installation The same directory you
directory used when installing SQL
Server.
SQL Server Client Instal- The same directory you
lation Directory used when installing SQL
Server.
SQL Server DNS Regis- The same name you used
tered Host Name when installing SQL
Server.
Installed SQL Server In- The name you used when
stance Name (Named In- installing SQL Server.
stance only) If you used the default in-
stance during installation
of SQL Server, this can be
left empty.
The following default values are set for you during the Express installation. You
cannot change these values during an Express installation.
Option Default Description
LDAP Server Port 389 Defines the port number that the
Number Windchill Directory Server listens
on for requests.
Base Distinguished cn=configuration, Defines the distinguished name of
Name for Product the top subtree LDAP entry under
cn=Windchill_10.0,
Properties which Windchill configuration
o=<myCompany> LDAP entries reside.
Base Distinguished ou=people, Specifies a base node in the Ad-
Name for Adminis- ministrative Directory hierarchy
cn=AdministrativeL-
trative Users that contains all users in the direc-
dap,
tory that should be visible to
cn=Windchill_10.0, Windchill.
o=<mycompany>
Base Distinguished ou=people, Specifies a base node in the Enter-
Name for Enterprise prise Directory hierarchy that con-
cn=EnterpriseLdap,
Users tains all users in the directory that
cn=Windchill_10.0, should be visible to Windchill.
o=<mycompany> Note
This option does not apply when a
solution is installed standalone.
Note
Refer to the section Preparing En-
terprise LDAP for Installation Data
Load on page 45 before setting this
option.
Enterprise User en- No Specifies whether user definitions
tries are in the En- are stored in the enterprise LDAP.
terprise LDAP
Windchill Directory o=Company Name Defines the LDAP base distin-
Server Directory guished name under which the en-
Suffix tire set of Windchill created entries
will be stored.
Windchill Directory 4444 The port number that is used by
Server Administra- the Windchill Directory Server
tor Port control-panel to administer
Define the settings for the Windchill Directory Server LDAP directory:
Note
The following is a complete list of possible options; some may not appear
depending on whether you are installing WDS on the same server with Windchill
or standalone.
Option Default Entry
LDAP Server DNS <hostname>. <hostname>.<domain> is the
Registered Host <domain> default.
Name
LDAP Server Port 389 Define the port number that the
Number Windchill Directory Server Direc-
tory server listens on for requests.
LDAP Server Ad- cn=Manager The distinguished name for the
ministrator Distin- Windchill Directory Server admin-
guished Name istrator. The setup program creates
the directory using the distin-
guished name that you specify.
LDAP Server Ad- Windchill Directory Server admin-
ministrative istrator’s password
Password
Confirm LDAP Specify the same password that you
Server Administra- specified for the Administrator’s
tive Password password.
Note
This field only appears when instal-
ling a new Windchill Directory
Server LDAP Server.
LDAP Server Base o=PTC Defines the LDAP base distin-
DN guished name under which the en-
tire set of Windchill created entries
will be stored.
Option Default
User Certificate userCertificate
Unique Identifier Attribute sAMAccountName
Telephone Number telephoneNumber
Postal Address postalAddress
Preferred Language preferredLanguage
Common Name cn
Surname sn
Mobile Phone Number mobile
E-Mail Address mail
Object Class user
Organization Name company
Fax Number facsimileTelephoneNumber
Unique Identifier sAMAccountName
Option Default
Unique Identifier Attribute sAMAccountName
Description description
Object Class group
Unique Member member
Option Description
Create New Creates a new Windchill site administra-
tor using the values in the following
fields.
Use Existing Account Uses an existing Windchill site adminis-
trator account. Specify the values for
the existing account in the following
fields.
Field Description
Windchill Site Administrator User A user name for the administrator of the
Name Windchill server. An example might be
wcadmin.
Note
Because of restrictions in both Apache
and the Sun ONE servers, the user
names that are used for logging on can-
not contain extended ASCII characters
nor multi-byte characters.
Note
If the Use Existing User (used as a Site
Administrator) option is enabled, the in-
stallation does not work. See also Instal-
lation Logs and Troubleshooting on
page 405.
Windchill Site Administrator Password The password for the Windchill server
administrator user.
Confirm Windchill Site Administrator Verify the password you entered for the
Password Windchill server administrator user.
This option is only necessary when cre-
ating a new account.
Repository Where the Site Administra- Specifies which LDAP repository con-
tor Is Stored tains the site administrator.
You have two options: Administrative
and Enterprise
Windows
Option Description
In a new program group Creates the icons in a new program
group in the Start menu
In an existing program group Creates the icons under a program
group that already exists in the Start
menu
In the Start menu Creates the icons at the top level of the
Start menu
On the Desktop Creates the icons on your Windows
desktop
In the Quick Launch Bar Creates the icons in your Windows
Quick Launch Bar
Other Specify the location where you want to
create icons
Do not create icons No icons are created during installation
Note
If you select In a New Program Group or In the Start Menu , you can create the icons
for all users by selecting Create Icons for All Users .
UNIX
Option Description
In your home folder Creates the links in your home folder
Other Specify the location where you want to
create links
Do not create links No links are created during installation
Click Save to copy an HTML version of this summary to your local machine. A
file called <summaryName>.htm.properties is saved in addition to the summary
that contains every property value set during that installation.
Note
The installation summary includes un-encrypted password information. After the
installation is complete, make sure that the following files are only accessible by
those with the appropriate permissions:
• <Windchill>\installer\*.properties
• Summary.html
After you have reviewed the summary, click Install .
Locating Post-installation
Post-installation Steps for Your Products
The PTC Solution Installer installs and configures many, but not all, PTC products
end-to-end. Each product has its own section in the Completing Configurations -
Manual Steps chapter that describes any necessary post-installation manual steps.
Refer to the section for each of your installed optional products to complete your
installation.
Installation
Remember the following points during the installation:
• Select and provide applicable information for your system requirements.
• Refer to the following installation procedure as a guideline. See the PSI
installation guide for detailed installation instructions.
• Click Back at anytime during the installation process to revise the information
that you have provided.
• Click Restore Default Folder to revert to the default folder location.
• Click Cancel at anytime to stop the installation. You are prompted for
confirmation.
Caution
If you cancel during the actual installation, any configurations already made to
the system cannot be undone.
Perform the following steps for Windchill Integrations for Embedded Software
installation.
Note
Refer to the following installation procedure for Windchill Integrations for
Embedded Software as a guideline. See the PSI installation guide for detailed
installation instructions for your system installation and configuration.
Note
If you choose not to perform this step during the installation, see Step 1 — Run
Windchill Loader in the post installation section for Windchill Integration for
IBM Rational ClearCase. This is a required step IBM Rational ClearCase.
There is no “load demo data” for IBM Rational ClearCase.
12. Specify the fully qualified host name and port numbers for both the web server
and servlet engine:
• Web Server DNS Registered Host Name
• HTTPS Port Number
• Servlet Web Server Listener Port Number
• Servlet Engine DSN Registered Host Name
13. Complete the applicable selections in the PSI installer windows.
14. Select a language for base data which includes templates and rules, and one or
more display languages for user interface and documentation.
• Select Base Data Language
• Select Display Languages
• If applicable, Select multibyte character set storage is required for multibyte
languages
15. Select the Oracle database specific to your location:
• Enter the Oracle database DNS Registered Host Name
• Enter the Oracle Database Listener Port Number
Caution
If you cancel during the actual installation, any configurations already made to
the system cannot be undone.
28. Once the installation is complete, the components installed display on the
screen. Click Done to exit the installer.
ERP Connector
ERP Connector is a product designed to leverage current standard Windchill ESI
capabilities on the Windchill side, without using any third-party EAI software.
This uni-directional integration enables the publication of product information
stored in Windchill PDMLink to distribution targets in XML. ERP Connector
enables the transfer and mapping of business objects, such as parts, Bills of
Note
For a description of each optional Windchill Workgroup Manager product, refer to
the Getting Started with Windchill Installation and Configuration Guide.
Under Optional Products , select Windchill Workgroup Manager .
Under Define Settings , in the Workgroup Manager Authoring Applications window,
check the check box next to all applicable Windchill Workgroup Manager
authoring applications you want to install.
Refer to Windchill Workgroup Manager on page 210.
Windchill MPMLink
Windchill MPMLink is an add-on product to Windchill PDMLink, and is the
central repository and the design environment for manufacturing data management
in Windchill. Windchill MPMLink enables the manufacturing engineer to
associatively transform the engineering BOM to the manufacturing BOM, to
manage libraries of manufacturing resources and standardized manufacturing
capabilities, to define digital definitions of process plans with associative links to
the mBOMs and manufacturing resources and to dynamically generate work
instructions for the shop floor.
Installation of Windchill MPMLink requires Windchill PDMLink.
Installation
This section describes how to install the Windchill PLM Connector server
software.
Remember the following points during the installation:
• Click Back at anytime during the installation process to revise the information
that you have provided.
• Click Restore Default Folder to revert to the default folder location.
• Click Cancel at anytime to stop the installation. You are prompted for
confirmation.
Caution
If you cancel during the actual installation, any configurations already made to
the system cannot be undone.
Refer to the chapter Completing Configurations - Manual Steps on page 161 for
any manual post-installation steps.
For advanced deployment options, such as installing in a clustered environment,
refer to the Windchill PartsLink Classification and Reuse Administrator's Guide .
Note
To install in a Windchill cluster environment, install the Windchill PartsLink client
on each node in the Windchill cluster.
1. Refer to Installing Using the PTC Solution Installer on page 50 while
completing the following sections:
• Launching the PTC Solution Installer
• Choosing the Installer Language
• Before You Begin
• PTC Customer Agreement
2. When prompted to select an install type, select Solution and click Next .
3. When prompted to select a solution, under Product Lifecycle Management ,
select Windchill PDMLink and click Next .
4. The list of optional products is displayed. Under Windchill Integration , select
Windchill PartsLink Integration Client and click Next .
Note
The server hostname you enter must be accessible by the machine on which
Windchill PartsLink client is being installed.
RMI Registry Port
Default value: 10011
Valid range: 1024–65535
Note
The value of the RMI Registry Port field must be the same as the RMI Registry
Port specified when installing Windchill PartsLink server.
When finished, click Next .
6. Review the Installation Overview , you have the option of changing settings at
this time. If the settings are acceptable, click Install .
7. When the installation has completed a confirmation is displayed. Click Done .
Click Next .
6. Enter Windchill PartsLink server database information. For more information
see, Entering Your Database Information on page 63. When finished, click
Next .
Note
The information entered on this screen is used to propagate the xconfmanager
and properties files. The schema for Windchill PartsLink is created separately.
For information on creating the schema, see Windchill PartsLink Classification
and Reuse Post-Installation Steps on page 212.
7. Specify optional product settings by entering the RMI Registry Port and
PartsLink client hostname .
Note
If the Windchill PartsLink client is installed in a Windchill cluster environment,
enter the hostnames of each of the Windchill nodes, separated by a semi-colon.
RMI Registry Port
Default value: 10011
Valid range: 1024–65535
Note
The value of the RMI Registry Port field must be the same as the RMI Registry
Port specified when installing Windchill PartsLink client.
When finished, click Next .
8. Follow the general PSI instructions for the remaining steps:
• Creating Product Icons or Links on page 80
• Selecting Staging Directory Options on page 81
• Copying CDs or CD Images to the Staging Area on page 81
• Reviewing the Installation Overview on page 82
Refer to the chapter Completing Configurations - Manual Steps on page 161 for
any manual post-installation steps.
Note
Windchill Business Reporting is also supported in a cluster environment. For
information on installing Windchill Business Reporting in a cluster environment,
see the Windchill Advanced Deployment Guide.
Local Installation
In a local installation, the Windchill Business Reporting components are installed
on the same machine as your Windchill solution. The PSI is run only once.
From the list of solutions to install, select the Windchill solution or solutions you
are installing.
On the optional products screen, select Windchill Business Reporting .
On the optional product features screen, select the following options, as
appropriate:
Option Default Description
Install the Selected When selected, installs
HostComponents
HostComponents the Windchill Business
Reporting host
components.
GatewayServer Selected
Install the GatewayServer When selected, installs
the Windchill Business
Reporting gateway server.
The Configure Local
Apache for Gateway
check box must also be
left selected (the default)
On the database configuration options screen, the checkbox to create the Database
Windchill Business Reporting User is selected by default, and cannot be cleared.
Enter the following installation directory information:
Option Default Description
Installation Directory for <base installation The location where the
Windchill Business directory>\Reporting selected Windchill Busi-
Reporting ness Reporting
components are installed.
Enter the following database information. These values apply to the Database
Windchill Business Reporting User created above.
Options Description
Windchill Business Reporting Oracle The user name for the Windchill Busi-
Database User Name for the Database ness Reporting database user account.
User Account
or
Windchill Business Reporting SQL
Server Database User Name for the
Database User Account
Windchill Business Reporting Oracle The password for the Windchill Busi-
Database Password for the Database ness Reporting database user account.
User Account
or
Note
If you leave both the Oracle Configuration and SQL Server Configuration
deselected, it is assumed that a database and associated user already exist, and that
you will supply that information in the database information screen.
Option Default Description
Oracle Configuration Deselected Select this option if you
are configuring an Oracle
database as part of this
installation scenario.
Under this option, select
the following as
appropriate:
• Create Database -
selected by default.
• Create Windchill
Database User
Account - selected by
default.
• Create Windchill
Business Reporting
Database User
Account - deselected
by default. Select this
checkbox to create a
new database user. To
use an existing
database user, leave
deselected.
SQL Server Configuration Deselected Select this option if you
are configuring a SQL
Server database as part of
this installation scenario.
Under this option, select
the following as
appropriate:
• Create Windchill
Database and User -
selected by default.
• Create Windchill
Business Reporting
Database and User -
Specify the appropriate LDAP settings for your configuration. For more
information, see Entering Your LDAP Settings on page 68.
Set the following optional product settings:
Option Default Description
Windchill Business local machine Location where the
Reporting Gateway gateway server will be
Machine’s DNS installed. Be sure to note
Registered Host Name this location to use when
you install the gateway
server.
Windchill Business 80 Port that the gateway
Reporting Gateway server will listen on to
Machine’s Web Server communicate with the
Port host components. Be sure
Note
If you leave both the Oracle Configuration and SQL Server Configuration
deselected, it is assumed that a database and associated user already exist, and that
you will supply that information in the database information screen.
Option Default Description
Oracle Configuration Deselected Select this option if you
are configuring an Oracle
database as part of this
installation scenario.
Under this option, select
the following as
appropriate:
• Create Database -
selected by default.
• Create Windchill
Specify the appropriate LDAP settings for your configuration. For more
information, see Entering Your LDAP Settings on page 68.
Set the following optional product settings:
Option Default Description
Windchill Business local machine Location where the
Reporting Gateway gateway server will be
Machine’s DNS installed. Be sure to note
Registered Host Name this location to use when
you install the gateway
server.
Windchill Business 80 Port that the gateway
Reporting Gateway server will listen on to
Machine’s Web Server communicate with the
Port host components. Be sure
to note this location to use
when you install the
gateway server.
Communication Port of the 9300 Port used by Windchill
Windchill Business Business Reporting host
Reporting Host to communicate with the
Windchill Business Re-
porting gateway.
Note
If you leave both the Oracle Configuration and SQL Server Configuration
deselected, it is assumed that a database and associated user already exist, and that
you will supply that information in the database information screen.
Option Default Description
Oracle Configuration Deselected Select this option if you
are configuring an Oracle
database as part of this
installation scenario.
Under this option, select
the following as
appropriate:
• Create Database -
selected by default.
• Create Windchill
Database User
Account - selected by
default.
• Create Windchill
Business Reporting
Database User
Account - deselected
by default. Select this
checkbox to create a
new database user. To
use an existing
database user, leave
deselected.
SQL Server Configuration Deselected Select this option if you
are configuring a SQL
Server database as part of
this installation scenario.
Under this option, select
the following as
appropriate:
• Create Windchill
Database and User -
selected by default.
• Create Windchill
Business Reporting
Database and User -
Specify the appropriate LDAP settings for your configuration. For more
information, see Entering Your LDAP Settings on page 68.
Post-Installation
Post-Installation Steps
Refer to the chapter Completing Configurations - Manual Steps on page 161 for
any manual post-installation steps.
Tip
Index Data should be stored on a
local filesystem. Remote filesys-
tems are typically quite a bit slow-
er for indexing. If your index
needs to be on the remote filesys-
tem, consider building it first on
the local filesystem and then copy-
ing it up to the remote filesystem.
Windchill Index 8085 The port on which the Windchill
Search Port Number Search Index starts.
Default Indexing The language originally The default language to be used
Language selected when launch- when processing data.
ing the installation
process.
Index Search Lan- The language originally Additional languages to be consid-
guage List selected when launch- ered when processing data.
ing the installation
process.
127
Overview
This chapter describes how to use the PTC Solution Installer (PSI) to install a
standalone product or component. The standalone product or component option
appears when you have selected Solution ▶ Standalone Product or Component .
If you are installing your PTC solutions in a distributed environment (on multiple
machines), use this option to install components. You must run the PSI on each
distributed machine that is to have standalone components. For more information
on the installation order of distributed optional products and platform components,
or high-level information on how to set up a distributed environment, see to the
Getting Started with Windchill Installation and Configuration Guide .
UNIX
setup
You can change each individual subdirectory to meet your needs. By default, all
products and components are installed under the Base Installation Directory. You
can change this by editing the installation directory in any given field. To continue
propagating changes throughout all installation paths, enter further changes under
the Base Installation Directory field.
Note
For HP-UX machines, the Installation Directory for the Apache Web Server should
only be installed in the following location:
/opt/hpws22/apache
Oracle
SQL Server
Oracle
Option Description
Select the check box for every language
Enable extended character sets check
except for English.
box.
A cleared check box is the default,
which means English is the default
language.
Oracle Server Installation Directory Create a new installation directory if
you are installing the PTC-bundled Pro/
INTRALINK - Oracle.
If you have installed Oracle, set the OR-
ACLE_HOME system environment
variable to the Oracle installation
directory.
<ORACLE _HOME> is the default if
the variable is not set.
Oracle ’SYSTEM’ Account Password Create a new password if you are instal-
ling the PTC-bundled Pro/INTRALINK
- Oracle.
If you have installed Oracle, enter the
existing system password.
Confirm Oracle ’SYSTEM’ Account Enter the system password again.
Password
Oracle User Name for Windchill Create a new user name.
Note
Your password cannot include special
characters (! @ % ^ & * ( ) + = \ | ` ~ [ {
] } ; : ' " , < > ?). If your site’s password
policy requires special characters, create
a temporary password now and man-
ually change it to include special char-
acters post-installation. For more
information, see Changing the Database
Password
on page 165.
Confirm Oracle User Password for Enter the password again to verify the
Windchill password.
Option Default Description
charac- A cleared check box is the
Enable extended charac- Select the check box for
ter sets check box. default, which means every language except for
English is the default English.
language.
Oracle Server Installation <ORACLE _HOME> is Create a new installation
Directory the default if the variable directory if you are instal-
is not set. ling the PTC-bundled Pro/
INTRALINK - Oracle.
Set the ORACLE_HOME
system environment varia-
ble to the Oracle installa-
tion directory.
Oracle Database DNS <hostName>.<domain> Defines the fully qualified
Registered Host Name machine name of the
Oracle server.
Create a new name for
PTC-bundled Pro/IN-
TRALINK - Oracle or use
the existing name for the
Oracle Configuration.
Oracle Database Listener 1521 Defines the port number
Port Number the Oracle server listens
on.
SQL Server
Creating a Windchill database user account and dabase objects remotely is not
supported for SQL Server using PSI. To accomplish this option for SQL server,
PSI must be run on the SQL Server host and the SQL Server Configuration option
must be selected to create a database and user. Then, PSI must be launched again
from the Windchill Server host. Select Configure to an existing user on an existing
database for SQL Server and fill in the fields with the SQL Server values used
during the database creation step on the database host.
For more information on creating a User on SQL Server, see Installing a
Standalone Product or Component on page 127.
Note
Some options do not appear when configuring to an existing user and database.
Option Description
Installed SQL Server Instance Name The default instance represents the ma-
(Named Instance only) chine on which the SQL server is
installed.
Password for User sa Enter a password.
Note
Your password cannot include special
characters (! @ % ^ & * ( ) + = \ | ` ~ [ {
] } ; : ' " , < > ?). If your site’s password
policy requires special characters, create
a temporary password now and man-
ually change it to include special char-
acters post-installation. For more
information, see Changing the Database
Password
on page 165.
Confirm SQL Server User Password for Enter the password again to verify the
Windchill password.
Option Default Description
SQL Server Installation The same directory you
directory used when installing SQL
Server.
SQL Server Client Instal- The same directory you
lation Directory used when installing SQL
Server.
SQL Server DNS Regis- The same name you used
tered Host Name when installing SQL
Server.
Installed SQL Server In- The name you used when
stance Name (Named In- installing SQL Server.
stance only) If you used the default in-
stance during installation
of SQL Server, this can be
left empty.
TCP Port Number for The same port number
SQL Server Instance you used when installing
SQL Server.
Password for User sa The password for the mas-
ter administrator for SQL
Server.
The following default values are set for you during the Express installation. You
cannot change these values during an Express installation.
Option Default Description
LDAP Server Port 389 Defines the port number that the
Number Windchill Directory Server listens
on for requests.
Base Distinguished cn=configuration, Defines the distinguished name of
Name for Product the top subtree LDAP entry under
cn=Windchill_10.0,
Properties which Windchill configuration
o=<myCompany> LDAP entries reside.
Base Distinguished ou=people, Specifies a base node in the Ad-
Name for Adminis- ministrative Directory hierarchy
cn=AdministrativeL-
trative Users that contains all users in the direc-
dap,
tory that should be visible to
cn=Windchill_10.0, Windchill.
o=<mycompany>
Base Distinguished ou=people, Specifies a base node in the Enter-
Name for Enterprise prise Directory hierarchy that con-
cn=EnterpriseLdap,
Users tains all users in the directory that
cn=Windchill_10.0, should be visible to Windchill.
o=<mycompany> Note
This option does not apply when a
solution is installed standalone.
Define the settings for the Windchill Directory Server LDAP directory:
Note
The following is a complete list of possible options; some may not appear
depending on whether you are installing WDS on the same server with Windchill
or standalone.
Option Default Entry
LDAP Server DNS <hostname>. <hostname>.<domain> is the
Registered Host <domain> default.
Name
LDAP Server Port 389 Define the port number that the
Number Windchill Directory Server Direc-
tory server listens on for requests.
LDAP Server Ad- cn=Manager The distinguished name for the
ministrator Distin- Windchill Directory Server admin-
guished Name istrator. The setup program creates
the directory using the
LDAP Service
Option Default
User Certificate userCertificate
Unique Identifier Attribute sAMAccountName
Telephone Number telephoneNumber
Postal Address postalAddress
Preferred Language preferredLanguage
Common Name cn
Surname sn
Mobile Phone Number mobile
E-Mail Address mail
Object Class user
Organization Name company
Fax Number facsimileTelephoneNumber
Unique Identifier sAMAccountName
Option Default
Unique Identifier Attribute sAMAccountName
Description description
Object Class group
Unique Member member
Option Description
Create New Creates a new Windchill site administra-
tor using the values in the following
fields.
Use Existing Account Uses an existing Windchill site adminis-
trator account. Specify the values for
the existing account in the following
fields.
Field Description
Windchill Site Administrator User A user name for the administrator of the
Name Windchill server. An example might be
wcadmin.
Note
If the Use Existing User (used as a Site
Administrator) option is enabled, the in-
stallation does not work. See also Instal-
lation Logs and Troubleshooting on
page 405.
Windchill Site Administrator Password The password for the Windchill server
administrator user.
Confirm Windchill Site Administrator Verify the password you entered for the
Password Windchill server administrator user.
This option is only necessary when cre-
ating a new account.
Repository Where the Site Administra- Specifies which LDAP repository con-
tor Is Stored tains the site administrator.
You have two options: Administrative
and Enterprise
Field Description
Web Application Context Root Defines the Web application context
root name used to access the Windchill
applications through the Web browser.
This value is used to format the URL,
for example, http://<DNS name>/<Web
application context root>.
The default is Windchill.
The automatic configuration of Tomcat
and Apache does not support use of
spaces or characters that are not allowed
in file names on the operating system
(including / and \) in the context root.
PTC recommends that you do not use
these characters.
Info*Engine Server Task Processor Port Defines the port number the task pro-
Number cessor listens on. The default is 10002.
Windows
Option Description
In a new program group Creates the icons in a new program
group in the Start menu
In an existing program group Creates the icons under a program
Note
If you select In a New Program Group or In the Start Menu , you can create the icons
for all users by selecting Create Icons for All Users .
UNIX
Option Description
In your home folder Creates the links in your home folder
Other Specify the location where you want to
create links
Do not create links No links are created during installation
Click Save to copy an HTML version of this summary to your local machine. A
file called <summaryName>.htm.properties is saved in addition to the summary
that contains every property value set during that installation.
Note
The installation summary includes un-encrypted password information. After the
installation is complete, make sure that the following files are only accessible by
those with the appropriate permissions:
• <Windchill>\installer\*.properties
• Summary.html
After you have reviewed the summary, click Install .
Locating Post-installation
Post-installation Steps for Your
Products
The PTC Solution Installer installs and configures many, but not all, PTC products
end-to-end. Each product has its own section in the Completing Configurations -
Manual Steps chapter that describes any necessary post-installation manual steps.
Refer to the section for each of your installed optional products to complete your
installation.
157
File Server Management Utility Overview
The File Server Management utility enables you to install, configure, and maintain
remote sites, including their vaults and folders.
Note
A File Server is a remote or replica server for Windchill.
File Server Management provides the following functions:
• Access to Windchill through a user interface for installing a File Server
• The ability to install, register, and maintain a File Server
• Automatic creation of a site, vaults, root folders, and a folder under that root
folder where the content resides
• Automatic creation of folders under a root folder if a folder becomes full
• The ability to set a File Server to read-only for downloads
• The ability to automatically detect an upgrade of the master site and trigger the
upgrade of a File Server
This section contains the manual instructions that complete the configurations for
Windchill.
161
Completing the Configuration Overview
This chapter wraps up the steps to complete the configurations for Windchill that
could not be addressed until now. Complete the following instructions that are
applicable to your configuration. Refer to the section for each product you installed
for any post-installation steps necessary for that product.
All Solutions
This section describes any manual post-configuration steps that apply to all
solutions.
For example,
ant -f webAppConfig.xml addAuthProvider -DappName=Windchill
2. Execute one of the following from <Apache_Home>/bin:
• If you are creating a password for the first time:
./htpasswd -c <Apache_Home>/conf/app-<webapp_name>-Passwd <username> <password>
• If you are creating a password for the second or subsequent time:
./htpasswd -b <Apache_Home>/conf/app-<webapp_name>-Passwd <username> <password>
For example,
./htpasswd -c /opt/hpws/apache/conf/app-Windchill-Passwd my_username my_password
3. By default the web server user may not have permissions to access
<Apache_Home>/conf, the default directory for which the password file is
configured. In order to allow the password file to be readable by the Apache
process, the conf directory and the app-<webapp_name>-Passwd file must both
be accessible to the web server user.
Registering a non-Windchill
non-Windchill User
This procedure describes how to register a non-Windchill user. The registration can
be done through an email notification when a non-Windchill user is added to
project team. Perform the following:
1. Login as project creator.
2. Create a project.
3. Go to the Project Team page and select Add participant to team .
4. Under Email Invitation , add the non-Windchill user email ID (for example,
[email protected]).
The user for [email protected] must open the email that is sent and click the
Register action in the email.
To configure Windchill ProjectLink self registration, change the following
properties in the <Windchill>/conf/register/reg.properties file
# the ldap used: provider_url=ldap://pl-pla1.ptc.com:389
ldap://<LDAPserverName>.<MyCompany>.com:<port>
This must be configured for the JRE that is used by the servlet engine, the
Windchill server, and any other Java application that would access the Web
server.
To list the default certificate of authority trusted by your JRE, execute:
keytool -list -v -keystore /<JRE>/lib/security/cacerts
Where <ServiceName> is the name you gave the Apache Windows service when
you created it.
Uninstall with Ant
Execute this command from the <Apache> directory.
ant -f config.xml uninstallService -DserviceName < serviceName>
Where <serviceName> is the name you gave the Apache Windows service
when you created it.
If the command does not succeed, verify that the "ant" command is in your
PATH.
Replication
Step 1, Option A: Register the File Server with the Master Site.
Register the File Server using the File Server Management utility, available from
Site ▶ Utilities ▶ File Server Administration . For more information, see the topic
“Registering a New File Server with the Master Site” in the online help, available
from File Server Management .
Note
If you need to update an existing site, select the site in the Site Management
window and then click Update .
Caution
Each folder must be mounted to a unique physical location. If this is not done,
permanent data loss will occur.
You create remote hosts, vaults, and folders from the Vault Configuration window.
To access this window, select Utilities ▶ File Server Administration ▶ Vault
Configuration , available from Site , Libraries , and Products .
Note
The system does not check that the DNS name that you enter for the host is a valid
DNS name.
To create a host:
1. From the Vault Configuration window, select File ▶ New ▶ Host . The New Host
window opens.
2. Enter the DNS name for the host in the Host Name field. (There cannot be any
blank values in the name.) The host name appears in the wt.properties file on
the remote site server (java.rmi.server.hostname).
Note
The system does not verify that the DNS name that you enter is valid.
3. Select the remote site from the Site list.
4. Click OK .
Note
Creating a cache vault on the File Server site is preferable because remote users
can upload content to this vault much faster. However, the existence of a cache
vault on a Windchill File Server is not a necessity for replicating contents to that
site.
To create a remote vault:
1. From the Vault Configuration window, select File ▶ New ▶ Vault . The New Vault
window opens.
2. Enter the following information:
Field Description
Site Select the File Server from the list.
Name Enter a vault name. The name you
specify must be unique among the
vaults defined for all sites.
Vault type Select one of the following:
• Master Vault —Stores (revaulted)
master copies of content files.
• Replica vault —Stores replicated
content files.
• Cache vault —Stores uploaded
files until they are revaulted to
their permanent storage locations.
If you select this vault type, the
vault is used as the local cache
vault for the site. Only one cache
vault is allowed for each site.
• All vault types are supported on
both main sites and File Server
sites.
Note
Vaults are enabled by default at
creation.
Default system target (for a master You can select this checkbox, but you
vault) or Default target for site (for a cannot directly clear it. Because there
replica or cache vault) must always be a default target for the
Note
For this option to work, you must
have manually created and mounted a
root folder.
Automatic cleanup of older content Select this checkbox if appropriate.
Note When this checkbox is selected,
automatic cleanups are performed on
This option is available only for this vault according to the rules and
replica and cache vaults. schedule that are specified in the
Automated cleanup of replica vaults
Note
You can create only one cache vault per Windchill File Server for replication.
Note
Creating a cache vault on the File Server site is recommended because remote
users can upload content to this vault much faster. However, the existence of a
cache vault on a Windchill File Server is not a necessity for replicating contents to
that site.
To create a folder:
1. From the Vault Configuration window, select File ▶ New ▶ Folder . The New
Folder window opens.
2. Enter a unique name for the folder in the Name field.
3. Select a vault from the Vault list.
Note
Do not select the Read Only checkbox. If you do, the folder is not available for
storing uploaded or replicated content files.
4. Click OK .
Before content can be replicated to a vault, at least one of its folders must be
mounted and enabled in the next step.
wt.services.service.2=wt.fv.replica.ReplicaServiceSvr/wt.fv.
replica.StandardReplicaService
wt.services.service.3=wt.wrmf.delivery.ShippingService/wt.wrmf.
delivery.StandardShippingService
wt.services.service.4=wt.wrmf.delivery.ReceiverService/wt.wrmf.
delivery.StandardReceiverService
wt.services.service.5=wt.wrmf.transport.GenericTransportService/
wt.wrmf.transport.StandardGenericTransportService
The method server and server manager should now launch successfully. The POM
messages that normally appear when the method server starts are not displayed,
and registering with the server manager is significantly quicker than in a full
Windchill installation.
Duser.install.dir=D:\ptc\PJL\Windchill -Dsource_image.dir=E:\
Note
If ant -f install_ccsdsu.xml fails on the first attempt, run it again to
successfully complete the update process.
4. Move the contents of the directory
<Windchill>/codebase/CCSTools/update directory to the
<Windchill>/codebase/CCSTools/Completedupdate directory,
overwriting the files in the destination folder.
5. Once the execution completes, start Windchill.
Note
Users executing the following script must have read/write privileges on the
<Windchill>\db\sql (or sql3) folder.
4. Execute the create_wc_app_user.sql file to create an application user,
a database role, and an after login trigger.
Note
PTC recommends creating the application user and role by appending the
Windchill maintenance release version to the name; for example,
WindchillAppUser_10M0XX, WindchillAppRole_10M0XX. This will help
uniquely identify the names and correlate them with the target Windchill
version.
The following is an example of the script execution output:
Windchill Install database User Name: <WINDCHILL_INSTALL_USERNAME>
5. Verify that the application user and role was created correctly by logging on to
the database as that user.
6. From a Windchill shell, execute the following commands to modify Windchill
db.properties file with appropriate values:
• xconfmanager -s wt.pom.
dbUser=<WINDCHILL_APP_USER_NAME> -t "db/db.
properties" -p
• xconfmanager -s wt.pom.
dbPassword=<WINDCHILL_APP_USER_PASSWORD> -t "db/db.
properties" -p
• xconfmanager -s wt.pom.
dbSchemaUser=<WINDCHILL_INSTALL_USERNAME> -t "db/
db.properties" –p
7. Start Windchill and its related services. From the method server output, verify
that the database application user name <WINDCHILL_APP_USER_NAME>
has been used for the database connection.
SQL Server
1. Open a Windchill shell.
2. Change the directory to <Windchill>\db\sqlserver.
3. Execute the batch file
D:\ptc\Windchill\db\sqlServer> create_wc_app_user.bat
to create an application user and a database role.
Note
Users executing the following script must have read/write privileges on the
<Windchill>\db\sqlserver folder.
Note
PTC recommends creating the application user and role by appending the
Windchill maintenance release version to the name; for example,
WindchillAppUser_10M0XX, WindchillAppRole_10M0XX. This will help
uniquely identify the names and correlate them with the target Windchill
version.
4. Verify that the application user and role was created correctly by logging on to
the database as that user.
5. From a Windchill shell, execute the following commands to modify Windchill
db.properties file with appropriate values:
Windchill Integrations for Embedded Software is a PTC product solution with the
following optional server integrations:
• Windchill Integration for Bugzilla
• Windchill Integration for IBM Rational ClearCase
• Windchill Integration for Atlassian JIRA
• Windchill Integration for Subversion
The Windchill Integrations for Embedded Software product solution consists of:
• Windchill Integration for Software Build Tools
• Windchill Integration for Eclipse
The Windchill Integrations for Embedded Software installation consists of:
• Selecting the product solution Windchill Integrations for Embedded Software
• Selecting the optional integrations for Windchill Integrations for Embedded
Software
Perform all applicable post-installation steps before using the Windchill
Integrations for Embedded Software for your integration[s].
191
Bugzilla and Atlassian JIRA Configuration
There are no post-installation steps for the Defect Tracking System (DTS) adapters,
Bugzilla and Atlassian JIRA.
Refer to the Windchill Help Center, Integrated Software Management ▶ Software
Defect Tracking Integrations ▶ Administration for information on how to setup and
manage additional DTS adapters.
Note
There are no post installation procedures when performing an initial installation of
Windchill in a Windows environment and when IBM Rational ClearCase is
installed on the same machine that Windchill is installed.
Note
If administrative data was not loaded by the installer, load the required
administrative data. This loads container templates, preferences, and access control
rules required by IBM Rational ClearCase.
windchill wt.load.WindchillLoader
-Application=Windchill.SoftwareConfigMgmtIntegration
rem *****************************************
rem User configured properties
set SCM_HOME=%ADAPTER_HOME%
set CLASSPATH=%JAVA_HOME%\lib\tools.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\servlet.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\ie3rdpartylibs.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\ieWeb.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\jmxcoreWeb.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\wc3rdpartylibs.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\CommonCore.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\MetaSpecCommon.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\cc.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\install.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%;%CLASSPATH%
echo -------------------------------------------------------------------------------
echo Starting SCM Adapter
echo.
• JAVA_HOME—
JAVA_HOME specify the location of JDK (on the machine where
the IBM Rational ClearCase adapter will be running). JDK version 1.5
should be installed on the client machine.
For example,
set JAVA_HOME=c:\jdk\jdk1.5_0_06
• ADAPTER_NAME—
ADAPTER_NAME specify the name of the IBM Rational
ClearCase adapter that created in Windchill.
For example,
set ADAPTER_NAME=$WC.com.ptc.swlink.scm.defaultAdapter$
Note
Also verify that IEPROPFILE and IENAMINGSERVICENAME all
have correct values as described in the comments of the
startCCAdapter.bat file.
d. The final step is the start the IBM Rational ClearCase adapter. Once the
adapter is running, start the Windchill server, servlet engine.
i. Using the startCCAdapter.bat file, start the IBM Rational ClearCase
adapter on the machine where it is to be run.
Subversion Configuration
This section contains the remote Subversion adapter configuration steps that must
occur after you have installed the Windchill Integrations for Embedded Software
server software with Subversion and before you begin using the Windchill
Integrations for Embedded Software system.
Note
There are no post installation procedures when performing an initial installation of
Windchill in a Windows environment and when Subversion is installed on the
same machine that Windchill is installed.
Note
If administrative data was not loaded by the installer, load the required
administrative data. This loads container templates, preferences, and access control
rules required by Subversion.
windchill wt.load.WindchillLoader
-Application=Windchill.SoftwareConfigMgmtIntegration
rem *****************************************
set JAVA_HOME=
rem set ADAPTER_HOME to the directory where the file svn.zip was extracted
set ADAPTER_HOME=
rem ADAPTER_NAME should be the set to the name of Subversion adapter you created
rem *****************************************
rem ldap://cn=manager:[email protected]/dc=IeProps,dc=test...
rem and should be the same as 'seeAlso' value seen in the file
rem WT_HOME\codebase\WEB-INF\ie.properties
set IEPROPFILE=$WC.com.ptc.swlink.scm.iepropfile$
rem wt.federation.ie.namingService
rem in WT_HOME\codebase\wt.properties
set IENAMINGSERVICENAME=$WC.com.ptc.swlink.scm.ccConfig.host2$.namingService
set SCM_HOME=%ADAPTER_HOME%
set CLASSPATH=%JAVA_HOME%\lib\tools.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\servlet.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\ie3rdpartylibs.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\ieWeb.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\wc3rdpartylibs.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\CommonCore.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\MetaSpecCommon.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\svn.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%\install.jar;%CLASSPATH%
set CLASSPATH=%SCM_HOME%;%CLASSPATH%
echo -------------------------------------------------------------------------------
echo.
echo.
echo.
pause
exit
echo.
pause
exit
rem The following line starts the scm adapter as a standalone process
-DruntimeServiceName="%ADAPTER_NAME%" -DserviceName="%ADAPTER_NAME%"
-DnamingServiceName="%IENAMINGSERVICENAME%" -Dwt.home="%SCM_HOME%"
com.ptc.swlink.scm.adapter.clearcase.CcMultithreadedAdapter
pause
Note
Also verify that IEPROPFILE and IENAMINGSERVICENAME all have
correct values as described in the comments of the startSVNAdapter.bat
file.
5. The final step is the start the Subversion adapter. Once the adapter is running,
start the Windchill server, servlet engine.
a. Using the startSVNAdapter.bat file, start the Subversion adapter on the
machine where it is to be run.
b. Once the adapter is started, start the Windchill server, servlet engine. The
Subversion adapter should now be successfully configured and running
remotely.
Windchill PDMLink
The following describes the post-installation procedures that are needed to
complete an installation of Windchill PDMLink.
Multi-byte
Multi-byte Installations
windchill --java=%JAVA_HOME%/bin/java.exe --javaargs="-Dwt.tools.
sql.dbUser=<username> -Dwt.tools.sql.dbPassword=<password>" wt.tools.sql.SQLCommandTool
%WT_HOME%/db/sql3/pdml/DDLBasic/Make_module_DDLBasic.sql
Note
Please note the following:
• If using an SQL server replace all instances of %WT_HOME%/db/sql with
%WT_HOME%/db/sqlServer.
• %JAVA_HOME% refers to JDK directory used by Windchill.
• %WT_HOME% refers to the Windchill directory.
Windchill ProjectLink
The following describes the post-installation procedures that are needed to
complete an installation of Windchill ProjectLink.
Multi-byte
Multi-byte Installations
windchill --java=%JAVA_HOME%/bin/java.exe --javaargs="-Dwt.tools.sql.dbUser=<username>
-Dwt.tools.sql.dbPassword=<password>" wt.tools.sql.SQLCommandTool
%WT_HOME%/db/sql3/pjl/ChangePlanning/Make_module_ChangePlanning.sql
windchill --java=%JAVA_HOME%/bin/java.exe --javaargs="-Dwt.tools.sql.dbUser=<username>
-Dwt.tools.sql.dbPassword=<password>" wt.tools.sql.SQLCommandTool
%WT_HOME%/db/sql3/pjl/ProjectManagement/Make_module_ProjectManagement.sql
Note
Please note the following:
• If using an SQL server replace all instances of %WT_HOME%/db/sql with
%WT_HOME%/db/sqlServer.
• %JAVA_HOME% refers to JDK directory used by Windchill.
• %WT_HOME% refers to the Windchill directory.
Windchill CAPA
The following describes the post-installation procedures that are needed to
complete an installation of Windchill CAPA.
Multi-byte
Multi-byte Installations
windchill --java=%JAVA_HOME%/bin/java.exe --javaargs="-Dwt.tools.
sql.dbUser=<username> -Dwt.tools.sql.dbPassword=<password>" wt.tools.sql.
SQLCommandTool %WT_HOME%/db/sql3/qms/Masterdata/Make_module_Masterdata.
sqlwindchill --java=%JAVA_HOME%/bin/java.exe --javaargs="
-Dwt.tools.sql.dbUser=<username>
-Dwt.tools.sql.dbPassword=<password>" wt.tools.sql.SQLCommandTool
Note
Please note the following:
• If using an SQL server replace all instances of %WT_HOME%/db/sql with
%WT_HOME%/db/sqlServer.
• %JAVA_HOME% refers to JDK directory used by Windchill.
• %WT_HOME% refers to the Windchill directory.
Windchill Nonconformance
The following describes the post-installation procedures that are needed to
complete an installation of Windchill Nonconformance.
Multi-byte
Multi-byte Installations
windchill --java=%JAVA_HOME%/bin/java.exe --javaargs="-Dwt.tools.
sql.dbUser=<username> -Dwt.tools.sql.dbPassword=<password>" wt.tools.sql.SQLCommandTool
%WT_HOME%/db/sql3/qms/Masterdata/Make_module_Masterdata.sql
windchill --java=%JAVA_HOME%/bin/java.exe --javaargs="
-Dwt.tools.sql.dbUser=<username> -Dwt.tools.sql.dbPassword=<password>"
wt.tools.sql.SQLCommandTool %WT_HOME%/db/sql3/nc/NC/Make_module_NC.sql
windchill --java=%JAVA_HOME%/bin/java.exe --javaargs="
-Dwt.tools.sql.dbUser=<username> -Dwt.tools.sql.dbPassword=<password>"
wt.tools.sql.SQLCommandTool %WT_HOME%/db/sql3/qms/DispositionServer/
Make_module_DispositionServer.sql
Note
Please note the following:
• If using an SQL server replace all instances of %WT_HOME%/db/sql with
%WT_HOME%/db/sqlServer.
• %JAVA_HOME% refers to JDK directory used by Windchill.
• %WT_HOME% refers to the Windchill directory.
Optional Products
This section describes any manual post-installation steps required for the optional
products.
Windchill ESI
The following describes the post-installation procedures that are needed to
complete an installation of Windchill ESI.
Multi-byte
Multi-byte Installations
windchill --java=%JAVA_HOME%/bin/java.exe --javaargs="-Dwt.tools.sql.dbUser=<username>
-Dwt.tools.sql.dbPassword=<password>" wt.tools.sql.SQLCommandTool
Note
Please note the following:
• If using an SQL server replace all instances of %WT_HOME%/db/sql with
%WT_HOME%/db/sqlServer.
• %JAVA_HOME% refers to JDK directory used by Windchill.
• %WT_HOME% refers to the Windchill directory.
Note
Once a target has been converted to a subtype the Change Target Type action will
no longer be available.
Multi-byte
Multi-byte Installations
windchill --java=%JAVA_HOME%/bin/java.exe --javaargs="-Dwt.tools.sql.dbUser=<username>
-Dwt.tools.sql.dbPassword=<password>" -Dwt.tools.sql.dbPassword=<password>"
wt.tools.sql.SQLCommandTool
%WT_HOME%/db/sql3/wii/Environment/Make_module_Environment.sql
Note
Please note the following:
• If using an SQL server replace all instances of %WT_HOME%/db/sql with
%WT_HOME%/db/sqlServer.
• %JAVA_HOME% refers to JDK directory used by Windchill.
• %WT_HOME% refers to the Windchill directory.
CATIA V5
For CATIA V5 only, after installing your Windchill solution, and prior to installing
Windchill Workgroup Manager client, you must build the CATIA V5 Abstraction
Library.
Refer to the Windchill Workgroup Manager for CATIA V5 Administrator’s and
User’s Guide located in the PTC Reference Documents site.
Note
The following system environment variables must be created before the Windchill
Workgroup Manager client software is installed. Also refer to the Windchill
System Administrator's Guide, available at the PTC Document Reference site for
more information.
• The system environment variable for the PTC Virtual File System (VFS), that
is installed during the Windchill Workgroup Manager client installation, is
PTC_VFS_INSTALL_DIR. This variable allows the user to install VFS at the
specified location for the Windchill Workgroup Manager client software. Set
the following system environment variable:
PTC_VFS_INSTALL_DIR
Note
If you do not set the above variable, then during the Windchill Workgroup
Manager client software installation, VFS will install at the default location “C:
\ProgramFiles\PTC\VFS”.
• Another system environment variable for PTC Virtual File System (VFS) that
is installed during the Windchill Workgroup Manager client software
installation is PTC_PLACES_DEFAULT. This variable allows a user to specify
the initial location for PTC Places. It is used during the installation of VFS.
This system variable can be changed using the PTC Places UI located in the
Control Panel.
Set the following system environment variable:
Note
If you do not set the PTC_PLACES_DEFAULT variable, then after the
Windchill Workgroup Manager client software installation, the default location
for PTC Places will be “<User Profiles>\<username>\PTC Places.”
For instructions, refer to “Configuring the Windchill Virtual File System” topic
in the Windchill Workgroup Manager Help Center for Creo Illustrate or
Arbortext IsoDraw, or in the Reference Documents site for the Windchill
Workgroup Manager for Creo Illustrate Administrator’s and User’s Guide or
the Windchill Workgroup Manager for Arbortext IsoDraw Administrator’s and
User’s Guide.
• Other system environment variables must be set before installing the Windchill
Workgroup Manager client software:
○ PTC_VFS_ROOT=<any local directory>
○ PTC_WLD_ROOT=<any local directory>
Note
If you do not set the above variables, then during the Windchill Workgroup
Manager client software installation, the folders “.ws” and “.vfs” are created
under <local drive>\<Users>\<user>\.wwgm. If the “.wwgm” folder becomes
created under the network drive, it will cause a conflict.
Note
There are no post-installation steps for Windchill PartsLink Client.
Note
<PTL_HOME> is the installation directory location set during installation of
Windchill PartsLink server. By default, this value is: C:\ptc\Windchill_10.0
\PartsLink.
4. Log in to sqlplus using the installation user name and password created during
the database schema creation:
sqlplus <install username>/<install password>@<service
id>
5. Execute the database scripts by running:
@ptl/PartsLinkService/make_schema.sql
To create the application user:
1. Open a command prompt or Windchill shell.
2. Change the directory of the shell to <PTL_HOME>/db/sql.
3. Login to sqlplus as system user.
4. Execute the database scripts by running:
@create_wc_app_user.sql
5. Enter details for the application user.
SQL Server
To create the Windchill PartsLink server schema:
1. Create a database schema.
2. Copy the following directory and all of its contents to a machine where the
sqlcmd tool is available:
PTL_HOME/db/sqlServer
3. Open a command prompt or Windchill shell.
4. Go to the sqlServer directory in the command prompt.
5. Log in to the SQLServer schema for the Windchill PartsLink installation
syntax:
sqlcmd -S <db-hostname>\<db-service> -U <username> -P
<password>
Windchill MPMLink
Perform the following steps to complete the Windchill MPMLink installation:
Property name="com.ptc.windchill.mpml.copyOver.update.wt.part.WTPart"
3. Add the following entries to each property:
WCTYPE|wt.part.WTPart~MBA|describedBy@WCTYPE|wt.epm.structure.EPMDescribeLink
WCTYPE|wt.part.WTPart~MBA|buildSource@WCTYPE|wt.epm.build.EPMBuildRule
WCTYPE|wt.part.WTPart~MBA|describedBy@WCTYPE|com.ptc.windchill.mpml.pmi.
MPMWTPartToEPMDocumentLink
WCTYPE|wt.part.WTPart~MBA|characteristic@WCTYPE|com.ptc.windchill.
mpml.pmi.MPMPartQualityLink
For example:
<Property name="com.ptc.windchill.mpml.copyOver.create.wt.part.WTPart"
default="WCTYPE|wt.part.WTPart~MBA|source,WCTYPE|wt.part.WTPart~MBA|
containerReference^WCTYPE|wt.inf.container.WTContainer,WCTYPE|wt.part.WTPart~MBA|
partType,WCTYPE|wt.part.WTPart~MBA|describedBy@WCTYPE|
wt.epm.structure.EPMDescribeLink,WCTYPE|wt.part.WTPart~MBA|describedBy@WCTYPE
|wt.part.WTPartDescribeLink,WCTYPE|wt.part.WTPart~MBA|references@WCTYPE
|wt.part.WTPartReferenceLink,WCTYPE|wt.part.WTPart~SCA|ALL_CLASSIFICATION_IBAS,WCTYPE|
wt.part.WTPart~MBA|buildSource@WCTYPE
|wt.epm.build.EPMBuildRule,WCTYPE|wt.part.WTPart~MBA|describedBy@WCTYPE|
com.ptc.windchill.mpml.pmi.MPMWTPartToEPMDocumentLink,WCTYPE|wt.part.WTPart~MBA|
characteristic@WCTYPE|com.ptc.windchill.mpml.pmi.MPMPartQualityLink"/>
<Property name="com.ptc.windchill.mpml.copyOver.update.wt.part.WTPart"
default="WCTYPE|wt.part.WTPart~MBA|source,WCTYPE|wt.part.WTPart~MBA|partType,WCTYPE|
wt.part.WTPart~MBA|describedBy@WCTYPE|wt.epm.structure.EPMDescribeLink,WCTYPE|
wt.part.WTPart~MBA|describedBy@WCTYPE|wt.part.WTPartDescribeLink,WCTYPE|
wt.part.WTPart~MBA|references@WCTYPE|wt.part.WTPartReferenceLink,WCTYPE|
wt.part.WTPart~SCA|ALL_CLASSIFICATION_IBAS,WCTYPE|wt.part.WTPart~MBA|choice@WCTYPE|
com.ptc.windchill.option.model.ChoiceMappableChoiceLink,WCTYPE|wt.part.WTPart~MBA|
To convert buildrule links to Inherited links use the following procedure (the
default is to convert to Content links):
1. Navigate to and open the mpmlink.properties.xconf file, found to the following
location:
\Windchill\codebase\com\ptc\windchill\mpml\xconfs\mpmlink.properties.xconf
Note
This property controls how EPMBuildRule links (Part-CAD Association type:
Owner, Contributing Content, Contributing Image and Image) are copied from
an upstream part to its downstream equivalent part when this link type is
declared in the copy over framework properties. The default for this property is
to convert an upstream EPMBuildRule to a downstream EPMDescribeLink
(Part-CAD Association type: Content). It can instead be set to convert an
upstream EPMBuildRule to a downstream MPMWTPartToEPMDocumentLink
(Part-CAD Association type: Inherited).
To maintain the published representation when iterating parts without iterating the
EPM Doc use the following procedure:
Note
This procedure is optional. However, if the default (true) is maintained
representations may not always appear after you checkout a part.
1. Navigate to and open the wvs.properties.xconf file, found in the following
location:
\Windchill\codebase\wvs.properties.xconf
ConfiguringCreo
ConfiguringCreo Options
To configureCreo options so that system parameters of designated objects are also
automatically designated, use the following procedure:
Tip
The ask_designate_owners option if set to no , allows you to designate annotation
elements without being prompted to also designate the parent annotation. The
parent annotation will not be designated.
Multi-byte
Multi-byte Installations
windchill --java=%JAVA_HOME%/bin/java.exe --javaargs="-Dwt.tools.sql.dbUser=<username>
-Dwt.tools.sql.dbPassword=<password>" wt.tools.sql.SQLCommandTool
Note
Please note the following:
• If using an SQL server replace all instances of %WT_HOME%/db/sql with
%WT_HOME%/db/sqlServer.
• %JAVA_HOME% refers to JDK directory used by Windchill.
• %WT_HOME% refers to the Windchill directory.
dbPassword=<password>"
wt.tools.sql.SQLCommandTool %WT_HOME%/db/sql/suma/SupplierManagement/
Make_module_SupplierManagement.sql
Multi-byte
Multi-byte Installations
windchill --java=%JAVA_HOME%/bin/java.exe --javaargs="
-Dwt.tools.sql.dbUser=<username> -Dwt.tools.sql.
dbPassword=<password>" -Dwt.tools.sql.dbPassword=<password>"
wt.tools.sql.SQLCommandTool %WT_HOME%/db/sql3/suma/
SupplierManagement/Make_module_SupplierManagement.sql
Note
Please note the following:
• If using an SQL server replace all instances of %WT_HOME%/db/sql with
%WT_HOME%/db/sqlServer.
• %JAVA_HOME% refers to JDK directory used by Windchill.
• %WT_HOME% refers to the Windchill directory.
Multi-byte
Multi-byte Installations
windchill --java=%JAVA_HOME%/bin/java.exe --javaargs="-Dwt.tools.sql.dbUser=<username>
-Dwt.tools.sql.dbPassword=<password>" wt.tools.sql.SQLCommandTool
%WT_HOME%/db/sql3/wadm/wadm/Make_module_wadm.sql
Note
Please note the following:
• If using an SQL server replace all instances of %WT_HOME%/db/sql with
%WT_HOME%/db/sqlServer.
• %JAVA_HOME% refers to JDK directory used by Windchill.
• %WT_HOME% refers to the Windchill directory.
Note
Refer to the WPCServer.zip file located at <WT_HOME>\src\wpcserver\Samples\
on the Windchill PLM Connector software CD for the sample .java script,
StandardWPCVetroService.java.
1. Open the Windchill shell and navigate to the <WT_HOME>\src\wpcserver
directory.
2. Enter the following command to create a new directory structure under
<WT_HOME>\src\wpcserver\cust\service.
javac -g -d. Samples/WPC_Server/src/cust/service/*.java
3. Copy the /cust folder to <WT_HOME\codebase>.
4. Navigate to Windchill/bin and enter the following xconf commands to update
the Windchill PLM Connector wt.properties file, and to register your new
service in the codebase with xconfmanager. For example,
xconfmanager -t codebase/wt.properties
-swt.services.service.5010=cust.service.
WPCVetoService/cust.service.StandardWPCVetoService -p
5. Restart the Windchill server.
Note
Refer to the Windchill Customizer’s Guide for more details on creating non-
modelled services for listening.
Note
Refer to the Windchill Customizer’s Guide for more details on creating non-
modelled services for listening.
Multi-byte
Multi-byte Installations
windchill --java=%JAVA_HOME%/bin/java.exe --javaargs="-Dwt.tools.sql.dbUser=<username>
-Dwt.tools.sql.dbPassword=<password>" wt.tools.sql.SQLCommandTool
Note
Please note the following:
• If using an SQL server replace all instances of %WT_HOME%/db/sql with
%WT_HOME%/db/sqlServer.
• %JAVA_HOME% refers to JDK directory used by Windchill.
• %WT_HOME% refers to the Windchill directory.
Apache on Windows
To configure Apache to recognize the Enterprise LDAP for authenticating Wind-
chill Business Reporting requests use the following procedure:
1. From within a Windchill shell, navigate to the directory where Apache is
installed.
2. Run the following on the command line:
ant -f webAppConfig.xml addCognosAuthProvider
-DappName=<COGNOS_WEBAPP_NAME>
-DproviderName=<ENTERPRISE_LDAP_NAME>
-DldapUrl=<ENTERPRISE_LDAP_URL>
where
• <COGNOS_WEBAPP_NAME> is the name of the Cognos Web application,
which is Cognos by default.
• <ENTERPRISE_LDAP_NAME> is the unique name of the Enterprise
LDAP. This value should match the EnterpriseLDAP Node value in the
Cognos Configuration tool.
• <ENTERPRISE_LDAP_URL> is the full URL for the Enterprise LDAP,
including the base distinguished name. For example:
ldap://mymachine.mycompany.com:389/
cn=EnterpriseLdap,
cn=Windchill_10.0,o=myorg
Note
If there is a space or an equal sign ( = ) anywhere in one of the arguments, you
must enclose the entire argument with double quotes ( " ).
3. Restart Apache.
Apache on HP-UX
On HP-UX, Apache can only use a single LDAP for authentication of Windchill
Business Reporting requests, however you can specify an additional password file
to allow users from the Administrative LDAP (or other LDAPs) to log in as well.
1. Edit the app-Cognos.properties file, located in the following directory:
<Apache>/conf
Where <Apache> is the directory location where your Apache is installed.
2. Change the values of the following properties as necessary to reflect the
Enterprise LDAP rather than the Administrative LDAP:
• apacheWebApp.ldapUpr
• apacheWebApp.anonBind
• apacheWebApp.bindDN
• apacheWebApp.bindPwd
3. To allow users from the Administrative LDAP to log into Windchill Business
Reporting, enable use of a password file as follows:
a. While editing the app-Cognos.properites file in the previous step,
specify a value of TRUE for the apacheWebApp.passwordFile.enabled
property.
b. Run the htpasswd command in the following directory to specify names
and passwords for all Administrative LDAP users that you want to be able
to log in to Windchill Business Reporting:
<Apache>/bin
where <Apache> is the directory location where your Apache is installed.
4. Regenerate the Cognos Web application configuration by running one of the
following from a Windchill shell:
cd <Apache>
or
or
cd <Apache>
Note
If you set the Enterprise LDAP as the gateway namespace, then only users
from the Enterprise LDAP can log into Windchill Business Reporting. This
means that users from the Administrative LDAP, such as wcadmin or
wbradmin, cannot log into Windchill Business Reporting, but users from the
Enterprise LDAP who have similar permissions can log in. You can later
remove this gateway namespace, and return to the drop-down list of
namespaces presented to users when the log into Windchill Business
Reporting.
Note
The Sun Java System Web Server must be configured to work with Windchill
before proceeding.
1. Log into Sun Java System Web Server as the administrator you established
when you installed Sun Java Web Server.
2. On the Common Tasks tab, select Document Directories .
3. On the Document Directories table, click the New button.
4. Add the following URI Prefix and Directory Path values:
URI Prefix Directory Path
/Cognos /<WBR_HOME>/webcontent
/Cognos/cgi-bin /<WBR_HOME>/cgi-bin
where <WBR_HOME> is the location where Windchill Business Reporting is
installed.
5. On the CGI tab, click the New button on the CGI as File Type Enabled URIs
table.
6. Select the Entire Virtual Server checkbox.
7. Click OK .
8. Deploy the pending changes to the server following the directions found in
Deploying changes to the Sun Java System Web Server on page 287.
9. Access Windchill Business Reporting as described in Log In to Windchill
Business Reporting on page 228
Setting Properties
Set the following properties using the xconfmanager, using values appropriate for
your installation:
• For wt.properties:
wt.reporting.thirdParty.enabled=true
Note
The value used for the wt.cognos.namespace property must match the
Namespace ID value in the Cognos Configuration tool, which by default is
AdministrativeLDAP. If you have changed the Namespace ID value, then you
must use that new value for the wt.cognos.namespace property.
$(wt.cognos.model.name)
Note
Both your Windchill solution and Windchill Business Reporting must use the same
LDAP.
Configuring Windchill
Changes must be made to your Windchill solution in the following locations:
• wt.properties file
where <cognos_url> is the fully qualified URL of the machine where the
Windchill Business Reporting host components are installed. For example:
http://server1.mycompany.com/Cognos
auth.conf
where <Apache> is the directory location where your Apache is installed, and
where <Web_application_context_root> is the name specified for your
Windchill installation, which is "Windchill" by default.
Bulk Indexing
You can use the Bulk Index Tool to load all the objects that belong in the Windchill
Index Search libraries. This utility sends objects to a search engine to be indexed
according to their domain’s indexing policy. You can perform the following tasks
with this utility:
• Start and stop the bulk indexing process. Because loading indexes can take a
significant amount of time, it may be necessary to stop the operation for some
length of time. State is maintined in the IndexStatus table, which is used by this
too, so the process can be stopped and restarted without having to reindex
objects that have already been indexed.
• Schedule the process to start and stop at specified times.
• Check on the status of the overall bulk indexing process.
• Attempt the reindex objects that have failed the indexing process.
• Maintain a detailed log of the indexing process.
Note
The Bulk Index Tool can only be used to load Windchill Index Search libraries.
Note
If a user searches for the latest iteration of an object that was loaded using the
data loading utilities, all iterations appear in the search results. You can correct
this problem by using the Bulk Index Tool to re-index the data once it has been
loaded.
For more information about these properties, see the Index Search properties topic
in the Windchill Help Center.
Note
This information is applicable only if Windchill is installed along with the
Windchill Index Search module, and is applicable to every node in a Windchill
cluster.
Configuration Description
Windchill with Single MethodServer In this configuration, the single Method-
and no BackgroundMethodServer Server will handle all Windchill proc-
esses including Index Search process.
The index engine (Solr) will also be
hosted in the MethodServer.
Windchill with single/multiple Method- In this configuration, the Background-
Server and single MethodServer will host the index en-
BackgroundMethodServer gine (Solr). All other Windchill related
processes run in the foreground Meth-
odServer(s)
Windchill with single/multiple Method- In this configuration, admin should en-
Server and multiple sure that only one BackgroundMethod-
BackgroundMethodServer Server is configured to host the index
engine (Solr). The configuration details
can be found in Configuring Back-
ground Method Servers on page .
Tip
The following may aid in performance:
• The host indexing engine (Solr) should be on a dedicated
BackgroundMethodServer.
• Disabling the queues on the BGMS hosting Solr will further improve
performance. The queues will run in the foreground MethodServers and other
BackgroundMethodServers configured in the installation
Objects processing: 0
When all objects have been processed, the bulk indexing process is complete.
Note
This progress is dependent on the wt.indexbulkIndexSize=200 property. No
changes to status are made until the set number of objects are processed.
8. Delete the bulk indexing list of objects.
9. Verify Index Data
Select option 9 to verify if the objects marked as “indexed” in Windchill are
actually present in the indexed data. This option is particularly useful while
restoring Windchill/index folders. We recommend using this option
periodically (ideally, every 3-6 months) to ensure the correct index status of
Windchill objects.
Note
Option 9 marks objects not present on the index server as failed. Use option 7
if you want to check the status of your indexed objects. Use option 4 to index
any failed objects.
10. Exit
Select option 10 to close the Bulk Index Tool.
http://<WINDCHILL_URL>-Solr/wblib/select/?q=solr&spellcheck=true&spellcheck.
q=solr&spellcheck.build=true
%WT_HOME%/db/sql/rialto/WTSoftwareIssue/Make_module_WTSoftwareIssue.sql
Multi-byte
Multi-byte Installations
windchill --java=%JAVA_HOME%/bin/java.exe --javaargs="-Dwt.tools.sql.dbUser=<username>
-Dwt.tools.sql.dbPassword=<password>" wt.tools.sql.SQLCommandTool
%WT_HOME%/db/sql3/rialto/AdaptersCC/Make_module_AdaptersCC.sql
%WT_HOME%/db/sql3/rialto/WTSoftwareIssue/Make_module_WTSoftwareIssue.sql
Note
Please note the following:
• If using an SQL server replace all instances of %WT_HOME%/db/sql with
%WT_HOME%/db/sqlServer.
• %JAVA_HOME% refers to JDK directory used by Windchill.
• %WT_HOME% refers to the Windchill directory.
Note
Please note the following:
• If using an SQL server replace all instances of %WT_HOME%/db/sql
with %WT_HOME%/db/sqlServer.
• %JAVA_HOME% refers to the JDK directory used by Windchill.
• %WT_HOME% refers to the Windchill directory.
This chapter provides a summary of the other installation tasks and the post
administrative tasks that are performed after the Windchill solutions are installed
and configured.
255
Other Product Installations and
Configurations
The following is a list of other configurations and products that you can install, and
for which the instructions are included in this guide.
• Configuring Windchill to use other enterprise directories; Configuring
Additional Enterprise Directories on page 333.
• Configuring Windchill to use EXPRESS Data Manager; Configuring
EXPRESS Data Manager on page 281.
• Configuring a split configuration between Windchill and Apache; Configuring
Windchill to Work with a Remote Apache on page 329.
The following is a list of other configurations and products that you can install.
References to the installation and configuration instructions for these products are
included:
• Windchill Index Search — This is an optional feature that allows you to
perform advanced searches of meta data. Windchill Index Search is a support
component that helps to facilitate the communication between Windchill and
Solr.
• Windchill Archive is an optional product that may be installed on top of Wind-
chill PDMLink and Pro/INTRALINK 10.0. Windchill Archive provides you
with the tools to manage archival and retrieval of Windchill data. Installation
and administration information for this product is found in the Windchill
Archive Administration Guide.
• Windchill Aerospace and Defense may be installed with a PDMLink
installation.
Administrative Activities
Before you can allow users to access the Windchill solutions, there are some
additional administrative tasks that must be completed. These administrative tasks
are covered in the Windchill Basic Administration Guide and the Windchill
Specialized Administration Guide.
This chapter contains the instructions to initialize and populate the Windchill
database with base and/or demonstration data. The base data for all of the installed
Windchill products must be loaded before you can use Windchill.
Follow the instructions in this chapter if you opted not to install the base data with
the PTC Solution Installer.
For information on loading legacy data, including converting data files from CSV
to XML format, refer to the Windchill Data Loading Reference and Best Practices
Guide.
259
Before You Begin
• Determine which versions of Oracle are supported for your application. For
more information, see the software matrix available from the PTC Reference
Documents site:
http://www.ptc.com/view?im_dbkey=124477
• On UNIX systems, the installing user (including root) is typically the database
administrator (DBA). It does not matter whether the user is a local user or
Network Information Services (NIS) user.
• On Windows systems, the installing user needs to be a member of the
Administrator's group. It does not matter whether the user is a local user or a
domain user.
• You must have 5 GB available hard drive disk space for an Oracle server
installation with a Windchill demo database. More disk space is needed for
larger databases.
• For additional installation requirements, consult the Oracle documentation.
To complete the installation, you must provide the installer with information. PTC
recommends you gather this information in advance to allow the installation to
proceed without interruption:
• Name to assign to the listener.
○ Default is LISTENER.
• Protocol type.
○ Default is TCP/IP.
• Port number for the protocol type.
○ The default for TCP/IP is 1521.
windchill wt.auth.Authentication
You will be prompted for a login. Enter the administrator user name and password.
You will get messages similar to the following if the authentication executed
correctly:
2. If only the method server is displayed, then only one method server is being
used and no other steps are required. Otherwise, change the wt.manager.
monitor.services to specify only the method server as follows:
xconfmanager -s wt.manager.monitor.services=MethodServer
-t <Windchill>/codebase/wt.properties -p
Now that only the method server is specified (limited to one), you can load the
database. After the database is loaded, restore these properties to their original
settings.
SQL Server
1. Open a Windchill shell and change directory to <Windchill>/db/sqlserver.
2. Execute the following:
Windows
create_ddl_wt.bat
UNIX
create_ddl_wt.sh
Oracle RAC
1. Log in to the Oracle RAC database using SQLPlus as a DBA user (For
example, SYSTEM).
2. After replacing the <USERNAME> and <PASSWORD> variables, execute the
following query to create a user schema:
create user <USERNAME> identified by <PASSWORD>
USERNAME>;
Note
Optional products may require their own specific installation instructions. For
more information refer to the Completing Configurations - Manual Steps on page
161post-installation section for the product you are installing.
The Windchill Services data (installed with Windchill Services) can be loaded by
itself or in conjunction with a Windchill solution. In the latter scenario, it must be
the first in the product data load order.
WindchillLoader Syntax
The WindchillLoader is run from the command line under the direction of the
windchill command.The WindchillLoader command syntax is:
windchill wt.load.WindchillLoader [class args]
Where [class args] represents the required and optional executable options.
Note
For additional information about the windchill command, refer to the Windchill
Command chapter.
wt.load.
wt.load.WindchillLoader
WindchillLoader Class Arguments
Note
It will also be loaded if you run the WindchillLoader command with the option
-Application=All.
After you have installed all the solutions that you intend to install, you are ready to
load the data. The following instructions will step you through the first time data
load process:
1. Display a list of the Windchill products that are installed:
windchill wt.load.WindchillLoader -Info
A list of all the Windchill products that are installed are displayed. Take a
moment to review the list and verify that the products listed are the products
that you expect to be installed. At a minimum, the list must include Windchill.
Foundation, the Windchill Services data.
Take note of the product names and the format used for the name, as you must
use this name as it exactly appears in the -Application argument product list.
For example, Windchill.Foundation represents the Windchill Services data and
Windchill PDMLink represents the Windchill PDMLink data.
2. Load all the data for the Windchill products that are installed.
A list of all the Windchill products that are installed are displayed. Review the
list for the name of the Windchill solution that you installed. Take note of the
format of the name, because you will use that name in the -Application
argument.
2. Load the base data for the Windchill solution (or solutions) that you installed:
windchill wt.load.WindchillLoader -Application=[<app ID>,...]
Caution
Do not run the WindchillLoader with the -All argument if a Windchill solution data
set is already loaded.
WindchillLoader Examples
The following are some examples using various combinations of the utility
arguments.
• To display a list of the installed Windchill solutions available for loading data:
windchill wt.load.WindchillLoader -Info
• To load only the base data for a specific solution identified by <app ID>:
windchill wt.load.WindchillLoader -Application=<app ID>
• To load the base data and the demonstration data for a specific solution:
windchill wt.load.WindchillLoader
-Application=<app ID> -IncludeDemo
For example,
windchill wt.load.WindchillLoader -
Application=Windchill.PDMLink -Locale=ja
Executing Post-Dataload
Post-Dataload Steps
After manually loading the base data, some solutions require additional commands
be run.
Windchill PDMLink and Pro/INTRALINK 10.0
In a Windchill shell, execute the following command:
windchill com.ptc.windchill.upgrade.templatemigration.TemplateMigrationTool
-install
Windchill Services
The information in the Windchill Services Base Data table is base data that is
required for all solutions. The base data files are listed in the loadset file:
<Windchill>/codebase/wt/load/foundationLoad.xml.
Windchill PDMLink
There are two sets of data for Windchill PDMLink – base data and demonstration
data. The base data files are listed in the loadset file: < Windchill>/codebase/com/
ptc/windchill/pdmlink/load/pdmlinkLoad.xml.
Note
If you are upgrading Pro/INTRALINK 10.0 to Windchill PDMLink and have
already loaded the base data, you should not reload the base data.
The demonstration files are listed in the loadset file: < Windchill>/codebase/com/
ptc/windchill/pdmlink/load/pdmlinkDemo.xml.
Windchill ProjectLink
Windchill ProjectLink base data files are listed in the loadset file: < Windchill>/
codebase/com/ptc/windchill/projectlink/load/atcmLoad.xml.
The demonstration files are listed in the loadset file: < Windchill>/codebase/com/
ptc/windchill/projectlink /load/projectlinkDemo.xml.
Pro/INTRALINK
Pro/INTRALINK 10
There is only one set of data for Pro/INTRALINK 10.0 – base data (there is no
demonstration data). The Pro/INTRALINK 10.0 base data is the same as Windchill
PDMLink on page 272 base data. The base data files are listed in the loadset file:
<Windchill>/codebase/com/ptc/windchill/pdmlink/load/pdmlinkLoad.xml.
This section describes how to install and configure the Adobe LiveCycle software
for use with Windchill for creating and managing task form templates.
Additionally, it covers how to deploy the Adobe software to an application server.
275
About Adobe LiveCycle Forms Software
The Adobe LiveCycle Forms software is a third-party product that is purchased
separately from your Windchill solution and is deployed to an application server. It
is used to pre-populate Windchill data into task form templates that are created in
Adobe Designer software in a XDP file format. The LiveCycle Forms software
also converts the XDP template into PDF format to be rendered in the web
browser.
The task form templates are managed via the Windchill Templates user interface
and contains various form fields, like labels, text fields, and radio buttons. These
form fields are place holders to display the attributes of task like variables and
process names to the task participant when a task for an activity is executed
through a Windchill workflow process. The Workflow Template Administration
utility then acquires the information completed by the task participant and updates
the Windchill system. Once created, the task forms are rendered in a PDF file
format and printed from Windchill.
For more information about templates, see the Templates online help.
For more information about creating a task form template, see the Workflow
Template Administration online help.
This is an optional configuration; however, if you plan to use the Windchill STEP
features, then you must install and configure EXPRESS Data Manager.
This chapter contains instructions to install and configure EXPRESS Data
Manager for Windchill.
281
Installing EXPRESS Data Manager
EXPRESS Data Manager (EDMS) is a third-party product that supports STEP
(Standard for Exchange of Product Data). It is used to automatically convert the
Windchill specific file format to and from the required STEP application protocol.
The EDMS product processes provide the mapping between STEP and Windchill;
which is described in EXPRESS-X. Information about EDMS is available at the
following URL.
http://www.epmtech.jotne.com
See the Contact Us page for the EPM Technology company address and phone
number to obtain information about procuring the EDMS product.
Follow the product installation and configuration instructions provided by EDMS.
After you have installed EDMS, you must reboot your Windows system to avoid
toolkit-generated errors.
-t <Windchill>/codebase/wt.properties -p
EDMS Properties
• Specify the existing and new value (append the new value to the existing
value). See the xconfmanager guidelines for specifying multiple property
and property value combinations:
xconfmanager -s wt.java.classpath=<appended EDMS value>
-t <Windchill>/codebase/wt.properties -p
SchemaGen.log
4. Restart the Windchill method server for the changes to take effect.
At this time, the STEP configurations are complete.
The instructions in this chapter provide the details to configure the Sun Java
System Web Server for use with your Windchill solution.
285
Before You Begin
Before you begin this configuration, you should have:
• Consulted the Windchill software matrices for the version of the Sun Java
System Web Server that is supported with this release.
• Installed Sun Java System Web Server.
The configurations for Sun Java System Web Server are performed using the Sun
Web Server Administration Server and manually editing files. You will need the
following information to complete the configuration:
• Windchill does not use the Sun Java System Web Server JDK, so the default,
bundled Java version can be installed instead of using an external JDK.
• PTC recommends installing and configuring the Apache Web Server with your
solution to provide a configuration baseline. You may then reconfigure to use
the Sun Java System Web Server as a manual post installation step.
• The location of the Windchill codebase directory – This value was defined
during the installation of Windchill, for example, /opt/ptc/Windchill/codebase.
• The Windchill Web application context root name – This value was defined
during the installation of Windchill.
• The host name of the system where Windchill Directory Server resides.
• The LDAP Server Port Number – This value was defined during the installation
of Windchill Directory Server. The default is 389.
• The Base DN used by Windchill Directory Server for your Windchill solution–
This is the value you entered in the Base Distinguished Name for Product
Properties field during your Windchill product installation.
• The LDAP Server Administrator Distinguished Name – This is the Windchill Di-
rectory Server administrator distinguished name that was defined during the
installation of Windchill Directory Server. The default is cn=Manager.
• The LDAP Server Administrator Password – This is the password you defined
for the Windchill Directory Server administrator that was defined during the
installation of Windchill Directory Server.
• The URL to use to access the Sun Java System Web Server Admin Console.
By default this is running on the local host at port 8989 for SSL and 8800 for
non-SSL
The user that the Sun Java System Web Server runs as must be allowed to read and
write to the following files and locations in Windchill:
<Windchill>/logs
Ensure that the permissions on the directory and files, if they exist, are set to allow
the Sun Java System Web Server user read and write privileges.
If manual changes were made directly to the files, the Configuration Deployment
page will provide the following options:
a. Click New .
The following appears:
Ensure that the magnus.conf file is saved after making this change. After
completing the changes to the magnus.conf file, the [virtualhost]-obj.conf must be
updated. If the [virtualhost]-obj.conf file does not exist, then the changes must be
applied to the entire configuration. In this case, make the modifications to the obj.
conf file. The generated vhost-objconfadditions.conf consists of three sections.
Below is an example of the contents of this file:
#The following section belongs in the Object name="default" section of the
vhost-obj.conf file
NameTrans fn="assign-name" from="/Windchill/*.jsp(|/*)" name="jknsapi"
NameTrans fn="assign-name" from="/Windchill/*.jspx(|/*)" name="jknsapi"
NameTrans fn="assign-name" from="/Windchill/servlet/*" name="jknsapi"
NameTrans fn="assign-name" from="/Windchill/app(|/*)" name="jknsapi"
NameTrans fn="assign-name" from="/Windchill/ptc1(|/*)" name="jknsapi"
NameTrans fn="assign-name" from="/Windchill/*.jar" name="jknsapi"
NameTrans fn="assign-name" from="/Windchill/gwt/servlet/*" name="jknsapi"
NameTrans fn="assign-name" from="/Windchill/gwt/*/servlet/*" name="jknsapi"
#The following line belongs in the Object name="default" section of the
vhost-obj.conf file
#but must be after the above NameTrans lines
NameTrans fn="pfx2dir" from="/Windchill" dir="/WT_HOME/codebase"
#The following line belongs at the end of the vhost-obj.conf file
<Object name="jknsapi">
ObjectType fn="force-type" type="text/plain"
Service fn="jk_service" method="*" worker="ajp13"
</Object>
The sections are separated by comment lines starting with the pound character (#).
The first two sections contain NameTrans lines and need to be pasted into the Sun
Java System Web Server configuration instance's virtualhost-obj.conf file's <Object
name=”default”> section.
Add these NameTrans lines after the last occurrence of any existing NameTrans
lines in the virtualhost-obj.conf file. The last section begins with <Object
name=”jknsapi”>. This section should be appended to the end of the virtualhost-
obj.conf file. Ensure that the virtualhost-obj.conf file is saved after making the
above changes.
Add the following just before the </virtual-server> line and save the file:
<acl-file>[virtual hostname].acl</acl-file>
For example, in the previous, block, where the hostname is windchill.company.
com the entire block will be:
<virtual-server>
<name>windchill.company.com</name>
<host>windchill.company.com</host>
<http-listener-name>http-listener-1</http-listener-name>
<object-file>windchill.company.com-obj.conf</object-file>
<acl-file>windchill.company.com.acl</acl-file>
</virtual-server>
297
Before You Begin
PTC supports Internet Information Services (IIS) with Tomcat.
Before you begin this configuration, you should have:
• Consulted the Windchill software matrices for the version of IIS supported
with this release.
• Installed a supported version of IIS, including the Microsoft Script Debugger.
The debugger is optional, but is very useful for debugging.
• Installed the Java 2 Software Development Kit (SDK).
• Installed Apache.
PTC highly recommends that you use the bundled Apache Web server to
initially test your Info*Engine installation before switching to IIS. Testing your
installation with Apache takes very little additional time up front and generally
saves a great deal of time in troubleshooting if anything is not working
properly with IIS.
• Installed Info*Engine as part of your Windchill solution.
• Installed any Windchill solution that you intend to use and tested it with
Tomcat and Apache. Completing this step ensures that Windchill is correctly
installed before you switch to using IIS.
As part of testing Windchill with Apache, you may want to add an alternate
user name (for example, "domainxzy\userxyz") to a user LDAP entry in Wind-
chill Directory Server to ensure that such users can be accessed using the
Windows "domain\user"-style credentials. For example, during the installation
of Windchill Services, you specified the user name of the Windchill
administrator and this user was added to Windchill Directory Server. If the
name you entered (such as wcadmin) was not a Windows user, you can add an
alternate user name for the administrator by updating the user through the
Windchill Principal Administrator. The user name you add should be an
established Windows user that IIS will be able to access. Remember that after
you switch to IIS, IIS does not access user and password information in Wind-
chill Directory Server.
Note
If you are using only Info*Engine and not Windchill, this item does not apply.
• Installed all vendor required operating system patches and other suggested
installations. For supported operating system versions, see the Software Matrix
that is accessible from the PTC Documentaiton Reference Web site.
• Enabled ISAPI-dll Handler Mapping at either the server or web site level.
• Ensured that the appropriate Role services have been installed, to ensure that
IIS works with Windchill.
Restarting IIS
Throughout this document, you will be instructed to restart IIS. Use the following
steps to restart IIS:
For IIS 6:
1. Select the <ComputerName> (local computer) node in the left pane.
2. Select All Tasks and then restart IIS from the right-mouse context menu.
3. Click OK .
For IIS 7:
1. Select the <ComputerName> (local computer) node in the left pane.
2. From the Actions pane, click Restart .
Note
As an alternative, if the out of the box PTC Tomcat Connector directory is
used, the following shorter command can be used:
isapi_install_iis7 <server> <tomcat_dir> <loglevel> <architecture>
Argument Description
<server> Name of the IIS web site to use; this should generally be “Default
Web Site” (including the double-quotes) unless your site requires
another value.
If you use a value other than “Default Web Site”, be sure to use
that value instead of “Default Web Site” throughout the remainder
of these instructions.
<fdir> Full file name (including path) of <IISConnectorDir>/iis/<archi-
tecture> where <architecture> is either x86 for 32-bit Windows or
x64 for 64-bit Windows.
<worker> Full file name of (including path) of <IISConnectorDir>\conf
\workers.properties.
<mount> Full file name (including path) of <IISConnectorDir>\conf\uriwor-
kermap.properties file.
<log> Full file name (including path) of log file in which filter connector
messages will be logged. This file does not exist at this point in
the process. PTC recommends that you use <IISConnectorDir>
\logs\isapi_redirect.log as the log file name.
<level> The level of logging verbosity: emerg , error , info , or debug .
error is suggested for normal production usage, whereas debug
should be used in the course of troubleshooting.
If error is too verbose in a given environment, then use emerg
instead.
<architecture> The architecture of the Windows IIS installation. x86 for 32-bit
Windows and x64 for 64-bit Windows.
Note
This command can be safely re-run with any necessary changes to any
arguments including the level of logging.
3. Restart IIS.
Note
Set Enable anonymous access for only the jakarta/, <webAppName>/,
and <webAppName>/servlet/WindchillGW directories.
g. Click OK in both windows.
Authentication must be set for the first seven paths listed in the table. If any of
the paths listed after the first seven paths do not exist in your installation, you
can skip them.
5. Restart IIS.
a. Select the <ComputerName> (local computer) node in the left pane.
b. Select All Tasks and then Restart IIS from the right-mouse contextual menu.
c. Click OK .
Configuration Summary
At this time, IIS and Tomcat are configured for Arbortext Publishing Engine and
Windchill.
To complete your IIS and Tomcat configuration activities, you should:
• If you have installed Windchill, test the Windchill solution that you intend to
use with IIS and Tomcat. Installing Windchill is described in this guide.
Administrative activities for Windchill are described in the Windchill Business
Administrator's Guide.
• If you want to use Active Directory Server (ADS) as your enterprise LDAP
service, you can do so by configuring Windchill to use it. For details on how to
configure Windchill, see the Configure Windchill to Use an Enterprise
Directory chapter in this guide.
Additionally, the isapi_redirect connector has additional advanced configuration
options and capabilities beyond what is covered in this chapter. For more
information, see <Tomcat>\connectors\doc\index.html.
The instructions in this chapter provide the details to configure IBM HTTP Server
on an AIX platform for use with Windchill solutions.
311
Installing HTTP Web Server
Install the following components for the IBM WebSphere Application Server as
directed by the IBM documentation:
• IBM HTTP Server
Note the following configuration options:
IBM HTTP Server
When the IBM HTTP Server Plug-in for the IBM WebSphere Application Server
check box appears, clear the check box.
Once you have installed WebSphere, extract the following file to the IBM
HTTPServer home directory.
imbHTTPServerManualOverlay.zip
This file is located under the Apache/ManualInstall directory on the Third Party
Applications CD (CAPPS CD).
Note
Any time the overlay is applied, any manual configurations in this file will need to
be redone as this step overwrites the custom configuration.
is the directory where the server is installed. For example if the installation
directory is
/usr/HTTPServer/binthen
./apachect1 start
This chapter provides additional instructions to configure Tomcat and Apache for
other options.
315
Before You Begin
The typical installation and configuration scenario for Apache is that Apache is
installed on the same machine as Windchill (local) and configured to support
HTTP requests. Tomcat must be installed on the Windchill machine, as this is the
only scenario PTC supports at this time. There are, however, other scenarios you
may have for your environment, for example, running Apache on a machine other
than Windchill (remote), reinstalling Apache after its initial installation, or running
Apache in a more secure environment such as HTTPS.
The additional instructions in this chapter include:
• Setting Up Apache Ant on page 316 – Apache Ant is a Java-based build tool
used by PTC to configure and reconfigure Apache (and Tomcat) for Info*En-
gine and Windchill.
Configurations When Apache is Installed Remotely on page 318 – Instructions
for configuring Apache when it is installed on a different machine than
Windchill.
• Running Tomcat and Apache As Windows Services on page 320 – Setting up
Tomcat and Apache as a Windows service using Ant.
• Installing Apache A Second Time on page 322 – Configurations for a
subsequent installation of Apache that overlays the initial version installed.
• Configuring a Non-PTC Apache (manual installation) on page 323–
Configurations for using an existing Apache installation with Windchill.
• Specifying Web Server Authentication on page 324 – Using Ant commands to
specify various web server authentication items for Apache.
For information on setting up HTTPS on Windchill and Apache, see the
Completing Configurations - Manual Steps chapter in the Windchill Installation
and Configuration Guide and the Windchill Considerations for Security
Infrastructures in the Windchill System Administrator's Guide.
You can also use the help command to review the other execution options available
with Ant and to verify the Ant syntax.
Where <ServiceName> is the name you gave the Apache Windows service when
you created it.
Uninstall with Ant
Execute this command from the <Apache> directory.
ant -f config.xml uninstallService -DserviceName <ServiceName>
Where <ServiceName> is the name you gave the Apache Windows service when
you created it.
Note
Use this same command to add authentication rules for either Windchill PDMLink
or Pro/INTRALINK when either of these Windchill solutions have been installed
and the Add Servlet Authentication Rules for Apache installation option was not
selected.
If not specific as parameters, the IPv6 address will default to [::1], localhost, and
the IPv4 address will default to 0.0.0.0, all available listening interfaces.
Running this target will result in Apache listening for both IPv6 and IPv4 requests
over HTTP and HTTPS. The listening ports used will be those currenlty used.
For additional details, review the configureForIPv6 target in config.xml by
running:
ant -f config.xml -projecthelp.
Note
The BrowserMatch entry is used to address a Microsoft Internet Explorer bug
that impacts Windows clients.
3. Save your changes and close the file.
4. Execute the following script after applying the HP-UX Apache overlay:
Non HP-UX
ant -f config.xml configureAJPWorkers -DAJP_PORT=<tomcat_listening_port> -
DAJP_HOST=<tomcat_host> -DAJP_WORKER_NAME=<ajp_worker>
Where <Web application name> is the Web name you assigned to Windchill and
where <relative URL of resource to authenticate> is the relative path from the Web
application to the resource to authenticate, for example, the section for the URL
after http[s]://hostname:port/.../<Web application name>/... The <relative URL of
resource to authenticate> can be a directory, for example, wtcore/jsp, in which case
it applies to everything in that directory, or a particular file, for example, foo/info.
html.
For example, to require authentication to access the IE servlet in an installation
where the Web application name is MyInfoEngine, the command would look like:
ant -f webAppConfig.xml addAuthResource -DappName=MyInfoEngine
-Dresource=servlet/IE
In Apache 2.2, this command can be used to add additional LDAP URLs for
authentication.
To add users to the LDAP, consult the Windchill Directory Server Administrator's
Guide.
-DldapUrl=<ldap Url>
-DbindDn=<bindDN> -DbindPwd=<bindPassword>
Where <your Web application name> is the Web application name you assigned,
for example, Windchill. Where <your realm name> is a value of your choice.
This section describes how to configure Windchill to work with a remote Apache
server, including split configurations and additional Apache configurations.
329
Background
This section describes the configuration necessary to run Windchill with Apache
installed on a machine other than the machine that Windchill is installed on. This
configuration is known as a split configuration.
PTC recommends that you first get Windchill running with Apache installed on the
same machine as Windchill before reconfiguring Windchill to work in a split
configuration. This ensures that you have functional configurations for both
Windchill and Apache.
After the system is running with Apache installed locally, you then migrate the
Apache configuration to an Apache installation on the remote machine. Note that
the remote Apache must be updated with changes to the Windchill installation
whenever the Tomcat and Windchill configuration files are modified, such as when
a Windchill application is installed or modified. Refer to the section titled
Configurations When Apache is Installed Remotely on page 318.
Finally, you perform configuration updates on Windchill to enable it to work with
the remote Apache server. The procedure described here includes instructions to
enable Remote Method Invocation (RMI) tunneling. This is not always required,
but is included because oftentimes the same security concerns that influence the
decision to implement a split configuration also discourage the use of direct RMI
to the Windchill server.
wt.rmi.serverSocketFactory=wt.util.WrappedRMISocketFactory
wt.rmi.javarmicgi=servlet/JavaRMIServlet
wt.server.codebase=http://<remote_Apache_hostname>:<webserver port>/<webapp>
com.ptc.core.ca.co.client.doer.task.default.repository=< Windchill_hostname>
wt.federation.rpc.endpoint=
http://<Windchill_hostname>:<taskdispatcher_minport>/<webapp>/servlet/RPC
To propagate these settings from a Windchill shell on Windows use the following
command:
cd /d %WT_HOME%\apacheConf\config
ant -f applyApacheWebAppConfig.xml
333
About Configuring Additional Enterprise
Directories
You can connect to any Version 3 compliant LDAP directory or Microsoft Active
Directory Service. If you are already using an enterprise LDAP service, you can
continue to use that service to maintain user information. To do this, you can
configure Windchill so that it can also access user information by querying entries
through a JNDI adapter.
However, Windchill typically does not create, update, or delete entries in an
enterprise directory, as that capability might be limited to other parts of the
organization. This means that Windchill cannot be used to administer user
information in your enterprise LDAP service; you must use separate administration
tools instead. However, Windchill must have the ability to update group
information and organization information; therefore, these must be stored in an
LDAP server, such as the Windchill Directory Server, that provides full access
Windchill. As a result, in this scenario you would maintain two different LDAP
directories in support of Windchill.
Group Information
The Windchill class wt.org.WTGroup provides applications with information
about related groups of users. Every Windchill group must have an entry in an
LDAP directory service. The information conveyed by an instance of wt.org.
Organization Information
The Windchill class wt.org.WTOrganization provides applications with
information about organizations (for example, companies, universities, government
institutions). Every organization referenced by Windchill must have an entry in an
LDAP directory service. The information conveyed by an instance of wt.org.
WTOrganization is obtained from the corresponding LDAP directory entry of the
organization. In particular, each instance of this class provides the following
information about an organization:
name
Specifies the unique name of the organization within the scope of the directory
context in which the entry of the organization resides.
organizationIdentifier
Specifies the globally unique identifier under which the organization is
registered. This might be a DUNS number, ISO organization identifies, or cage
code.
description
Provides descriptive text about the group.
members
Specifies the users or nested groups that are members of the group.
administrator
Specifies the user or group that serves as administrator of the organization.
classification
Specifies the business classification of the organization.
conferencingIdentifier
Specifies an identifier that is used in conjunction with the conferencingURL
attribute to create or subscribe to meetings and conferences scheduled by the
organization.
conferencingURL
Specifies the URL of a service that can be used to create or subscribe to
meetings and conferences scheduled by the organization.
There are numerous other solutions that require knowledge and expertise regarding
the deployment of multiple web servers and multiple LDAP directories in a
complex secure environment. Most customers that have an existing LDAP
directory will find Option Two to be the least complicated solution. The following
topics explain how to implement Option Two.
The value you set for this property represents the organization name
assigned to all users accessed through this adapter.
If used, this property overrides any organization attribute defined in user
entries in the directory server. Only the value of the
usersOrganizationName property is used by Windchill. For more
information, see “Managing User Access to Data” in the Windchill Basic
Administration Guide.
For more information on mapping attribute values, see User and Group LDAP
Attribute Value Mapping on page 350.
Note
Both the Webject Processor and Task Processor fields should both be set to the
same value as the default LDAP adapter (typically the one used for the Wind-
chill Directory Server).
3. Click Create to create the repository definition.
For more information on the Task Delegate Administration utility, click the Help
link available from the utility main page.
Note
You must copy the current value of the property. When adding additional JNDI
adapter names to the value, you must retain the existing values by including
them in your updated property value list.
2. Add any additional JNDI adapter names (using the adapter service name) to the
existing property value. Use a comma to separate the adapter names.
xconfmanager -s wt.federation.org.directoryServices= <JNDI adapter service names>
-t <Windchill>/codebase/wt.properties -p
Note
You can enable access using the windchill.config.readOnly and windchill.
config.doesNotContainGroups properties described in Set Additional
Properties on page 344.
To change the access control privileges set for a user who is defined in LDAP,
you must use the directory server administrative tools.
3. Use the xconfmanager utility to modify the MapCredentials.xml file to
include the distinguished name and password used by the Windchill
administrator to access the directory server (property changes are stored in the
codebase/WEB-INF/mapCredentials.txt file).
The property is formatted as follows:
mapcredentials.admin.adapters=<service_name>^<distinguished_name>^<password>
This specifies the distinguished name and password for a user who does not have
Windchill administrative privileges, but still needs access to the established
enterprise LDAP adapter.
For example, assume newAdapter is the name of the adapter that has been set up
for accessing an enterprise LDAP directory server. In this scenario, the
distinguished name values are cn=NonprivUser,o=myCompany and the
password is password. The following command adds the authentication access
that is required for the LDAP directory:
xconfmanager --add "mapcredentials.nonprivileged.adapters=
newAdapter^cn=NonprivUser,o=myCompany^password"
-t "codebase/WEB-INF/mapCredentials.txt" -p
Note
Ensure that the distinguished name you specify here allows sufficient privileges to
read the Windchill objects in the directory server.
For additional credentials mapping information, see the Info*Engine User's Guide.
The value you enter is saved in the named JNDI configuration property. After the
properties are reloaded, they are then used by the directory service.
When mapping property attributes in the JNDI adapter, the following formats are
used to specify the user, group, and organization attribute properties:
Principal Property Format
User <service_name>.windchill.mapping.user. <map_identifier>
Group <service_name>.windchill.mapping.group. <map_identifier>
Organization <service_name>.windchill.mapping.org. <map_identifier>
where:
<service_name> is the service name specified for the adapter (the Service Name
field in the LDAP property form)
The following table lists the default LDAP values for group objects recognized by
Windchill. If necessary, use the <map_identifier> to change the corresponding
default attribute value for your LDAP directory:
Windchill LDAP Group Attributes
<map_identifier> Description Default Value
cn Identifies the attribute that holds cn
the names of groups in the
directory service.
description Identifies the attribute that holds description
the descriptive text about groups
in the directory service.
filter Specifies an additional expression
that is be added to all LDAP
search filters used in querying
groups that use this JNDI adapter.
By default, no additional
Note
The mapping values represents the attribute that gets mapped to the map identifier.
For instance, the map identifier o is mapped to the attribute company.
company
Note
The uid is assumed to be unique since it is the user ID that is used to log on to the
web server, therefore, the value specified for mapping.user.uniqueIdAttribute
should always be the same value specified for mapping.user.uid.
mapping.user.uid
The following attribute-mapping values are based on an out-of-the-box installation
of a Microsoft Active Directory. The actual values you assign to these attribute-
mapping properties might vary depending on your Microsoft Active Directory
installation:
<service_name>.windchill.mapping.user.postalAddress=postalAddress
<service_name>.windchill.mapping.group.objectClass=group
<service_name>.windchill.mapping.user.uid=sAMAccountName
<service_name>.windchill.mapping.user.cn=cn
The following tables list the default attributes for Microsoft Active Directory user
objects as compared to Windchill values:
Note
Some mapping values for Microsoft Active Directory might vary depending on the
Active Directory schema in use, which varies based on the release level of
Windows being used.
This section details the steps necessary to configure and enable security labels and
agreements for your site.
Non-Null
Non-Null Label Values and Their Authorized Participants
A security label can have multiple non-null label values. Each non-null label value
can be associated with a participant who is unrestricted by the security label value.
Only one authorized participant can be assigned to each security label value. This
authorized participant can be a user, user-defined group, or organization.
Specifying a user-defined group as the authorized participant provides the most
flexibility, as membership in the group can be modified as needed using the
Participant Administration utility, the Organizations ▶ Groups page, or a third
party LDAP tool to manage groups within an LDAP directory service. If a group is
used as the authorized participant for a security label value, the membership of the
group can include other groups. While there is no explicit hierarchy among
security label values, a hierarchy can be achieved by nesting groups within other
groups.
Each security label value can also optionally have an associated agreement type.
Users who are not authorized participants for that security label value are denied
access to objects with that label value applied, unless they are specifically granted
temporary access to the object by membership in an authorized participants group
for an active agreement.
If the License Required - State value has an associated agreement type of State
Export Agreement, the users who are not in the US Persons group, but meet the
necessary licensing requirements can be granted temporary access to objects
marked with the License Required - State value through use of an active State
Export Agreement. When the agreement is created, users who are not members
If the site also has a Corporate Proprietary security label configured, with its own
set of label values and authorized participants, a user must be authorized for both
security labels to access the object. For example, if a user is only a member of the
US Persons group, which is the authorized participant group for the License
Required - State label value, he will not be able to access an object that also has the
Internal label value applied. Likewise, a user who is only a member of the Internal
Personnel group, the authorized participant group for the Internal label value, will
not be able to access the object that also has the License Required - State value
Being authorized for one security label does not automatically authorize a user for
any other security label. Users must be cleared for all security labels that are set on
an object to be able to access the object.
Agreements
An agreement can provide an exception to a security label value. For example, if a
user needs to access an object that has a security label applied, but that user is not
an authorized participant for that security label value, that user can be granted
access to the object through an active agreement. An agreement clears additional
participants for access to specified security-labeled objects for a predetermined
amount of time. Once cleared for the security label value, the participants then
must have the appropriate access control permissions to be able to take their
desired action on the object. Any security-labeled object can be associated with an
agreement.
Agreements can only be created and modified by members of a user-defined, site-
level agreement managers group. This group is specified in the security labels
configuration file. Depending on their permissions, agreement managers may be
able to create agreements in the project, product, library, organization, and site
contexts. Agreements are not accessible through the context folder structure. They
are only accessible through the Agreements page or from a search results table.
Only members of the agreement managers group can access the Agreements page.
For more information, see the Agreements help.
For the Export Control security label, users outside of the US Persons group can be
granted temporary clearance for objects marked as License Required - State
through a State Export Agreement. Users granted temporary clearance who attempt
to download objects with content files will be asked to agree to the conditions of
download. Users outside of the US Persons group can be granted temporary
clearance for objects marked as License Required - Commercial through a
Commercial Export Agreement. All users who attempt to download objects with
content files, including those who are members of the US Persons group, will be
asked to agree to the conditions of download. Objects marked as Do Not Export or
Unknown cannot be cleared for users outside of the US Persons group.
Objects marked as No License Required (the null value) are unrestricted and can
be accessed by anyone with the necessary permissions on the object.
Corporate Proprietary
The Corporate Proprietary security label is used to indicate an object's level of
corporate sensitivity.
Authorized Download
Values Participants Agreements Acknowledgement
Public (null value) – – –
Private Employees Non-Disclosure None
Agreement
Internal Internal Non-Disclosure AgreementAuthorized
Personnel Agreement
Company Most Highly Trusted Non-Disclosure AllAuthorized
Private Employees Agreement
Legal Information
The Legal Information security label indicates whether an object contains legally
sensitive information.
Authorized Download
Values Participants Agreements Acknowledgement
No (null value) – – –
Yes – – –
The Legal Information security label is used for purely informational purposes. A
Yes value indicates that the object contains legally sensitive information, but the
object is unrestricted. Anyone with the necessary permissions on the object can
access the object if either label value is set. Using security labels as informative
markings is acceptable, but security labels are intended to restrict access. For more
information, see Best Practices for Security Labels and Agreements on page 403.
Note
When creating user-defined groups, be sure to note the distinguished name of
each group, and the directory service in which it is being stored, as this
information is needed during your configuration.
• Decide whether agreements will be enabled for your site. If you are going to
enable agreements, you must also:
○ Create or identify an existing group for agreement managers in the site
context. In the example configuration, this group is the Agreement
Managers group. Be sure to note the distinguished name of the group and
the directory service in which it is being stored as this information is
needed during your configuration. You will also need to set access control
permissions for the members of the agreement managers group. For more
information about setting these permissions, see Setting Access Control
Permissions for Agreement Managers on page 397.
○ If you want more than one type of agreement to be available, create soft
types of the Agreement type. Each security label value can optionally be
associated with one type of agreement. Be sure to note the internal name of
each agreement soft type as you will need it during your configuration.
For more information about creating soft types, see the help available from
the Type and Attribute Management utility. For more information about the
Agreement type, see the agreements help.
• Decide whether a download confirmation message will display when users
attempt to download object content.
• Decide whether there are certain object types for which you want to hide
security labels, so non-null security label values cannot be set. For the list of
security labeled object types, access the
<Windchill>/conf/exposedSecurityLabelObjects.xml file,
where <Windchill> is the location where your Windchill solution is installed.
Note
Because this configuration involves modifying PTC-provided files, it is important
that you understand and follow the practices detailed in the Managing
Customizations chapter of the Windchill Customization Guide. Because PTC-
provided files can subsequently be updated by PTC in a maintenance release, you
should use a “safe area” for managing your files so that your configurations are not
lost when maintenance updates are installed. The Managing Customizations
chapter provides information on setting up and using a “safe area” for storing your
site-modified files, as well as keeping versions of the original PTC-provided files,
and providing other best practice information. You should familiarize yourself with
this information before proceeding with this configuration.
1. Define Security Labels on page 370
2. Define Security Label Values on page 373
3. Define Download Acknowledgement on page 375
4. Edit the Security Labels Configuration File on page 376
5. Edit LogicalAttributesSite.xml on page 381
6. Add Security Labels to RuleConfigurableTypeAttribute.properties on page 382
7. Specify Attribute Handler for Label Attribute on page 383
8. Enable Agreement Object Type for Search on page 384
9. Enable Agreement Object Type for Auditing on page 385
10. Enable Agreement Object Type for Subscription on page 386
11. Enable Modify Security Label Event for Auditing on page 386
12. Enable Modify Security Label Event for Subscription on page 387
13. Hide Security Labels on Certain Objects on page 388
14. Restart Windchill Method Servers on page 390
15. Add Agreements to List of Searchable Object Types on page 390
16. Define Object Initialization Rules for Security Labels on page 391
Note
If the <Windchill>/wtCustom directory does not already exist in your
installation, and your site has not already implemented a parallel directory
structure for site specific files, complete the following steps to implement it:
a. Create the following directory:
<Windchill>/wtCustom
By default this is the directory root recognized by Windchill for custom
directories, as specified in the wt.generation.custom.dir property in tools.
properties. For more information see the Windchill Customization Guide.
b. Create additional subdirectories within the <Windchill>/wtCustom
directory as needed.
3. Open the <Windchill>/wtCustom/wt/access/accessModelRB.
rbInfo file in a text editor.
4. For each security label, add the following lines, making sure not to include any
spaces except in the <DISPLAY_NAME> or the <LONG_DESCRIPTION>:
WCTYPE|wt.access.SecurityLabeled~SCA|<SECURITY_LABEL>.value=<DISPLAY_NAME>
WCTYPE|wt.access.SecurityLabeled~SCA|<SECURITY_LABEL>.dataType=java.lang.String
WCTYPE|wt.access.SecurityLabeled~SCA|<SECURITY_LABEL>.serverFunction=
com.ptc.core.foundation.security.server.impl.SACFSecurityLabel
WCTYPE|wt.access.SecurityLabeled~SCA|<SECURITY_LABEL>.serverFunction.arg1=
PID{<SECURITY_LABEL>}
WCTYPE|wt.access.SecurityLabeled~SCA|<SECURITY_LABEL>.longDescription=
<LONG_DESCRIPTION>
where:
• <SECURITY_LABEL> is the security label name. This value should use
only alphanumeric characters and the underscore character. The string
WCTYPE|wt.access.SecurityLabeled~SCA|
<SECURITY_LABEL> is the value that will be specified for the
SecurityLabelResourceKey element for the security label in Step 3
on page 376 of this configuration. While there is no requirement for the
<SECURITY_LABEL> value to match the name attribute specified for the
SecurityLabel element in the security labels configuration file, that is
the convention used in this guide.
WCTYPE|wt.access.SecurityLabeled~SCA|EXPORT_CONTROL.value=Export Control
WCTYPE|wt.access.SecurityLabeled~SCA|EXPORT_CONTROL.dataType=java.lang.String
WCTYPE|wt.access.SecurityLabeled~SCA|EXPORT_CONTROL.serverFunction=
com.ptc.core.foundation.security.server.impl.SACFSecurityLabel
WCTYPE|wt.access.SecurityLabeled~SCA|EXPORT_CONTROL.serverFunction.arg1=
PID{EXPORT_CONTROL}
WCTYPE|wt.access.SecurityLabeled~SCA|EXPORT_CONTROL.longDescription=
The "Export Control" label indicates the business object's level
of export sensitivity
WCTYPE|wt.access.SecurityLabeled~SCA|LEGAL_INFORMATION.value=Legal Information
WCTYPE|wt.access.SecurityLabeled~SCA|LEGAL_INFORMATION.dataType=java.lang.String
WCTYPE|wt.access.SecurityLabeled~SCA|LEGAL_INFORMATION.serverFunction=
com.ptc.core.foundation.security.server.impl.SACFSecurityLabel
WCTYPE|wt.access.SecurityLabeled~SCA|LEGAL_INFORMATION.serverFunction.arg1=
PID{LEGAL_INFORMATION}
WCTYPE|wt.access.SecurityLabeled~SCA|LEGAL_INFORMATION.longDescription=
Note
Do not delete or alter the existing lines that begin with:
WCTYPE|wt.access.SecurityLabeled~SCA|ALL_SECURITY_LABELS
5. Save and close.
6. From within a windchill shell, run one of the following commands to build the
resource bundle. With the <Windchill>/wtCustom directory created, the
system automatically builds the RBINFO files found in the <Windchill>/
wtCustom directory, rather than the files found in the <Windchill>/src
directory.
• For a Windows system:
ResourceBuild wt.access.accessModelRB
• For a UNIX system:
ResourceBuild.sh wt.access.accessModelRB
to the
<Windchill>/wtCustom/wt/access/configuration
where :
• <VALUE> is the security label value name that will be specified in the
securityLabelsConfiguration.xml file.
• <LOCALIZED_DISPLAY_NAME> is the name of the security label value
as it will display in the user interface.
• <LONG_DESCRIPTION> is the long description of the security label. The
long description is displayed in the automatically generated online help for
the security label, accessed by clicking the view security label information
icon from the Security Labels table.
Note
The NULL resource key is present automatically for each security label. A
meaningful display name and description can be provided for the NULL key
by editing the resource entry, but the entry should not be deleted.
For example, the following lines would be modified in or added to the
SecurityLabel1.rbInfo file for the sample configuration:
NULL.value=No License Required
NULL.shortDescription=Export of the selected business objects does not
require a license.
UNK.value=Unknown
UNK.longDescription=Export restriction status of the selected business
object is not known. Treat as Do Not Export.
Where:
• <KEY> is the download acknowledgement key that will be specified in the
securityLabelsConfiguration.xml file.
• <LOCALIZED_MESSAGE_TEXT> is the confirmation message that will
appear in the user interface.
• <COMMENT> is the optional comment describing the purpose of the
message.
To enable security labels, make the following changes within the configuration file:
• If you are enabling agreements, add the AgreementConfiguration
element and its sub-elements.
• For each security label, add a SecurityLabel element and its sub-elements.
• Change the value of the enabled parameter on the
SecurityLabelsConfiguration element from false to true:
<SecurityLabelsConfiguration enabled="true">
AgreementConfiguration Element
Note
For security labels to work, you do not need to enable agreements. If you are not
planning to use agreements, you do not need to include this element.
The AgreementConfiguration element and sub-elements are specified in
the following manner, using sample information:
<AgreementConfiguration enabled="true">
<AgreementManagersGroup>
<groupUfid>cn=Agreement Managers,ou=people,
cn=AdministrativeLdap,cn=Windchill_9.1,o=ptc
|Ldap.ptcnet.ptc.com|Ldap.ptcnet.ptc.com</groupUfid>
</AgreementManagersGroup>
<AgreementLifecycleState>
SecurityLabel element
The SecurityLabel element contains the data for defining a security label,
including possible security label values, the authorized participant for each value
(if not all users), the agreement type (if any) associated with the label value, and
various mappings used by applications and services to process security labels.
There should be one SecurityLabel element for each security label you
configure. For example:
<SecurityLabel name="EXPORT_CONTROL" enabled="true">
<SecurityLabelResourceKey>WCTYPE|wt.access.SecurityLabeled~SCA|
EXPORT_CONTROL</SecurityLabelResourceKey>
<SecurityLabelValueResourceClass>wt.access.configuration.SecurityLabel1
</SecurityLabelValueResourceClass>
<SecurityLabelValue name="LNS" enabled="true" downloadAckMessageKey=
"LNS_DownloadAck" downloadAckUsers="AgreementAuthorized">
The name attribute of the SecurityLabel element is the string that is stored in
the database for this security label, in this case, EXPORT_CONTROL. For this
security label to be available in your Windchill solution, the enabled attribute
must be set to true. This name value does not generally show in the user
interface; the display name for this security label was defined in Step 1 of this
configuration.
If you are using download acknowledgement, include the
downloadAckMessageKey attribute and the downloadAckUsers attribute.
The value for the downloadAckMessageKey attribute is the key specified in
the securityLabelDownloadAckResource.rbInfo file. The value for
the downloadAckUsers attribute can be one of the following:
• None: no users are shown the download confirmation message
• AgreementAuthorized: only users authorized through an agreement are
shown the download confirmation message
• AllAuthorized: all authorized users are shown the download confirmation
message
The SecurityLabelResourceKey element represents the resource key for
the label, and is specified in the following format:
WCTYPE|wt.access.SecurityLabeled~SCA|<SECURITY_LABEL>
Note
Even if security labels are globally disabled, the security label resource keys
specified in the configuration file must exist in the accessModelRB.rbInfo
file in order for the method server to start. For more information on disabling
security labels, see the security labels administration help.
Instructions for defining object initialization rules for security labels are found later
in this configuration.
xconfmanager —s wt.services/svc/default/com.ptc.core.command.server.delegate.io.
AbstractAttributeHandler/CORPORATE_PROPRIETARY/wt.access.SecurityLabeled/0=
com.ptc.core.command.server.delegate.io.SecurityLabelAttributeHandler/singleton
xconfmanager —s wt.services/svc/default/com.ptc.core.command.server.delegate.io.
AbstractAttributeHandler/LEGAL_INFORMATION/wt.access.SecurityLabeled/0=
com.ptc.core.command.server.delegate.io.SecurityLabelAttributeHandler/singleton
—t codebase/com/ptc/core/foundation/FoundationAttributeHandler.properties —p
For example,
<!-- If security labels is enabled on your system then add
wt.access.agreement.AuthorizationAgreement to ProjectLink.userSearch:
<AddToProperty name="ProjectLink.userSearch" value=
"wt.access.agreement.AuthorizationAgreement"/>
-->
becomes
<!-- If security labels is enabled on your system then add
wt.access.agreement.AuthorizationAgreement to ProjectLink.userSearch:-->
<AddToProperty name="ProjectLink.userSearch" value=
"wt.access.agreement.AuthorizationAgreement"/>
4. If the property named WindchillPDM.allSearch does not exist, add it as
follows:
<Property name="WindchillPDM.allSearch" multivalued="," default=
”wt.access.agreement.AuthorizationAgreement"/>
Note
This step makes the agreement object type searchable. You must also Add
Agreements to List of Searchable Object Types on page 390.
Note
Do this before the security label enabled system is made available to your users.
To hide the Security Labels tab in the Manage Security window and remove the
ability to associate the object type as an authorized object:
1. Open the following file in a text editor:
<Windchill>/conf/exposedSecurityLabelObjects.xml
Note
Only complete these steps if you enabled security labels for subscription in Enable
Modify Security Label Event for Subscription on page 387.
1. Open the following file in a text editor:
<Windchill>/codebase/wt/notify/subscriptionConfig.xml
Note
Only complete these steps if you enabled agreements.
1. Open the following file in a text editor:
<Windchill>/codebase/com/ptc/core/agreements/
agreements-SearchableTypes.properties.xconf
<Arg>LNS</Arg>
</AttrValue>
<Value algorithm="com.ptc.core.rule.server.impl.GetServerPreGeneratedValue"/>
</AttrConstraint>
Specifying a UFID
The syntax for specifying a UFID is as follows:
<DISTINGUISHED_NAME>|<GUID>|<DOMAIN>
This principal is used as the session principal for a replication session for that
replica site. For objects to be replicated to the replica site, the principal specified
for that site must have access to that object. When security labels are enabled, this
means that for an object to be replicated to the replica site, the user or group
specified as the site principal must be an authorized participant for all security label
values on that object.
The following types of replication are impacted:
• Scheduled replication – Only objects to which the site principal has access are
replicated.
• User initiated replication – When replication is initiated, only objects to which
the site principal for chosen replica site has access are replicated, even if the
user initiating the replication has access to the objects.
Watermarks
Security label settings can be included in watermarks, similar to other object
attributes. When publishing an assembly or structure, the security labels associated
with the top-level object being published are the security labels included in the
watermark. If the security label setting is different on a child part within the
structure, that difference is not reflected in the watermark.
where
• <PROPERTY_GROUP> is the prefix associated with the property group:
○ part for the WindchillPart property group
○ epmdoc for the WindchillEPM property group
○ doc for the WindchillDocument property group
• <SECURITY_LABEL_NAME> is the security label name as it appears in the
name attribute of the SecurityLabel element in the security labels
configuration file.
For example, the security label property for the Export Control security label in the
WindchillPart property group displays as follows:
part_slExport_Control
When a security label is selected from one of the property groups and included in a
watermark, the localized label value displays based on the locale of the server.
Initially, a representation inherits the security labels from the object it is
representing, known as the representable object. Use the Manage Security action to
update the security labels set on the representation. The properties available for
selection on a watermark depend on the representation being viewed, and its
representable object.
• When the representable object is a part with no associated EPM document:
○ The WindchillPart security label properties for representations are those of
the representable part and are dynamically updated whenever the security
labels on the representable part are updated.
○ If a representation was copied from an EPM document, the WindchillEPM
security label properties for the representation are the security labels as they
were set at the time the representation was copied to its current location.
There is no connection between the representation and the original EPM
document.
This section describes where to find the log files that can help you debug issues
that arrise during installation. It also describes known issues and actions you can
take to resolve them.
Note
On Windows, the Local Settings directory may be hidden by default. If you
cannot find the Local Setting directory using the Windows Explorer, check
your folder options to ensure that hidden folders are displayed.
• On UNIX, the logs are temporarily written to either /var/tmp or /tmp (JVM
implementation dependent). If the installer does not have permission to write to
the temporary directory, it writes the <installer short name>_InstallLog.xml file
to the user's <HOME> directory, but the <installer short name>_PtcInstall.log
is held in memory until they are both written to <Windchill>/installer/logs. If
Problem:
When an installation fails, the installer logs are not written to the standard output
directory of <installation directory>/installer/logs.
Action:
In this case, the installer displays the location of the installation log files that it has
produced. Write down the location specified by the installer. The location of the
log files depends upon when in the installation process the installation fails. Refer
to Installation Log Files on page 406 for details.
Problem:
When installing on Windows, the installation fails after the PTC Solution Installer
(PSI) closes before completing the installation.
Action:
This can result from the Windchill Directory Server or Java not being installed on a
local drive. The following error will be found in the WINDCHILLDS_PtcInstall.
log:
javax.naming.CommunicationException: Could not connect to the LDAP Server
See the section titled Setting the Installation Directory on Windows on page 43 in
the Windchill Installation and Configuration Guide. If a prohibited file path was
specified in PSI for installation, reinstall using a non-prohibited file path.
ldap
at com.ptc.ldapserver.install.
port: 389 ldap manager: cn=Manager
actions.CheckServerStatus.process(CheckServerStatus.java:78)
at com.ptc.windchill.install.framework.InstallAction.run(InstallAction.java:476)
By default, the IBM JVM initially uses Internet Protocol Version 6 (IPv6) for all
network accesses, followed by using IPv4. If a site’s Domain Name Server is not
set up properly to respond to IPv6 requests, the IPv6 requests may time out before
IPv4 use is attempted. For example, even a simple request to get the local host
name can cause such timeouts. The Windchill Directory Server code makes several
local host name requests and, therefore, may take a long time to start on some AIX
sites.
The Windchill Directory Server installation process only waits 120 seconds for the
Windchill Directory Server to start before continuing with installation tasks and the
server must be running for the installation to complete successfully. If, as a result
of the DNS timeouts, the Windchill Directory Server takes longer than 120 seconds
to start, then the Windchill Directory Server installation may fail with the error that
is identified above. Although the Windchill Directory Server may eventually start,
the installation does not complete successfully and you will not be able to connect
to the Control Panel.
Action:
This is an issue with a site’s IPv6 DNS configuration in conjunction with the way
IPv6 is used by the IBM JVM. For additional information on the issue, see
information on the IBM site that is available from:
http://www-01.ibm.com/support/docview.wss?uid=swg21170467 .
Also see RFC 4074 that is available from:
http://www.ietf.org/rfc/rfc4074.txt.
One way to resolve the issue is to update the DNS to respond properly to IPv6
requests, as described in section 3 of RFC 4074.
After you have fixed the problem, rerun the installer.
Alternatively, if you are not using IPv6, you can set the IP configuration to use
only IPv4 by adding the following line to the /etc/netsvc.conf file:
Using IPv4 fixes the timeout problem that was causing the Windchill Directory
Server installation to fail.
After you have fixed the problem, rerun the installer.
Problem:
On a UNIX system, the installer does not run.
This can happen if the TMP directory does not have the disk space required by the
installer.
Action:
Set the environment variable LAX_DEBUG=1 in the shell where the installer was
launched and restart the installer. This should result in output being written to the
console window.
If the output produced indicates that the amount of /tmp disk space required to
perform this installation is greater than what is available, you can set the
IATEMPDIR environment variable to a directory on a disk partition with enough
free disk space. Then restart the installer.
To set the variable, enter one of the following commands at the UNIX command
line prompt before running this installer again:
• for Bourne shell (sh), ksh, bash and zsh:
$ IATEMPDIR=/<your>/<free>/<space>/<directory>
$ export IATEMPDIR
• for C shell (csh) and tcsh:
$ setenv IATEMPDIR /<your>/<free>/<space>/<directory>
Problem:
The installer cannot find a valid Java Virtual Machine (JVM).
This can happen in the following situations:
• If you try running the installer using an executable file that is located in a
NoVM directory.
• You are trying to install one of the products from the Windchill Third Party
Software CD or the Windchill Services CD over a network connection, and
you do not have a supported JVM on your local machine. For the installers, the
supported JVM is a version of Java 1.5.
Action:
If you were not using a setup script that is located at the root directory on the CD,
rerun the installer using the setup script located in the root directory. Running the
installer from the root directory ensures that the JVM bundled with the installer is
used.
If you are installing over a network connection, locate a supported JVM and rerun
the installer using the setup command with the following as the first two arguments
on the command line.
UNIX:
UNIX
<install_dir>/<setup_script> LAX_VM <java_install_dir>/bin/java
Windows:
Windows
<install_dir>/<setup_script> LAX_VM <java_install_dir>/bin/java.exe
Where <install_dir> is the directory path to the setup file, <setup_script> is the
setup script in the root directory of the CD for the product you are installing (such
as setup_tomcat.vbs), and <java_install_dir> is the installation directory for the
JVM. The second argument is the actual Java VM executable, not a directory. If
any other arguments are passed in, they must follow these two arguments.
Alternative Method:
Method
An alternative to running the setup script from command line and including the
LAX_VM option is to set the LAX_VM environment variable to the same value
that would be used on the command line. When this variable is set, running the
setup script that is in the root directory on the CD automatically adds LAX_VM
and <java_install_dir>/bin/java to the command line for the installer that you are
starting.
Problem:
On AIX, the installer core dumps and does not launch.
Action:
This can happen if the IBM_MIXED_MODE_THRESHOLD environment
variable is set. Unset the IBM_MIXED_MODE_THRESHOLD variable.
Problem:
Technical Support asks you to provide additional diagnostic information about
how the installer launches and what JRE is used to execute the installer.
Problem:
The installer does not run. The error message returned indicates that one of the
following requirements is not true:
• The installer only runs on the following platforms:
AIX, HP-UX, Solaris, Windows 2000, or Windows 2003
• The installer requires Java 1.5 or higher in your path.
Action:
Ensure that you are running on a supported platform. Although the message does
not indicate that Windows XP is supported, the installers can run on Windows XP
also.
Additionally, ensure that you are running the installer using the scripts located in
the root directory of the CD. This ensures that Java Virtual Machine bundled with
the installer is being used.
Problem:
Sometimes the installer appears to skip over a step.
Action:
The installers behave in a wizard-like fashion with Next and Previous buttons. In a
system where the response is slow, the wizard may not advance to the next or
previous step as quickly as expected and you may click the Next or Previous
button again (repeatedly). This mouse click event is queued up and acted upon
when the system responds. This may advance the windows beyond the expected
window.
Once the Next or Previous button has been clicked, wait for the installer to respond
and advance to the intended window.
Under normal system conditions, the installer moves forward and backward
through the windows with little noticeable delay.
Problem:
On Windows, the installer Cancel Installation dialog box demands the user
interface focus.
Action:
When you try to cancel the installer through the Cancel Installation dialog box, the
window monopolizes the window focus on the desktop.
To release the focus, click either the cancel (the X in the upper right corner of the
dialog box) or Resume button.
Problem:
During an installation, the installer displays the following:
Action:
The appearance of this window indicates that the installer could not locate a
required file from the current media set.
Problem:
The following error message appears when you are doing a keyword search in
Windchill Index Search:
Resource limit Exceeded
Problem:
The following error message appears on a UNIX system during a data load if the
Windchill Index Search server is not running:
Indexing Queue is Experiencing Problems
Action:
PTC recommends you disable indexing during data loads and use the Bulk Index
Tool for a more performant load.
Also, you need to make sure that Windchill Index Search has enough time to start
completely before the data load is started, and the indexing queue is ready. You
need to check this directly.
If the error still occurs, start Windchill Index Search manually. See the information
in “Completing Configuration - Manual Steps”.
Note
The indexing errors clear once Windchill Index Search is up and running correctly.
Everything then should run normally.
Problem:
On AIX, installing the Windchill solution with multiple optional products fails.
Action
The last JAR to be loaded from the JDK should always be tools.jar.
--------------------------------------------
Starting MethodServer
Class path =
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/activation.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/ie.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-
INF/lib/ie3rdpartylibs.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/ieWeb.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/install.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/mail.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/Gantt.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/jviews-chart-
all.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/jviews-framework-
all.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/jviews-gantt-
all.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-
INF/lib/wc3rdpartylibs.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-
INF/lib/CounterPartWeb.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/prowtWeb.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/wncWeb.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/pdmlWeb.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/sumaWeb.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/scmiWeb.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/pjlWeb.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/tibjms.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/ptlWeb.jar
/mnt/disk2/ptc/Windchill/lib/servlet.jar
/mnt/disk2/ptc/Windchill/lib/windu.jar
/mnt/disk2/ptc/Windchill/lib/wnc.jar
/mnt/disk2/ptc/Windchill/lib/pdml.jar
Mon 6/30/
6/30/08
08 16:27:15: main: /mnt/disk2/
/mnt/disk2/ptc/
ptc/
Starting MethodServer
Class path =
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/activation.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/ie.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/ie3rdpartylibs.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/ieWeb.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/install.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/mail.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/Gantt.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/jviews-chart-all.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/jviews-framework-all.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/jviews-gantt-all.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/wc3rdpartylibs.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/CounterPartWeb.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/prowtWeb.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/pdmlWeb.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/sumaWeb.jar
/mnt/disk2/ptc/Windchill/codebase/WEB-INF/lib/scmiWeb.jar
/mnt/disk2/ptc/Windchill/lib/servlet.jar
/mnt/disk2/ptc/Windchill/lib/windu.jar
/mnt/disk2/ptc/Windchill/lib/wnc.jar
/mnt/disk2/ptc/Windchill/lib/pdml.jar
/mnt/disk2/ptc/Windchill/lib/scmi.jar
Problem:
When installing as a root user on UNIX, the PTC Solution Installer terminates after
hitting Install .
Action:
Clear the SESSION_MANAGER variable. This issue will not occur if using the
PSI as a non-root user.
Dpassword=<password>
3. Select each of the links. The following list describes a successful result:
• The first two rows result in SUCCESS messages
• Authenticated JSP Request link results in a page that shows the user
authentication name
• THe last row shows a low-level echo of the HTTP request's fields without
an error. An authenticated version shows the user name under the heading
“cgi.remote_user” in the format:
:<username>:
If all of these links show successful messages, the communication between the
Web server, servlet engine and method server is working. Any failure messages
include more information on troubleshooting the issue.
Windows
<drive>\User Profiles\<user_name>\Application Data\PTC\ Windchill\<instance_id>
Within the <instance_id> is the actual registry file “psi_iir.xml” which contains
information about that instance. There may be some numbered backups such as
“psi_iir.000.xml” as well.
The <instance_id> folder is a computer-generated unique ID, so in order to identify
a particular registry, the psi_iir.xml must be referenced.
When the PSI is executed, the registry is backed up to the following location:
<Base Installation Directory>/installer/instreg/<instance_id>
where:
<Base Installation Directory> = the base common directory of the installed
products
<instance_id> = the unique string that identifies the registry instance
The base installation directory and its instance_id are added to a master index file
(psi_iir_index.xml) that resides in the old registry location. When an existing
installation is updated to a later maintenance release or point release, an entry for
the installation is created in this file and the registry for the old release is removed.
Most UNIX systems automatically mount the CD-ROM after it is loaded into the
CD-ROM drive. For users whose machines do not mount automatically, the
following instructions explain how to load and mount the CD-ROM both locally
and remotely.
Note
Sun Solaris 2.x has automatic CD mounting. For more specific information on how
to mount CDs on Sun hardware, visit http://docs.sun.com/.
<device>should be replaced
with each item in the /dev/dsk
directory.
For the device file identified as
type: CD-ROM, the SCSI ID is
to the right of the letter t in this
example of a device file name:
c0t3 d0
Note
The identified device file name is
the same file name that is used in
the command to mount the CD-
ROM.
SUN Automatically mounts the CD-
ROM.
AIX lsdev -C -c cdrom -H 4
Note
The inclusion of a system in this table does not indicate support for that system;
this information is only included to help you determine the SCSI ID for CD-ROM
drives that are remotely mounted to your workstation. See the software platform
matrix (available from http://www.ptc.com/appserver/cs/doc/refdoc.jsp) for
information on supported systems and platforms.
3. To mount the CD-ROM drive, enter the command appropriate for your UNIX
workstation system.
• For Sun, the command is:
mount -F hsfs -o ro /dev/dsk/c0t#d0s0 /cdrom
In the command line, replace the # symbol with the SCSI ID of the drive.
• For AIX, the command is:
/usr/sbin/mount -o ro -v cdrfs -f /dev/cd0 /cdrom
Example:
/dev/dsk/c5t2do /cdrom pfs-rrip xlat=unix 0 0
b. Perform this step (and steps c through e) as the root user. Run the
following file:
# nohup /usr/sbin/pfs_mountd &
If you have not configured a CD-ROM device in /etc/fstab or did not allow the Red
Hat installer to automatically configure a CD-ROM device in your /etc/fstab, refer
to Red Hat documentation for instructions. You can find Red Hat documentation
at:
http://www.redhat.com/docs/manuals/enterprise/
Note
If problems occur while using an installer from a
remote-mounted CD-ROM, you can try remounting
the remote CD-ROM using one of the following
commands:
For Sun systems
mount -o ro,hard,vers=2 <node>:<cdmount>
/cdrom
<node>:<cdmount> /cdrom
Note
In the preceding example, the number sign (#) represents the SCSI ID of the
CD-ROM drive.
8. The CD-ROM file system must be exported before a remote UNIX system
allows access to the CD-ROM from your local UNIX workstation. To
accomplish this, you must add a line to a file on your local UNIX workstation,
and, in some cases, execute a command.
9. Use the following table, to identity your remote system; add the text in the Line
to Add column to the file listed in the File to Edit column. You must have the
correct write permissions to edit the files. If necessary, execute the command
listed in the Command column. For additional information, see your hardware-
specific documentation.
System File to Edit Line to Add Command
HP-UX /etc/exports /cdrom -ro exportfs /cdrom
Sun /etc/dfs/dfstab share -F nfs -o ro shareall
/cdrom
If problems occur while using an installer from a remote-mounted CD-ROM on
Sun Solaris systems, try remounting the remote CD-ROM using the following
command:
mount -o ro,hard,vers=2 <node>:<cdmount> /cdrom
Starting and Stopping Apache and the Windchill Method Server .................................. 432
Using a URL to Access Windchill .............................................................................. 433
Running Windchill as a Windows Service .................................................................. 434
This chapter provides instructions on managing the Windchill servers (start and
stop), how to initiate the Windchill home page, and how to configure Windchill to
run as a Windows service.
If you configured Windchill for HTTPS, then the format would be:
https://<hostname>:<port>/<webapp>
The default port number for HTTPS is 443. If you assigned a value other than the
default value, then include the port number in the HTTPS URL string.
Troubleshooting Tips
If the “JNI error finding main class” or “Unable to change the working directory”
messages are displayed in the Windows Event Viewer, then try the following:
• Verify your CLASSPATH settings to ensure it is correct. If a directory contains
spaces, enclose the directory path in quotes.
Where <ServiceName> is the name you gave the Windchill Windows service when
you created it.