Schnell & einfach: Zwei Standard-Repositorys auf einem DB-Server einrichten

Stand: Release 1.0.x

Eine typische Situation: Man hat x-plant auf einen oder mehreren Arbeitsplätzen installiert, dort in Betrieb genommen und alles funktioniert einwandfrei. Ist ein lokales Netzwerk vorhanden, möchte man dies natürlich nutzen und nicht nur die Dateiablage auf einem Server durchführen, sondern in aller Konsequenz auch das Datenmanagement von x-plant zentral einrichten. Dies bedeutet, dass der mitgelieferte SQL Server 2000 und die benötigten Datenbanken (=Repositorys) ebenfalls auf einem geeigneten Server-PC im Netzwerk installiert und eingerichtet werden müssen.

In der der Regel reichen auch bei diesem Szenario zwei Repositorys auf dem Server zunächst vollkommen aus: "Projekte SERVER" und "Kataloge SERVER".

Bitte klären Sie vor der Installation die folgenden Punkte, ggf. kontaktieren Sie dazu Ihren IT-Administrator:

- Sie benötigen am Server-PC lokale Administrator-Rechte für die Installation des SQL Servers
- Damit die Kommunikation mit dem zentralen SQL Server reibungslos funktioniert, dürfen im lokalen Netzwerk keine TCP- und UDP-Ports durch Firewalls gesperrt sein. Eine Übersicht über die im Umfeld von x-plant verwendeten Ports erhalten Sie im Anhang.

Unter diesen Voraussetzungen ist die Einrichtung ein recht einfaches Unterfangen, das hier nun beschrieben wird:


1. .SQL Server 2000 von der x-plant CD auf dem Server-PC installieren. Danach den Server neu starten oder alternativ den SQL Server Dienst manuell starten (Dienstname: MSSQL$XPLANTLOCAL).

Den Dienst manuell starten:
Den Dienst-Manager finden Sie am Server-PC unter Start/Systemsteuerung/Verwaltung/Dienste. Wählen Sie den Dienst in der Dienstliste an, klicken Sie ihn mit der rechten Maustaste an und wählen Sie im Kontextmenü das Kommando "Starten".

 
WICHTIG:
a) Das .NET-Framework und x-plant müssen NICHT auf dem Server installiert werden!
b) Vorher bitte eine vorhandene Installation der SQL Servers 2000 Desktop Engine entfernen! Auch das Programmverzeichnis C:\Programme\Microsoft SQL Server\MSSQL$XPLANTLOCAL komplett löschen, wenn es danach noch existiert!
 

2. Das Verzeichnis
 
C:\x-plant\metadata\repository\rdbms\sqlserver2k\scripts
 
von einer x-plant Arbeitsstation auf den Server kopieren (als Kopie). Es kann sich auf dem Server an einem beliebigen Ort befinden, es muss also nicht derselbe Verzeichnisbaum übernommen werden.
 

3. Am Server in der Kopie des
scripts-Verzeichnisses die beiden Batchdateien
 
createcatalogrepository.bat
createprojectrepository.bat
 
ausführen (Doppelklick). Dies sollte jeweils eine kurze Weile dauern (ohne Fehlermeldungen!).


4. Den Repository-Index erweitern (eine exemplarische erweiterte Index-Datei ist im Anhang abgebildet).

Im Verzeichnis C:\x-plant\config die Datei RepositoryIndex.xml öffnen (mit Texteditor).

Die beiden vorhandenen
<Repository>-"Blöcke" kopieren (unmittelbar vor den End-Tag </XPCRepositoryIndexDataSet> einfügen) und in den neuen "Blöcken" die Anpassungen für die neuen Repositorys vornehmen (Beschreibung je Repository):

A. Zwischen den Tags
<Name> einen Klartext-Namen für das neue Repository eintragen. Mit diesem Namen erscheint das Repository später in den Auswahllisten der x-plant Module. Dieser Name muss nicht mit dem Namen der zugrunde liegenden Datenbank übereinstimmen.

B. Zwischen den Tags
<DBHost> den Begriff (local) durch die IP-Adresse bzw. den Netzwerknamen des Server-PC ersetzen.

C. Die Datei speichern.

WICHTIG:
Die geänderte Datei
RepositoryIndex.xml muss anschließend auf alle x-plant Arbeitsplätze verteilt werden (in das Verzeichnis C:\x-plant\config), die ebenfalls auf die neuen Repositorys Zugriff erhalten sollen.

 
5. Das Verzeichnis
 
C:\x-plant\data
 
von einer x-plant Arbeitsstation auf den Server kopieren (einheitliches Server-Laufwerk aus der Sicht der Clients!).

Im Verzeichnis C:\x-plant\config die Datei xplantconfig.xml öffnen (mit Texteditor).

