Common Install content - Content Reference file

Apache Tomcat has been installed in the directory JazzInstallDir/server/tomcat. The Web application (jazz.war) has been installed in the Apache Tomcat directory webapps. In a command window, set your current directory to JazzInstallDir/server. The server startup and shutdown scripts are located in this directory.
  • If you want to run the start and stop scripts from any other directory, you must change the profiles.ini file in JazzInstallDir/server/conf/jazz/provision_profiles to use an absolute path. See Modifying the profile.ini and license_profile.ini files.
  • Apache Tomcat is configured to use the ports 9080 and 9443 in file JazzInstallDir/server/tomcat/conf/server.xml. If necessary, change them as appropriate for your system. If necessary, also update the configuration settings of Jazz server Repository HTTP ports in the Advanced Properties configuration page of in the Jazz Admin Web UI.
  • The directory JazzInstallDir/server/logs contains the server log files. If you have trouble starting the server, check the log files.
  • The JazzInstallDir/server/tomcat/conf/server.xml file contains SSL settings that specify an algorithm only available in the IBM JRE. To run the server with a Sun JRE, in the server.xml file, change the settings for Connector port="9443", so that sslProtocol="TLS" instead of "SSL". Also remove the algorithm parameter.

The Jazz™ Team Server, Rational Team Concert™ client, Build System Toolkit, ClearCase® Connector, ClearQuest® Connector and other incubator files can be downloaded from http://jazz.net. To purchase Rational Team Concert, go to http://www.ibm.com/software/awdtools/rtc/, where you can download an installable image or order a DVD.

Installation Manager Based Installs

This set of steps and notes is used for an Installation Manager based install path
Before you begin
About this task

When using the IBM Installation Manager, note the Installation Directory on the Location page during the installation process. The directory is referred to as JazzInstallDir.

  • Installation Manager Web install for client, server, and optional components: This archive file contains the Installation Manager launchpad program and the predefined installation repository locations. This is a self-extracting file that starts the IBM Installation Manager launchpad program after extracting the contents. The benefit of using the Web install package is that it reduces the size of initial download and the installation process downloads only the resources you choose to install.
    Note: The Web install requires an Internet connection during the installation process.
  • Full DVD Contents .zip file: This archive file contains the Installation Manager launchpad program and a local copy of all the installable resources. The benefit of using the local install package is that it allows the installation to proceed without an Internet connection. This is not a self-extracting .zip file.
  • Client CD Contents .zip file - Installation Manager local install for client: This archive file contains the Installation Manager launchpad program and a local copy of the Rational Team Concert client. The benefit of using the local install package is that it allows the installation to proceed without an Internet connection. This is a .zip file that is not self extracting.
  • Installation Manager Web install for client, server, and optional components: This archive file contains the Installation Manager launchpad program and the predefined installation repository locations. This is a self extracting file that will start the IBM Installation Manager launchpad program after extracting the contents. The benefit of using the Web install package is that it reduces the initial download and the installation process only downloads the resources you choose to install.
    Note: The Web install requires an Internet connection during the installation process.
  • Full DVD Contents .zip file: This archive file contains the Installation Manager launchpad program and a local copy of all the installable resources. The benefit of using the local install package is that it allows the installation to proceed without an Internet connection. This is a .zip file that is not self extracting.
  1. Start the launchpad program.

    If the Installation Manager is not running, start it.

    Note: You must have administrator privileges to run the launchpad program.
    • If you are using the Installation Manager Web install, run the executable file. The files are extracted to a directory and a launchpad program appears.
      • To run the file on Windows, run this command:
        RTC-edition-Full-version-Win-Web.exe
      • To run the file on Linux, run this command:
        sh RTC-edition-Full-version-Linux-Web.sh
    • If you are using the Full DVD Contents .zip file, extract the contents of the archive into a temporary directory and run the launchpad program.
      • To run the file on Windows, run this command:
        launchpad.exe
      • To run the file on Linux, run this command:
        sh launchpad.sh
  2. Start the launchpad program.

    If the Installation Manager is not already running, complete the following steps to start it.

    Note: You must have administrator privileges to run the launchpad program.
    Note: The Linux commands to start the launchpad program are only for the Rational Team Concert for Eclipse IDE.
    To start the launchpad program file on:
    • If you are using the Client CD Contents .zip file, extract the contents of the archive into a temporary directory and run the launchpad program. To start the launchpad program file on:
      • To run the file on Windows, run this command:
        launchpad.exe
      • To run the file on Linux, run this command:
        sh launchpad.sh
    • If you are using the Installation Manager Web install, run the executable file. The files are extracted to a directory and a launchpad program appears. To start the executable file on:
      • To run the file on Windows, run this command:
        RTC-edition-Full-version-Win-Web.exe
      • To run the file on Linux, run this command:
        sh RTC-edition-Full-version-Linux-Web.sh
    • If you are using the Full DVD Contents .zip file, extract the contents of the archive into a temporary directory and run the launchpad program. To start the launchpad program file on:
      • To run the file on Windows, run this command:
        launchpad.exe
      • To run the file on Linux, run this command:
        sh launchpad.sh

