Example Database

In this section we will locate an example database, launch a local server attached to the database, and then open a web browser that points to the server.

Your EnSight install includes an example database in the following location:

$CEI_HOME/nexus193/examples/documentation_database/documentation_examples.zip


(where CEI_HOME points to the installation directory of EnSight. The default on Windows is: C:\Program Files (x86)\CEI).

Copy the database example from your install location to a directory where you can read and write. Unzip the file. You will see a folder named “documentation_examples” that contains three items:

  • db.sqlite3
  • manage.py
  • media


The db.sqlite3 file is your Nexus database. The other files are used internally by Nexus.

Now we need to start the local Nexus server on a specified port number, and point it to the db.sqlite3 file. Open a command prompt / shell, and type:


nexus_template_editor


This will launch an application that control the templates for the Nexus reports.



You can use this application to launch a Nexus server and connect it to the example database. Go into Tools -> Launch local Nexus server...


This will pop up the following widget, asking if the server should be shut down when you quit EnSight. If you answer No, Nexus will remain running and accessible by your web browser even after you quit the application. Select "No".



Now browse for the db.sqlite3 file and choose it. Click OK in the subsequent dialog to use the default port of 8000.


The result should be the successful dialog shown below.


Click on the link in the above dialog to open a web browser.

Congratulations! You have just started your first Nexus instance. You have successfully started a Nexus server on your machine and connected it to a database. Now you can browse the data that is in this sample database from within your default web browser as shown below.