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>