Installation der CAVE

Entpacken

Sobald Sie die CAVE heruntergeladen haben, finden Sie eine .zip-Datei welches Sie mit einem Packprogramm entpacken können. Beispiele hierfür sind:

• Windows integriertes Packprogramm "extrahieren"
• 7Zip
• WinRAR

Wir übernehmen keine Garantie für jeweilig genutzte Packprogramme!

Wählen Sie einen geeigneten Standort zum entpacken des Programms. Eine direkte Installation ist nicht nötig.

Die entpackte Dateistruktur wird wie folgt aufgebaut sein:

| - ekkoCAVE.exe (.exe-Datei)
| - ekkoCAVE_Data/ (Ordner)
| - docker-compose.yml (.yml-Datei)

Weitere Dateien wie Ordner oder Dateien (.dll/.exe) können enthalten sein.

Die Installation der ekkoCAVE ist nun abgeschlossen. Falls Sie Speckle bereits installiert und konfiguriert haben, können Sie mit der Konfiguration der CAVE beginnen

Speckle Server

Damit Modelle in der CAVE dargestllt werden können, benötigen Sie einen Speckle-Server.

Speckle ist eine Open-Source Plattform, die es Architekten, Ingenieuren und Bauexperten ermöglicht, ihre Bauprojektdaten miteinander zu teilen.

Es funktioniert wie eine Art Übersetzer, der verschiedene Softwareprogramme verbindet und es den Benutzern ermöglicht, ihre 3D-Modelle und Zeichnungen einfach und reibungslos auszutauschen.

Die CAVE dockt sich genau daran an, um Ihre Modelle so schnell wie möglich aus verschiedenen Programmen darzustellen.

Sie können sich entweder hierzu einen eigenen Speckle-Server kostenlos auf Ihrem PC einrichten oder einen Speckle Server bei Speckle mieten.

Zu Beginn empfehlen wir die Einrichtung auf dem eigenen PC da dies ohne weitere Kosten möglich ist.

Sollten Sie eine größere Kollaborationsstruktur benötigen, indem z.B. mehrere Teams auf den Speckle Server zugreifen sollen, empfehlen wir langfristig das Mieten oder Hosten eines eigenen Speckle Servers.

Öffentlichen Speckle Server nutzen

Wenn Sie keinen eigenen Server bereitstellen oder mieten möchten, können Sie auch den offiziellen, öffentlichen Speckle Server nutzen.

Diesen finden Sie unter https://speckle.xyz/.

Hier entstehen zwar keine Kosten, jedoch liegen Ihre Daten auf fremden, von Ihnen unkontrollierbaren Servern weshalb wir empfehlen keine sensitiven Daten dort hochzuladen!

Sollten Sie sich dennoch dazu entscheiden, navigieren Sie zu https://speckle.xyz/ und springen Sie zu Schritt "Speckle Nutzer konfigurieren".

Eigene Installation von Speckle

Innerhalb der entpackten Dateistruktur befindet sich eine fertig konfigurierte Docker-Compose-Datei. Hiermit können Sie sich selbstständig einen Speckle Server auf Ihrem Computer bereitstellen.

Docker installieren

Besuchen Sie die offizielle Docker-Website (https://www.docker.com) und laden Sie die passende Version von Docker Desktop herunter. Befolgen Sie die Installationsanweisungen, um Docker erfolgreich auf Ihrem Computer zu installieren.

Öffnen Sie nun Docker-Desktop und warten Sie bis das Programm bereit ist. Dies ist zu erkennen am unteren, linken, Bereich im Programm an einer grünen Leiste.

Docker-Compose starten

Navigieren Sie nun in Ihren CAVE-Ordner und öffnen Sie eine Kommandozeile.

(Windows: Rechtsklick -> Kontextmenü -> In Terminal öffnen)

Geben Sie nun folgendes Kommando in die Kommandozeile ein:

docker-compose up -d

Warten Sie bis das Kommando erfolgreich abschlossen hat.

Lokales Speckle öffnen

Öffnen Sie folgende URL in einem Browser:

http://localhost:5002

Speckle Nutzer konfigurieren

Registrieren Sie sich einen eigenen Account.

Hinweis: Sie registrieren sich hierbei in einer Anwendung welche sich lokal auf Ihrem PC befindet, daher werden keine Daten an dritte gesendet oder zugänglich gemacht!

Sie sind nun erfolgreich in ihrem Speckle-Server eingeloggt!

Erstellen eines Streams

Erstellen Sie nun einen neuen Stream und vergeben Sie einen entsprechenden Namen.

Sie haben nun alles vorbereitet um diesen Stream später von Ihrer CAVE abzurufen.

Dieser Stream ist jedoch noch leer, weshalb Sie nun ein Modell in diesen hochladen sollten. Eine Beschreibung hierzu finden Sie je nach Ihrem Tool unter https://speckle.systems/features/connectors/.