Hier den Eintrag

 
<DataPath>C:\x-plant\data</DataPath>
 
auf das neue Server-Verzeichnis (s.o.) anpassen.

WICHTIG:
Die geänderte Datei
xplantconfig.xml muss anschließend auf alle x-plant Arbeitsplätze verteilt werden (in das Verzeichnis C:\x-plant\config), die ebenfalls auf die neuen Repositorys Zugriff erhalten sollen.
 

 
6. Mit x-plant Catalog die beiden neuen Repositorys auf dem Server einmalig komplett reinitialisieren (von einem beliebigen Client aus).
 
 
7. Die neuen Server-Repositorys können nun verwendet werden.

_________________________________


Ihr x-plant Team.


Anhang 1

TCP- und UDP-Ports, die von x-plant und dem SQL Server 2000 für eine einwandfreie Funktion benötigt werden.

Für x-plant:

TCP-Port 8085
TCP-Port 8086
TCP-Port 8090
TCP-Port 8091

Für SQL Server 2000:

UDP-Port 1434

TCP-Port ... (diesen bitte wie unten beschrieben ermitteln)

TCP-Port des SQL-Servers ermitteln

Auf dem Rechner mit dem installierten SQL Server über Start/Ausführen... das Programm SVRNETCN.EXE starten (eintippen und <Return>).

Es erscheint ein Dialog.



Hier zunächst die Instanz auswählen (sofern mehrere existieren). Danach in der rechten Liste das Protokoll TCP/IP selektieren und die Schaltfläche Eigenschaften... bzw. Properties... betätigen. Jetzt wird die verwendete Portnummer angezeigt (bitte notieren).

Alle Dialoge wieder verlassen.


Anhang 2

Eine erweiterte RepositoryIndex.xml Datei (die neuen Abschnitte sind fett geschrieben, der Server-PC heißt hier MYSERVER)

<?xml version="1.0" encoding="UTF-8"?>
    <
XPCRepositoryIndexDataSet xmlns="urn:schemas-xplant-com:repositoryindex" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:schemas-xplant-com:repositoryindex xplantrepositoryindex.xsd" version="0.1">
        <Repository>
            <Name>Kataloge</Name>
            <DataProvider>SQL</DataProvider>
            <RDBMS>SQL Server</RDBMS>
            <RDBMSWithVersion>SQL Server 2000</RDBMSWithVersion>
            <DBHost>(local)\xplantlocal</DBHost>
            <DBName>xpCatalogs</DBName>
            <DBUser>xplantuser1</DBUser>
            <DBPassword>xplantuser1</DBPassword>
            <DBTimeout>60</DBTimeout>
            <DBSecurity/>
            <DBConnectionPoolSize>5</DBConnectionPoolSize>
        </Repository>
        <Repository>
            <Name>Projekte</Name>
            <DataProvider>SQL</DataProvider>
            <RDBMS>SQL Server</RDBMS>
            <RDBMSWithVersion>SQL Server 2000</RDBMSWithVersion>
            <DBHost>(local)\xplantlocal</DBHost>
            <DBName>xpProjects</DBName>
            <DBUser>xplantuser1</DBUser>
            <DBPassword>xplantuser1</DBPassword>
            <DBTimeout>60</DBTimeout>
            <DBSecurity/>
            <DBConnectionPoolSize>5</DBConnectionPoolSize>
        </Repository>
        <Repository>
            <Name>Kataloge SERVER</Name>
            <DataProvider>SQL</DataProvider>
            <RDBMS>SQL Server</RDBMS>
            <RDBMSWithVersion>SQL Server 2000</RDBMSWithVersion>
            <DBHost>MYSERVER\xplantlocal</DBHost>
            <DBName>xpCatalogs</DBName>
            <DBUser>xplantuser1</DBUser>
            <DBPassword>xplantuser1</DBPassword>
            <DBTimeout>60</DBTimeout>
            <DBSecurity/>
            <DBConnectionPoolSize>5</DBConnectionPoolSize>
        </Repository>
        <Repository>
            <Name>Projekte SERVER</Name>
            <DataProvider>SQL</DataProvider>
            <RDBMS>SQL Server</RDBMS>
            <RDBMSWithVersion>SQL Server 2000</RDBMSWithVersion>
            <DBHost>MYSERVER\xplantlocal</DBHost>
            <DBName>xpProjects</DBName>
            <DBUser>xplantuser1</DBUser>
            <DBPassword>xplantuser1</DBPassword>
            <DBTimeout>60</DBTimeout>
            <DBSecurity/>
            <DBConnectionPoolSize>5</DBConnectionPoolSize>
        </Repository>
</
XPCRepositoryIndexDataSet>