Neues x-plant Repository anlegen und einrichten

Stand: Release 1.0.x

Nach der Installation von x-plant werden standardmäßig zwei Repositories (=Datenbanken) angelegt: "Kataloge" und "Projekte". Im Falle einer Netzwerk-Installation oder wenn die vorhandenen Repositorys nicht ausreichen, können jederzeit weitere Repositorys in beliebiger Anzahl hinzugefügt werden.

Das Anlegen und Einrichten eines Repositories gliedert sich in 4 Schritte:

1. Voraussetzungen schaffen
2. SQL-Datenbank erzeugen und einrichten
3. Neues Repository bzw. SQL-Datenbank im Repository-Index von x-plant aufnehmen
4. Neues Repository initialisieren

1. Voraussetzungen schaffen

Das Erzeugen von SQL-Datenbanken setzt natürlich voraus, dass auf dem jeweiligen Computer bereits eine Instanz von Microsoft SQL Server 2000 (mit Service Pack 3 oder höher) installiert und in Betrieb genommen wurde. Dies kann die mit x-plant gelieferte und kostenfreie Desktop-Version des SQL Server 2000 sein oder jede andere kommerziell verfügbare Version (Standard, Enterprise, usw.).

Handelt es sich um die mit x-plant gelieferte Desktop-Version des SQL Server 2000, müssen die geringsten vorbereitenden Maßnahmen durchgeführt werden. Auf die Unterschiede zu anderen bzw. bereits vorhandenen SQL Server 2000 Installationen gehen wir an den jeweiligen Stellen im Text mit einem farblich hervorgehobenen Hinweis ein.

Das .NET-Framework von Microsoft, das für die x-plant Module eine notwendige Grundlage darstellt, ist für den Betrieb des Microsoft SQL Server 2000 nicht notwendig. Wenn Sie also einen dedizierten Rechner bzw. Server für die Aufnahme der Repositories einrichten (auf dem sonst keine weiteren x-plant Module installiert werden sollen), muss das .NET-Framework nicht installiert sein. Es darf jedoch installiert sein, da es die Lauffähigkeit von Microsoft SQL Server 2000 in keiner Weise beeinflusst bzw. einschränkt.

Wird bzw. ist der MS SQL Server 2000 auf einem Rechner bzw. Server installiert, auf dem sonst keine x-plant Module installiert sind, muss dieser Rechner von den x-plant Arbeitsplätzen über das lokale TCP/IP-Netzwerk erreichbar sein - entweder über seine IP-Adresse oder (besser) über seinen Host- bzw. DNS-Namen.

2. SQL-Datenbank erzeugen und einrichten

Das Erzeugen einer neuen SQL-Datenbank geschieht normalerweise von einer x-plant Arbeitsstation aus, da hier bereits alle benötigten Dateien vorhanden sind. Diese Dateien befinden sich bei einer Standard-Installation im Verzeichnis

C:\x-plant\metadata\repository\rdbms\sqlserver2k\scripts

2.1. SQL-Scriptdatei anpassen

Zunächst erzeugen Sie von der Dateivorlage createrepository_template.sql eine Kopie und benennen sie passend (z.B. createrepository_projects2.sql).

Die neue Scriptdatei mit einem Texteditor (z.B. Notepad von Windows) öffnen und folgende Änderungen vornehmen:

I. Den Namen der neuen Datenbank festlegen. Dazu alle Vorkommen von <NAME> mit dem Namen der neuen Datenbank ersetzen (z.B. xpProjects2). Dieser Name darf bisher noch nicht für andere Datenbanken verwendet worden sein. Hierzu am besten die Suchen&Ersetzen-Funktion des Editors verwenden.

II. Die neue Scriptdatei speichern.

2.2. Batchdatei anpassen

Zunächst erzeugen Sie von der Dateivorlage createrepository_template.bat eine Kopie und benennen sie passend (z.B. createrepository_projects2.bat).

Die neue Batchdatei mit einem Texteditor (z.B. Notepad von Windows) öffnen und folgende Änderungen vornehmen:

I. Alle Vorkommen von -S(local)\xplantlocal in -S<HOST>\xplantlocal ändern.

<HOST> durch die IP-Adresse bzw. den Netzwerknamen des Server-PC ersetzen (z.B. -SMyServer\xplantlocal)

WICHTIG: Wenn es sich um einen von der x-plant CD lokal installierten SQL Server 2000 handelt (x-plant und DB-Server auf demselben Rechner), brauchen Sie diese Änderung nicht durchzuführen!

