Borland ® StarTeam ® 2006
Guide d'installation
Borland Software Corporation 20450 Stevens Creek Blvd., Suite 800 Cupertino, California 95014 USA http://www.borland.com
Borland Software Corporation peut posséder des brevets et/ou des applications en attente de brevet concernant les sujets traités dans ce document. Veuillez vous reporter au CD du produit ou à la boîte de dialogue A propos pour voir la liste des brevets applicables. La fourniture de ce document ne vous donne aucun droit d'accès à ces brevets.
COPYRIGHT © 1995–2006 Borland Software Corporation et/ou ses filiales. Tous les noms de marques et de produits Borland sont des marques de fabrique ou des marques déposées de Borland Software Corporation aux Etats-Unis et dans d'autres pays. Toutes les autres marques appartiennent à leurs propriétaires respectifs.
Part Number ST06-INST Novembre 2006 PDF
Table des matières
Chapitre 1
Introduction à l’installation et à la documentation
de Borland StarTeam 2006 1
Inclus avec ce Guide d’installation . . . 1
Accès aux produits Borland StarTeam et aux instructions d’installation . . . 2
Feuille de route de l’installation . . . 3
Feuille de route pour la mise à niveau . . . 3
Feuille de route pour les clients StarTeam. . . 3
Feuille de route pour les administrateurs de Borland StarTeam Server . . . 4
Feuille de route pour l’ajout des intégrations . . . 5
A propos des CD d’installation de StarTeam . . . 5
Contenu des disques d’installation de StarTeam . . . 5
Contenu de StarTeam Disque 1 . . . 5
Contenu de StarTeam Disque 2 . . . 6
Documentation Borland StarTeam . . . 7
Documentation des produits facultatifs . . . 8
Conventions de la documentation . . . 8
Comment contacter les services de support Borland . . . 9
Chapitre 2 Installation de StarTeam Server 11
A propos de StarTeam Server . . . . 11Configuration système pour StarTeam Server . . . . 12
Systèmes d’exploitation pris en charge . . . . 12
Bases de données prises en charge . . . . 12
StarTeam Server et MSDE sur le même ordinateur . . . . 12
StarTeam Server sur un ordinateur séparé . . . . 13
Configuration système du serveur de la base de données. . . . 13
Logiciels tiers requis . . . . 14
Prise en charge de la mémoire large . . . . 14
Prise en charge des jeux de caractères Unicode par StarTeam Server . . . . 15
Pré-installation requise pour une nouvelle installation . . . . 15
Mise au niveau de Borland StarTeam 2006. . . . 16
Mise à niveau de votre correctif StarTeam Server actuel . . . . 16
Préparation pour une mise à niveau . . . . 17
Résumé des instructions de mise à niveau . . . . 18
Exigences pour une mise à niveau . . . . 18
Conversion des fichiers d’archive Native-I au format Native-II . . . . 21
Conversion des fichiers . . . . 21
Vérification des résultats de la conversion . . . 22
Nettoyage de la base de données . . . . 23
Téléchargement des utilitaires Vault Verify et Report Archives . . . . 23
Configuration minimale pour les utilitaires Vault Verify et Report Archives . . . . 24
Vérification des révisions de fichiers Native-II . . 24
Exécution de l’utilitaire Vault Verify . . . 24
Recherche des fichiers Non Native-II. . . 25
Exécution de l’utilitaire Report Archives. . . . 26
Exigences de la base de données pour la mise à niveau . . . 27
Mise à niveau à partir d’une base de données StarTeam 2005 ou 2005 R2 . . . 27
Accord des privilèges Oracle . . . 27
Mise à niveau des configurations de serveur. . . 27
Dépannage du processus de mise à niveau . 28 Modifications des fichiers de StarTeam Server. . 28
Installation de StarTeam Server . . . 28
Problèmes d’installation connus . . . 32
Post-installation pour une nouvelle installation . . . 32
Post-installation pour une mise à niveau . . . 33
Evaluation de StarTeam Server . . . 33
Licences StarTeam Server. . . 34
Comprendre les licences . . . 34
Utilisation des licences StarTeam . . . 35
Utilisation d’un serveur de licences. . . 37
Utilisation de la configuration de serveur exemple StarDraw . . . 37
Chapitre 3 Installation des clients StarTeam 39
A propos des clients StarTeam . . . 39Configuration système du client StarTeam multiplate-forme . . . 40
Avant d’installer un client StarTeam . . . 40
Démarrage des utilisateurs avec les mêmes options personnelles . . . 40
Installation du client StarTeam multiplate-forme . . . 41
Installation sous Windows . . . 41
Installation sous Linux ou Solaris. . . 42
Installation sur d’autres plates-formes . . . 43
Installation des autres clients StarTeam . . . 43
Installation de StarTeam Web Edition . . . 43
Installation des intégrations de StarTeam . . . . 43
Chapitre 4 Installation de StarTeamMPX sous Windows 45
A propos de StarTeamMPX . . . 45Composants StarTeamMPX . . . 46
Emetteurs StarTeamMPX . . . 46
Agent de messages StarTeam . . . 46
Service Multidiffusion StarTeam. . . 46
Agent de mise en cache StarTeam . . . 47
Configuration système pour StarTeamMPX . . . 47
Configuration système pour l’Agent de messages et pour le Service Multidiffusion. . . 47
Configuration système pour les Agents de mise en cache . . . 48
Configurations de StarTeamMPX. . . 48
Installation de StarTeamMPX . . . 48
Génération des fichiers XML des émetteurs . . . 49
Installation de l’Agent de messages et du Service Multidiffusion . . . . 49 Installation d’un Agent de mise en cache. . . . 50
Mise à niveau d’un Agent de mise en cache
StarTeamMPX . . . . 51 Avant l’installation d’un Agent de mise en cache . 51 Installation d’un Agent de mise en cache . . . . . 52 Après l’installation d’un Agent de mise en cache . 54 Désinstallation des composants MPX . . . . 55
Chapitre 5
Installation de StarTeam
Layout Designer 57
A propos de StarTeam Layout Designer . . . . 57 Configuration système pour StarTeam
Layout Designer. . . . 58 Installation de StarTeam Layout Designer . . . . 58
Chapitre 6
Installation de StarTeam
Workflow Extensions 61
A propos de StarTeam Workflow Extensions . . . . . 61 Configuration système de StarTeam Workflow
Extensions . . . . 63 Installation de StarTeam Extensions . . . . 63 Installation de StarTeam Workflow Designer . . . . . 65 Installation de l’Agent de notification StarTeam . . . 66
Chapitre 7
Utilisation des bases de données Microsoft SQL Server et MSDE
avec StarTeam Server 69
Terminologie employée pour les bases de données Microsoft . . . . 69 Connexion aux bases de données . . . . 70 Comprendre les différences d’encodages . . . . 70 Utilisation d’une base de données MSDE :
Présentation . . . . 70 Présentation de l’utilisation d’une base de données
Microsoft SQL Server . . . . 71 Connexion aux bases de données Microsoft
SQL Server 2000 . . . . 71 Création et démarrage d’une configuration
de serveur. . . . 72 Conseils pour les fichiers de données et les journaux
de transactions . . . . 76 Exécution des scripts SQL sur les bases de données
Microsoft . . . . 77 Création manuelle d’une base de données :
Présentation . . . . 79 Création d’un DSN système ODBC pour la base
de données StarTeam . . . . 80 Création d’une configuration de serveur (pour une
base de données existante) . . . . 81 Comprendre la collation . . . . 85 Comment est choisie la collation par défaut ?. . . 86
Chapitre 8
Utilisation d’utilisateurs de schéma Oracle avec Borland StarTeam Server 87
Terminologie employée pour les bases de données Oracle . . . .87 Connexion à des utilisateurs de schéma . . . .88 Présentation de l’utilisation d’un utilisateur de schéma
Oracle . . . .88 Vérification de la connexion entre le client
et le serveur . . . .89 Utilisation des bons pilotes ODBC Oracle
avec StarTeam . . . .89 Téléchargement et installation des pilotes ODBC
Oracle . . . .89 Utilisation correcte de NLS_LANG avec StarTeam . .90 Définition de NLS_LANG. . . .91 Jeu de caractères de la base de données et StarTeam
Server . . . .92 Création et démarrage d’une configuration de serveur
avec un utilisateur de schéma Oracle . . . .92 Conseils pour les fichiers de données . . . .97 Exécution des scripts SQL pour les utilisateurs
de schéma Oracle . . . .97 Présentation de la création manuelle de l’utilisateur de
schéma . . . . 100 Tablespaces gérés par dictionnaire et tablespaces
gérés en local. . . . 101 Création des DSN ODBC pour Oracle . . . . 101 Création et démarrage d’une configuration de
serveur pour un utilisateur de schéma Oracle . 102
Chapitre 9 Comprendre
l’emplacement des données 107
Utilisation des espaces de stockage Native-I
et Native-II . . . . 107 Comprendre les référentiels 2005 et ultérieurs . . . 108 Dossier Attachments . . . . 108 Dossiers de l’espace de stockage Native-II . . . 108
Structure des chemins d’Archive
et de Cache . . . . 110 Fichiers journaux et dossiers. . . . 111 Utilisation du stockage du delta . . . . 111
Annexe A
Installation et configuration
des logiciels requis 113
Synchronisation des horloges des stations
de travail . . . . 113 Adobe Acrobat Reader . . . . 114 Installation de l’environnement d’exécution de Java 114 Utilisation des utilitaires Vault Verify
et Report Archives . . . . 114 Installation de Vault Verify
et de Report Archives . . . . 114 Vérifications effectuées par Vault Verify . . . . . 115 Vérification des fichiers endommagés . . . . 115
Vérification des fichiers manquants . . . 115
Vérification des fichiers isolés . . . 115
Conseils et meilleures pratiques d’utilisation de Vault Verify . . . 116
Options d’utilisation de Vault Verify . . . 117
Conseils et meilleures pratiques d’utilisation de Report Archives. . . 119
Options d’utilisation de Report Archives . . . 120
Annexe B Sauvegarde de bases de données 123
Sauvegarde des bases de données SQL Server . . 123Sauvegarde complète de la base de données. . 124
Sauvegarde différentielle de la base de données. . . 125
Sauvegarde du journal des transactions. . . 125
Sauvegardes des fichiers . . . 125
Recommandations . . . 126
Sauvegarde des bases de données Oracle. . . 126
Sauvegardes logiques (Exportation/Importation) 127 Sauvegardes hors connexion/à froid . . . . 127
Sauvegardes en ligne/à chaud . . . . 128
Sauvegardes RMAN . . . . 128
Data pump d’exportation/importation. . . . 129
Recommandations . . . . 130
Annexe C Réglage des bases de données Oracle 8i 131
Paramètres d’initialisation recommandés . . . . 131Réglage et suivi des bases de données Oracle . . . 133
StarTeam Server et les tablespaces . . . . 133
Gestion des tablespaces par dictionnaire . . . . 133
Gestion des tablespaces en local . . . . 133
ASSM (Automatic Segment Space Management) . . . 134
Index 135
C h a p i t r e
1
Chapitre 1
Introduction à l’installation
et à la documentation de Borland StarTeam 2006
Ce chapitre présente l’installation du produit Borland StarTeam ainsi que la documentation d’installation fournie avec StarTeam.
Inclus avec ce Guide d’installation
Ce document fournit les instructions d’installation des produits Borland StarTeam suivants :
■ StarTeam Server 2006
■ StarTeam Cross-Platform Client 2006
■ StarTeamMPX, incluant :
■ Emetteurs d’événements et de fichiers StarTeam (installés lors de l’installation de StarTeam Server 2006)
■ Agent de messages StarTeam
■ Service Multidiffusion StarTeam
■ Agent de mise en cache StarTeam
■ StarTeam Workflow Extensions, incluant :
■ StarTeam Extensions
■ StarTeam Workflow Designer
■ Agent de notification StarTeam
■ StarTeam Layout Designer En outre, ce manuel couvre :
■ La configuration des bases de données Microsoft SQL Server et Oracle.
■ La mise à niveau des configurations de serveur.
■ L’installation et la configuration des logiciels pris en charge.
■ L’emplacements des données.
A c c è s a u x p ro d u i t s B o r l a n d S t a r T e a m e t a u x i n s t r u c t i o n s d ’ i n s t a l l a t i o n
Voir dans la section suivante la liste complète des produits StarTeam et des moyens d’y accéder.
Accès aux produits Borland StarTeam et aux instructions d’installation
Le tableau suivant donne un résumé des produits Borland StarTeam, et indique où vous pouvez les obtenir et où vous pouvez trouver les instructions de leur installation.
Tableau 1.1 Accès aux produits Borland StarTeam et aux instructions d’installation
Borland StarTeam 2006 Packages de produits
Disponibles depuis …
Où trouver les instructions d’installation
Jeu des 2 CD principaux pour Windows
Téléchargement du Web
CD séparé/
dans un ensemble
PDF du guide d’installation consolidé (ce manuel)
Guide d’installation séparé StarTeam Entreprise
Serveurs StarTeam
StarTeam Server 2006 - Windows Oui Oui Oui
Clients StarTeam
StarTeam Cross-Platform Client 2006+ Oui Oui Oui
StarTeam Web Edition Oui Oui Oui
Outils d’administration de StarTeam
Borland LDAP QuickStart Manager Oui Oui Oui
Gestionnaire d’importation/exportation de StarTeam
Oui Sous contrôle1 Oui
StarTeam Layout Designer Oui Oui
Outils divers de StarTeam
StarTeam SDK (complet)4 Oui Oui
StarTeamMPX (Agent de messages, Service Multidiffusion et Emetteur d’événements)
Oui Oui Oui
StarTeam Entreprise Advantage
<Tous les produits StarTeam Entreprise>
Voir ci-dessus StarTeamMPX (Emetteur de fichiers et
Agent de mise en cache)
Oui Oui Oui
StarTeam Workflow Extensions (StarTeam Extensions, Workflow Designer, Agent de notification)
Oui Oui Oui
Borland Search Sous contrôle2 Oui Oui
* StarTeam Datamart Sous contrôle2 Oui Oui
Intégrations Intégration StarTeam Visual Studio
2005
Oui Oui
Intégration StarTeam Visual Studio 2003
Oui
Intégration StarTeam SCC Oui Oui
Intégration StarTeam Microsoft Project Oui Oui
StarTeam Edition pour Eclipse Oui Oui
StarTeam Synchronizer for Mercury TestDirector for Quality Center
Sous contrôle3 Oui
StarTeam Version-Control Add-in for Mercury TestDirector for Quality Center
Oui Oui
F e u i l l e d e r o u t e d e l ’ i n s t a l l a t i o n
+ Plusieurs versions peuvent être téléchargées pour les diverses plates-formes non Windows, y compris un client universel.
* Peut être acquis séparément et ajouté au package Entreprise.
1 Nécessite l’acquisition d’une licence StarTeam pour accéder à la page de téléchargement contrôlée.
2 L’acquisition d’Entreprise Advantage permet d’accéder à la page de téléchargement contrôlée.
3 Nécessite l’acquisition d’une licence avant le téléchargement.
4 Le runtime de StarTeam SDK est automatiquement installé avec les clients ; cette entrée fait référence au SDK complet destiné aux développeurs pour créer des applications supplémentaires utilisant StarTeam Server.
Les produits StarTeam sont disponibles sur CD et presque tous les produits StarTeam peuvent être téléchargés depuis :
http://www.borland.com/downloads/download_starteam.html
Vous connaîtrez les nouveautés apportées par la version StarTeam 2006 en consultant Prise en main > Quoi de neuf ? dans l’Aide en ligne de StarTeam, accessible après l’installation dans le menu Démarrer>Programmes>Borland StarTeam>StarTeam Server 2006>Documentation. Des informations sur les nouveautés se trouvent également sur le CD d’installation de StarTeam, dans AdministeringAndUsingStarTeam.pdf (Administration et utilisation de StarTeam) sousPrise en main> Quoi de neuf ?
Feuille de route de l’installation
Selon votre rôle, votre connaissance de Borland StarTeam et les produits que vous installez, choisissez une des sections appropriée ci-dessous comme guide du processus d’installation.
Feuille de route pour la mise à niveau
Si vous utilisez déjà StarTeam, sachez que la mise à niveau de certains produits fait l’objet de considérations et d’instructions spéciales :
■ StarTeam Server
■ StarTeamMPX, et particulièrement l’Agent de mise en cache
Pour chacun de ces produits, reportez-vous aux chapitres correspondants de ce manuel et consultez les instructions de mise à niveau :
Feuille de route pour les clients StarTeam
Reportez-vous au Chapitre 3, “Installation des clients StarTeam”, page 39, pour connaître les instructions d’installation des clients StarTeam.
Tableau 1.2 Informations sur la mise à niveau des produits StarTeam Produit mis à niveau Voir...
StarTeam Server “Mise au niveau de Borland StarTeam 2006”, page 16 et
“Post-installation pour une mise à niveau”, page 33 StarTeamMPX “Mise au niveau de Borland StarTeam 2006”, page 16
et
“Mise à niveau d’un Agent de mise en cache StarTeamMPX”, page 51
F e u i l l e d e r o u t e d e l ’ i n s t a l l a t i o n
Feuille de route pour les administrateurs de Borland StarTeam Server
Si vous êtes l’administrateur de Borland StarTeam ou l’Administrateur IT, installez ces produits StarTeam sur les systèmes indiqués ci-dessous :
Les produits Borland StarTeam peuvent être installés depuis le CD d’installation ou téléchargés depuis le site web de Borland, à l’adresse :
http://www.borland.com/downloads/download_starteam.html
Tableau 1.3 Où installer StarTeam Server 2006 et les outils d’administration du serveur Installez ce produit Sur ce système.. Voir...
StarTeam Server 2006 (Installez ce produit en premier)
L’ordinateur qui servira de serveur StarTeam ; cet ordinateur doit être accessible à tous les clients StarTeam
Chapitre 2, “Installation de StarTeam Server”, page 11
Workflow Extensions (Workflow Designer et StarTeam Extensions)
Station de travail de l’administrateur de StarTeam
Chapitre 6, “Installation de StarTeam
Workflow Extensions”, page 61 Workflow Extensions
(Agent de notification)
Habituellement sur le même ordinateur que StarTeam Server
Chapitre 6, “Installation de StarTeam
Workflow Extensions”, page 61 Services StarTeamMPX
(Agent de messages et Service Multidiffusion)
Sur l’ordinateur de StarTeam Server et, éventuellement, ailleurs, selon la façon dont vous utilisez StarTeamMPX et l’Agent de mise en cache.
Vous pouvez l’installer sur un ordinateur proche du réseau au lieu de l’ordinateur de StarTeam Server.
Chapitre 4, “Installation de StarTeamMPX
sous Windows”, page 45
Agent de mise en cache StarTeamMPX
Un Agent de mise en cache par ordinateur ; plusieurs instances peuvent s’exécuter.
L’Agent de mise en cache racine doit être installé sur l’ordinateur de StarTeam Server.
Chapitre 4, “Installation de StarTeamMPX
sous Windows”, page 45
Borland LDAP QuickStart Manager
Station de travail de l’administrateur de StarTeam
install_LDAP_en.html (accessible à la racine du CD d’installation de StarTeam et sur le site Web Borland Technical Publications, à l’adresse : http://
info.borland.com/techpubs/
starteam) Gestionnaire d’importation/
exportation
Quand vous utilisez cet outil, la même version doit être installée les ordinateurs source et cible.
install_IEM.html (accessible à la racine du CD d’installation de StarTeam et sur le site Web Borland Technical
Publications, à l’adresse : http:/
/info.borland.com/techpubs/
starteam) Layout Designer Station de travail de
l’administrateur de StarTeam
Chapitre 5, “Installation de StarTeam Layout Designer”, page 57
A p r o p o s d e s C D d ’ i n s t a l l a t i o n d e S t a r T e a m
Feuille de route pour l’ajout des intégrations
Les intégrations StarTeam peuvent être téléchargées depuis le site web de Borland, à l’adresse :
http://www.borland.com/downloads/download_starteam.html
Après avoir téléchargé l’exécutable d’installation, allez au manuel approprié et suivez les instructions d’installation.
A propos des CD d’installation de StarTeam
Les produits Borland StarTeam 2006 peuvent être installés depuis les deux CD ou téléchargés depuis le site web StarTeam de Borland, à l’adresse :
http://www.borland.com/downloads/download_starteam.html
Si vous installez à partir d’un CD, vous pouvez installer les produits comme indiqué dans “Accès aux produits Borland StarTeam et aux instructions d’installation”, page 2.
Le menu principal de l’installation de StarTeam propose les options suivantes :
Contenu des disques d’installation de StarTeam
Contenu de StarTeam Disque 1
StarTeam Disque 1 contient un lanceur permettant d’installer les produits suivants :
■ Client StarTeam multiplate-forme (pour les plates-formes Windows)
■ StarTeam Server
■ StarTeamMPX (Services et Agent de mise en cache)
■ Outils d’administration de StarTeam (Gestionnaire d’importation/exportation — vous dirige vers l’emplacement web depuis lequel obtenir ce produit, Borland LDAP QuickStart Manager et Layout Designer)
■ StarTeam SDK Runtime Tableau 1.4 Options d’installation par CD
Option du menu principal Choisissez-la pour…
Installer les produits Afficher la liste des produits disponibles dans ce jeu de CD et y faire une sélection.
Remarque : Si vous choisissez StarTeam Integrations dans la liste des produits disponibles, vous accédez à :
http://ussvs-bes1.borland.com/WebDownload/
outcome_pages/st2005_Int_kdown.html
Parcourir la documentation Voir la liste des manuels StarTeam disponibles au format PDF.
Parcourir le contenu Voir le contenu des CD d’installation de StarTeam. Voir
“Contenu des disques d’installation de StarTeam”, page 5.
Borland Developer Network Accéder au site web Borland Developer Network.
Nous contacter Afficher l’adresse et les numéros de téléphone de Borland Corporation, ainsi que les liens aux sites web de Borland, dont le site de support.
A p r o p o s d e s C D d ’ i n s t a l l a t i o n d e S t a rT e a m
Disque 1 contient les dossiers et les fichiers suivants :
Contenu de StarTeam Disque 2
StarTeam Disque 2 contient un lanceur permettant d’installer les produits suivants :
■ StarTeam Workflow Extensions (StarTeam Extensions, Workflow Designer et Agent de notification)
■ StarTeam SDK
Disque 2 contient les dossiers et les fichiers suivants : Tableau 1.5 Dossiers et contenu de StarTeam Disque 1
Dossier Contenu
\Documentation La documentation StarTeam, fournie au format .PDF, que vous pouvez consulter en ligne ou imprimer.
\LDAPQuickStart Les fichiers nécessaires à l’installation de Borland LDAP QuickStart Manager
\MPX Les fichiers nécessaires à l’installation des fonctionnalités complémentaires de StarTeamMPX. (Il se peut que vous n’ayez pas de licence pour ce produit.)
\SDK Les fichiers nécessaires à l’installation de StarTeam SDK Runtime.
\Server Les fichiers nécessaires à l’installation de StarTeam Server, qui fournit un accès client/serveur aux projets StarTeam.
\StarTeamCPWin Les fichiers nécessaires à l’installation du client StarTeam multiplate-forme sous Windows.
\StarTeamLayoutDesigner Les fichiers nécessaires à l’installation de StarTeam Layout Designer.
\Utility Les fichiers relatifs à certains contrôles courants, JRE, MSDE 2000 et ODBC, chacun dans son propre dossier. Vous pouvez avoir besoin de les utiliser séparément.
Racine de Disque 1 : Inclut l’exécutable d’installation, les fichiers readme et les fichiers d’installation.
Tableau 1.6 Dossiers et contenu de StarTeam Disque 2
Dossier Contenu
\Documentation Le manuel des StarTeam Workflow Extensions, fourni au format .PDF, que vous pouvez consulter en ligne ou imprimer.
\NotificationAgent Les fichiers nécessaires à l’installation de l’Agent de notification, qui fait partie de StarTeam Workflow Extensions. (Il se peut que n’ayez pas de licence pour ce produit mais vous pouvez le tester.)
\SDK Les fichiers nécessaires à l’installation du SDK StarTeam pour Windows complet ainsi que la version universelle.
\StarTeamCP Les fichiers nécessaires à l’installation du client StarTeam multiplate-forme sur des plates-formes non Windows.
\StarTeamExtensions Les fichiers nécessaires à l’installation de StarTeam Extensions, qui fait partie de StarTeam Workflow Extensions. (Il se peut que n’ayez pas de licence pour ce produit mais vous pouvez le tester.)
\Utility Les fichiers pour DotNet et pour JRE, chacun dans son propre dossier. Vous risquez de devoir les utiliser séparément.
\WorkflowDesigner Les fichiers nécessaires à l’installation de Workflow Designer, qui fait partie de StarTeam Workflow Extensions. (Il se peut que n’ayez pas de licence pour ce produit mais vous pouvez le tester.)
Racine de Disque 2 Inclut l’exécutable d’installation, les fichiers readme et les fichiers d’installation.
D o c u m e n t a t i o n B o rl a n d S t a r T e a m
Documentation Borland StarTeam
Le jeu de documentation Borland StarTeam vous servira de guide lors de l’utilisation de la suite de produits Borland StarTeam. La documentation Borland StarTeam est fournie sous deux formats : HTML et Adobe PDF. Les deux formats de la
documentation sont disponibles aux emplacements suivants :
■ Démarrer>Programmes>Borland StarTeam>StarTeam Cross-Platform Client 2006>Documentation
■ Démarrer>Programmes>Borland StarTeam>StarTeam Server 2006>Documentation
Les documents fournis dans ces sous-menus sont affichés en gras :
HTML
■ Aide StarTeam — Documentation en ligne complète destinée à tous les types d’utilisateurs. Explique comment utiliser et administrer StarTeam. Elle regroupe la documentation en quatre catégories :
■ Prise en main — Fournit une présentation de StarTeam incluant les nouveautés de la version, des informations sur les différents rôles des utilisateurs, un aperçu de l’administration du serveur et des projets et une introduction à l’interface utilisateur de StarTeam.
■ Concepts — Informations conceptuelles sur les opérations générales, la sécurité, la personnalisation, l’administration des projets et l’administration du serveur.
■ Procédures — Procédures, étape par étape, d’accomplissement des tâches, regroupées selon les domaines suivants : configuration, personnalisation, opérations générales, optimisation, administration des projets, reporting et test, sécurité et administration du serveur.
■ Référence — Décrit tous les menus et toutes les boîtes de dialogue ainsi que leurs options.
■ Read Me — Contient les dernières informations concernant votre installation particulière, y compris la configuration système, les problèmes connus et les restrictions.
Manuels Adobe PDF
■ Installation de StarTeam (ce manuel)
Le Guide d’installation de StarTeam (ce manuel) contient des instructions détaillées d’installation et de configuration des principaux produits StarTeam.
■ Administration et utilisation de StarTeam (identique à l’aide StarTeam) Ce guide fournit la documentation complète destinée aux administrateurs et aux utilisateurs généraux de StarTeam.
■ StarTeam Extensions User’s Guide
Explique comment créer et gérer les extensions StarTeam, comme les éditeurs APE (Alternate Property Editors). Il couvre également le Workflow Designer et l’Agent de notification de StarTeam.
■ StarTeamMPX Administrator’s Guide
Explique l’utilisation de base et l’architecture d’un système StarTeamMPX et présente les instructions d’installation et de configuration des composants StarTeamMPX.
D o c u m e n t a t i o n B o r l a n d S t a r T e a m
Veuillez noter que, selon les produits StarTeam que vous avez achetés et installés, les applications décrites dans ces manuels ne seront pas toutes présentes sur votre système.
Important Tous les manuels, distribués au format Adobe Acrobat (.PDF), nécessitent Adobe Acrobat Reader, version 4.0 ou ultérieure, pour être affichés. Le programme d’installation d’Adobe Acrobat Reader est disponible sur le site Web d’Adobe à l’adresse : www.adobe.com.
Documentation des produits facultatifs
La documentation des produits facultatifs comme LDAP QuickStart Manager, le Gestionnaire d’importation/exportation et Borland Search se trouve dans le sous-menu Démarrer>Programmes>nom_produit>Documentation.
Conventions de la documentation
La documentation StarTeam utilise les conventions suivantes.
Remarque Identifie des informations supplémentaires.
Astuce Identifie des informations sur des procédures alternatives, ou d’autres informations utiles mais non essentielles.
Important Identifie des informations essentielles à l’accomplissement d’une tâche.
Attention Identifie des actions pouvant provoquer une perte de données, ou les procédures devant être suivies pour ne pas perdre de données.
Choisissez Fichier >
Quitter
Indique la sélection d’un menu suivie par la sélection d’un sous-menu. Le symbole supérieur (>) sépare les commandes à sélectionner dans les sous-menus successifs. Par exemple, “Choisissez la commande Fichier > Quitter” demande de choisir Fichier dans la barre de menus et ensuite de choisir Quitter dans le menu déroulant.
Police à espacement fixe
Le texte apparaissant en police Courier représente les informations que vous devez taper et les messages provenant du système.
italique La syntaxe apparaissant en italiques représente des informations que vous devez remplacer par les noms de vos fichiers véritables, des dossiers enfant, etc. Les italiques servent également aux noms des dialogues et des manuels, ainsi que pour attirer l’attention.
Gras La syntaxe apparaissant en gras représente des informations que vous devez utiliser exactement telles qu’elles sont indiquées (si vous les utilisez).
[ ] Crochets pour entourer la syntaxe des options.
| Une barre verticale sépare les choix syntaxiques mutuellement exclusifs.
C o m m e n t c o n t a c t e r l e s s e r v i c e s d e s u p p o r t B o r l a n d
Comment contacter les services de support Borland
Borland Software Corporation s’est engagé à fournir des services de classe
internationale dans le domaine du consulting et du support technique. Nous avons plus de 15 ans d’expérience dans le support aux développeurs et aux entreprises.
Nos ingénieurs qualifiés pour le support technique sont prêts à traiter vos besoins en support, au cas par cas ou dans le cadre d’un partenariat permanent. Borland offre un support dans le monde entier et apporte le service rapide et fiable qui garantit la réussite commerciale de chacun de ses clients.
Vous pouvez bénéficier de support technique gratuit (jusqu’à 30 jours) lors de
l’installation et de l’enregistrement des produits Borland. Pour bénéficier de ce service, voir :
http://support.borland.com/entry.jspa?externalID=151
Pour de plus amples informations sur les services de support de Borland, visitez notre site web, à l’adresse http://support.borland.com. Depuis ce site Web, vous pouvez aussi accéder à de nombreux groupes de discussion où les utilisateurs échangent informations, astuces et techniques. Voyez à l’adresse http://info.borland.com/
newsgroups/ la dernière liste des groupes de discussion libres d’accès. Egalement disponible sur Internet le site Borland Developer Network, à l’adresse http://
community.borland.com. Borland Community donne accès à des informations spécifiques aux produits, à des articles, à des exemples de code et à des nouvelles.
Avant de contacter le support, préparez des informations complètes sur votre environnement, la version du produit que vous utilisez et une description détaillée du problème.
Pour avoir de l’aide sur les outils tiers, ou leur documentation, contactez votre fournisseur.
C h a p i t r e
2
Chapitre 2
Installation de StarTeam Server
Ce chapitre explique comment installer StarTeam Server. Il parle également des préparations pouvant intervenir avant l’installation et des étapes à respecter après, en particulier si vous mettez à niveau une version antérieure de StarTeam Server.
■ Si vous évaluez le produit avant de l’adopter ou si vous l’installez pour une première utilisation sur site, vous devez lire “Pré-installation requise pour une nouvelle installation”, page 15, et aller ensuite directement à “Installation de StarTeam Server”, page 28.
■ Si vous mettez à niveau une version antérieure du produit avec la nouvelle release, vous devez lire l’intégralité de ce chapitre. Après l’installation, vous devez mettre à niveau chaque configuration de serveur. Voir “Mise au niveau de Borland StarTeam 2006”, page 16.
A propos de StarTeam Server
StarTeam Server est un outil puissant qui prend en charge les équipes de
développement distribuées et les membres des équipes mobiles. Il prend en charge toutes les langues pouvant être encodées en UTF-8. Vous avez accès aux données gérées par StarTeam Server depuis une grande variété de clients. Le client le plus souvent utilisé est le client StarTeam multiplate-forme ; il prend en charge les systèmes Windows, Solaris et Linux.
Les autres clients utilisent des applications déjà familières pour accéder au serveur.
Par exemple, vous pouvez accéder au serveur à partir d’Internet Explorer 6.0 en utilisant StarTeam Web Edition. Si vous utilisez une intégration de StarTeam à un EDI, vous accéderez à StarTeam Server depuis des applications EDI telles que Microsoft Visual Studio 2005 et depuis des plates-formes telles qu’Eclipse.
L’accès à StarTeam Server peut être local ou distant — via Internet, un intranet, un WAN ou une connexion téléphone. Le chiffrement intégré vous permet de travailler en toute sécurité sur les réseaux publics comme Internet. Normalement, vous installerez StarTeam Server sur un ordinateur accessible par tous les membres de l’équipe. Vous installerez ensuite les clients StarTeam sur les stations de travail des membres de l’équipe. Pour apprendre à utiliser le serveur StarTeam, veuillez vous reporter à l’aide en ligne.
C o n f i g u ra t i o n s y s t è m e p o u r S t a rT e a m S e r v e r
Configuration système pour StarTeam Server
Borland recommande d’installer StarTeam Server sur un serveur d’applications dédié, et d’installer la base de données sur un serveur séparé sauf si vous utilisez Microsoft SQL Server 2000 Desktop Engine (MSDE) comme base de données.
Remarque Il doit exister une connexion dédiée entre l’ordinateur qui exécute StarTeam Server et celui du système de gestion de la base de données. Pour optimiser les
performances, les deux machines doivent être sur le même commutateur physique.
Les tableaux suivants présentent le matériel minimal et recommandé nécessaire à l’ordinateur sur lequel est déployé l’application et la base de données StarTeam Server. Bien que les vitesses des processeurs soient mentionnées, vous devez toujours utiliser la CPU la plus rapide possible pour obtenir les meilleures performances.
Systèmes d’exploitation pris en charge
Le système d’exploitation suivant est pris en charge par cette version de Starteam Server :
■ Microsoft Windows 2003 Server (version 32 bits)
■ Microsoft Windows 2003 Server R2 (version 32 bits)
Vous pouvez exécuter StarTeam Server 2005 R2, et les versions suivantes, sur VMware ESX Server.
Bases de données prises en charge
Les bases de données et les pilotes ODBC suivants sont pris en charge par StarTeam Server :
* Microsoft MSDE peut être installée en tant que partie de l’installation de StarTeam Server. Les autres produits de base de données doivent être achetés auprès du fournisseur approprié.
Pour de plus amples informations, voir “Configuration système du serveur de la base de données”, page 13.
StarTeam Server et MSDE sur le même ordinateur
Lorsque vous employez MSDE, la base de données réside habituellement sur le même ordinateur que l’application Starteam Server correspondante. Les recommandations suivantes vis à vis du matériel pour un ordinateur Starteam Server/MSDE sont établies en fonction du nombre de postes (utilisateurs enregistrés) — bien que la situation puisse varier selon la taille de vos projets StarTeam et le nombre de projets gérés par la configuration de serveur.
Tableau 2.1 Configuration pour la base de données Base de données prise
en charge CPU Version Version ODBC
Microsoft MSDE 2000* x86 (32 bits) 2000 (SP2) avec le correctif pour le virus Slammer
v2000.85.1025 Microsoft SQL Server 2000 x86 (32 bits) 2000 (SP4) v2000.85.1025
Oracle x86 (32 bits) 9.2.0.5
10.1.0.4.0
9.2.0.65 10.1.0.5.0
Oracle Sparc (32 bits) 9.2.0.5
10.1.0.4.0
9.2.0.65 10.1.0.5.0
C o n f i g u r a t i o n s y s t è m e p o u r S t a r T e a m S e r v e r
MSDE n’est pas recommandée pour les configurations servant plus de 100 utilisateurs enregistrés.
StarTeam Server sur un ordinateur séparé
Les recommandations suivantes vis à vis du matériel s’appliquent lorsque l’application StarTeam Server s’exécute sur un autre ordinateur que le serveur de la base de données. Elles sont basées sur le nombre de postes (utilisateurs enregistrés) — bien que la situation puisse varier selon la taille de vos projets StarTeam et le nombre de projets gérés par la configuration de serveur.
Tableau 2.3 Suggestions de configuration système pour StarTeam Server un ordinateur distinct du serveur de la base de données
Configuration système du serveur de la base de données
Les recommandations suivantes s’appliquent au serveur de la base de données lorsqu’il n’est pas sur le même ordinateur que StarTeam Server. Le nombre de postes est équivalent au nombre d’utilisateurs enregistrés.
Les bases de données SQL Server et MSDE n’ont été testées qu’en 32 bits. Les bases de données Oracle ont été testées en 32 et 64 bits.
Tableau 2.2 Suggestions de configurations système pour StarTeam et MSDE sur le même ordinateur Nombre
de postes
Configuration minimale
Configuration recommandée
< 50 Ordinateur avec processeur Pentium®4 à 1,3 GHz et 1,5 Go de RAM
Ordinateur avec deux processeurs Pentium 4 à 1,3 GHz, ou plus, et 2 Go de RAM
50 – 100 Ordinateur avec deux processeurs Pentium Xeon™ à 2,26 GHz, ou plus, et 2,5 Go de RAM
Identique à la configuration minimale
Nombre de postes
Configuration minimale
Configuration recommandée
< 50 Ordinateur avec processeur Pentium 4 à 1,3 GHz et 512 Mo de RAM
Ordinateur avec deux processeurs Pentium 4 à 1,3 GHz, ou plus, et 1 Go de RAM
50 – 100 Ordinateur avec deux processeurs Pentium 4 à 1.3 GHz et 1 Go de RAM
Ordinateur avec deux processeurs Pentium 4 à 1,3 GHz, ou plus, et 2 Go de RAM
100 – 200 Ordinateur avec deux
processeurs Pentium Xeon 4 à 2,26 GHz et 1,5 Go de RAM
Ordinateur avec deux processeurs Pentium Xeon 4 à 2,26 GHz et 2,5 Go de RAM
> 200 Tout serveur d’entreprise haute performance avec quatre processeurs à 2.26 GHz, et plus, et 4.0 Go de RAM
Configuration minimale plus un système RAID
C o n f i g u ra t i o n s y s t è m e p o u r S t a rT e a m S e r v e r
Tableau 2.4 Configuration système pour le serveur de la base de données
Logiciels tiers requis
StarTeam Server utilise la VM Java 1.5.0_09 de Sun Microsystems, qui est installée automatiquement à C:\Program Files\Borland\Java\Sun1.5.0_09.
Adobe Acrobat Reader est nécessaire pour lire les manuels StarTeam qui sont livrés au format .pdf (Portable Document Format) d’Adobe et peuvent être visualisés avec la version 4.0, ou une version ultérieure, du programme gratuit d’Adobe, Acrobat Reader.
Vous pouvez télécharger la dernière version d’Acrobat Reader depuis le site Web d’Adobe, à l’adresse http://www.adobe.com.
Prise en charge de la mémoire large
4GT RAM tuning peut être utilisé pour permettre à l’application StarTeam Server d’utiliser 3 Go de mémoire. 4GT RAM tuning peut être utilisé uniquement avec les systèmes d’exploitation suivants :
■ Windows Server 2003
■ Windows Server 2000 Datacenter Server
■ Windows Server 2000 Advanced Server
Pour que cette fonctionnalité soit possible, le commutateur /3GB doit être ajouté au fichier Boot.ini. Pour de plus amples informations sur le paramétrage de ce
commutateur, voir :
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/memory/base/
4gt_ram_tuning.asp
Nombre de postes Configuration matérielle
Configuration pour la base de données
< 50 Ordinateur avec processeur Pentium 4 à 1,3 GHz et 1 Go de RAM
Minimum : MSDE 2000 SP2 avec correctif contre le virus Slammer Recommandé :
■ Oracle 9.2.0.5
■ Oracle 10.1.0.4.0
■ Microsoft SQL Server 2000 SP4 50 – 100 Ordinateur avec deux
processeurs Pentium 4 à 1.3 GHz et 2 Go de RAM
Minimum : MSDE 2000 SP2 avec correctif contre le virus Slammer Recommandé :
■ Oracle 9.2.0.5
■ Oracle 10.1.0.4.0
■ Microsoft SQL Server 2000 SP4 100 – 200 Minimum : Ordinateur avec deux
ou quatre processeurs Pentium Xeon 4 à 2.26 GHz et 2-3 Go de RAM
Recommandé : Configuration minimale plus un système RAID
Minimum et recommandé :
■ Oracle 9.2.0.5
■ Oracle 10.1.0.4.0
■ Microsoft SQL Server 2000 SP4
> 200 Minimum : Tout serveur d’entreprise haute performance avec quatre processeurs à 2.26 GHz, et plus, et 4.0 Go de RAM
Recommandé : Configuration minimale plus un système RAID
Minimum et recommandé :
■ Oracle 9.2.0.5
■ Oracle 10.1.0.4.0
■ Microsoft SQL Server 2000 SP4
P r é - i n s t a l l a t i o n r e q u i s e p o u r u n e n o u v e l l e i n s t a l l a t i o n
Prise en charge des jeux de caractères Unicode par StarTeam Server
Comme StarTeam Server prend en charge toutes les langues pouvant être encodées en UTF-8, il n’utilise que les caractères ASCII (0-127) lorsqu’il développe des
mots-clés. Les caractères hors de cet intervalle sont développés en “?”. L’expansion des mots-clés et la conversion des EOL devraient fonctionner pour tous les encodages
“basés sur ASCII”, ce qui inclut UTF8, Cp1252, etc. Les divers encodages UTF-16 ne sont pas compris. Actuellement, StarTeam traite les encodages UTF-16 comme des binaires et n’exécute sur eux aucune expansion d’EOL ni de mots-clés.
Les noms internes des champs personnalisés doivent être ASCII, mais les noms affichés peuvent utiliser des jeux de caractères non anglais.
Pré-installation requise pour une nouvelle installation
Avant d’installer StarTeam Server :
1 Assurez-vous que le système de votre ordinateur répond aux exigences minimales du produit. Pour de plus amples informations, voir “Configuration système pour StarTeam Server”, page 12.
2 Vous devez être administrateur local sur l’ordinateur cible pour installer StarTeam Server ou d’autres produits StarTeam. De même, les paramètres locaux du compte administrateur effectuant l’installation doivent être stockés sur l’ordinateur cible.
Starteam Server et les clients StarTeam ne fonctionnent pas correctement si les paramètres locaux sont stockés sur une unité du réseau.
3 L’écran de l’ordinateur sur lequel vous installez StarTeam Server doit avoir une définition de 256 couleurs ou plus.
4 Sauf si vous voulez uniquement utiliser MSDE, la base de données par défaut pour les configurations de serveur, vous devez installer le système de gestion de la base de données que vous prévoyez d’utiliser avec StarTeam Server. Habituellement, le serveur de base de données est installé sur un autre ordinateur. Assurez-vous que le système de votre ordinateur répond aux exigences minimales de la base de données. Reportez-vous à la documentation fournie avec le système de gestion de la base de données pour de plus amples informations. Voir “Configuration système du serveur de la base de données”, page 13, pour de plus amples informations sur les bases de données prises en charge.
Remarque Il doit exister une connexion dédiée entre l’ordinateur qui exécute StarTeam Server et celui du système de gestion de la base de données. Pour optimiser les performances, les deux ordinateurs doivent être sur le même commutateur physique.
5 Installez le client de la base de données sur le même ordinateur que StarTeam Server.
6 Si vous utilisez MSDE, base de données par défaut de StarTeam, elle est généralement installée en même temps que StarTeam Server sur le même ordinateur. Si vous avez exécuté l’installation à partir du CD, vous avez cinq exemplaires de MSDE. Si vous avez exécuté l’installation à partir d’une version téléchargée de StarTeam Server, vous avez deux exemplaires. Un suffit ;
l’installation en fournit au moins deux car vous pouvez avoir une application utilisant déjà MSDE sur l’ordinateur où le serveur StarTeam est installé. Des numéros spécifiques ont été attribués par Microsoft Corporation aux fichiers de la base de données et des fichiers ayant le même numéro ne peuvent servir à deux
applications.
M i s e a u n i v e a u d e B o r l a n d S t a r T e a m 2 0 0 6
Bien que MSDE soit livrée avec StarTeam Server en tant que base de données par défaut, Borland conseille d’utiliser des systèmes de gestion de bases de données de classe entreprise sauf si vous avez une équipe peu nombreuse et une quantité de données relativement faible.
Vous pouvez gérer MSDE avec les outils SQL Server ou avec MSDE AdminTool.
Sachez que MSDE AdminTool est un outil non pris en charge de Microsoft
Corporation. MSDE AdminTool nécessite Microsoft Access 2000 Runtime et sert à archiver et à restaurer les bases de données MSDE.
Vous pouvez soit installer Microsoft Access 2000 Runtime depuis le CD Office 2000, soit, si vous avez une copie licenciée de Microsoft Office 2000 Developer, vous pouvez télécharger Access 2000 Run-Time Minimum (Art2kmin.exe) depuis le site web de Microsoft.
Pour installer MSDE AdminTool avec le serveur, vous devez effectuer une installation personnalisée de StarTeam Server.
7 StarTeam Server pouvant être utilisé avec n’importe quel jeu de caractères UTF-8, le paramétrage des pages de codes pour les bases de données peut s’avérer très important. Vous trouverez des informations à ce sujet dans le chapitre concernant la création d’une configuration de serveur pour le type de votre base de données.
■ Pour les bases de données Microsoft SQL Server et MSDE, voir “Comprendre les différences d’encodages”, page 70.
■ Pour les bases de données Oracle, voir “Jeu de caractères de la base de données et StarTeam Server”, page 92.
Mise au niveau de Borland StarTeam 2006
Si vous avez utilisé des versions antérieures de StarTeam Server, vous devez mettre à niveau chacune de vos configurations de serveur après avoir installé la nouvelle version. Le processus de mise à niveau varie selon :
■ La base de données que vous utilisez
■ La version antérieure de StarTeam Server que vous utilisez
■ Que vous avez précédemment enveloppé des archives PVCS ou VSS
■ Que vous avez encore des archives StarTeam au format Native-I
Votre mise au niveau de StarTeam Server 2006 peut nécessiter davantage d’étapes que les mises à niveau précédentes de StarTeam Server. Assurez-vous d’avoir le temps d’effectuer ces étapes.
Remarque Les étapes des procédures fournies dans cette section et dans ses sous-sections sont basées sur StarTeam Server 2005 R2. Parfois, les étapes pour StarTeam Server 2005 sont légèrement différentes. Vous aurez peut-être besoin de consulter la
documentation de StarTeam 2005 pour avoir des détails.
Mise à niveau de votre correctif StarTeam Server actuel
Vous pouvez passer directement à StarTeam Server 2006 à partir de StarTeam Server 2005 et de StarTeam Server 2005 R2. Si vous utilisez une version plus ancienne de StarTeam Server, vous devez d’abord la mettre au niveau de la version 2005 ou de la version 2005 R2, avant de passer à la dernière version. Le Tableau 2.5 donne les versions correctes de StarTeam Server et les correctifs devant être appliqués au serveur avant d’entamer le processus de mise à niveau.
M i s e a u n i v e a u d e B o r l a n d S t a r T e a m 2 0 0 6
Remarque Le Tableau 2.5 indique les meilleurs correctifs au moment où ce manuel est rédigé.
Des nouvelles versions des correctifs mentionnés ci-dessus contenant de nouvelles corrections peuvent être disponibles. Contactez le support technique pour de plus amples informations sur les dernières versions des correctifs.
Préparation pour une mise à niveau
Avant une mise à niveau, vous devez effectuer ce qui suit :
■ Etablissez le plan de la mise à niveau
Prévoyez d’effectuer la mise à niveau du serveur à un moment où cela gênera le moins d’utilisateurs possible. Avant et pendant la mise à niveau, certaines étapes ne peuvent pas être effectuées si une configuration de serveur est en exécution.
Vous pouvez prévoir la mise à niveau à la fin d’une journée de travail ou pendant un week-end. Si vous avez un référentiel volumineux ou un système lent, le processus de mise à niveau peut être long. Selon la taille de votre base de données et si vous devez convertir des fichiers et effectuer un nettoyage avant la mise à niveau, vous devrez prévoir plusieurs périodes d’arrêt — peut-être une série de week-ends consécutifs. Par exemple, vous pouvez prévoir un week-end pour les conversions, un pour le nettoyage et un pour la vérification de l’espace de stockage. Si vous prévoyez plusieurs week-ends pour le processus de mise à niveau, vous pouvez continuer d’utiliser entre temps des configurations de serveur StarTeam 2005 et 2005 R2 en production, mais faites des sauvegardes avant et après chaque étape pour être certain de ne pas perdre de données.
Indiquez suffisamment à l’avance aux membres de votre équipe la période où vous allez effectuer cette transition ainsi que le moment où ils devront avoir installé la dernière version du client StarTeam. Sauf indication spécifique, les clients StarTeam d’une version donnée peuvent travailler avec cette même version de StarTeam Server, une version antérieure ou une version ultérieure. Quand un client plus ancien fonctionne avec un serveur plus récent, le client ne peut pas accéder aux nouvelles fonctionnalités. Par exemple, le client ancien ne dispose pas des nouvelles commandes de menu.
■ Sauvegardez la configuration de serveur
Soyez certain de posséder des sauvegardes à jour et vérifiées des fichiers et dossiers de la configuration de serveur (fichiers de la base de données, fichiers d’archive, etc.) avant de commencer les étapes importantes du processus de mise à niveau.
Tableau 2.5 Mise à niveau d’une version 2005 ou 2005 R2
Version de StarTeam Server Correctif appliqué StarTeam Server 2005 R2 version 8.0.172 Correctif 29 StarTeam Server 2005 version 7.0.133 Correctif 21
M i s e a u n i v e a u d e B o r l a n d S t a r T e a m 2 0 0 6
Résumé des instructions de mise à niveau
Le tableau suivant fournit un résumé du processus de mise à niveau. Voir les sections suivantes, pour de plus amples informations.
Exigences pour une mise à niveau
Cette section décrit les étapes à suivre pour la mise au niveau de Borland StarTeam Server 2006, en détaillant la liste de contrôle précédente et en indiquant à quelles sections se reporter pour obtenir de plus amples informations.
Avant la mise au niveau de Borland StarTeam 2006, vous devez effectuer les opérations suivantes :
1 Relisez les points exposés dans les problèmes de pré-installation pour savoir si certains s’appliquent à votre situation. Voir “Pré-installation requise pour une nouvelle installation”, page 15.
2 Vous pouvez passer à StarTeam Server 2006 uniquement depuis StarTeam Server 2005 ou 2005 R2. Si vous avez une version antérieure, effectuez les étapes nécessaires pour mettre cette version au niveau 2005 ou 2005 R2. Consultez le Tableau 2.6 Liste de contrôle pour la mise au niveau de StarTeam 2006
Ancienne version
Nouvelle
version Procédure de mise à niveau
6.0 2005 R2 et
2006
1 Sauvegardez vos référentiels StarTeam et les autres fichiers du serveur.
2 Installez StarTeam Server2005 R2 build 8.0.172 et le correctif 29.
3 Si nécessaire, mettez à niveau ou faites migrer votre base de données vers une version prise en charge par StarTeam Server 2005 R2.
4 Suivez les instructions de mise à niveau depuis StarTeam Server 2005 R2 vers StarTeam Server 2006.
2005, 2005 R2 2006 1 Sauvegardez vos référentiels StarTeam et les autres fichiers du serveur.
2 Convertissez au format Native-II les fichiers d’archive Native-I restants.
3 Convertissez les archives PVCS ou VSS au format Native-II.
4 Exécutez l’utilitaire de nettoyage pour réduire la taille de votre base de données et de vos répertoires de stockage et pour supprimer les archives Native-I, PVCS et VSS qui étaient précédemment dans des vues ou dans des projets désormais supprimés.
5 Exécutez l’utilitaire Vault Verify pour vérifier que dans toutes les révisions des fichiers Native-II il n’y a pas de fichiers manquants, endommagés et/ou isolés. Cela vous permet de connaître l’état de vos fichiers avant la mise à niveau. L’état de vos fichiers après la mise à niveau devrait être très proche.
6 Exécutez ReportArchives, un nouvel outil intégré à VaultVerify, pour savoir si vous avez des fichiers dont les archives sont encore listées dans la base de données en tant qu’archives étrangères (PVCS ou VSS) ou Native-I et effectuer les étapes nécessaires.
7 Installez StarTeam Server 2006.
8 Si nécessaire, mettez à niveau ou faites migrer votre base de données vers une version prise en charge par StarTeam Server 2006.
9 Mettez à niveau vos configurations de serveur.
M i s e a u n i v e a u d e B o r l a n d S t a r T e a m 2 0 0 6
guide d’installation approprié pour plus de détails. Une fois que vous avez installé la version 2005 ou 2005 R2, assurez-vous d’installer les derniers correctifs. Pour 2005, vous devez avoir au moins le correctif 21. Pour 2005 R2, vous devez avoir au moins le correctif 29.
3 Sauvegardez vos référentiels StarTeam et les autres fichiers du serveur.
Reportez-vous à la documentation de la version de StarTeam Server actuellement installée pour savoir quels éléments sauvegarder.
4 Dans l’Outil d’administration du serveur StarTeam 2005 ou 2005 R2, convertissez au format Native-II tous les espaces de stockage Native-I dont vous disposez.
Native-II est le seul type d’espace de stockage pris en charge par la version 2006.
Pour de plus amples informations, voir “Conversion des fichiers d’archive Native-I au format Native-II”, page 21.
5 Dans les versions précédentes de StarTeam, une approche par “enveloppement”
servait à inter-opérer avec les projets PVCS et VSS. L’“enveloppement” d’archives étrangères n’est pas pris en charge par StarTeam Server 2006. Vous devez convertir les fichiers stockés dans des projets PVCS ou VSS en format natif de StarTeam, avant de mettre le serveur au niveau de StarTeam Server 2006, en utilisant cette procédure :
a Dans StarTeam 2005 ou 2005 R2, ouvrez le projet enveloppé.
b Sélectionnez Outils > Convertir au format natif dans la barre de menus. Un message vous invite à vérifier la conversion des fichiers de ce projet dans le type de stockage StarTeam.
c Cliquez sur OK. Un autre message vous informe que la conversion a commencé.
Si la notification par courrier électronique est activée, l’application vous envoie (en tant qu’utilisateur connecté) un message électronique dès la fin du processus. (Pour de plus amples informations, voir “Activation de la prise en charge du courrier électronique”, page 29 du Guide de l’administrateur de StarTeam fourni avec StarTeam 2005 et 2005 R2.) Suivant le nombre et la taille des archives converties, le processus peut prendre du temps. Ce processus se déroule alors que la configuration du serveur est en exécution. Les utilisateurs ne doivent pas essayer d’utiliser le projet pendant la conversion. Vous pouvez modifier les droits d’accès au niveau projet pour être certain que les utilisateurs n’accéderont pas à ce projet.
Un fichier journal GoNative fournit des données sur la conversion. Il est stocké dans dossier_référentiel\Logs\Files_Logs où dossier_référentiel représente
l’emplacement défini pour le référentiel de la configuration de serveur. Le fichier journal porte le nom GoNative.locale.log.
Pour différencier les fichiers journaux GoNative, des informations d’horodatage sont ajoutées au fichier journal GoNative existant quand vous en créez un nouveau. Le nom de l’ancien fichier change de GoNative.locale.log en
GoNative.locale.dateheure.log. Par exemple, vous pouvez voir
GoNative.en_US.Log et GoNative.en_US.2004-02-18-14-38.Log dans le dossier Files_Logs.
6 Exécutez l’utilitaire de nettoyage depuis la ligne de commande pour enlever de la base de données et des archives les données relatives aux projets et aux vues supprimés. L’exécution de l’utilitaire de nettoyage avant la mise à niveau est une bonne idée, mais devient indispensable lorsque l’une des deux situations suivantes est vraie :
■ Votre configuration de serveur StarTeam avait à un certain moment des archives de fichiers Native-I (car vous utilisiez une version antérieure à StarTeam 2005).
■ Vous aviez enveloppé des archives PVCS ou VSS pour les utiliser avec StarTeam.
