Group Content
Recent Content
Share your Product Documentation questions, issues, and ideas here.
The ScienceLogic Documentation would like to hear from you! This discussion area is where you can let us know if you have any suggestions for the various docs sites at https://docs.sciencelogic.com/. This includes: Areas where the documentation might be missing key information. Suggestions for examples in the docs. Out-of-date or deprecated content. Typos! Errors in the docs. Areas where the docs are confusing or hard to navigate. Issues with the search. Bad links. Or anything else about the docs you'd like to share. TIP: You can Reply to this page, or simply click the dark blue Start a Discussion button at top right to share your info about the docs with the doc team. Thanks so much!
ScienceLogic 12.1 /gql endpoint displays incorrect contract for updateDevice(s)
When using the GraphiQL interface, you can see which GraphQL operations are available. Under 'Mutation', the operation "updateDevice" and "updateDevices" exists, which allow you to modify device properties via API. Using the normal Device Investigater Settings UI screen, we can change the SNMP Read dropdown value to whatever value we like (including 'none' to empty it), but the GQL contract does not show this option. Upon examining the action, ther browser shows that the properties "snmpReadCredentials" and "snmpReadWriteCredential" are used to update these values. I tried entering that same command in the /GQL and confirms it works; it's just showing an error in the syntax: Query: mutation UpdateDeviceSettings($deviceId: ID!, $snmpReadCredential: ID, $snmpReadWriteCredential: ID) { updateDevice(id: $deviceId, snmpReadCredential: $snmpReadCredential, snmpReadWriteCredential: $snmpReadWriteCredential) { id snmpReadCredential { id } } } Variables: { "deviceId": "10104", "snmpReadCredential": null, "snmpReadWriteCredential": null } Result: { "data": { "updateDevice": { "id": "10104", "snmpReadCredential": null } } } Error: Unknown argument: "snmpReadCredential" on diels "Mutations.updateDevice". Can this be corrected please?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?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.
This week's updates to the Doc sites at docs.sciencelogic.com
11/1/24: Doc updates to the release notes site at https://docs.sciencelogic.com/release_notes_html/ Added release notes for SL1 12.2.4, which includes: Updates to the Access Logs page Package updates Numerous support defect fixes Updated the release notes for all currently supported versions of SL1 with new guidance regarding future Python 2 support deprecation. 11/1/24 Doc updates to the main docs site at https://docs.sciencelogic.com/ Updated the Discovery & Credentials manual to reflect changes made to credentials and the Credentials page in recent AP2 releases. Updated the Business Services manual to reflect updates made to the Service Investigator and Business Services pages in recent AP2 releases. Updated the Dashboards manual to include details about the ability to select different scale prefixes for Dashboard widgets using non-percentage-based metrics introduced in AP2 Gelato. Updated the "Global Manager System and Technical Requirements" section of the Global Manager manual to specify that Global Manager stacks and all of its child stacks must run on the same SL1 build version, as well as the same versions of AP2 and Oracle Linux. Updated the "Installing and Configuring SL1 PowerFlow" chapter of the SL1 PowerFlow Platform manual to add missing steps and correct issues with the "Configuring a Proxy Server" and "Installing from the RPM File" sections. Added a new appendix to the section on "Access Permissions" that lists all of the Access Hooks that are available in SL1.Request documentation update on SNMP Traps
The latest ScienceLogic documentation still has sections to execute when you are still using SL1 8 or 10. They can be removed from the documentation as it causes confusion Link to the docs: https://docs.sciencelogic.com/latest/Content/Web_Events_and_Automation/Syslogs_and_Traps/snmp_traps.htm#manually-configuring-snmpv3-trapsIncorrect procedure for upgrading MariaDB on Collectors since SL12
Hello, It seems the procedure for manual upgrading the MariaDB on collectors has changed since SL 12. The procedure however has not been updated. Location: https://docs.sciencelogic.com/latest/Content/Web_Admin_and_Accounts/System_Administration/sys_admin_system_upgrade.htm#manually-upgrading-standalone-database-servers-all-in-one-applia In fact, the manual mariadb upgrade on SL 12 is no longer supported and executing the procedure will make the collector unusuable.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.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
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
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
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.This week's updates to the Doc sites at docs.sciencelogic.com
11/8/24: Doc updates to the release notes site at https://docs.sciencelogic.com/release_notes_html/ Added "IBM: MQ" PowerPack v104 Release Notes detailing the updates for Python 3.6 compatibility and includes: updates and improvements to the functionality for several Dynamic Applications updates to the universal credential Password field to accept empty values and to the PEM Key field to allow multi-line values to be entered. Added "SL1: System Upgrade Assessment" PowerPack v101 Release Notes which includes: enhancements to the "PowerPack Encryption Validation" and "Python Assessment Tool" reports instructions for updating legacy PowerPacks to SL1 version 12.3.0 or later Added a known issue about an update to the Cisco Viptela API that caused issues with Dynamic Applications in the "Cisco: Viptela" PowerPack v106. Added "Datacenter Automation Utilities v200" PowerPack Release Notes which incorporates content from the "Network Connectivity Automation" and "HTTP Action Type" PowerPacks. The PowerPack was also updated for Python 3 compatibility. Added the MR20241106 Restorepoint Release Notes detailing that users: can now disable bulk processes on multiple devices with different protocols. are redirected to the correct user security page when they need to update missing details on their account or logging in the first time via an email activation link; and that the API was updated so that calls on the /logs and /settings endpoints are now logged and syslogged for every API call that comes in. 11/8/24 Doc updates to the main docs site at https://docs.sciencelogic.com/ "IBM: MQ" PowerPack v104 manual updates include: enabling queue filtering for Linux/AIX and Windows operating systems updates to all three "Creating a Credential" sections "Datacenter Automation Utilities" PowerPack v200 manual updates include: content and procedures from the "Network Connectivity Automation" and "HTTP Action Type" PowerPack updates for Python 3 compatibilityThis 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
12/20/24 Doc updates to the main docs site at https://docs.sciencelogic.com/ Updated the manual for Restorepoint 5.6 for the 20241218 release. Various updates to fix typos and bad links, and general cleanup after SL1 12.3.0 release. 12/20/24 Doc Updates to the release notes site at https://docs.sciencelogic.com/release_notes_html/ Updated the Restorepoint release notes for the 20241218 release. Various updates to fix typos and bad links, and general cleanup after SL1 12.3.0 release. Happy Holidays from the ScienceLogic Documentation team!This week's updates to the Doc sites at docs.sciencelogic.com
11/22/24: Doc updates to the release notes site at https://docs.sciencelogic.com/release_notes_html/ Added Release Notes for : Linux Base Pack v112 updated silo_apps version and Execution Environment Restorepoint MR20241121 Addressed issues in which: the Device Control Action Names were displaying as "Unknown" existing command outputs did not display for users in the Test Rule modal the "Select All" options on the Device table did not operate when the "Disabled=True" filter was applied users received an error message when clicking the Test Connection button on any device restoring appliance backups required additional checks to ensure both their integrity and handling of legacy database dump formats were intact from CentOs 6.8-based appliances to an OL8-based one. Updated the Restorepoint API to enforce specific headers Updated the appliance backup process so that users now receive verification messages in conjunction with additional checks of the archive and backups within the archive Update the API call logs to include user information, such as User ID, Username, and User address "Low-code Tools" v102 PowerPack, which includes enhancements to the "silo-low-code" API library, the ability to specify HTTPs as your default proxy scheme when creating a proxy port, and various bug fixes. Updated the SL1 12.2.3 and 12.2.4.1 release notes with additional steps you must take if you are upgrading MariaDB from version 10.4.x to 10.6.x. 11/22/24 Doc updates to the main docs site at https://docs.sciencelogic.com/ Added manual updates for: Linux Base Pack v112: Added tested ciphers for Linux devices Added monitoring guidelines for a Linux device with an IPv6 address, specifically for SL1 version 12.1.3 and 12.2.4This 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
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
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.
About Product Documentation
Learn about documentation updates, ask questions, and share feedback about the docs.
Open Group