xplantlocal ist der Instanzname des SQL Servers, wenn er von der x-plant CD installiert wurde (Desktop-Edition). Dieser muss ebenfalls angepasst werden, wenn eine andere bzw. bereits vorhandene Instanz eines Microsoft SQL Server 2000 verwendet werden soll (z.B. -SMyServer\sqlinstance1). Bitte kontaktieren Sie ggf. den zuständigen DB-Administrator, um diese Angaben zu erhalten.

II. Den Platzhalter <SQLTEMPLATE> in der 1.Zeile mit dem Namen der neuen SQL-Scriptdatei (siehe 2.1.) ersetzen (z.B. -icreaterepository_projects2.sql).

III. Den Namen der neuen Datenbank festlegen (siehe auch 2.1. / I.). Dazu alle Vorkommen von <NAME> mit dem Namen der neuen Datenbank ersetzen (z.B. xpProjects2). Dieser Name darf bisher noch nicht für andere Datenbanken verwendet worden sein. Hierzu am besten die Suchen&Ersetzen-Funktion des Editors verwenden.

IV. Die neue Batchdatei speichern.

Die Batchdatei verwendet den Standardbenutzer sa und ein eigenes Passwort für den Zugriff auf den SQL Server 2000. Dies muss ebenfalls angepasst werden, wenn ein bereits vorhandener SQL Server 2000 verwendet wird.

2.3. Batchdatei ausführen

Nun wird die neu erzeugte Batchdatei aus 2.2. ausgeführt (z.B. Doppelklick im Windows Explorer). Es erscheint ein Kommandozeilen-Fenster, in dem nun verschiedene Ausgaben erfolgen. Der Vorgang dauert einige Sekunden bzw. bis zu einer halben Minute (je nach Hardware- und Netzwerkbedingungen). Bitte nicht mit CTRL-C o.ä. abbrechen!
Nach Beendigung der Kommandos wird das Kommandozeilen-Fenster wieder geschlossen.

Sollten später Probleme beim Betrieb des neuen Repositorys auftreten, kann es daran liegen, dass bereits beim Ablauf dieser Batchdatei Fehler aufgetreten sind. Dies kann mit Hilfe der erzeugten .LOG-Dateien überprüft werden. Diese befinden sich im o.g. Verzeichnis und können mit einem Text-Editor eingesehen werden.
Senden Sie uns ggf. diese .LOG-Dateien (bitte auf Datum und Uhrzeit achten) zu, damit wir Ihnen bei der Fehlersuche helfen können.

3. Neues Repository bzw. SQL-Datenbank im Repository-Index von x-plant aufnehmen

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

Einen der vorhandenen <Repository>-"Blöcke" kopieren (unmittelbar vor den End-Tag </XPCRepositoryIndexDataSet> einfügen) und in den neuen "Block" die Anpassungen für das neue Repository vornehmen:

1. 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.

2. Zwischen den Tags <DBHost> den Begriff (local) durch die IP-Adresse bzw. den Netzwerknamen des Server-PC ersetzen (siehe 2.2. / I.).
WICHTIG: Wenn es sich um einen von der x-plant CD lokal installierten SQL Server 2000 handelt (x-plant und DB-Server auf demselben Rechner), brauchen Sie diese Änderung nicht durchzuführen!

xplantlocal ist der Instanzname des SQL Servers, wenn er von der x-plant CD installiert wurde (Desktop-Edition). Dieser muss ebenfalls angepasst werden, wenn eine andere bzw. bereits vorhandene Instanz eines Microsoft SQL Server 2000 verwendet werden soll (z.B. MyServer\sqlinstance1). Bitte kontaktieren Sie ggf. den zuständigen DB-Administrator, um diese Angaben zu erhalten.

3. Zwischen den Tags <DBName> den Datenbank-Namen des neuen Repositorys eintragen (siehe auch 2.1. I.). Diesen Namen bitte nicht mit dem o.g. (1.) Klartext-Namen verwechseln!

4. 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 das neue Repository Zugriff erhalten sollen.

4. Neues Repository initialisieren

x-plant Catalog auf einer x-plant Arbeitsstation starten und mit dem Kommando Extras/Repository (re)initialisieren das neue Repository (es sollte nun in der Liste erscheinen) initialisieren. Dazu bitte rechts alle 4 Optionen auswählen!

Das neue Repository steht nun voll zur Verfügung und es können dort weitere Projekte, Kataloge, Rohrleitungsspezifikationen und CAD-Bibliotheken angelegt bzw. importiert werden.

_________________________________

Ihr x-plant Team.