Manage packages
Step by step guide to installing and uninstalling packages in your LinkedDataHub dataspace.
Package management requires Control access to the administration application. Only users with administrative privileges can install or uninstall packages.
Read more about how packages work.
Install a package
Installing a package adds new functionality to your dataspace by importing ontologies, data, and resources.
Follow these steps to install a package through the web interface:
- Open the package URI in browser mode by entering its URI in the address bar
- Click the Actions dropdown button next to the package
- Select Install from the dropdown menu
- Wait for the installation to complete
- Refresh your browser to ensure the new package functionality is loaded
Execute the following command:
install-package.sh \ -b "https://localhost:4443/" \ -f ssl/owner/cert.pem \ -p "$owner_cert_password" \ --package "https://packages.linkeddatahub.com/skos/#this"
Parameters:
-b- Base URL of your LinkedDataHub instance
-f- Path to your owner certificate file
-p- Owner certificate password
--package- Package URI to install (e.g., https://packages.linkeddatahub.com/skos/#this)
Uninstall a package
Uninstalling a package removes its ontologies and resources from your dataspace. User-created data that uses the package vocabulary will remain but may not function correctly.
Follow these steps to uninstall a package through the web interface:
- Navigate to the administration application of your dataspace
- Open the Packages container to view installed packages
- Find the package you want to uninstall in the list
- Click the Actions dropdown button next to the package
- Select Uninstall from the dropdown menu
- Confirm the uninstallation when prompted
- Wait for the uninstallation to complete
Uninstalling a package will remove its ontologies and associated resources. Any data you created using the package's vocabulary will remain in your dataspace but may not display or function correctly without the package.
Execute the following command:
uninstall-package.sh \ -b "https://localhost:4443/" \ -f ssl/owner/cert.pem \ -p "$owner_cert_password" \ --package "https://packages.linkeddatahub.com/skos/#this"
Parameters are the same as for installation.
Verify package installation
After installing a package, verify that it was installed correctly:
- Navigate to the administration application
- Click on Ontologies in the left navigation menu
- Verify that the package ontology appears in the list of imported ontologies
- In the end-user application, check that package-specific classes and properties are available when creating new resources
- If the package includes stylesheets, verify that custom UI elements are rendering correctly
Customize package behavior
Packages may include custom XSLT stylesheets that affect how data is displayed. You can further customize the behavior by:
- Importing additional stylesheets to extend package functionality
- Overriding package templates to customize the rendering of package resources
- Creating custom views and layouts for package data
See the Change layout guide for detailed instructions on stylesheet customization.
Troubleshooting
Installation fails
If package installation fails:
- Verify you have Control access to the administration application
- Check that all package dependencies are met
- Review the error message for specific issues
- Ensure the package files are valid and well-formed
Package functionality not visible
If installed package features are not visible:
- Refresh your browser to reload the application
- Clear the browser cache if stylesheets are not updating
- Verify the package ontology is imported in the Ontologies section
- Check that you have appropriate permissions to view package resources