Creating a Repository

GraphDB EE edition supports master and worker repositories. The master keeps a log of the recent transactions, while all workers keep a full copy of the repository data. For more information, see how GraphDB EE works.

Create a worker

There are two ways for creating and managing repositories: either through the Workbench interface, or by using the RDF4J console.

Using the Workbench

To manage your repositories, go to Setup -> Repositories. This opens a list of available repositories and their locations.

  1. Click the Create new repository button or create it from a file by using the configuration template that can be found at configs/templates/.

    _images/createRepository.png
  2. Select GraphDB EE worker.

    _images/select-repo-type-worker-ee.png
  3. Enter the Repository ID (e.g., repository1) and leave all other optional configuration settings with their default values.

    Tip

    For repositories with over several tens of millions of statements, see the configuration parameters.

  4. Click the Create button. Your newly created repository appears in the repository list.

Note

Make sure the location where you want to create the repository is active.

Using the RDF4J console

Note

Use the create command to add new repositories to the location to which the console is connected. This command expects the name of the template that describes the repository’s configuration.

  1. Run the RDF4J console application, which resides in the /bin folder:

    console.cmd (Windows)
    ./console (Unix/Linux)
    
  2. Connect to the GraphDB server instance using the command:

    connect http://localhost:7200.
    
  3. Create a worker using the command:

    create worker.
    
  4. Fill in the values of the parameters in the console.

  5. Exit the RDF4J console:

    quit.
    

Create a master

  1. Go to Setup -> Repositories.

  2. Click Create new repository.

  3. Select GraphDB EE Master.

    _images/select-repo-type-master-ee.png
  4. Enter the Repository ID (e.g., repository1). The Repository description field is optional.

If you are creating the master with the RDF4J console, use the configuration template called master.ttl in the /templates folder of the GraphDB distribution.

Initialize a master

  • If the machine where the master is installed has a GraphDB Workbench deployed, the latter will initialize the master.

  • If you are not using the RDF4J console for initialization, you have to initialize the master yourself by using two methods: either connecting to it in the Workbench, or, if the machine where the master is installed does not have a GraphDB Workbench deployed, by executing the command:

    curl http://localhost:7200/repositories/masterID/size
    

This operation ensures that the master appears in the JMX interface.

Manage repositories

Select a repository

  • Connect the newly created repository to the active location.

    _images/connect_to_repo.png
  • Alternatively, use the dropdown menu in the top right corner. This allows you to easily switch between repositories while running queries or importing and exporting data in other views.

    _images/selectRepository.png

Make it a default repository

Use the pin to select it as a default repository.

_images/default-repo-pin.png

Edit a repository

To copy the repository URL, edit it, download the repository configuration as a Turtle file, restart it, or delete it, use the icons next to its name.

_images/repo-actions.png

Warning

Once a repository is deleted, all data contained in it is irrevocably lost.

You can restart a repository without having to restart the entire GraphDB instance. There are two ways to do that:

  • Click the restart icon as shown above. A warning will prompt you to confirm the action.

  • Click the edit icon, which will open the repository configuration. At its bottom, tick the restart box, save, and confirm.

_images/restart-repo.png

Warning

Restarting the repository will shut it down immediately, and all running queries and updates will be cancelled.