Skip to main content
Pentaho Documentation

Publish a Domain to the Pentaho Server

You can share an XML representation of your domain with a Pentaho solution that your Pentaho Server recognizes, so that the server can access the metadata domain and its contents. The implementation of metadata in the Pentaho Server requires that you follow some basic rules:

  • There can only be one metadata domain per Pentaho solution.
  • The metadata domain is associated with the solution by placing the XML format of the domain in the root directory of the solution.
  • The domain XML file must be [myBusinessModel].xmi, where [myBusinessModel] is any name you want to give the model.

You can accomplish this by using the Pentaho Metadata Editor Publish feature, or you can export your domain file and copy it manually to the solution repository folder associated with the solution.

Once you have published a model, it becomes available as a public data source, unless you add security to the metadata business objects. Published models appear as data sources for these Pentaho design tools and components:

  • Report Designer
  • Interactive Reports
  • Dashboards

Before You Begin

Before you publish a domain make sure you have this information available:

  • The user name and password for the Pentaho Server. The default user name is admin.

  • The base URL for your Pentaho Server. This consists of all URL information up to and including the Web application context. For example, the base URL of the Pentaho demo server is http://localhost:8080/pentaho. For publishing, you must append the base URL the to name of the publish service. The default is http://localhost:8080/pentaho/plugin...etadata/import . This is the value you must use, unless your server administrator has changed the service name.
  • The solution to which you want to publish the domain. For example, the Pentaho demo server ships with two different solutions, the Samples solution and the Steel Wheels solution. No slashes are required.