Oracle® Fusion Middleware Installation Guide for Oracle Team Productivity Center Server 11g Release 1 (11.1.1) E14156-06 |
|
![]() Previous |
Installation Guide for Oracle Team Productivity Center Server
11g Release 1 (11.1.1)
E14156-06
January 2011
This document provides information on:
Section 1, "Oracle Team Productivity Center Server System Requirements"
Section 2, "Installing the Oracle Team Productivity Center Server"
Section 3, "Installing an Oracle Team Productivity Center Connector"
For the most current system requirements, please refer to the Oracle Fusion Middleware Installation Guide for Oracle JDeveloper.
The installation software for Oracle Team Productivity Center Server is distributed as a platform-independent JAR file. Download the Oracle Team Productivity Center Server installation JAR file from the Oracle Technology Network (OTN) web site: http://www.oracle.com/technetwork/developer-tools/jdev/downloads/index.html
You can choose to install the Oracle Team Productivity Center Server either as a new installation or as an update to an existing server. The installation software is the same, but there are slight differences in the procedure for installing the server depending on whether you are creating a new installation or upgrading an existing one. Instructions for installing a new server or updating an existing one are included in Section 2.4, "Installer Screens for Server Installation".
Before installing the Oracle Team Productivity Center Server, take note of the following terms that will help manage the server during and after installation:
Client—the set of features in Oracle JDeveloper that allow interaction with team members, selecting work items, and otherwise tracking project development.
Server—the software that manages the connections between the team's TPC features in Oracle JDeveloper and data repositories (such as a bug database, feature wiki, or directory of product features and specifications).
Connector—the element that defines the data structures and user interface between Oracle Team Productivity Center and a given data repository. For example, presenting a list of bugs from the bug tracking tool in Oracle JDeveloper requires a connector to the bug tracking tool. For more information on this, see the online help for developing a connector (look up how to craft such a link).
The Oracle Team Productivity Center installation package can perform two functions:
to perform the initial installation of the server
to install or update connectors that the existing server installation will be able to access (such as project tracking software, or a feature/specification repository)
It is possible to install the Oracle Team Productivity Center software without installing a connector at the same time. Installing a new connector can be performed at any time after the installation of the server software.
Before you run the installer, ensure that the following prerequisites are satisfied:
Installation requires entering a user ID and password for the database to which Oracle Team Productivity Center is to be connected. Make sure that you have all user privileges that you require for full access to this database before beginning installation. For example, if an Oracle database is used, please make sure the user has been granted Connect and Resource options.
Make sure to download the Oracle Team Productivity Server installation package, available from the Oracle Technology Network (OTN) web site: http://www.oracle.com/technetwork/developer-tools/jdev/downloads/index.html
If you are using Oracle WebLogic Server as the installation server, version 10.3.4 is recommended.
Make a note of the directory containing the downloaded installation file, called tpcinstaller.jar
. Installation requires navigating to that directory and executing a command-line instruction to install Oracle Team Productivity Center.
Make sure the system on which Oracle Team Productivity Server is to be installed is running the latest JDK, as required by the Oracle Fusion Middleware Installation Guide for Oracle JDeveloper.
The Oracle Team Productivity Center Server installation package is a JAR file. The package can be installed on Windows, Linux, or Mac OS X platforms that meet the Oracle JDeveloper standard requirements. The installation system must also be running a Java EE application server, on which the Oracle Team Productivity Center server will run when installed.
Installation begins from the command line; after launching the installer, it will continue with a sequence of installation screens containing selections as the installer proceeds with the installation.
To start the installer:
Navigate to the directory containing the Oracle Team Productivity Center installation file, tpcinstaller.jar
.
From a command line (that is, a Linux or DOS command shell), type the following command, substituting the installation system's JAVA_HOME
directory where indicated:
set JAVA_HOME=location of java_home
For example, on a Windows system with JDK 1.6.0_11 installed in the Program Files directory on the C:\ drive, the command would be:
set JAVA_HOME=C:\Program Files\Java\jdk1.6.0_11
When the preceding command completes and the system command-line prompt is once again visible, type the following command:
set PATH=%JAVA_HOME%\bin;%PATH%
When the preceding command completes and the system command-line prompt is once again visible, type the following command:
java -jar tpcinstaller.jar
This launches the Oracle Team Productivity Center installer, which proceeds with a number of screens as shown in the following section.
The installer provides several screens, which specify various parameters for the installation. Depending on whether you are installing Oracle Team Productivity Center for the first time, or updating an existing installation, the responses you give to the screens may change. Follow the instructions shown here:
Welcome
On this screen, the Oracle Team Productivity Center installer shows the list of steps you can perform.
Specify Database Connection Information
Enter the following information for this installation's database connection:
Connection type:
Connect using either generic JDBC or Oracle JDBC. Selecting generic JDBC causes the installer to prompt for the driver to use.
For purposes of this installation, select Oracle (JDBC)
JDBC URL:
Type the JDBC URL for the database connection used by this server. For example:
jdbc:oracle:thin:@192.0.2.1:1521:orcl
Username:
Type the selected username for the database to which you are connecting.
Password:
Type the selected user's password.
After entering all the selections, click Next. The Oracle Team Productivity Server installer will verify the connection before proceeding to the next step.
You can install TPC server and connectors to database other than Oracle database. Using MySQL as an example, specify the following values in the "Specify Database Connection Information" step:
Connection Type: Generic JDBC
Driver Library: <JDEV_HOME>/oracle/wlserver_10.3/server/ext/jdbc/mysql/mysql-connector-java-commercial-5.0.3-bin.jar
Driver Class: com.mysql.jdbc.Driver
JDBC URL: jdbc:mysql://<host>:3306/<db_name>
Select Installation Or Update Type
This screen presents the option of installing the server alone, one or more connectors alone, or both the server and connectors.
If Oracle Team Productivity Center has been installed previously, the installer will detect this, and will present options for updating the server, updating the connectors, or both. When running this installer, make sure to select only the Update type.
Select at least one of these installation elements before the installer will continue.
For the purpose of this instruction, select the checkbox labeled Server, then click Next.
Instructions for installing or updating an Oracle Team Productivity Center connector are described in Section 3, "Installing an Oracle Team Productivity Center Connector".
Create Administrator Account (New Installation Only)
This step applies only to the initial installation of Oracle Team Productivity Center. If you are updating the Oracle Team Productivity Center server or connectors, use the administrator account information entered during the initial installation of Oracle Team Productivity Center.
Installation requires creating an administrator account that will be used to seed the database with an Oracle Team Productivity Center user that has administrative privileges. The account name does not have to be the same as an existing Team Productivity Center account name. Be sure to follow safe, high-security password guidelines when creating your password.
Enter the desired user name, followed by the password for the account being created. Repeat the password to confirm, then click Next.
Specify Application Server Location
Enter a fully qualified path to the location on the Java EE application server selected to run the Oracle Team Productivity Server. It is possible to type the path, copy and paste it from another location screen, or click Browse to search for the path in the local file system.
For example, on a Windows system running the Oracle WebLogic server, enter the following application server location:
C:\<WebLogic_Server_Home>\user_projects\domains\<Your_Domain>\autodeploy
where <fields>
represent the specific path information on the installation system.
For example, on a Windows system running the Apache Tomcat application server version 6.0.16 from the top level of its C:\ drive, enter the following application server location:
C:\apache-tomcat-6.0.16
\webapps
If you are updating an existing installation of Oracle Team Productivity Center, be sure to use the same path used for the previous installation.
Select Connector Source
On this screen, specify the location of the source file for the connector. Options are to search the Oracle JDeveloper Update Centers for connectors, or to install from a local file.
To search the Oracle JDeveloper Update Centers:
Select Search Update Centers.
Select one or more of the Update Centers displayed on the screen.
Click Next.
To install from a local file:
Select Install From Local File, and then click Next.
Enter the pathname of the connector ZIP file in the local file system. For example: C:\tpc-connector-msprojectserver_bundle.zip
Click Next.
Installation Summary
The final screen of the installation wizard displays the key information about the installation:
Server location
Database details
Selected connectors, with the path to the ZIP or JAR file containing the connector components
To complete the installation, click Finish. The wizard then displays the installation progress.
After installation is complete:
The Oracle Team Productivity Center installer only ships with the Oracle JDBC Driver. If a database other than Oracle (for exmaple, MySQL) is used, you need to make that database's driver available for your Application Server to use. In some case, you need to copy the driver to the designated folder of your Application Server before you can bring up and connect to Oracle Team Productivity Center Server.
For WebLogic, the MySQL JDBC driver is installed in the folder <WL_HOME>/server/lib
through weblogic.jar
. It will be loaded when the server starts. Therefore, you do not need to do anything for this driver. If you plan to use a JDBC driver other than Oracle and MySQL, specifically one that is not installed with the WebLogic folder, see "Third-Party JDBC Drivers Installed with WebLogic Server."
Note: If you use a WebLogic domain for TPC server installation, copy the driver to your <JDEV_HOME>/user_projects/domains/<domain>/lib
folder instead.
If you are using JDeveloper Studio Edition, MySQL JDBC driver is shipped in <JDEV_HOME>/oracle/wlserver_10.3/server/ext/jdbc/mysql/mysql-connector-java-commercial-5.0.3-bin.jar
.
Start Oracle JDeveloper and download and install the Oracle Team Productivity Center client extension. To download the extension in Oracle JDeveloper, click the Help menu, and then select Check for Updates. The online Help for Oracle Team Productivity Center contains instructions for the administrator on how to set up Team Productivity Center inside Oracle JDeveloper.
When the Oracle Team Productivity Center installer is used to update a Team Productivity Center server running on Apache Tomcat version 6.0.20, any new or updated Team Productivity Center webservice classes cannot be auto-deployed correctly by the server. This causes an Oracle Team Productivity Center login issue, as observed in the server's log file. Upgrading the Team Productivity Center server running on other versions of Apache Tomcat does not have this problem.This is due to an issue with Apache Tomcat 6.0.20. When using this version of Apache Tomcat, updates to Team Productivity Center webservice classes are not properly re-deployed, even with autoDeploy set to "true" in the Tomcat server.xml file.To resolve this issue:
Complete the Oracle Team Productivity Center update, as described in Section 2.3, "Starting the Installer" and Section 2.4, "Installer Screens for Server Installation".
If the Tomcat server is running, shut it down.
Delete the folder <tomcat_install_folder>\webapps\otpc
.
Restart the Tomcat server .
If you are using MySQL with Tomcat, download the driver from your provider, then copy the driver to your <TOMCAT_HOME>/lib
folder.
If you are using JDeveloper Studio Edition, the MySQL JDBC driver is shipped in <JDEV_HOME>/oracle/wlserver_10.3/server/ext/jdbc/mysql/mysql-connector-java-commercial-5.0.3-bin.jar
.
Backward compatibility is supported on a limited basis between Oracle Team Productivity Center Server and Oracle Team Productivity Center client software as follows:
If you install a newer server with older clients, you will not be able to log in to the server with the older client.
If you install newer clients with an older server, the clients will be able to log in to the older server.
For best results and full compatibility, it is recommended that you update both the client and the server software when you install a new version of Oracle Team Productivity Center.
Installing a connector begins by launching the Oracle Team Productivity Center installer, as described in Section 2.3, "Starting the Installer". When you launch the installer, select the information from the installer screens as described below.
Note that you can also use the installer to update an Oracle Team Productivity Center connector. If you install a later version of the same connector as one that has already been installed, the installer will overwrite the earlier version and install the later version in its place.
The installer provides several screens that specify various parameters for the installation:
Select Installation Type
This screen presents the option of installing the server alone, one or more connectors alone, or both the server and connectors. Select at least one of these installation elements before the installer will continue.
For the purpose of this instruction, select the checkbox labeled Connectors, then click Next.
For information on installing an Oracle Team Productivity Center server, see Section 2.4, "Installer Screens for Server Installation".
Specify Database Connection Information
Enter the following information for the selected database connection:
Connection type:
Connect using either generic JDBC or Oracle JDBC. Selecting generic JDBC makes the installer prompt for the driver to use.
For purposes of this installation, select Oracle (JDBC)
JDBC URL:
Type the JDBC URL for the database connection. For example:
jdbc:oracle:thin:@192.0.2.1:1521:orcl
Username:
Type the selected username on the database.
Password:
Type the user's password.
After entering all selections, click Next. The Oracle Team Productivity Server installer will verify the connection before proceeding to the next step.
Select Connector Source
On this screen, specify the location of the source file for the connector. Options are to search the Oracle JDeveloper Update Centers for connectors, or to install from a local file.
To search the Oracle JDeveloper Update Centers:
Select Search Update Centers.
Select one or more of the update centers displayed on the screen.
Click Next.
To install from a local file:
Select Install From Local File, and then click Next.
Enter the pathname of the connector ZIP file in the local file system. For example:
C:\tpc-connector-msprojectserver_bundle.zip
After making the selection, click Next.
Installation Summary
The summary screen of the installation wizard displays the key information about the installation:
Database connection information
Selected connectors, with the path to the ZIP or JAR file containing the connector components
Once satisfied with the data, click Finish to proceed with the installation. The wizard then displays the installation progress.
The installer will unpack the compressed file and make connections to the database as required to configure this connector for use. When the installer indicates that it has completed the installation, connect to the data repository for the connector. Details for using the connector are in the Oracle JDeveloper on-line help for Oracle Team Productivity Center.
Installing Oracle Team Productivity Center Server on a production Web Logic Server database requires a specific procedure.
Install Oracle Team Productivity Center server.
For information on installing an Oracle Team Productivity Center server, see Section 2.3, "Starting the Installer".
Move the WebLogic Server file otpc.war
Locate the file otpc.war
that you deployed on your Web Logic Server autodeploy folder. Move it to another location in order to perform manual deployment successfully. Note the new location, as you will use it in the following step.
Log in to WebLogic Server administration console
Once the domain server is running, log in to its Admin Server Console using your WebLogic Server Administrator user name and password. You can log in either from Fusion Middleware's Start menu or from the server's login page, located at http://<hostname>:<port>/console/login/LoginForm.jsp
Select Deployments from the Domain Structure panel.
Click the Lock & Edit button from the Change Center panel to edit the Deployments page.
On the Deployments page, click Install. Specify the path to which you copied your otpc.war
file, and then click Next.
Verify the options shown on the Install Application Assistant page, and then click Next.
Verify the optional settings, and then click Next.
Click Finish when you are done with verifying or changing settings in the Install Application Assistant.
Click Save on the Settings for otpc page. Wait until you get the confirmation message, Settings updated successfully from WebLogic Server.
Click Activate Changes from the Change Center panel to activate deployment changes. Wait until you see the message All changes have been activated. No restarts are necessary.
Select Deployments from the Domain Structure panel.
Select the checkbox next to otpc Deployment on the Deployments list, then click Start. Select Service all requests, and then click Yes on the Start Deployments page.
Wait for the message, otpc application has Active state. It may be necessary to refresh the WebLogic Server console before you can login to Team Productivity Center.
The final portion of the process for installing Oracle Team Productivity Center on a production WebLogic Server database is to create a WebLogic Server production domain, using the Fusion Middleware Configuration Wizard.
Select Create a new WebLogic Domain, and then click Next.
Select Default, and then click Next on the Select Domain Source window.
Enter domain name and domain location, and then click Next.
Specify WebLogic Server Administrator user name and password, and then click Next .
Select Production Mode, and then click Next, Next, Create.
You can now bring up the newly created production domain yourself, or follow these steps:
Select Start Admin Server, and then click Done.
Type in your WebLogic Server Administrator user name and password at the startWebLogic.cmd
prompt.
Our goal is to make Oracle products, services, and supporting documentation accessible to all users, including users that are disabled. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at http://www.oracle.com/accessibility/
.
Accessibility of Code Examples in Documentation
Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.
Accessibility of Links to External Web Sites in Documentation
This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.
Deaf/Hard of Hearing Access to Oracle Support Services
To reach Oracle Support Services, use a telecommunications relay service (TRS) to call Oracle Support at 1.800.223.1711. An Oracle Support Services engineer will handle technical issues and provide customer support according to the Oracle service request process. Information about TRS is available at http://www.fcc.gov/cgb/consumerfacts/trs.html
, and a list of phone numbers is available at http://www.fcc.gov/cgb/dro/trsphonebk.html
.
Oracle® Fusion Middleware Installation Guide for Oracle Team Productivity Center Server, 11g Release 1 (11.1.1)
E14156-06
Copyright © 1997, 2011, Oracle and/or its affiliates. All rights reserved.
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.
If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:
U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.
This software is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous applications.
Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.
This software and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.