Skip to content

Published libraries

Published libraries enable you to centrally manage and publish a library definition and view or query the data from the Altair SLC Hub Excel Add-in and the portal interface.

With appropriate administrative access, you can use the Altair SLC Hub web portal to manage published libraries in the Altair SLC Hub.

Through published libraries, you do not need to have a locally running Altair SLC or install and configure drivers locally to access data in databases. Administrators can configure published libraries on the Altair SLC Hub while workers and users can access the data through Altair SLC Hub.

Managing Published Libraries

The Published Libraries page can be used to create and edit published libraries.

Creating New Published Libraries

Authentication domains are not supported

Library definitions making use of authentication domains are not supported for publishing due to technical limitations.

To create a new published library:

  1. Click the New button.
  2. In the Publish library dialog, select the library definition you want to publish.
    Each library definition can only be published once.

  3. Select the execution profile that controls the environment the published library runs in.
    For example, the environment could be a specific worker that contains the data or the correct drivers to access a database.

  4. Specify the Number of workers, which controls how many processes run to serve requests to the library.

  5. Modify Session encoding to specify the expected encoding of the data.
  6. Click OK.

Editing Published Libraries

In the Published Libraries page, you can select a library name from the list to edit its properties using the Edit Library Definition window.

Alternatively, you can click more (...) at the right of each library name and select Edit to view the current properties of the published library and optionally modify those properties.

Note that changes to a published library might interrupt a current request being made by users.

Status of Published Libraries

At the right of each library name, click more (...) and select Info to view the status of the published library, worker process, and tasks.

Info Tab

Th Info tab displays an overview of the published library. This includes configuration details and the number of workers and failed workers it has.

Workers Tab

The Workers tab displays a list of the individual workers and their status. You can expand each worker in the list to view what the current worker is doing or display any errors that have occurred upon starting the workers.

Tasks Tab

The Tasks tab displays a list of the current tasks being performed by the published library. From here, an administrator can see how long tasks have been running and cancel any that are taking too long or consuming too many resources.

Troubleshooting

If a published library has failed to start any workers successfully, it will not be able to serve any requests. This failure can be caused by various reasons, including incorrect library definitions, drivers not configured correctly on the workers, and ports not being open to reach a database.

You can perform the following steps if a published library is failing to start:

  1. Verify that the library definition is correct by creating a libname binding for the library and checking that the library can be accessed after logging into Altair SLC Hub from Altair Analytics Workbench.

  2. Check for startup failures in the published libraries worker tab.
    This should give useful information regarding why the library server has failed.

  3. Check the Hub Administration > Cluster Workloads page.
    Find a workload with the name Library server for library '<library definition>' in namespace '<namespace>', select the currently running job, select the Main task, and then check the output logs for errors.