.Zip file based installs

The following items are used for a .zip file install.
About this task
Note: When using the compressed archive files to complete installation, make a note of the directory you extract the files to. The directory is referred to as JazzInstallDir in future steps.
  1. Download the file(s) to your computer.
    • Download the server .zip file
    • Download the client .zip file
    • Optional: Download the build .zip file
    • Optional: Download the connector .zip file(s)
  2. Extract the contents of the package to your file system.
    Note: When you extract the files, you should choose a location close to the root of the file system. Long file path names can cause unnecessary warnings. For example, extract the files to c:\IBM on Windows or to /opt/IBM on Linux.

Client installs

About this task
Note: If you want to install the client into an existing Eclipse workbench, use the IBM Installation Manager. The IBM Installation Manager install prompts you for the workbench you want to extend and takes care of managing future workbench updates, rollbacks, and modifications
Trouble Shooting: Here are some suggested problem management techniques.
  • Start with an empty workspace.
  • The client and the server builds must match. Make sure the build ID's match for both the client and server distributions.
  • Make sure the server is up. Confirm using the status URL: https://example.com:9443/jazz.
  • On Linux, if you want to start the client from outside of the directory JazzInstallDir/client/eclipse you must change each file in JazzInstallDir/client/eclipse/links/ and include the absolute path to the named directory. By default, relative paths are used. For example, JazzInstallDir/client/eclipse/links/build.link contains the text "path=jazz/build". If your client is installed in the directory /home/username/teamconcert, edit the file to look like "path=/home/username/teamconcert/jazz/client/eclipse/build".
