DOCTEAM- 2167 Cockpit Applications

articles/cockpit.asm.xml

@@ -21,6 +21,7 @@ xmlns="http://docbook.org/ns/docbook">
 <resource href="../concepts/cockpit-network-bonds.xml" xml:id="_cockpit-network-bonds"/> 
 <resource href="../concepts/cockpit-selinux.xml" xml:id="_cockpit-selinux"/> 
 <resource href="../concepts/cockpit-system-update.xml" xml:id="_cockpit-system-update"/>
+<resource href="../concepts/cockpit-applications.xml" xml:id="_cockpit-applications"/>
 <!-- glue -->
 <resource href="../glues/cockpit-managing-filesystem.xml" xml:id="_cockpit-managingfs-glue"/> 
 <resource href="../glues/cockpit-storage-plugin.xml" xml:id="_cockpit-storage-plugin"/> 
@@ -431,6 +432,7 @@ different levels.
 </module>
 <module renderas="section" resourceref="_cockpit-creating-timers"/>
 </module>
+<module renderas="section" resourceref="_cockpit-applications"/>
 <module renderas="section" resourceref="_cockpit-manage-subscriptions"/>
 <module renderas="section" resourceref="_cockpit-selinux">
 <module renderas="section" resourceref="_cockpit-managing-software-updates">

concepts/cockpit-applications.xml

@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE topic
+[
+  <!ENTITY % entities SYSTEM "../common/generic-entities.ent">
+    %entities;
+]>
+<!-- refers to legacy doc: <add github link to legacy doc piece, if applicable> -->
+<!-- point back to this document with a similar comment added to your legacy doc piece -->
+<!-- refer to README.md for file and id naming conventions -->
+<!-- metadata is dealt with on the assembly level -->
+<topic xml:id="concept-cockpit-applications"
+ role="concept" xml:lang="en"
+ xmlns="http://docbook.org/ns/docbook" version="5.2"
+ xmlns:its="http://www.w3.org/2005/11/its"
+ xmlns:xi="http://www.w3.org/2001/XInclude"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:trans="http://docbook.org/ns/transclusion">
+  <info>
+    <title>Managing applications using &cockpit;</title>
+    <meta name="maintainer" content="shalaka.harne@suse.com" its:translate="no"/>
+    <abstract>
+      <para>
+        &cockpit; allows you to view and remove the applications installed in &productname;.
+      </para>
+    </abstract>
+  </info>
+  <para>
+   The <guilabel>Applications</guilabel> tab lists the modules enabled in the &cockpit; web interface side pane. Adding an application adds a new page to the sidebar that allows you to manage a complex system service (like Firewalls or Virtual Machines) through a visual interface instead of the command line. The applications such as <guimenu>Networking</guimenu>, <guimenu>Packages</guimenu>, <guimenu>Repositories</guimenu>, <guimenu>SELinux</guimenu>, and so on appear in the <guimenu>Applications</guimenu> page. If a service fails to start, the <guilabel>Applications</guilabel> page shows you the specific systemd error log on the screen.
+  </para>
+  <para>If the <guilabel>Applications</guilabel> tab is empty or if any module name is missing, run the following command to refresh the packages</para>
+  <screen>&prompt.sudo; zypper ref
+&prompt.sudo; systemctl restart cockpit.socket</screen>
+  <para>To view the list of installed applications, click <guimenu>Applications</guimenu> on the left pane. When you click an application name, the web interface displays the corresponding application tab.</para>
+  <para>To remove the application from &cockpit; click the <guimenu>Remove</guimenu> button corresponding to the application.</para>
+  </topic>