Group Content
Featured Content
Recent Content
This week's updates to the Doc sites at docs.sciencelogic.com
10/11/24: Doc updates to the release notes site at https://docs.sciencelogic.com/release_notes_html/ Added release notes for the NVIDIA GPU PowerPack v100. Added release notes for the SL1: System Upgrade Assessment PowerPack v100. Updated the release notes for the Restorepoint MR20241010 release. 10/11/24 Doc updates to the main docs site at https://docs.sciencelogic.com/ Added a manual for the NVIDIA GPU PowerPack v100. Added a manual for the SL1: System Upgrade Assessment PowerPack v100. Updated the manual for the Restorepoint MR20241010 release.How many docs sites ARE there at docs.sciencelogic.com?
If you go to https://docs.sciencelogic.com/, you might think that there is only one documentation site at that address. However, the ScienceLogic Documentation team maintains multiple "sites" at that location. Here's a quick primer on each site, and what you can find there. The docs sites maintained by the Documentation team include the following: https://docs.sciencelogic.com/latest/ - the "main" docs site, which contains all of the various in-depth manuals for the different features for SL1, SL1 PowerPacks, SL1 PowerFlow, and PowerFlow SyncPacks, along with additional supporting docs. https://docs.sciencelogic.com/release_notes_html/ - the release notes site, which contains brief, release-specific documents for all ScienceLogic products. https://docs.sciencelogic.com/restorepoint/latest/ - the Restorepoint site, which covers how to configure and use Restorepoint, a disaster recovery and secure configuration management appliance for network devices. https://docs.sciencelogic.com/zebrium/latest/ - the Skylar Automated RCA (formerly Zebrium) site, which covers how to configure and use Skylar AI in conjunction with SL1 to automatically find the root cause of software issues. NOTE: Since this post went live, this site was updated to contain all of the Skylar products so far, include Skylar Automate RCA and Skylar Analytics, with more Skylar products coming soon. The Skylar products are also part of the main docs site as well: Skylar AI. The content is the same in both locations. The following sites are hosted at the docs site, but are not maintained by the Documentation team: https://docs.sciencelogic.com/dev-docs/ - the SL1 developer documentation site, which includes docs for Low-code Tools, Snippet Framework, CLI Toolkit, Prometheus Toolkit, REST Toolkit, Snippet API, and the PowerPack Quality Assessment Tool. Please note the the Documentation team only hosts these docs, but we do not actually write these docs (the developers do that). https://docs.sciencelogic.com/restorepoint/api/5-6/api.html - the Restorepoint RESTful API site, which is also hosted by the Documentation team but updated by the developers. Typically the Documentation team updates the docs sites at least once a week, if not more often. Watch this space for more information about our documentation updates every week.
No documentation on how to logon/logoff when using gql directly
The documentation about the ScienceLogic GraphQL API only mentions a login procedure when using the /gql endpoint. There is no information about how to log on (or log off) on the ScienceLogic platform and then use the API. Link to the documentation: https://docs.sciencelogic.com/latest/Content/Web_Content_Dev_and_Integration/GraphQL_API/graphql_introduction.htm#authentication-and-user-access For Logon, I have found a way to achieve this: execute a GET request to <platformURI>/authenticate with basic authentication, using a valid SL1 Local user information. From the response received, save the cookie information for later Any subsequent call to the /gql endpoint (inserting the cookie information on each request) allows me to execute gql queries/mutations. I can also reuse that same cookie information if I want to execute REST API actions. However, I do not succeed in 'forcing' a logoff from my previously created session: whatever I do, my session remains active and usable in the System > Monitor > Audit Logs. Only when I explicitly kill the session in that screen is my session invalid and I must login again. Can this be added to the documentation please?This week's updates to the Doc sites at docs.sciencelogic.com
10/18/24: Doc updates to the release notes site at https://docs.sciencelogic.com/release_notes_html/ Added release notes for the SL1 AP2 Halwa version 8.16.1.14, which includes: Enhancements to the Timeline panel on the Service Investigator page a new Device Groups widget for dashboards improved data visibility and more bulk management options for devices greater flexibility when viewing and managing events Updated the release notes for the Restorepoint MR20241023 release, which includes new features and addressed issues.This week's updates to the Doc sites at docs.sciencelogic.com
10/18/24: Doc updates to the release notes site at https://docs.sciencelogic.com/release_notes_html/ Added release notes for the VMware vSphere PowerPack v309. Updated the release notes for the Restorepoint MR20241017 release. 10/18/24 Doc updates to the main docs site at https://docs.sciencelogic.com/ Updated the manuals for the VMware vSphere PowerPack v309. Updated the manual for the Restorepoint MR20241017 release. Added a System Requirements page to the Restorepoint docs site.This week's updates to the Doc sites at docs.sciencelogic.com
9/26/24: Doc updates to the release notes site at https://docs.sciencelogic.com/release_notes_html/ Added release notes for SL1 version 12.2.3. Added release notes for SL1 AP2 Gelato version 8.14.26. Added release notes for version 101 of the "SL1: Execution Environment Check" PowerPack, which included several updates to the Dynamic Application included in the PowerPack. Updated the release notes for the Restorepoint MR20240925 release. 9/26/24 Doc updates to the main docs site at https://docs.sciencelogic.com/ Major updates to the Installation and Initial Configuration manual, including a complete reorganization of the Installing SL1 on Hardware Appliances and Virtual Appliances chapter. Updated the manual for the Restorepoint MR20240924 release.This week's updates to the Doc sites at docs.sciencelogic.com
8/15/24 Doc updates to the main docs site at https://docs.sciencelogic.com/: Updated the Restorepoint site with new information about Backups, SSH Host Keys, and additional SSH settings. Created a new Datacenter Automation PowerPacks, and updated the PowerPacks listed on that page with current information and tips. Re-branded the Zebrium docs site with new "Skylar Automated RCA" branding, and updated all screenshots to show new user interface. 8/15/24 Doc updates to the release notes site at https://docs.sciencelogic.com/release_notes_html/: Added SL1 12.1.2 release notes. Added AP2 version 8.7.96 (French Toast) release notes. Added release notes for a new Restorepoint maintenance release, 20240814. Updated the Zebrium release notes site with new "Skylar Automated RCA" branding.ScienceLogic rest api x-em7-run-as header validation
We discovered that after updating our SL1 platform from 12.1 to 12.3 that the validation of the rest api request header "X-EM7-RUN-AS" has changed and is now more strict. In SL 12.1, we can (for example) delete an event using admin credentials and use the x-em7-run-as header to actually execute the request on behalf of a different user (in our scenario we use a customer-specific account). We used '/api/account/<accountid>' as a value for this header. Since SL 12.3 (or somewhere after 12.1), we noticed that '/api/account/<accountid>' is no longer accepted: any rest api call using the x-em7-run-as with value '/api/account/<accountid>' will return a HTTP 401 Unauthorized with corresponding message: { "errors": [ { "errorcode": "NO_AUTH", "message": "Valid authentication credentials not provided" } ], "messages": [], "resource_body": null } However, if I simply put '<accountid>' as the value for this header, the request succeeds. Can you please improve the documentation (https://docs.sciencelogic.com/api-developer-docs/Content/Web_Content_Dev_and_Integration/ScienceLogic_API/methods_headers_and_responses.htm#request-headers) and specify that the value for this header must be a number which matches a real user in the system. Also, the request also fails when using an account id value and that account is Inactive. Would be nice to read it in the docs. error message when trying to execute an action on a suspended user: { "errors": [ { "errorcode": "NO_AUTH", "message": "Account \u0027em7admin\u0027 failed authentication due to 1 account restriction(s)" } ], "messages": [ "This account is marked as \u0022inactive\u0022" ], "resource_body": null }This week's updates to the Doc sites at docs.sciencelogic.com
6/13/25 Updates to the main documentation site at https://docs.sciencelogic.com/ : The supported SL1 12.3.5 upgrade paths were added to the SL1 Upgrade Path Matrix. The section on SL1 Backup Management was updated to add instructions for enabling the tmux utility prior to mounting backups and restoring, if necessary. The Snippet Dynamic Application Development manual was updated to provide additional context around the use of the root_device variable as it relates to Collector Affinity. The Cisco UCS Manager v105 PowerPack manual was updated to reflect the PowerPack's Python 3.6 compatibility and new directions for the unguided discovery workflow and creating credentials. The Restorepoint 5.6 manual was updated to add Amazon Web Services virtual appliance installation instructions. 6/13/25 Updates to the release notes site at https://docs.sciencelogic.com/release_notes_html/ : Added release notes for SL1 Ibiza 12.3.5, which included package updates and addressed multiple issues from previous releases. The Cisco UCS Manager v105 PowerPack was updated for Python 3.6 compatibility. Restorepoint released Hotfix 20250612 to address an issue preventing users from clearing the Disabled checkbox on the Device tab.Last week's updates to the Doc sites at docs.sciencelogic.com
4/11/25 Doc updates to the main docs site at https://docs.sciencelogic.com/ Updated the following PowerPacks manuals for Python 3 compliance and other features: Nginx: Open Source & Plus v103 Added Guided Discovery workflow Microsoft: Windows Server v118 Added 2025 Device classes Updated the Restorepoint 5.6 User Guide to include details about appliance-related settings in the [Devices] tab (previously [Device Defaults]) on the System Settings page, and its corresponding new "Global Device Settings" section. Removed the "Testing the CUCM Credential" section from the Cisco: CUCM Cisco Unified Communications Manager PowerPack manual as the "CUCM Credential Test" credential tester has been excluded from this PowerPack. Updated the Agents chapter of the Restorepoint 5.6 User Guide to include Config Policy information for agents. Updated the SL1 Recommended Upgrade Paths section to add the approved upgrade paths for SL1 12.3.3. 4/11/25 Doc Updates to the release notes site at https://docs.sciencelogic.com/release_notes_html/ Added release notes for SL1 12.3.3, which includes package updates to improve security and system performance and addresses multiple issues from previous releases. Updated the following PowerPacks Release Notes for Python 3 compliance and other features: Nginx: Open Source & Plus v103 Added Guided Discovery workflow Microsoft: Windows Server v118 Added 2025 Device classes Added releases notes for Skylar Analytics 1.4.1. Added release notes for version 114 of the Cisco: CUCM Cisco Unified Communications Manager PowerPack release, which includes compatibility with Python 3 for all Dynamic Applications using snippet argument and specific run book actions. Added release notes for version 101 of the Couchbase PowerPack release, which includes compatibility with Python 3.6 for all Dynamic Applications and the ability to leverage snippet framework when collecting data. Added release notes for version 8.16.1.41 of the AP2 Halwa.01 release, which addresses two issues relating to API and Global Manager that affected the previous AP2 Halwa version 8.16.1.14 release. Added release notes for version 8.17.23.45 of the AP2 Ice Pop.01 release, which addresses two issues relating to API and Global Manager that affected the AP2 Ice Pop version 8.17.23.18 release. Added release notes for Restorepoint MR20250409, which includes updates to global alert definitions. Added release notes for version 2.3.2 of the Restorepoint SyncPack, which updates the default backup schedule in the SyncPack from every 15minutes to once a day at midnight, and addresses an issue with the "Get List of Credentials from SL1" application.
This week's updates to the Doc sites at docs.sciencelogic.com
3/21/25 Doc updates to the main docs site at https://docs.sciencelogic.com/ Updated the section on SL1 Self-Monitoring with revised instructions for creating and aligning credentials for monitoring SL1 devices. Added a sample credential to the Cisco: AppDynamics v105 PowerPack that includes CURL options for SSL verification, added a new threshold for the "Cisco: AppDynamics Application Discovery" Dynamic Application, and updated the the "Cisco: AppDynamics Application Discovery" run book action. Added the PowerFlow v3.1.1 manual. 3/21/25 Doc Updates to the release notes site at https://docs.sciencelogic.com/release_notes_html/ Added a sample credential to the Cisco: AppDynamics v105 PowerPack that includes CURL options for SSL verification, added a new threshold for the "Cisco: AppDynamics Application Discovery" Dynamic Application, and updated the the "Cisco: AppDynamics Application Discovery" run book action. Added the PowerFlow 3.1.1 release notes Added the PowerFlow powerflowcontrol (pfctl) Command-Line Utility 2.7.11 release notesThis week's updates to the Doc sites at docs.sciencelogic.com
3/14/25 Doc updates to the main docs site at https://docs.sciencelogic.com/ Updated the section on Updating SL1 to add recommended upgrade paths for SL1 12.3.2. Restorepoint added instructions for rotating back connection passwords and information about how those passwords are encrypted and stored. Update the Run Book Automation > Snippet Variables section with examples to use with Basic/Snippet credentials. 3/14/25 Doc updates to the release notes site at https://docs.sciencelogic.com/release_notes_html Added release notes for SL1 12.3.2, which includes several enhancements to Skylar AI, multiple package updates, and a change to schedule management. Restorepoint released both a hotfix and a maintenance release this week: MR20250311 addressed an issue with agent statuses not being reported. MR20250312 addressed several support defects for back connection password protocols, Full transcript settings, and missing back up files due to faulty archive restores.This week's updates to the Doc sites at docs.sciencelogic.com
2/28/25 Doc updates to the main docs site at https://docs.sciencelogic.com/ Microsoft: Exchange Server v102 added two new Dynamic Applications and upgraded for Python 3 compatibility. Cisco: Intersight v101 added support for RSA Private Keys for the PEM key previously documented in KB article 15398. Restorepoint 5.6 added a note that Restorepoint is encrypted-at-rest for the security of databases and backups. 2/28/25 Doc Updates to the release notes site at https://docs.sciencelogic.com/release_notes_html/ Microsoft: Exchange Server v102 added two new Dynamic Applications and upgraded for Python3 compatibility. Restorepoint MR20250226 updated storage protocols for users' passwords. Restorepoint 5.6 Release Notes were updated to include a known issue regarding asset data being unable to populate the Asset page after a GET function.This week's updates to the Doc sites at docs.sciencelogic.com
2/7/25 Doc Updates to the release notes site at https://docs.sciencelogic.com/release_notes_html/ Updates to the Restorepoint MR20250203 hotfix addressed a support defect for agents that crashed after updating. Skylar Analytics 1.2 release notes Datacenter Automation Utilities PowerPack 201 release notes Linux SSH Automations PowerPack v107 release notes Juniper Mist PowerPack v100.1 release notes 2/7/25 Doc updates to the main docs site at https://docs.sciencelogic.com/ Skylar Analytics 1.2 manual Updated Using Single Sign-On manual to include a note clarifying you might need to enter the complete URL displayed in the SAML trace for the attribute mapping fields. Added an icon and a link to the Restorepoint Developer Docs to the home page Linux SSH Automations PowerPack v107 manual Added a new SL1 Automation PowerPacks page, with a new icon and link on the home page as well Juniper Mist PowerPack v100.1 manualThis week's updates to the Doc sites at docs.sciencelogic.com
1/24/25 Doc updates to the main docs site at https://docs.sciencelogic.com/ SL1 PowerFlow manual updated with changes for PowerFlow version 3.1.0 and PowerFlow powerflowcontrol (pfctl) v2.7.10. Added updated snippet functions for import logging from a Dynamic Application or a run book snippet in the Run Book Automations manual. Added a new Upgrade Checklist and Upgrade Path Matrix for SL1 to the System Administration manual. AMPQ: RabbitMQ v103, which includes updates to support Python3 compatibility. F5: BIG-IP DNS v101, which includes updates to support Python3 compatibility. 1/24/25 Doc Updates to the release notes site at https://docs.sciencelogic.com/release_notes_html/ SL1 PowerFlow v3.1.0, which addresses several issues and adds multiple user interface improvements for PowerFlow, including indicators for the number of schedules for an application, a persistent footer at the bottom of PowerFlow with system information, and an "Export to CSV" option for SyncPacks. SL1 PowerFlow powerflowcontrol (pfctl) v2.7.10, which includes multiple fixes and improvements for node and cluster actions. This version of the utility is included with the PowerFlow Platform version 3.1.0 release. AMPQ: RabbitMQ v103 PowerPack, which includes updates to support Python3 compatibility. F5: BIG-IP DNS v101 PowerPack which includes updates to support Python3 compatibility. Revised the SL1 12.2.5 release notes to include a note about upgrading from MariaDB 10.4 to 10.6.This week's updates to the Doc sites at docs.sciencelogic.com
1/17/25 Doc Updates to the release notes site at https://docs.sciencelogic.com/release_notes_html/: The Restorepoint MR 20250115 Release Notes addressed several support defects including scrolling issues on the Schedules page, public key displays on the Edit Device page, and template issue in the Device configuration page. This maintenance release also updated values for the Allowed SSH Ciphers, updated the validation process for the Monitor.AlertFail field, and corrected an agent runtime error. The IBM: Tivoli Storage Manager v103 PowerPack was updated for Python 3 compatibility.This week's updates to the Doc sites at docs.sciencelogic.com
1/10/24 Doc updates to the main docs site at https://docs.sciencelogic.com/ Updated Monitoring with SL1 Agent to add a matrix detailing the Linux and Windows agent versions for each SL1 release and added content regarding TLS connection validation with Extended Architecture systems. Updated the "Troubleshooting" section of the Business Services manual to clarify that SaaS users cannot access the SL1 appliance via SSH and should use the "Developer Logs" page (System > Tools > Developer Logs) to obtain trace-level logs. 1/10/24 Doc Updates to the release notes site at https://docs.sciencelogic.com/release_notes_html/ Added release notes for SL1 Hollywood 12.2.6, which includes package updates and addresses several issues from previous releases. Updated the lists of PowerPacks that were removed from the Golden Gate 12.1.0.2 and Hollywood 12.2.0 ISOs in all SL1 12.1.x and 12.2.x release notes.This week's updates to the Doc sites at docs.sciencelogic.com
12/12/24 Doc updates to the main docs site at https://docs.sciencelogic.com/ Extensive documentation updates to reflect the many new features that were added to SL1 12.3.0 Ibiza. Updated the Monitoring Windows with PowerShell documentation to reflect updated content for the Microsoft: DHCP Server v101 PowerPack. Updated the documentation for the Palo Alto v103 PowerPack, which added three new credential types for REST API support. 12/12/24 Doc Updates to the release notes site at https://docs.sciencelogic.com/release_notes_html/ SL1 12.3.0 Ibiza. This release includes: Support for the Beta version of Skylar Analytics, including numerous SL1 user interface updates Enhancements to the Service Investigator and Device Investigator pages New dashboard data visibility options Updates to meet FedRAMP requirements Global Manager single sign-on configuration updates and stackDiff options Package updates for enhanced security and improved performance Utilization of MariaDB 10.6 and Python 3.11 And many more updates! SL1 12.2.5 Hollywood, which includes package updates to improve security and system performance and addresses multiple issues from previous releases. JMX PowerPack v104, which includes updates to support Python 3 compatibility and updated snippet framework conversions. Microsoft: DHCP Server v101 PowerPack, which addresses a support defect for the "Microsoft: DHCP IPv4 Scope Performance" Dynamic Application. Palo Alto Base Pack PowerPack v103, which includes updates to support Python 3 compatibility and adds support for REST API requests along with two new device classes and three new example credentials. Restorepoint MR20241204, which addresses multiple support defects.
About Product Documentation
Learn about documentation updates, ask questions, and share feedback about the docs.
Open Group