Skip to content

Commit a3b39b2

Browse files
harneshalakalvicoundariavladykina
authored
DOCTEAM- 2167 Cockpit Applications (#644)
* Fixed validation errors. * Update concepts/cockpit-applications.xml Co-authored-by: lvicoun <JSindelarova@suse.com> Co-authored-by: Daria Vladykina <daria.vladykina@suse.com>
1 parent 90632d7 commit a3b39b2

3 files changed

Lines changed: 32 additions & 1 deletion

File tree

articles/cockpit.asm.xml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,7 @@ xmlns="http://docbook.org/ns/docbook">
2121
<resource href="../concepts/cockpit-network-bonds.xml" xml:id="_cockpit-network-bonds"/>
2222
<resource href="../concepts/cockpit-selinux.xml" xml:id="_cockpit-selinux"/>
2323
<resource href="../concepts/cockpit-system-update.xml" xml:id="_cockpit-system-update"/>
24+
<resource href="../concepts/cockpit-applications.xml" xml:id="_cockpit-applications"/>
2425
<resource href="../concepts/cockpit-packages.xml" xml:id="_cockpit-packages"/>
2526
<resource href="../concepts/cockpit-virtual-machines.xml" xml:id="_cockpit-virtual-machines"/>
2627
<!-- glue -->
@@ -449,6 +450,7 @@ different levels.</para>
449450
</module>
450451
<module renderas="section" resourceref="_cockpit-creating-timers"/>
451452
</module>
453+
<module renderas="section" resourceref="_cockpit-applications"/>
452454
<module renderas="section" resourceref="_cockpit-packages"/>
453455
<module renderas="section" resourceref="_cockpit-manage-subscriptions"/>
454456
<module renderas="section" resourceref="_cockpit-selinux">

concepts/cockpit-applications.xml

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
<?xml version="1.0" encoding="UTF-8"?>
2+
<!DOCTYPE topic
3+
[
4+
<!ENTITY % entities SYSTEM "../common/generic-entities.ent">
5+
%entities;
6+
]>
7+
<!-- refers to legacy doc: <add github link to legacy doc piece, if applicable> -->
8+
<!-- point back to this document with a similar comment added to your legacy doc piece -->
9+
<!-- refer to README.md for file and id naming conventions -->
10+
<!-- metadata is dealt with on the assembly level -->
11+
<topic xml:id="concept-cockpit-applications"
12+
role="concept" xml:lang="en"
13+
xmlns="http://docbook.org/ns/docbook" version="5.2"
14+
xmlns:its="http://www.w3.org/2005/11/its"
15+
xmlns:xi="http://www.w3.org/2001/XInclude"
16+
xmlns:xlink="http://www.w3.org/1999/xlink"
17+
xmlns:trans="http://docbook.org/ns/transclusion">
18+
<info> <title>Managing applications in &cockpit;</title> <meta name="maintainer" content="shalaka.harne@suse.com" its:translate="no"/> <abstract> <para>The &cockpit; Web interface supports modularity through plug-in applications. This section describes how to view, navigate and remove these applications using the <guilabel>Applications</guilabel> page. </para> </abstract> </info>
19+
<para>&cockpit; applications (or modules) extend the functionality of the Web interface. Adding an application creates a new entry in the sidebar, allowing you to manage complex system services—such as firewalls, virtual machines or SELinux—through a visual interface rather than the command line.</para>
20+
<para>Commonly installed modules include: <guimenu>Networking</guimenu>, <guimenu>Software Updates (Packages)</guimenu>, <guimenu>Repositories</guimenu> and <guimenu>SELinux</guimenu>.</para>
21+
<section><title>Viewing and navigating applications</title>
22+
<para>You can access your installed modules by clicking the <guimenu>Applications</guimenu> tab in the left-hand navigation pane and clicking the application's name to switch to its dedicated management tab. To uninstall a module, locate the application in the list and click the <guimenu>Remove</guimenu> button.</para>
23+
</section>
24+
<section><title>Troubleshooting missing applications</title>
25+
<para>If the <guilabel>Applications</guilabel> page is empty, or if a newly installed module does not appear in the list, you may need to refresh the &cockpit; service.</para>
26+
<para>Restart the socket: Run the following command in your terminal: </para>
27+
<screen>&prompt.sudo; systemctl restart cockpit.socket</screen>
28+
<para>Check for service failures: If a specific service fails to start, the <guilabel>Applications</guilabel> page will display the relevant systemd error logs directly on the screen to assist with debugging.</para>
29+
</section></topic>

tasks/cockpit-manage-subscriptions.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@
1616
xmlns:xlink="http://www.w3.org/1999/xlink"
1717
xmlns:trans="http://docbook.org/ns/transclusion">
1818
<info>
19-
<title>Managing Subscriptions using &cockpit;</title>
19+
<title>Managing subscriptions using &cockpit;</title>
2020
<meta name="maintainer" content="shalaka.harne@suse.com" its:translate="no"/>
2121
<abstract>
2222
<para>

0 commit comments

Comments
 (0)