Knowledgebases in the Admin Console
The Knowledgebases section in the the admin console provides a list of all the KBs currently on the server. To access this section, navigate to KB Management > Knowledgebases.
The default view shows columns for the name and description for each KB, as well as the KB Revision and Status.
- OK – Indicates an active KB.
- Invalid – KB failed to delete or patch correctly. Invalid KBs will not appear in the drop-down menu of the server login page.
- Disabled – Disabled KBs do not appear in the drop-down menu of the server login page.
- Importing/Deleting – Indicates a KB being created, deleted, or imported. This status is rarely seen.
- Sync Carrier KB – A KB used for an entity set sync export. This status appears only when exporting an entity set to hard drive via Sync settings in the standard Agiloft administrator interface. Agiloft creates a temporary placeholder KB for export purposes. After the export completes successfully, the KB is scheduled for immediate deletion. Persistent visibility of KBs with this status may indicate a bug. Further inspection or contacting Agiloft support is recommended.
Copy a Knowledgebase
Choose Copy to create a copy of an existing KB on the same server. Copying creates a new KB using the original KB as a template. Copying KBs is useful to create a development or test copy of a KB to test changes and integrations, or if you need a new KB whose structures are more similar to an existing KB than the available defaults.
Select the Type of Copy
After adding a name and description, select the Type of Copy in the dialog.
- Copy Table Definitions Only – copy the table structures and fields, but not the records. (Default selection)
- Copy Tables and Contents – copy the structures and the records stored in the original KB.
When creating a copy for testing purposes, there is a danger that the copy may grab emails intended for the original knowledgebase. This may generate warning messages claiming that old issues have not been resolved. To prevent this, deselect the checkboxes for copying inbound email settings and copying rules.
Delete a Knowledgebase
KBs can be deleted from the admin console. Deleting KBs helps free up server space.
- Choose Delete to remove the KB. A confirmation dialog will open.
When deleting a knowledgebase, the system performs these tasks in the following order:
- Disables background and Web services for the KB.
- Logs out any users currently working in the KB.
- Locks user tables to prevent any changes.
- Disables any foreign keys.
- Collects all nullable fields in user tables that references data in the system tables (e.g. the History table), then nullifies said user fields.
- Deletes data in system tables using a prepared list of SQL statements. These are defined as XML and found in:
java/projects/importer/resources/resources/import/sw2delete.xml.Note that if any system table or foreign is added/deleted from the original
sw2delete.xmlfile must also be updated to reflect the changes.
- Deletes all user tables in the database.
- Re-enables foreign keys and background services.
- Deletes the KB home directory.
If a backup of the deleted KB was already taken, the backup is preserved. Seefor more information.
The system prevents the Admin KB from being deleted.
Editing a Knowledgebase
Click the Edit icon next to a KB name to open the Edit menu. This provides options to:
- Edit the table definitions
- Rename the KB
- Reset user passwords
- Reset user properties
Edit tables from the admin console
|The Edit Tables menu provides the same level of access to editing database tables as if the administrator is logged in to the Staff Interface. See Tables for more information.|
Rename a knowledgebase
|You can rename a KB through the admin console. Renaming can be useful for exporting to a server that may have a KB by the same name, or for marking KBs for retirement, but not deletion.|
Reset user password
You can reset a user's password directly from the Admin Console.
Reset user properties
|Resetting user properties will reset the cached information of that user’s session. None of the data in the KB is reset by this operation. This feature is used primarily to troubleshoot situations where users have cleared their browser cache but the GUI still displays incorrectly.|
This option determines the shortest time interval, in minutes, allowed between successive time-based searches. Many searches, often when running Charts and Reports, can get complex and put a significant burden on the server. Limiting the number of times such a search can run prevents a single KB from spiking the load and resulting in a potentially downed server.
The minimum allowable interval between searches is one minute, with the default set to five minutes.
Displays the communication type for the KB. This will usually show Unified Communications.
In Unified Communications, all communication information is collected into the All Communications table with relevant links. This setting may show users any relevant communication whether or not it is linked to the particular record in question.
- The Admin KB can't be copied because the system prevents the operation.
- The Admin KB can be edited, but some options will be unavailable.