Guide d installation StarTeam
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................ 8 Pré-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.......... 19 Dé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 Terminologie employée pour les bases de données Microsoft................ 26 Connexion aux bases de données.......... 26 Présentation des différences d encodages...... 26 Utilisation d une base de données MSDE : Présentation.................... 27 Utilisation 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....................... 45 Connexion à 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 Création des DSN ODBC pour Oracle...... 61 Création et démarrage d une configuration de serveur pour un utilisateur de schéma Oracle. 62 i
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....... 76 Mise à 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..................... 83 Pré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....................95 Synchronisation 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...97 Sauvegarde 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..... 109 Systè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 ii
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 iii
iv
Chapitre 1 1Jeu de documentation StarTeam Chapitre 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 Le Guide de l Administrateur de StarTeam explique comment configurer et maintenir StarTeam Server, comment créer et maintenir les objets StarTeam comme les projets et les vues, et comment gérer les accès des utilisateurs. Ce manuel contient aussi des instructions sur l utilisation de StarTeam Server avec les archives de fichiers PVCS et Visual SourceSafe existantes. Chapitre 1 : Jeu de documentation StarTeam 1
Documentation en ligne StarTeam 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. Nom du fichier admin.pdf adminmpx.pdf extensions.pdf install.pdf newfeatures.pdf stardisk.pdf start.pdf user.pdf Manuel StarTeam Guide de l Administrateur de StarTeam StarTeamMPX Administrator s Guide StarTeam Extensions User s Guide Guide d installation de StarTeam Guide des nouvelles fonctionnalités de StarTeam StarDisk User s Guide (client StarTeam Windows uniquement) Guide d introduction à StarTeam Guide de l utilisateur de StarTeam 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. 2 Guide d installation de StarTeam
Contenu des CD d installation de StarTeam 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 \Client \Docs \MPX \Readme \Server \StarDisk \StarTeam SDK \StarTeamCPWin \Utility \Utility\Patched Oracle ODBC Drivers Contenu Les fichiers nécessaires à l installation du client StarTeam Windows. Le jeu de documentation StarTeam, fourni dans le format.pdf pour le consulter en ligne ou l imprimer. 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.) Les fichiers readme de StarTeam, qui donnent un aperçu général de tous les produits. Les fichiers nécessaires à l installation de StarTeam Server, qui fournit un accès client/serveur aux projets StarTeam. 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.) Les fichiers nécessaires à l installation du StarTeam Runtime. Les fichiers nécessaires à l installation du client StarTeam multiplate-forme sous Windows. 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. Correctifs aux pilotes ODBC Oracle, pour un serveur StarTeam utilisant une base de données Oracle. Chapitre 1 : Jeu de documentation StarTeam 3
Comment contacter les services de support Borland Le disque 2 contient les dossiers suivants : Dossier \Docs \Extras \NotificationAgent \Readme \StarTeam SDK \StarTeamCP \StarTeamDesigner \StarTeamExtensions \StarTeamSDK Contenu Le jeu de documentation StarTeam, fourni dans le format.pdf pour le consulter en ligne ou l imprimer. Copies de Guiffy (utilitaire de comparaison et de fusion) et d OpenMake (utilitaire de conception). 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.) 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. Les fichiers nécessaires à l installation du StarTeam Runtime. Les fichiers nécessaires à l installation du client StarTeam multiplate-forme sur des plates-formes non Windows. 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.) 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.) Les fichiers nécessaires à l installation de SDK StarTeam. 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. 4 Guide d installation de StarTeam
Conventions de la documentation Conventions de la documentation La documentation StarTeam utilise les conventions suivantes. Choisissez Fichier > Quitter Police à espacement fixe italique Gras 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. Le texte apparaissant en police Courier représente les informations que vous devez taper et les messages provenant du système. 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. 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.) Remarque Astuce Important Attention Identifie des informations supplémentaires. Identifie des informations sur des procédures alternatives, ou d autres informations utiles mais non essentielles. Identifie des informations essentielles à l accomplissement d une tâche. Identifie des actions pouvant provoquer une perte de données, ou les procédures devant être suivies pour ne pas perdre de données. Chapitre 1 : Jeu de documentation StarTeam 5
6 Guide d installation de StarTeam
Chapitre 2 2Installation de StarTeam Server Chapitre 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. Chapitre 2 : Installation de StarTeam Server 7
Prise en charge des jeux de caractères Unicode par StarTeam Server 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 Remarque 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. 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 téléchargée de StarTeam Server, vous avez deux exemplaires. Un suffit ; 8 Guide d installation de StarTeam
Pré-installation pour une mise à niveau 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 service : 1 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. Chapitre 2 : Installation de StarTeam Server 9
Installation de StarTeam Server b 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. 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. 10 Guide d installation de StarTeam
Installation de StarTeam Server 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 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. Chapitre 2 : Installation de StarTeam Server 11
Problèmes d installation connus 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 : c x:\setup.exe où x: est la lettre représentant votre lecteur de CD-ROM. 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 : Problèmes d installation connus 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. 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). 12 Guide d installation de StarTeam
Post-installation pour une nouvelle installation 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 création des répertoires de stockage pour les espaces de stockage Native-II. 2 Si vous utilisez StarTeamMPX, assurez-vous que vous avez installé les derniers émetteurs StarTeam, le dernier Agent de messages StarTeam et/ou les derniers Services de multidiffusion StarTeam. Chapitre 2 : Installation de StarTeam Server 13
Evaluation de StarTeam Server 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. Licences StarTeam Server 5 Entrez la clé d évaluation et cliquez sur OK. 6 Fermez la boîte de dialogue A propos de 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. 14 Guide d installation de StarTeam