To update a package through the UI:

In the case of libraries, the component templates from the package are updated. Templates that have been modified from the original package remain unchanged.

For applications, where component templates are materialized during installation and afterwards managed by LogScale, you may encounter conflicts during the upgrade process. Conflicts arise when you have made local changes to an application component prior to updating it. For example, if you installed an application with a dashboard and you've changed a widget of that dashboard , a conflict may occur when you update that application. In order to resolve conflict while updating an application LogScale supports a basic Use Ours/Theirs merging view that lets you choose what to do with each conflicting component, meaning you either keep the modified version or replace it completely with the new version.

If you are using the LogScale CLI you are able to entirely overwrite the installed package without handling update conflicts.

If you want to uninstall a package you can do so through the UI or the CLI. Doing so will remove the components and templates previously installed by the package, even those that might currently be in use on your system.

To uninstall a package through the UI

To update an existing package from a file:

Once the update has been completed you will be sent to the Installed section of the Packages view.

To uninstall a package using the CLI, you must quote the package name:

humioctl packages uninstall github/events

You can install a previously downloaded package directly into LogScale using the installPackageFromZip() GraphQL mutation.

To do this, you must specify the name of the file on the command-line using curl you will need to specify a multi-part form entry, one part consisting of the mutation and the other the name of the file of the package to bee installed. For example:

$ curl --location 'https://$YOUR_LOGSCALE_URL/graphql' \
--header 'Authorization: Bearer XXXXXXXXXXXXXX\
--header 'accept: application/json, multipart/mixed' \
--form 'file=@"package.zip"' \
--form 'json="{\"query\":\"mutation {installPackageFromZip(viewName: \\\"Package_Testing\\\",overwrite: true) {wasSuccessful}}\"}";type=application/json'

When completed successfully you will get the success message back:

{
  "data": {
    "installPackageFromZip": {
      "wasSuccessful": true
    }
  }
}