StarTeam ®
Guide d’installation
Borland Software Corporation 100 Enterprise Way
Scotts Valley, California 95066-3249 www.borland.com
Les applications mentionnées dans ce manuel sont brevetées, ou en attente de brevet, par Borland Software Corporation. Reportez-vous au CD ou à la boîte de dialogue A propos pour avoir la liste des brevets. Ce document ne donne aucun droit sur ces brevets.
COPYRIGHT © 1995–2005 Borland Software Corporation. Tous droits réservés. 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. Tous les autres produits sont la propriété de leurs fabricants respectifs.
Pour connaître les conditions et limites des fournisseurs tiers, lisez les Notes de mises à jour sur le CD du produit.
Table des matières
Chapitre 1
Jeu de documentation StarTeam 1
Documentation en ligne StarTeam . . . 2
Contenu des CD d’installation de StarTeam . . . 3
Comment contacter les services de support Borland . . . 4
Conventions de la documentation . . . 5
Chapitre 2 Installation de StarTeam Server 7
Prise en charge des jeux de caractères Unicode par StarTeam Server . . . 8Pré-installation pour une nouvelle installation . . . . 8
Pré-installation pour une mise à niveau. . . 9
Modifications des fichiers de StarTeam Server . . 10 Installation de StarTeam Server. . . . 10
Problèmes d’installation connus . . . . 12
Post-installation pour une nouvelle installation . . . . 13
Post-installation pour une mise à niveau . . . . 13
Evaluation de StarTeam Server . . . . 14
Licences StarTeam Server . . . . 14
Utilisation d’une licence StarTeam . . . . 15
Utilisation d’un serveur de licences . . . . 16
Présentation des licences . . . . 16
Utilisation de la configuration de serveur exemple StarDraw . . . . 17
Installation des autres composants du serveur . . . . 18
Installation de StarTeamMPX . . . . 18
Installation de StarTeam Extensions. . . . 18
Chapitre 3 Installation des clients StarTeam 19
Avant d’installer un client StarTeam. . . . 19Démarrage des utilisateurs avec les mêmes options personnelles . . . . 19
Installation du client StarTeam Windows . . . . 20
Installation du client StarTeam multiplate-forme . . . 22
Installation sous Windows . . . . 22
Installation sous Linux ou Solaris . . . . 23
Installation sous Macintosh OSX . . . . 23
Installation sur d’autres plates-formes . . . . 24
Installation des autres clients StarTeam . . . . 24
Installation de StarDisk . . . . 24
Installation de StarTeam Web Edition . . . . 24
Installation des intégrations de StarTeam . . . . . 24
Chapitre 4 Utilisation des bases de données Microsoft SQL Server/MSDE avec StarTeam Server 25
Utilisation d’une base de données MSDE : Présentation . . . 27Utilisation d’une base de données Microsoft SQL Server : Présentation. . . 27
Connexion aux bases de données Microsoft SQL Server 2000 . . . 27
Création et démarrage d’une configuration de serveur . . . 28
Conseils pour les fichiers de données et les journaux de transactions . . . 33
Exécution des scripts SQL sur les bases de données Microsoft . . . 34
Création manuelle d’une base de données : Présentation . . . 36
Création d’un DSN système ODBC pour la base de données StarTeam . . . 37
Création d’une configuration de serveur (pour une base de données existante) . . . 39
Présentation de la collation. . . 42
Comment est choisie la collation par défaut ? . . 43
Chapitre 5 Utilisation d’utilisateurs de schéma Oracle avec StarTeam Server 45
Terminologie employée pour les bases de données Oracle . . . 45Connexion à des utilisateurs de schéma . . . 46
Présentation de l’utilisation d’un utilisateur de schéma Oracle . . . 46
Vérification de la connexion entre le client et le serveur . . . 46
Utilisation des bons pilotes ODBC Oracle avec StarTeam . . . 47
Téléchargement et installation des pilotes ODBC Oracle . . . 48
Correctif du pilote ODBC Oracle pour StarTeam Server . . . 50
Utilisation correcte de NLS_LANG avec StarTeam . 50 Définition de NLS_LANG . . . 51
Jeu de caractères de la base de données et StarTeam Server . . . 52
Création et démarrage d’une configuration de serveur avec un utilisateur de schéma Oracle . . . 53
Conseils pour les fichiers de données . . . 57
Exécution des scripts SQL pour les utilisateurs de schéma Oracle . . . 57
Présentation de la création manuelle de l’utilisateur de schéma . . . 60
Tablespaces gérés par dictionnaire et tablespaces gérés en local . . . 61
Chapitre 6
Utilisation de bases de données UDB DB2
avec StarTeam Server 67
Connexions aux bases de données . . . . 67
Utilisation d’une base de données IBM DB2 : Présentation . . . . 67
Création d’une base de données IBM DB2 pour StarTeam Server . . . . 68
Configuration d’un compte utilisateur. . . . 70
Reconfiguration d’une base de données IBM DB2 . . 70 Création d’une connexion ODBC . . . . 70
Création d’une configuration de serveur pour une base de données IBM DB2 . . . . 71
Exécution des scripts SQL sur les bases de données IBM DB2 . . . . 72
Scripts SQL pour les bases de données Microsoft SQL Server et MSDE . . . . 73
Résolution des problèmes liés aux bases de données IBM DB2 . . . . 73
Chaîne de langue introuvable . . . . 73
Aucun propriétaire enregistré . . . . 74
La connexion à une base de données IBM DB2 modifie la valeur des paramètres régionaux . . . 74
Impossibilité d’ouvrir une base de données IBM DB2 . . . . 74
Erreur d’utilisation d’une procédure stockée . . . 74
Chapitre 7 Mise à niveau des configurations de serveur 75
Mise à niveau d’une version 2005 ou 6.0. . . . 76Mise à niveau depuis SP1 5.2 . . . . 77
Préparation de la mise à niveau d’une configuration de serveur. . . . 77
Accord des privilèges Oracle . . . . 77
Exécution de la procédure de mise à niveau . . . . . 78
Dépannage du processus de mise à niveau . . . 78
Avant le lancement d’une configuration de serveur mise à niveau . . . . 78
Lancement d’une configuration de serveur mise à niveau . . . . 81
Conversion des fichiers d’archive Native-I . . . . 81
Chapitre 8 Comprendre l’emplacement des données 83
Utilisation des espaces de stockage Native-I et Native-II . . . . 83Présentation des espaces de stockage Native-II . . . 84
Taille des révisions de fichiers plus grande . . . . 84
Davantage d’emplacements pour le stockage des archives . . . . 84
Meilleures performances . . . . 84
Opérations d’ajout . . . . 85
Opérations d’archivage. . . . 85
Opérations d’extraction. . . . 85
Sauvegardes plus flexibles . . . .86
Besoin de davantage de place pour le stockage . . . .86
Présentation des référentiels 2005 et ultérieurs. . . .86
Fichiers journaux et dossiers. . . .87
Dossier Attachments . . . .87
Dossiers de l’espace de stockage Native-II . . . .88
Structure de Archive et de Cache . . . .89
Utilisation du stockage du delta . . . .90
Présentation des référentiels antérieurs à 2005 . . .91
Dossiers de l’espace de stockage Native-I. . . . .91
Conversion des fichiers d’archive Native-I en Native-II. . . .92
Dossiers de StarDraw . . . .93
Annexe A Installation et configuration des logiciels requis 95
Saisie de données précises dans les champs Heure sous Windows . . . .95Synchronisation des horloges des stations de travail . . . .95
Installation d’Adobe Acrobat Reader . . . .96
Installation de l’environnement d’exécution de Java . . . .96
Annexe B Sauvegarde de bases de données 97
Sauvegarde des bases de données SQL Server . . .97Sauvegarde complète de la base de données . . .98
Sauvegarde différentielle de la base de données . . . .99
Sauvegarde du journal des transactions . . . .99
Sauvegardes des fichiers . . . .99
Recommandations . . . . 100
Sauvegarde des bases de données Oracle . . . . . 100
Sauvegardes logiques (Exportation/Importation) . . . . 101
Sauvegardes hors connexion/à froid . . . . 101
Sauvegardes en ligne/à chaud . . . . 102
Sauvegardes RMAN . . . . 103
Data pump d’exportation/importation . . . . 104
Recommandations . . . . 104
Sauvegarde de bases de données DB2. . . . 104
Consignation . . . . 104
Consignation circulaire . . . . 104
Consignation d’archive . . . . 105
Procédures de sauvegarde en ligne . . . . 106
Procédures de restauration . . . . 106
Annexe C Configuration système 109
Configuration système de StarTeam Server. . . . . 109Systèmes d’exploitation pris en charge . . . . . 110
StarTeam et MSDE sur le même ordinateur . . . 110
StarTeam Server sur un ordinateur séparé . . . 110
Configuration système du serveur de la base de données . . . . 111
Configuration système du client StarTeam
multiplate-forme . . . 111 Configuration système du client StarTeam
Windows. . . 112
Annexe D
Réglage des bases de données
Oracle 8i 113
Paramètres d’initialisation recommandés . . . 113
Réglage et suivi des bases de données Oracle . . . 115 StarTeam Server et les tablespaces . . . . 115 Gestion des tablespaces par dictionnaire . . . . 115 Gestion des tablespaces en local . . . . 115 ASSM
(Automatic Segment Space Management) . . . 116
Index 117
C h a p i t r e
1
Chapitre 1
Jeu de documentation StarTeam
Le jeu de documentation StarTeam vous servira de guide lors de l’utilisation de la suite de produits StarTeam. Le jeu de documentation est composé des manuels suivants.
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.
■ Guide des nouvelles fonctionnalités de StarTeam
Le Guide des nouvelles fonctionnalités de StarTeam décrit les nouvelles fonctionnalités de cette version de la ligne de produits StarTeam.
■ Guide d’installation de StarTeam
Le Guide d’installation de StarTeam contient des instructions détaillées sur l’installation des principaux produits StarTeam et indique la configuration système requise pour chacun d’eux.
■ Guide d’introduction à StarTeam
Le Guide d’introduction à StarTeam présente deux tutoriels sur la gestion de la configuration pour StarTeam Server et les clients StarTeam. Le premier tutoriel est destiné aux administrateurs et explique comment exécuter les fonctions
d’administration élémentaires sur le serveur comme sur le client. Le second tutoriel est destiné aux utilisateurs et explique comment utiliser les fonctionnalités
élémentaires de l’application.
■ Guide de l’utilisateur de StarTeam
Le Guide de l’utilisateur de StarTeam explique comment utiliser les clients StarTeam Windows et StarTeam multiplate-forme, pour suivre et gérer les modifications apportées aux fichiers, pour partager des fichiers et des
commentaires avec les autres membres de l’équipe, pour accéder aux versions antérieures d’un fichier, et pour les autres fonctions de la gestion de la
configuration. Il explique également comment utiliser les autres éléments, en particulier demandes de modification, exigences, tâches et rubriques.
■ Guide de l’Administrateur de StarTeam
D o c u m e n t a t i o n e n l i g n e S t a r T e a m
■ StarTeam Extensions User’s Guide
Le StarTeam Extensions User’s Guide explique comment concevoir et gérer les Extensions de StarTeam, par exemple les éditeurs de propriétés APE. Il couvre également le Concepteur de Workflow et l’Agent de notification de StarTeam.
■ StarTeamMPX Administrator’s Guide
Le StarTeamMPX Server Administrator’s Guide décrit les opérations de base et l’architecture d’un système serveur StarTeamMPX et présente les instructions d’installation et de configuration des composants StarTeamMPX.
■ StarDisk User’s Guide
Le StarDisk User’s Guide explique comment installer et utiliser l’application client StarDisk. StarDisk améliore l’explorateur de Windows afin qu’il soit utilisable en tant que simple client d’un serveur StarTeam. Après avoir mis en correspondance une configuration spécifique de la vue d’un projet StarTeam et un disque virtuel Windows, vous pouvez exécuter les opérations de base du contrôle de versions sur les fichiers et les dossiers appartenant à cette vue.
Documentation en ligne StarTeam
La procédure d’installation de StarTeam installe les versions en ligne des manuels StarTeam dans le dossier \Online Documentation de l’application serveur ou client StarTeam. Le tableau suivant indique le nom des fichiers correspondant aux manuels en ligne StarTeam. Les manuels en ligne que vous avez reçus dépendent des produits StarTeam que vous avez achetés.
Important Les manuels en ligne sont distribués au format Adobe Acrobat (.PDF) et nécessitent Adobe Acrobat Reader, version 4.0 ou ultérieure, pour être affichés. Le programme d’installation d’Adobe Acrobat Reader se trouve dans le dossier \Docs du CD d’installation de StarTeam. Acrobat Reader est également disponible sur le site web d’Adobe à l’adresse : www.adobe.com.
Nom du fichier Manuel StarTeam
admin.pdf Guide de l’Administrateur de StarTeam adminMPX.pdf StarTeamMPX Administrator’s Guide extensions.pdf StarTeam Extensions User’s Guide install.pdf Guide d’installation de StarTeam
newfeatures.pdf Guide des nouvelles fonctionnalités de StarTeam
stardisk.pdf StarDisk User’s Guide (client StarTeam Windows uniquement) start.pdf Guide d’introduction à StarTeam
user.pdf Guide de l’utilisateur de StarTeam
C o n t e n u 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
Contenu des CD d’installation de StarTeam
Les principaux produits StarTeam s’installent à partir de deux CD. Le disque 1 contient les produits suivants :
■ StarTeam Server
■ Emetteurs StarTeamMPX
■ client StarTeam Windows
■ Client StarTeam multiplate-forme (pour les plates-formes Windows)
■ StarDisk
Le disque 2 contient les produits suivants :
■ Client StarTeam multiplate-forme (pour les plates-formes autres que Windows)
■ StarTeam Extensions
■ SDK StarTeam
Le disque 1 contient les dossiers suivants :
Dossier Contenu
\Client Les fichiers nécessaires à l’installation du client StarTeam Windows.
\Docs Le jeu de documentation StarTeam, fourni dans le format .PDF pour le consulter en ligne ou l’imprimer.
\MPX Les fichiers nécessaires à l’installation des fonctionnalités complémentaires de StarTeamMPX. (Il se peut que n’ayez pas de licence pour ce produit.)
\Readme Les fichiers readme de StarTeam, qui donnent un aperçu général de tous les produits.
\Server Les fichiers nécessaires à l’installation de StarTeam Server, qui fournit un accès client/serveur aux projets StarTeam.
\StarDisk Les fichiers nécessaires à l’installation de StarDisk, qui améliore l’explorateur de Windows pour inclure le contrôle de version. (Il se peut que n’ayez pas de licence pour ce produit mais vous pouvez le tester.)
\StarTeam SDK Les fichiers nécessaires à l’installation du StarTeam Runtime.
\StarTeamCPWin Les fichiers nécessaires à l’installation du client StarTeam multiplate-forme sous Windows.
\Utility Les fichiers pour certains contrôles courants, pour
MSDE 2000 et pour ODBC, chacun dans son propre dossier.
Vous risquez de devoir les utiliser séparément. Par exemple, supposons que vous installiez d’autres applications logicielles après l’installation de StarTeam et que vous ayez alors des pilotes ODBC ne fonctionnant pas avec StarTeam. Vous risquez de devoir réinstaller les pilotes à partir du dossier Utility.
\Utility\Patched Oracle ODBC Drivers
Correctifs aux pilotes ODBC Oracle, pour un serveur StarTeam utilisant une base de données Oracle.
C o m m e n t c o n t a c t e r l e s se r v i c e s d e s u p p o r t B o r l a n d
Le disque 2 contient les dossiers suivants :
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.
Pour de plus amples informations sur les services de support de Borland, visitez notre site web, à l’adresse http://support.borland.com.
Depuis le 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.
Dossier Contenu
\Docs Le jeu de documentation StarTeam, fourni dans le format .PDF pour le consulter en ligne ou l’imprimer.
\Extras Copies de Guiffy (utilitaire de comparaison et de fusion) et d’OpenMake (utilitaire de conception).
\NotificationAgent Les fichiers nécessaires à l’installation de l’Agent de notification, qui fait partie de StarTeam Extensions. (Il se peut que n’ayez pas de licence pour ce produit mais vous pouvez le tester.)
\Readme Les fichiers readme de StarTeam, qui donnent un aperçu général de tous les produits, y compris la liste de leurs nouvelles caractéristiques.
\StarTeam SDK Les fichiers nécessaires à l’installation du StarTeam Runtime.
\StarTeamCP Les fichiers nécessaires à l’installation du client StarTeam multiplate-forme sur des plates-formes non Windows.
\StarTeamDesigner Les fichiers nécessaires à l’installation du Workflow Designer, qui fait partie de StarTeam Extensions. (Il se peut que n’ayez pas de licence pour ce produit mais vous pouvez le tester.)
\StarTeamExtensions Les fichiers nécessaires à l’installation de StarTeam Extensions. (Il se peut que n’ayez pas de licence pour ce produit mais vous pouvez le tester.)
\StarTeamSDK Les fichiers nécessaires à l’installation de SDK StarTeam.
C o n v e n t i o n s d e l a d o c u m e n t a t i o n
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.
Lorsque cette icône apparaît dans la marge, c’est pour indiquer que la section ou la procédure s’applique uniquement au client StarTeam multiplate-forme. (Si une section ou une procédure s’applique à tous les clients, aucune icône n’apparaît dans la marge.)
Lorsque cette icône apparaît dans la marge, c’est pour indiquer que la section ou la procédure s’applique uniquement au client StarTeam Windows. (Si une section ou une procédure s’applique à tous les clients, aucune icône n’apparaît dans la marge.)
C h a p i t r e
2
Chapitre 2
Installation 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, comme les clients StarTeam Windows et StarTeam multiplate-forme.
Les autres clients utilisent des applications déjà familières pour accéder au serveur.
Par exemple, vous pouvez accéder au serveur depuis l’explorateur de Microsoft Windows avec StarDisk, et depuis les navigateurs web standard avec StarTeam Edition Web. Si vous utilisez une intégration EDI de StarTeam, vous avez accès à StarTeam Server depuis des applications EDI telles que Microsoft Visual Studio .NET et 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 savoir comment utiliser StarTeam Server, veuillez consulter le Guide de l’Administrateur de StarTeam, le Guide d’introduction à StarTeam et l’aide en ligne complète.
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 pour une nouvelle installation”, page 8, et aller ensuite directement à “Installation de StarTeam Server”, page 10.
■ 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. Dans certains cas, vous risquez de devoir mettre à jour les APE (Alternate Property Editors), etc. Voir “Mise à niveau des configurations de serveur”, page 75.
P r i s e e n c h a rg e d e s j e u x d e c a r a c t è re s U n i c o d e p a r S t a r T e a m S e r v e r
Ce chapitre explique également où obtenir des informations détaillées sur l’installation de StarTeamMPX et de StarTeam Extensions.
■ StarTeamMPX est livré avec StarTeam Entreprise Advantage. Il n’est pas disponible avec StarTeam Entreprise ou StarTeam Standard.
■ StarTeam Extensions lui aussi n’est disponible qu’avec StarTeam Entreprise Advantage. Certains fichiers de StarTeam Extensions doivent être archivés dans un projet spécial que vous devez créer sur chaque configuration de serveur utilisant StarTeam Extensions.
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 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. Voir “Configuration système”, page 109, pour de plus amples
informations.
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.
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 huit exemplaires de MSDE. Si vous avez exécuté l’installation à partir d’une version
P r é - i n s t a l l a t i o n p o u r u n e m i s e à n i v e a u
l’installation en fournit au moins deux pour le cas où vous auriez une application utilisant déjà MSDE sur l’ordinateur où StarTeam Server 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.
Bien que MSDE soit livré avec StarTeam Server en tant que base de données par défaut, Borland Software Corporation 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 “Présentation des différences d’encodages”, page 26.
■ Pour les bases de données Oracle, voir “Jeu de caractères de la base de données et StarTeam Server”, page 52.
■ Pour de plus amples informations sur les bases de données DB2, voir “Utilisation d’une base de données IBM DB2 : Présentation”, page 67, et “La connexion à une base de données IBM DB2 modifie la valeur des paramètres régionaux”, page 74.
Pré-installation pour une mise à niveau
Vous pouvez passer directement à StarTeam Server 2005 Release 2 à partir de StarTeam Server 6.0 et 2005.
Cependant, plusieurs étapes avant et après l’installation peuvent être nécessaires. Ne désinstallez pas votre ancienne version de StarTeam Server tant que vous n’avez pas terminé l’installation StarTeam Server 2005 Release 2 et que vous n’êtes pas satisfait par ses performances.
Pour être prêt à entreprendre la mise à niveau de votre StarTeam Server :
1 Relisez les points exposés dans les problèmes de pré-installation pour savoir si certains s’appliquent à votre situation. Voir “Pré-installation pour une nouvelle installation”, page 8.
2 Vous ne pouvez pas installer StarTeam Server pendant que des configurations de serveur s’exécutent. Effectuez l’une des opérations suivantes :
a Pour arrêter une configuration de serveur qui ne s’exécute pas en tant que
I n s t a l l a t i o n d e S t a rT e a m S e r v e r
2 Sélectionnez la configuration de serveur et, sur la barre d’outils, cliquez sur le bouton Arrêter le serveur. L’icône Etat passe de “Exécution” à “Arrêt”, puis à
“Prêt”.
b Si vos configurations de serveur StarTeam s’exécutent en tant que services Windows, vous devez arrêter ces services et modifier le mode d’exécution de StarTeam.
1 Affiche le Panneau de configuration de Windows, en sélectionnant Démarrer > Paramètres > Panneau de configuration.
2 Double-cliquez sur l’icône Services. La boîte de dialogue Services apparaît.
3 Localisez la configuration de serveur StarTeam et cliquez sur Arrêter.
4 Après l’arrêt du service, fermez la boîte de dialogue Services et le Panneau de configuration.
5 Démarrez l’utilitaire Administration du serveur en sélectionnant Démarrer >
Programmes > StarTeam > StarTeam Server x> StarTeam Server. La fenêtre Administration du serveur apparaît.
6 Sélectionnez la configuration de serveur et cliquez sur Retirer le service. La colonne Mode d’exécution passe de “Service” à “Application”.
3 Sauvegardez vos référentiels StarTeam et les autres fichiers du serveur.
Reportez-vous à la documentation de votre version précédente de StarTeam Server pour savoir quels éléments sauvegarder.
4 Si nécessaire, mettez le gestionnaire de votre base de données (SGBDR) au niveau d’une version prise en charge par la nouvelle version de StarTeam Server.
5 La nouvelle version de StarTeam Server doit être installée sur le même ordinateur que la version de StarTeam Server que vous mettez à niveau.
Modifications des fichiers de StarTeam Server
L’ancien fichier starteam-server-configs.xml est copié depuis le dossier d’installation de l’ancienne version de StarTeam Server vers le dossier d’installation de la nouvelle version.
Installation de StarTeam Server
Avant d’installer StarTeam Server, veillez à lire “Pré-installation pour une nouvelle installation”, page 8. Si vous mettez à niveau une version précédente de StarTeam Server, veillez à lire également “Pré-installation pour une mise à niveau”, page 9.
Le programme Setup figurant sur le CD d’installation permet de sélectionner le type d’installation souhaitée. Vous pouvez faire votre choix parmi les types d’installation suivants :
■ Standard
Installe StarTeam Server avec les options les plus courantes. Recommandé à la majorité des utilisateurs. Ces options sont Fichiers programme, Configuration de serveur exemple, MSDE 2000 et Documentation en ligne du serveur.
■ Minimum
Installe StarTeam Server avec le minimum des options nécessaires. Seuls les Fichiers programme sont installés. Choisissez ce type d’installation si vous ne voulez pas utiliser MSDE comme base de données ni installer la configuration de serveur exemple StarDraw.
I n s t a l l a t i o n d e S t a r T e a m S e r v e r
■ Personnalisée
Vous permet de choisir vous-même les options à installer. Recommandé aux utilisateurs expérimentés.
Vous devez effectuer une installation personnalisée si vous voulez que :
■ Les utilisateurs installent le client StarTeam via le réseau à partir de l’ordinateur sur lequel vous avez installé StarTeam Server.
Les fichiers de configuration du client ne font pas automatiquement partie de l’installation du serveur. Si vous cochez la case Installation du client, l’image de StarTeam sur le disque est installée dans le dossier Client Setup, enfant du dossier d’installation de StarTeam Server. Assurez-vous que ce dossier est accessible à tous les membres de l’équipe.
■ Le référentiel de l’exemple StarDraw ne soit pas installé, car il utilise MSDE et que vous n’installez pas une application de cette base de données.
Désélectionnez la case “Configuration de serveur exemple” si vous ne voulez pas installer StarDraw.
L’installation de la configuration de serveur exemple StarDraw pour 2005 Release 2 ne remplace pas une configuration StarDraw existante. Cependant, la configuration de serveur exemple StarDraw dans le fichier
starteam-server-configs.xml de la version 2005 Release 2 fera référence au nouveau StarDraw.
Les autres options que vous pouvez sélectionner (pour les installer) ou
désélectionner (pour les sauter) au cours d’une installation personnalisée sont les suivantes :
■ Fichiers programme
Si vous utilisez l’installation personnalisée pour installer un élément n’ayant pas été installé lors d’une précédente installation de StarTeam Server, vous pouvez désélectionner cette case. Par exemple, supposons que, au cours d’une précédente installation personnalisée, vous ayez choisi de sauter l’installation de MSDE 2000. Maintenant, vous voulez ajouter cette base de données, mais vous ne voulez pas réinstaller tous les fichiers des programmes du serveur, vous ne cocherez donc pas la case Fichiers programme.
■ Documentation en ligne
Normalement, la documentation est installée en même temps que le serveur. Si vous ne voulez pas placer la documentation sur cet ordinateur, supprimez la coche de la case Documentation en ligne.
■ MSDE 2000
MSDE 2000 est une variante de Microsoft SQL 2000 offert gratuitement par Microsoft, pour autant que vous respectiez ses conditions. Il est installé en tant que partie de l’installation standard car il sert de base de données par défaut.
Si vous utilisez exclusivement une base de données de classe entreprise (Microsoft SQL ou Oracle), vous ne serez pas intéressé par l’ajout de ces fichiers à la machine du serveur.
■ MSDE AdminTool
Non installé en tant que partie de l’installation standard, parce que MSDE AdminTool est un outil Microsoft non pris en charge et qu’il nécessite Microsoft Access 2000 Runtime. Vous pouvez soit installer Microsoft Access 2000
P r o b l è m e s d ’ i n s t a l l a t i o n c o n n u s
Si vous sélectionnez cette option, le programme d’installation crée un dossier MSDE AdminTool enfant du dossier d’installation StarTeam Server. Il ajoute les fichiers à ce dossier, ce qui vous permettra d’installer l’outil. Après l’installation de StarTeam Server, vous devrez exécuter le fichier setup.exe du dossier MSDE AdminTool pour installer MSDE AdminTool.
Pour installer StarTeam Server :
1 Fermez toutes les autres applications Windows.
2 Insérez le CD d’installation de StarTeam dans votre lecteur de CD. La fenêtre du Lanceur Borland StarTeam doit apparaître automatiquement.
3 Si le menu d’installation n’apparaît pas automatiquement, affichez-le en suivant les étapes ci-dessous :
a Dans le menu Démarrer de Windows, sélectionnez Démarrer > Exécuter.
b Entrez : x:\setup.exe
où x: est la lettre représentant votre lecteur de CD-ROM.
c Appuyez sur Entrée.
4 Lorsque la boîte de dialogue principale apparaît, cliquez sur Installer StarTeam Server.
5 Suivez les instructions d’installation affichées à l’écran.
6 Après avoir fini d’installer StarTeam Server, vérifiez que les autorisations d’accès au dossier et aux fichiers d’installation de StarTeam Server sont correctement définies.
Le compte Windows de l’administrateur StarTeam doit disposer des autorisations maximales sur le dossier et les fichiers d’installation. Définissez les autorisations Windows pour tous les autres utilisateurs de StarTeam conformément aux usages de votre entreprise en ce domaine. Consultez votre administrateur réseau si vous avez besoin d’aide.
Si vous utilisez l’emplacement par défaut, l’installation de StarTeam Server place les fichiers dans les dossiers suivants, situés sous votre dossier Program Files :
■ Borland\StarTeam Server 2005 R2
Ce dossier et ses sous-dossiers contiennent les exécutables, les DLL et les utilitaires utilisés pour exécuter StarTeam Server. Ce dossier contient aussi le fichier StarTeam_Server_2005_R2_InstallLog.log, qui documente ce qui est arrivé pendant le processus d’installation.
■ Borland\StarTeam SDK 2005 R2
Ce dossier contient StarTeam SDK Runtime qui est nécessaire à la majorité des clients pour accéder à StarTeam Server.
Problèmes d’installation connus
L’installation de MSDE 2000 peut échouer pour cause d’insuffisance des privilèges d’accès au registre. L’erreur ressemble à ceci :
InstallSQLAgentSecurity failed (nom_ordinateur,LocalSystem,203)
La résolution du problème consiste à modifier la sécurité pour la clé HKLM\Software\
Microsoft\Microsoft SQL Server en “Full Control” et de ré-installer ensuite MSDE. Cela peut se faire en utilisant l’éditeur de registre Windows (regedt32).
P o s t - i n s t a l l a t i o n 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
Post-installation pour une nouvelle installation
Si StarTeam Server n’était pas installé auparavant, vous devez exécuter les tâches suivantes avant que les membres de l’équipe puisent commencer à utiliser StarTeam.
Pour commencer à utiliser StarTeam Server : 1 Créez une configuration de serveur.
Pour plus de détails sur la création d’une configuration de serveur, voir le chapitre consacré au type de votre base de données :
■ “Utilisation des bases de données Microsoft SQL Server/MSDE avec StarTeam Server”, page 25
■ “Utilisation d’utilisateurs de schéma Oracle avec StarTeam Server”, page 45 Lorsque vous créez une configuration de serveur, vous définissez des valeurs pour les options session de la configuration ; elles sont stockées dans le fichier
starteam-server-configs.xml. Les options de session spécifient les informations fondamentales nécessaires à StarTeam Server pour démarrer une configuration de serveur.
2 Connectez-vous à cette configuration.
StarTeam Server est livré avec un nom d’utilisateur “Administrator” dont le mot de passe est “Administrator”.
3 Configurez le serveur.
Après la création de la configuration de serveur, vous pouvez définir les options de configuration ; elles sont stockées dans la base de données de la configuration de serveur. Les options de configuration permettent d’optimiser les performances de la configuration de serveur et vous offrent plusieurs fonctionnalités, comme :
■ Les fonctionnalités d’email et d’audit
■ La compression et le chiffrement des données transférées entre le serveur et les stations de travail
4 Créez des projets et des vues.
5 Ajoutez des utilisateurs et des groupes
6 Définissez les droits d’accès appropriés pour la configuration de serveur, le projet et la vue.
7 Si vous le souhaitez, exécutez la configuration de serveur en tant que service Microsoft Windows.
Pour de plus amples informations sur les étapes 3 à 7, consultez le Guide de l’Administrateur de StarTeam.
Post-installation pour une mise à niveau
Si vous mettez à niveau une version précédente de StarTeam Server, faites attention à ce qui suit :
1 Toutes les configurations de StarTeam Server existantes doivent être mises à niveau pour une utilisation avec la dernière version de StarTeam Server.
Reportez-vous au “Mise à niveau des configurations de serveur” on page 75, pour avoir des informations sur la mise à niveau des configurations de serveur et la
E v a l u a t i o n d e S t a r T e a m S e r v e r
3 Voir le StarTeamMPX Server Administrator’s Guide pour plus de détails.
4 Pour avoir les instructions d’installation et de mise à niveau de StarTeam Extensions, reportez-vous au StarTeam Extensions User’s Guide.
Evaluation de StarTeam Server
La première fois que vous exécutez StarTeam Server, une licence d’évaluation est créée pour StarTeam Entreprise Advantage, c’est-à-dire pour l’édition de StarTeam qui possède le plus de fonctionnalités.
Avant la fin des 30 jours d’étude du produit, vous pouvez prolonger la période d’évaluation en contactant Borland Software Corporation à l’adresse
www.borland.com/company/contact/where_to_buy.html pour obtenir une clé de prolongation de l’évaluation.
N’oubliez pas d’enregistrer le produit ou de prolonger la période d’évaluation avant que celle-ci n’expire. Sinon, lorsque des clients accèdent à une configuration de serveur gérée par StarTeam Server, aucun composant (comme le composant Fichier ou le composant Demande de modification) ne sera disponible. Dans les clients StarTeam Windows et multiplate-forme, les volets supérieur et inférieur n’auront pas d’onglet.
Pour prolonger la période d’évaluation de StarTeam Server :
1 Après avoir obtenu une clé de prolongation de l’évaluation, sélectionnez Démarrer >
Programmes > StarTeam > StarTeam Server 2005 R2 > StarTeam Server. La fenêtre Administration du serveur apparaît.
2 Sélectionnez Aide > A propos dans la barre de menus. La boîte de dialogue A propos de StarTeam Server apparaît.
3 Sélectionnez l’élément Licence dans le volet gauche de la boîte de dialogue.
4 Cliquez sur Prolonger l’évaluation. La boîte de dialogue Prolongation de l’évaluation apparaît.
5 Entrez la clé d’évaluation et cliquez sur OK.
6 Fermez la boîte de dialogue A propos de StarTeam Server.
Licences StarTeam Server
StarTeam Server peut être utilisé avec deux types de licences :
■ Une licence StarTeam interne au produit
■ Une licence Borland à utiliser avec des serveurs de licences
Si les utilisateurs de StarTeam essaient d’accéder à une configuration de serveur gérée par une version sans licence de StarTeam Server, les volets supérieur et inférieur de leurs clients StarTeam n’ont pas d’onglet.
L i c e n c e s S t a r T e a m S e r v e r
Utilisation d’une licence StarTeam
Comme les licences de StarTeam Server sont cumulables, vous pouvez entrer plusieurs licences, pourvu que toutes se rapportent à la même édition (Standard, Entreprise ou Entreprise Advantage). Veillez à supprimer la licence d’évaluation avant d’entrer la première licence. Pour de plus amples informations sur les licences, voir
“Présentation des licences”, page 16
Pour obtenir une licence StarTeam Server à partir de l’utilitaire Administration du serveur :
1 Dans le menu Démarrer de Windows, sélectionnez Démarrer > Programmes >
StarTeam > StarTeam Server 2005 R2 > StarTeam Server. L’utilitaire Administration du serveur apparaît.
2 Dans la barre de menus obtenue, sélectionnez Aide > A propos.
3 La boîte de dialogue A propos de StarTeam Server apparaît.
4 Sélectionnez le nœud Licence dans le volet gauche de la boîte de dialogue.
5 Si vous devez entrer une licence, vous devez supprimer la clé d’évaluation.
Sélectionnez cette dernière dans le volet droit de la boîte de dialogue et cliquez sur Supprimer.
6 Cliquez sur Enregistrer. La boîte de dialogue Enregistrement du serveur apparaît.
7 Remplissez correctement les zones de texte Numéro de série et Clé d’accès.
Les numéros de série différencient majuscules et minuscules ; les clés d’accès ne le font pas.
8 Cliquez sur OK.
9 Fermez la boîte de dialogue A propos de StarTeam Server.
Pour entrer la licence d’une version de StarTeam Server depuis la ligne de commande :
■ Sur la ligne de commande, entrez ce qui suit : starteamserver -serial numéro -access clé
Remarques Le numéro de série différencie majuscules et minuscules ; la clé d’accès ne le fait pas.
Vous ne pouvez pas obtenir une licence StarTeam Server si l’une des configurations de serveur s’exécute en tant que service Windows.
Si vous modifiez la licence enregistrée alors qu’un projet StarTeam est ouvert sur la station de travail d’un utilisateur, la modification ne prend effet qu’une fois la fenêtre du projet fermée puis réouverte.
L i c e n c e s S t a r T e a m S e rv e r
Utilisation d’un serveur de licences
Depuis StarTeam 2005 Release 2, vous pouvez utiliser Borland License Server ou FLEXlm avec StarTeam Server. Vous avez ainsi le choix entre utiliser un serveur de licences et utiliser les licences StarTeam incluses dans votre version de StarTeam.
Un administrateur effectue les étapes suivantes :
1 Il reçoit de la part de Borland Software Corporation, par e-mail, les informations relatives à la licence (généralement envoyées par un commercial)
2 Il installe le serveur de licences (la documentation du serveur de licences explique comment faire)
3 Il héberge les licences envoyées par Borland Software Corporation (cela implique l’accès à un site web Borland et le téléchargement de fichiers de licence Borland appelés fichiers d’activation)
4 Il place les fichiers d’activation (.slip) dans le dossier /license, sous-dossier du dossier d’installation de StarTeam Server.
5 Sur le serveur de licences, il assure une configuration adaptée aux utilisateurs prévus (ce sujet est traité dans la documentation du serveur de licences) 6 Avec l’outil StarTeam Administration du serveur, il :
a remplace les noms d’utilisateurs par des noms de connexion au réseau ; b affecte des utilisateurs à des licences spécifiques.
Remarques Si vous utilisez un serveur de licences, les noms de connexion au réseau doivent être identiques aux noms d’utilisateurs StarTeam.
Les fichiers de configuration FLEXlm sur Solaris font la distinction entre majuscules et minuscules.
Au démarrage, StarTeam Server vérifie la présence de fichiers d’activation et si c’est le cas, en stocke les informations en mémoire. Il ne reconnaît les nouveaux fichiers d’activation qu’au redémarrage suivant.
Lorsqu’un utilisateur se connecte depuis une application du client StarTeam, StarTeam Server demande à cette dernière quelles sont les fonctions dont il dispose, sur la base de la licence accordée à cet utilisateur.
Si la licence accordée vient d’un fichier d’activation qui ne se trouve plus dans le dossier de licences, StarTeam Server affiche un message d’erreur. Si le type de licence est Sans attribution, l’utilisateur n’est pas connecté et StarTeam Server renvoie une exception.
Présentation des licences
StarTeam Server peut être exécuté en tant que serveur Standard, Entreprise ou Entreprise Advantage, chacun avec un ensemble différent de fonctionnalités.
■ Standard est l’ensemble de fonctionnalités de base.
■ Entreprise possède toutes les fonctionnalités de Standard plus le composant Tâche, la possibilité de personnaliser les propriétés de n’importe quel composant et le client StarDisk.
■ Entreprise Advantage possède toutes les fonctionnalités d’Entreprise plus le composant Exigence, StarTeamMPX et les éditeurs de propriétés APE qui permettent de créer des formulaires personnalisés et des règles de workflow pour contrôler la façon dont tous les éléments d’un composant passent d’un état à un autre.
U t i l i s a t i o n d e l a c o n f i g u r a t i o n d e s e r v e u r e x e m p l e S t a r D r a w
Le serveur dont vous disposez (ou, plus exactement, les fonctionnalités auxquelles un client peut accéder sur ce serveur) est déterminé par les licences.
Les licences déterminent aussi le nombre d’utilisateurs ayant accès à StarTeam Server. Les utilisateurs peuvent avoir des licences d’utilisateur nommé ou des licences simultanées. Une licence d’utilisateur nommé, parfois appelée licence fixe, ne peut être utilisée que par l’utilisateur auquel elle a été attribuée. Si vous avez, par exemple, 5 licences d’utilisateur nommé et 25 licences simultanées, les 5 utilisateurs ayant reçu les licences d’utilisateur nommé sont assurés d’accéder au serveur. Personne d’autre ne peut utiliser leurs licences.
Une licence simultanée peut être utilisée en l’absence de licence d’utilisateur nommé.
Par exemple, les utilisateurs sans licence d’utilisateur nommé reçoivent des licences simultanées selon le principe du premier arrivé, premier servi. Lorsque toutes les licences simultanées ont été attribuées, les utilisateurs essayant de se connecter sont avertis qu’il n’y a plus de licences disponibles à ce moment. Ils doivent refaire un essai ultérieur.
Lorsque vous enregistrez votre serveur pour la première fois, vous saisissez un ou deux numéros de série : un pour les licences d’utilisateur nommé et/ou un pour les licences simultanées. Lors de l’utilisation de plusieurs numéros de série, ceux-ci doivent tous identifier la même édition de StarTeam. L’édition Standard ne prend en charge que les licences d’utilisateur nommé.
Vous pouvez ajouter des licences d’utilisateur nommé ou des licences simultanées.
StarTeam Server connaît le nombre total en additionnant les licences fournies avec chaque fichier d’activation ou numéro de série. Nous appellerons cela le cumul des licences.
Vous pouvez ajouter ou importer autant d’utilisateurs que vous voulez, mais l’accès au serveur n’est accordé qu’à ceux qui possèdent des licences d’utilisateur nommé ou qui ont reçu des licences simultanées au moment de la connexion.
Si vous avez des licences StarTeam d’utilisateur nommé, vous devez les accorder à des utilisateurs spécifiques dans la boîte de dialogue Gestionnaire des utilisateurs.
L’hypothèse est que tous les autres ont une licence simultanée StarTeam. Voir le Guide de l’Administrateur de StarTeam pour plus de détails.
Si vous avez des licences Borland, vous devez affecter les utilisateurs au fichier d’activation correct dans la boîte de dialogue Gestionnaire des utilisateurs, quelle que soit leur licence d’utilisateur nommé ou simultané. Il est possible d’utiliser un état Sans Attribution à la place d’un fichier d’activation.
L’administrateur de StarTeam Server reçoit automatiquement une licence d’utilisateur nommé qui ne peut être retirée. C’est une licence “gratuite” qui n’est pas comptée dans le nombre des licences d’utilisateur nommé dont vous disposez.
Utilisation de la configuration de serveur exemple StarDraw
StarTeam fournit un exemple de configuration de serveur appelée StarDraw. Il contient un exemple d’application Visual C++ et ses éléments connexes. Il fournit fichiers, demandes de modification, rubriques et tâches. Vous pouvez lire le Guide
d’introduction à StarTeam et utiliser le référentiel exemple pour vous familiariser avec StarTeam et approfondir vos connaissances.
Au cours de la procédure d’installation de StarTeam Server, la configuration de serveur exemple est installée avec l’installation Standard et peut l’être avec l’installation Personnalisée. La procédure d’installation :
I n s t a l l a t i o n d e s a u t r e s c o m p o s a n t s d u s e r v e u r
■ Crée un DSN (Data Source Name) système ODBC portant le nom StarDrawDB80.
■ Ajoute la nouvelle configuration de serveur StarDraw au fichier
starteam-server-configs.xml. Si une précédente configuration de serveur StarDraw est définie dans ce fichier, ses paramètres sont mis à jour avec la nouvelle version de StarDraw.
Important Dans le fichier starteam-server-configs.xml, la valeur prédéfinie de ServerGuid pour le Référentiel StarDraw est :
be5ee3b0-c719-49c6-a1a1-f493764a03f5
Ne modifiez pas cette valeur. La configuration de serveur StarDraw ne démarrerait pas si vous modifiez ServerGuid.
Utilisez la configuration de serveur StarDraw uniquement à des fins d’expérimentation et de formation — jamais pour de véritables données.
Installation des autres composants du serveur
Jusqu’ici, ce chapitre a expliqué comment installer les composants disponibles dans toutes les éditions de StarTeam Server. Les autres rubriques expliquent où trouver les instructions d’installation de StarTeamMPX et de StarTeam Extensions, inclus dans l’édition Entreprise Advantage de StarTeam Server.
Installation de StarTeamMPX
StarTeamMPX est installé et enregistré séparément de StarTeam Server. Accédez au programme Setup de StarTeamMPX sur le CD d’installation de StarTeam. Vous devez installer et enregistrer StarTeam Server avant d’installer StarTeamMPX. Si vous utilisez StarTeamMPX, assurez-vous que vous avez installé l’émetteur d’événements (Event Transmitter), l’émetteur de fichiers (File Transmitter) (pour l’Agent de mise en cache), l’agent de messages (Message broker) et/ou les derniers services de multidiffusion StarTeam (Multicast Services).
Vous ne pouvez pas avoir de licence d’évaluation de StarTeamMPX. Il nécessite une licence d’utilisation. Il est livré avec son propre mécanisme de licences, sans lien avec les licences utilisateur de StarTeam décrites dans “Utilisation d’une licence StarTeam”, page 15.
Pour de plus amples informations sur l’installation de StarTeamMPX, voir le Guide de l’Administrateur de StarTeamMPX.
Installation de StarTeam Extensions
Les fichiers de StarTeam Extensions doivent être installés puis archivés dans le projet d’extensions StarFlow dans chaque configuration de serveur utilisant éditeurs APE (Alternate Property Editors) et workflow.
Pour avoir les instructions d’installation et de mise à niveau de StarTeam Extensions, reportez-vous au StarTeam Extensions User’s Guide.
C h a p i t r e
3
Chapitre 3
Installation des clients StarTeam
Ce chapitre explique comment installer le client StarTeam Windows et le client StarTeam multiplate-forme. Il vous indique également où trouver les instructions d’installation des autres clients StarTeam.
Pour savoir comment utiliser les clients StarTeam Windows ou multiplate-forme, veuillez consulter le Guide de l’utilisateur de StarTeam, le Guide d’introduction à StarTeam et l’aide en ligne complète.
Avant d’installer un client StarTeam
Avant d’installer un produit StarTeam, vérifiez que le système de votre ordinateur répond aux exigences minimales de ce produit. Voir “Configuration système”, page 109, pour de plus amples informations.
Les versions 2005 et 2005 Release 2 des clients StarTeam, Windows et
multiplate-forme, peuvent accéder aux serveurs 2005 et 2005 Release 2. Cela facilite vos mises à niveau du client après l’installation de StarTeam Server 2005 Release 2.
Cependant, les clients 2005 ne bénéficient pas des nouvelles fonctionnalités du serveur 2005 Release 2.
Important Vous devez être administrateur local sur l’ordinateur cible pour installer les produits StarTeam.
Démarrage des utilisateurs avec les mêmes options personnelles
Le programme d’installation de StarTeam copie le fichier
starteam-client-default-options.xml (s’il existe) dans le dossier All Users\Application Data\Borland\StarTeam sur chacune des stations de travail client. Il écrasera tout fichier de ce nom existant à cet emplacement. Ce fichier servira de modèle au nouveau fichier starteam-client-options.xml lorsque chaque utilisateur démarrera un client StarTeam Windows pour la première fois.
I n s t a l l a t i o n d u c l i e n t S t a r T e a m W i n d o w s
Pour fournir à tous les utilisateurs (du client StarTeam Windows) le même ensemble initial d’options personnelles :
1 Effectuez une installation personnalisée de StarTeam Server en sélectionnant la case à cocher Installation du client, de façon à ce que l’image disque de StarTeam soit installée dans le dossier Client Setup, enfant du dossier d’installation de StarTeam Server.
2 Assurez-vous que ce dossier est accessible à tous les membres de l’équipe.
3 Installez le client StarTeam Windows sur un seul ordinateur.
4 Définissez les options personnelles. Pour obtenir des détails, reportez-vous au Guide de l’utilisateur de StarTeam.
5 Notez que vous avez maintenant un fichier nommé starteam-client-options.xml dans le dossier profil utilisateur.
■ Sous Windows NT, il s’agit de C:\winnt\Profiles\user\Application Data\Borland\
StarTeam\.
■ Sous Windows 2000 et XP, il s’agit de C:\Documents and Settings\user\
Application Data\Borland\StarTeam\.
6 Copiez ce fichier dans le dossier Client Setup.
7 Renommez ce fichier starteam-client-default-options.xml.
8 Demandez aux utilisateurs d’installer le client StarTeam Windows.
Installation du client StarTeam Windows
Au lieu d’effectuer l’installation depuis le CD d’installation de StarTeam comme l’explique la procédure ci-après, vous pouvez installer StarTeam via le réseau depuis le dossier Client Setup de l’ordinateur où a été installé StarTeam Server.
Adressez-vous à l’administrateur de StarTeam pour plus de détails.
Important Les utilisateurs doivent avoir les privilèges d’un administrateur sur l’ordinateur où est installé StarTeam pendant le processus d’installation.
Pour installer le client StarTeam Windows :
1 Fermez toutes les applications Windows en cours d’exécution.
2 Insérez le CD d’installation de StarTeam dans votre lecteur de CD. La fenêtre du Lanceur Borland StarTeam doit apparaître automatiquement.
3 Si le menu d’installation n’apparaît pas automatiquement, affichez-le comme suit : a Dans le menu Démarrer de Windows, sélectionnez Démarrer > Exécuter.
b Entrez : x:\setup.exe
où x: est la lettre représentant votre lecteur de CD.
c Cliquez sur OK.
4 Cliquez sur Installer les produits.
5 Cliquez sur Borland StarTeam Clients.
6 Cliquez sur Borland StarTeam Client.
I n s t a l l a t i o n d u c l i e n t S t a r T e a m W i n d o w s
7 Suivez les instructions d’installation affichées à l’écran.
a Dans la boîte de dialogue Introduction, lisez les informations et cliquez sur Suivant.
b Dans la boîte de dialogue Contrat de licence: 1 Lisez le contrat.
2 Sélectionnez le bouton de l’option “J’accepte...”.
3 Cliquez sur Suivant.
c Dans la boîte de dialogue User Information, tapez le nom d’utilisateur et le mot de passe dans les zones de texte appropriées.
d Dans la boîte de dialogue Choix de l’installation:
1 Sélectionnez le bouton Standard, Minimum ou Personnalisée.
■ Standard installe le client StarTeam, ses manuels utilisateur, son aide en ligne et la barre d’outils StarTeam. La barre d’outils stocke les informations de connexion pour faciliter vos connexions. Pour de plus amples
informations, voir le Guide de l’utilisateur de StarTeam.
■ Minimum installe le client StarTeam, ses manuels utilisateur et son aide en ligne.
■ Personnalisée vous permet de choisir ce qui sera installé. C’est la seule façon d’installer l’utilitaire StarTeam Administration à utiliser sur une station de travail client. Lorsque l’utilitaire fait partie du client, vous ne pouvez effectuer qu’une administration du serveur à distance.
2 Cliquez sur Suivant.
e Si vous avez choisi une installation Personnalisée, cochez ou non les cases des éléments que vous voulez ou non installer.
f Dans la boîte de dialogue Choix du répertoire d’installation, saisissez le dossier d’installation ou naviguez jusqu’à son emplacement. (L’emplacement par défaut est C:\Program Files\Borland\StarTeam 2005 R2.)
g Dans la boîte de dialogue Sélection du dossier des raccourcis, utilisez le paramétrage par défaut (le bouton de l’option Autre dont la valeur est C:\
Documents and Settings\All Users\Start Menu\Programs\StarTeam\StarTeam Client 2005 R2).
h Dans la boîte de dialogue Résumé d’installation, effectuez l’une des opérations suivantes :
■ Examinez les paramètres et cliquez sur Installer.
■ Examinez les paramètres et cliquez sur Précédent une ou plusieurs fois afin de redéfinir certains d’entre eux. Puis revenez et cliquez sur Installer.
i Si vous avez installé le client StarTeam multiplate-forme sur cet ordinateur, vous êtes invité à préciser si c’est le client StarTeam Windows qui s’ouvre quand vous utilisez un raccourci StarTeam.
Sélectionnez Oui si le client StarTeam Windows est votre client primaire.
j Dans la boîte de dialogue L’installation est terminée, cliquez sur Terminé.
Le dossier d’installation par défaut est C:\Program Files\Borland\StarTeam 2005 R2\.
Le fichier StarTeam_2005_R2_InstallLog.log de votre dossier d’installation documente ce qui est arrivé pendant le processus d’installation.
I n s t a l l a t i o n d u c l i e n t S t a r T e a m m u l t i p l a t e - f o r m e
Installation du client StarTeam multiplate-forme
Vous pouvez installer le client StarTeam multiplate-forme sous Windows ou sous d’autres systèmes d’exploitation comme Macintosh OS X et les systèmes UNIX.
Installation sous Windows
Pour installer le client StarTeam multiplate-forme sous Windows : 1 Fermez toutes les applications Windows en cours d’exécution.
2 Insérez le CD d’installation dans votre lecteur de CD. La fenêtre du Lanceur Borland StarTeam doit apparaître automatiquement.
3 Si le menu d’installation n’apparaît pas automatiquement, affichez-le comme suit : a Dans le menu Démarrer de Windows, sélectionnez Démarrer > Exécuter.
b Entrez : x:\setup.exe
où x: est la lettre représentant votre lecteur de CD.
c Cliquez sur OK.
4 Cliquez sur Installer les produits.
5 Cliquez sur Borland StarTeam Clients.
6 Cliquez sur Borland StarTeam Cross-Platform Client.
7 Suivez les instructions d’installation affichées à l’écran.
a Dans la boîte de dialogue d’ouverture, sélectionnez une langue dans la liste déroulante, cliquez ensuite sur OK.
b Dans la boîte de dialogue Introduction, lisez les informations et cliquez sur Suivant.
c Dans la boîte de dialogue Contrat de licence: 1 Lisez le contrat.
2 Sélectionnez le bouton de l’option “J’accepte...”.
3 Cliquez sur Suivant.
d Dans la boîte de dialogue Choix de l’installation:
1 Sélectionnez le bouton Standard, Minimum ou Personnalisée.
■ Standard installe le client StarTeam, ses manuels utilisateur, son aide en ligne et la barre d’outils StarTeam. La barre d’outils stocke les informations de connexion pour faciliter vos connexions. Pour de plus amples
informations, voir le Guide de l’utilisateur de StarTeam.
■ Minimum installe le client StarTeam, ses manuels utilisateur et son aide en ligne.
■ Personnalisée vous permet de choisir ce qui sera installé. C’est la seule façon d’installer l’utilitaire StarTeam Administration à utiliser sur une station de travail client. Lorsque l’utilitaire fait partie du client, vous ne pouvez effectuer qu’une administration du serveur à distance.
2 Cliquez sur Suivant.