After you have successfully installed the client, you should refer to the following topics to help you get started with Rational Team Concert.

  1. Connect to the server. The easiest way to connect to a server is using the Team Invitation. If you do not have an invitation you can connect manually.
    1. Click File > Accept team invitation. The wizard guides you through the process.
      Note: If you do not have an invitation you need the URI or URL from your server admin. (an example format is: https://example.com:9443/jazz). Click on the connecting to an existing project area hyperlink that appears in the bottom right corner of the Accept Team Invitation window.
    2. Follow the instructions in the wizard to set up your connection.

Misc install conref

About this task
Important: Using Jazz Team Server with a Derby database supports up to 10 users. To support more than 10 users, use a DB2® Workgroup Server, DB2, Oracle, or Microsoft SQL Server database. DB2 Workgroup Server is included with the Enterprise, Standard, and Express edition installation packages when you use the IBM Installation Manager. If you use the .zip file installation method, the DB2 Workgroup Server download is available on the same site as the Rational Team Concert download. After DB2 Workgroup Server is installed, you must install and configure it as described in the installation setup guide.

When properties files are saved, the application always makes a backup copy of the previous version in the same directory. If you want to remove all files that contain the clear-text password, remove the backup properties files after configuring the server for the first time.

Note: If you are planning to use an existing application server, instead of the included Apache Tomcat server, clear the Apache Tomcat package check box. Doing so, installs only the files required to use with your existing application server. The Installation Manager prompts you to choose a location to install these files.
Note: Although a Derby database is included in the default configuration and requires no installation, this database cannot support more than 10 users. If you want to support more than 10 users and do not have access to an existing DB2 or Oracle database, install the bundled DB2 Workgroup Server edition.

If you install DB2 Workgroup Server, record the user ID, password and port number. This information is needed later. Accepting the defaults during the installation simplifies the Jazz Team Server configuration.

Starting the server

About this task

If you plan to use the included Apache Tomcat application server, you are ready to start the Jazz Team Server.

If you plan to use the WebSphere® Application Server, set up your server environment as described in Setting up a WebSphere Application Server.

If you plan to use the WebSphere Application Server, set up your server environment as described in Nastavení produktu WebSphere Application Server.

Starting the Apache Tomcat server

You are now ready to start the Apache Tomcat server.
Apache Tomcat has been installed in the directory JazzInstallDir/server/tomcat. The Web application (jazz.war) has been installed in the Apache Tomcat directory webapps. In a command window, set your current directory to JazzInstallDir/server. The server startup and shutdown scripts are located in this directory.
  • If you want to run the start and stop scripts from any other directory, you must change the profiles.ini file in JazzInstallDir/server/conf/jazz/provision_profiles to use an absolute path. See Modifying the profile.ini and license_profile.ini files.
  • Apache Tomcat is configured to use the ports 9080 and 9443 in file JazzInstallDir/server/tomcat/conf/server.xml. If necessary, change them as appropriate for your system. If necessary, also update the configuration settings of Jazz server Repository HTTP ports in the Advanced Properties configuration page of in the Jazz Admin Web UI.
  • The directory JazzInstallDir/server/logs contains the server log files. If you have trouble starting the server, check the log files.
  • The JazzInstallDir/server/tomcat/conf/server.xml file contains SSL settings that specify an algorithm only available in the IBM JRE. To run the server with a Sun JRE, in the server.xml file, change the settings for Connector port="9443", so that sslProtocol="TLS" instead of "SSL". Also remove the algorithm parameter.

Starting the server on Windows

Run the startup file to start your server on Windows.
About this task
  1. To start the server, from the JazzInstallDir/server directory, run this command:
    server.startup.bat
    Note: A separate Apache Tomcat console window opens. Do not close this window or the server will stop working. Also, several informational messages launch, including a message about the Apache Tomcat Native Library. These informational messages do not affect the Jazz Team Server functionality.
  2. To stop the server, from the JazzInstallDir/server directory, run this command:
    server.shutdown.bat
What to do next
Note: The example above runs the start and stop scripts directly from the directory JazzInstallDir/server. If you installed Jazz Team Server using IBM® Installation Manager, you can also run the commands from the Jazz Team Server Windows start menu.

After the server is started, proceed to Spuštění průvodce nastavením.

Starting the server on Linux

Run the following startup file to start or stop your server on Linux.
About this task
  1. To start the server, from the JazzInstallDir/server directory, as user root, run this command:
    ./server.startup
    If your user ID has administrator access, run this command:
    sudo ./server.startup

    A separate Apache Tomcat console window is not visible. You can check the server startup progress by viewing the log file at JazzInstallDir/server/logs/jazz.log.

  2. To stop the server, from the JazzInstallDir/server directory, as user root, run this command:
    ./server.shutdown
    If your user ID has administrator access, run this command:
    sudo ./server.shutdown
What to do next
Note: This example runs the start and stop scripts directly from the directory JazzInstallDir/server. If you installed Jazz Team Server by using IBM Installation Manager, you can also run the commands from the Jazz Team Server application start menu.

After the server is started, proceed to Spuštění průvodce nastavením.

Setting up a WebSphere Application Server

This topic describes how to set up the Jazz Team Server to work with WebSphere Application Server. This setup assumes that you are installing the Jazz Team Server on the same machine as the Websphere Application Server.
Before you begin
Before beginning these steps, you should have the following completed:
  • WebSphere Application server is already installed.
  • The database is created and the teamserver.properties file is updated with your database settings.
  • Enabling the case insensitive login (optional): If the application server's authentication method allows case insensitive login, then it's possible to make the Jazz application accept them as well. Allowing case insensitive login can be enabled through the "Use case insensitive user ID matching" property on the Advanced Properties page of the admin Web UI. The default is unchanged; administrators must explicitly override this property to enable case insensitive login.
  • Java™ 2 Security option should be turned off. If this option is turned on in WebSphere Application Server it will cause the Jazz Team Server .war to fail to start.
  • Ensure that the WAS security setting "Use available authentication data when an unprotected URI is accessed" is checked. If you are using the WAS Integrated Solutions Console, you can do this by:
    1. Navigating to Security -> Secure administration, applications, and infrastructure -> Web Security - General Settings.
    2. Selecting the checkbox for "Use available authentication data when an unprotected URI is accessed".
  • The Jazz Team Server includes the files required to run a complete Apache Tomcat-based server. For a WebSphere installation you only need a subset of the Jazz Team Server files and you should place them in a directory on your WebSphere server machine. Further instructions refer to this as the Jazz Team Server installation directory, or JazzInstallDir for short. From this directory, use:
    • The file JazzInstallDir/server/tomcat/webapps/jazz.war.
    • The directory JazzInstallDir/server/update-site.
    • The directory JazzInstallDir/server/conf.
    • The default repository database in JazzInstallDir/repositoryDB.
    • The repository tools in JazzInstallDir/repotools.
    • The directory JazzInstallDirserver/license-update-site.
    • The directory JazzInstallDir/server/nl1-update-site.
    • The directory JazzInstallDir/server/nl2-update-site.
Tip: When using the IBM Installation Manager the Jazz Team Server files can be installed into a Web application directory. During the installation process, you should not install the included Apache Tomcat application server; this makes the Installation Manager ask for a Web Application directory and install only the files needed for WebSphere. The default directory is C:\Program Files\IBM\JazzTeamServer on Windows or /opt/IBM/JazzTeamServer on Linux. The installation directory is referred to as JazzInstallDir in this procedure. If you use the IBM Installation Manager to install the files into the WebSphere Application Server Web applications directory, then you do not need to manually move the files as described above.
About this task
Note: This document does not teach the configuration of WebSphere authentication or SSL, which is a complex topic. Detailed information about the various authentication and encryption options for WebSphere is covered in the WebSphere Information Center. For more information, go to the WebSphere Information Center and search for Securing applications and their environment. The Jazz Web UI requires that authentication be configured in order to perform authorization and personalize the application.
  1. Review and update the database location in the teamserver.properties file
    com.ibm.team.repository.db.vendor = DB2
    com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
    com.ibm.team.repository.db.jdbc.password=db2admin
    Note: This is a sample DB2 configuration. The teamserver.properties should be updated depending on the database vendor (Oracle/MS-SQL).
  2. Verify or update the WebSphere Application Server level.

    Jazz Team Server requires WebSphere Application Server Version 6.1 with the IBM Java SDK 1.5 SR5 or later Cumulative Fix applied or WebSphere Application Server Version 7.0 with at least 7.0.0.3 installed. The IBM Java SDK 1.5 SR6 SDK update is available from http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492. With WebSphere 6.1 and the GA IBM Java SDK, Jazz starts to report "proxy errors" after some number of operations.

    You must obtain the corresponding WebSphere Application Server i-fixes for fixes to IBM Java SDK 1.5 SR9 or IBM Java SDK 1.6 SR4 that are necessary for IBM Rational Team Concert 2.0 to run correctly. Otherwise, some services in the server might not start correctly. The i-fixes are available under their corresponding WebSphere Application Server APARs. For IBM Java SDK 1.5/WebSphere Application Server 6.1, the APAR is PK85942 and you can download the files from ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/. Install at least WebSphere Application Server 6.1 fixpack 19 before installing the JRE i-fix. For IBM Java SDK 1.6/WebSphere Application Server 7.0, the APAR is PK 86771 and you can download the files from ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/.

  3. Update the JVM arguments.

    The Jazz Team Server needs some specific settings on the Java Virtual Machine in which it is run.

    First, it needs to know where to find some configuration files. This is done by setting a system property JAZZ_HOME. This property uses a URL rather than a simple path, so the value should be specified as a file://-style URL.

    The second property which is required for the Jazz JVM is to provide it with more than the default maximum memory allocation, using the -Xmx setting. This should be set based on the size of the team supported by the server and the memory capacity of the server where Jazz Team Server is running. A typical medium-size team can use a value of -Xmx1536M, providing 1536 MB of heap memory for the Jazz Team Server process.

    If you are connecting to an Oracle or SQL Server database then you need to add a property named "ORACLE_JDBC" or "SQLSERVER_JDBC". Set the property to the absolute file path (not a URL) to the appropriate jdbc drivers.

    There are a couple other system properties which need to be set to control some behavior of the server, they are included below. Here are the specifics of setting these JVM properties in the WebSphere Administrative Console, substitute JazzInstallDir with your Jazz Team Server installation directory:

    1. Click on Servers > Application Servers.
    2. Click on server1.
    3. Click on Java and Process Management > Process Definition.
    4. Click on Java Virtual Machine.
    5. Add the value 100 to the Initial Heap.
    6. Add the value 1000 to the Maximum Heap Size.
    7. Click Apply.
    8. Click Logging and Tracing. Click Change Log Detail Levels. The Jazz Team Server uses the BIRT reporting engine. To prevent BIRT informational entries from being written to the WebSphere log file, set the logging level to severe for the org.eclipse.birt.* packages. Click Apply.
    9. Click Custom Properties
    10. Add the following properties: Click New; enter the Name and Value; then click OK.
      • Name: java.awt.headless Value: true
      • Name: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Value: true
      • Name: JAZZ_HOME Value: file:///JazzInstallDir/server/conf
    11. Click Save directly to the master configuration.
    Important: For Solaris only, you must also add the following Java command line argument:
    -XX:MaxPermSize=256m
    For additional information, see Chapter 2, "Configuring a Solaris environment for WebSphere Application Server" of the IBM WebSphere Application Server V6.1 on the Solaris 10 Operating System redbook.
  4. Restart Websphere to install the Jazz Application
    In the following command line examples, WASInstallDir represents the location where WebSphere Application Server is installed on your server.
    • On Windows, the default value for WebSphere installation directory is:
      C:\Program Files\IBM\WebSphere\AppServer
      You can restart the server with the following commands on Windows:
      cd WASInstallDir\bin 
      stopServer.bat server1 [for a secure server, include: -username {LDAP_User} -password {LDAP_Password}] 
      startServer.bat server1
    • On Linux, the default value for WebSphere installation directory is:
      /opt/IBM/WebSphere/AppServer
      You can restart the server with the following commands on Linux:
      cd WASInstallDir/bin 
      ./stopServer.sh server1 [for a secure server, include: -username {LDAP_User} -password {LDAP_Password}] 
      ./startServer.sh server1
    1. Open the Admin console for your WebSphere Application Server.
    2. Click on Applications > Install New Application.
    3. Under Path to new Application, click Local file system.
    4. Under Full path enter:
      JazzInstallDir/server/jazz.war
    5. Set Context Root to /jazz.
    6. Click Next and continue through the remaining Install New Application steps.
    7. Click Finish.
    8. Click Save directly to the master configuration.
    9. Click on Applications > Enterprise Applications.
    10. Select the box next to jazz_war; click Start.

      A green arrow should appear indicating the application started successfully.

What to do next
After the server is started, proceed to Spuštění průvodce nastavením.

Running the setup wizard

Running the setup wizard verifies that the server is operating properly and guides you through the steps to configure the server.
About this task

To verify that the Jazz Team Server is connecting to the database, look at the server log or console output. The connection and database information is echoed on its first access. The directory JazzInstallDir/server/logs is used for the server log files.

This procedure assumes your server is available using the hostname localhost and the default ports 9443. If necessary, replace localhost with your server hostname and replace the port 9443.

Start the setup wizard to configure your server. Use the URL https://localhost:9443/jazz/setup.
The default user name and password are case-sensitive:
  • The user name is ADMIN.
  • The password is ADMIN.
If you configured the LDAP directory Web container, log in with a JazzAdmin user that is defined in your LDAP directory.
Choose a setup path. The setup wizard has two main paths.
  • The Fast Path Setup uses the default configuration. If you want to get the server running quickly, the fast path setup is a good option. During the Fast Path Setup, setup
    • the user registry.
  • The Custom Setup guides you through the detailed server configuration, including the ability to enable e-mail notifications. During the Custom Setup, you set up the following items:
    • Database
    • E-mail notification
    • User registry
    Note: By default, the server is configured to use Derby as the database. To use another database, such as DB2, select the custom setup path and complete Step 2: Configure Database. If you have not created your database tables, after testing the connection you will be prompted to create the database tables. If you choose the Fast Path Setup and your database tables are not created, you will be prompted to go to Step 2 and create database tables.

When the initial setup is complete, additional options can be configured from the Jazz Team Server Admin Web user interface by using the URL https://localhost:9443/jazz/admin.

What to do next
If the server setup wizard does not load, check the following items:
  • Verify that the application server has started. Use the URL http://localhost:9080.
  • Verify the Jazz Team Server has started by logging in to the Jazz Team Server Admin Web UI using the URL https://localhost:9443/jazz/admin. If the page does not load or the server has errors, the server did not start correctly. See the troubleshooting information at Troubleshooting server issues.
  • The URI root for the Jazz Team Server path must be /jazz. For example https://example.com:9443/jazz must be used rather than https://example.com:9443.

Váš názor

Byla tato pomoc užitečná? Zpětnou vazbu můžete poskytnout na stránkách Jazz.net (registrace je požadována): Komentář na fóru nebo odeslat chybu