GNOME.org
 

[gnome-user-docs/wip/system-admin-guide] Seven disk- pages created.

commit 6cd887e8b33dc2f6ec28cf40f791fdc43821ff3c
Author: Jana Svarova <jsvarova redhat com>
Date:   Mon Aug 26 17:18:47 2013 +0200

    Seven disk- pages created.
    
    I have created a new section in the index.page called Disks and
    Storage where the sys admin can find how to troubleshoot some
    disk issues.
    
    Conflicts:
        system-admin-guide/C/index.page

 system-admin-guide/C/disk-brasero.page             |   40 +++++++++++++++
 system-admin-guide/C/disk-busy.page                |   35 +++++++++++++
 .../C/disk-connection-unavailable.page             |   24 +++++++++
 system-admin-guide/C/disk-failing.page             |   53 ++++++++++++++++++++
 system-admin-guide/C/disk-usb.page                 |   36 +++++++++++++
 system-admin-guide/C/disk-vfs-mounts.page          |   37 ++++++++++++++
 system-admin-guide/C/index.page                    |    8 +++
 system-admin-guide/C/problematic-partitions.page   |   41 +++++++++++++++
 8 files changed, 274 insertions(+), 0 deletions(-)
---
diff --git a/system-admin-guide/C/disk-brasero.page b/system-admin-guide/C/disk-brasero.page
new file mode 100644
index 0000000..c9cba86
--- /dev/null
+++ b/system-admin-guide/C/disk-brasero.page
@@ -0,0 +1,40 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="disk-brasero">
+  <info>
+    <revision version="0.1" date="2013-08-26" status="draft"/>
+    <link type="guide" xref="index" group="disks-storage" />
+    <link type="seealso" xref="disk-usb" />
+
+     <credit type="author">
+      <name>Jana Svarova</name>
+      <email>jana svarova gmail com</email>
+      <years>2013</years>
+    </credit>
+
+    <desc>What if <app>Brasero</app> does not see CD/DVD/BD drive?</desc>
+  </info>
+
+  <title>Brasero</title>
+
+  <p><app>Brasero</app>, free disc-burning program, is the default CD/DVD
+  application in the GNOME desktop.</p>
+
+  <p>Here are a few tips on what to check first if <app>Brasero</app> does not
+  see the CD/DVD/BD drive:</p>
+
+<list>
+<title>Check whether:</title>
+  <item><p>the medium is in the drive;</p></item>
+  <item><p>your CD/DVD/BD is on the list of running device;</p></item>
+  <item><p>the medium is empty or full.</p></item>
+</list>
+
+<!-- Co má vlastně sysadmin zkontrolovat a proč? -->
+
+<note style="important">
+  <p>It is a known issue that <app>Brasero</app> tends to have problems
+  recognizing empty and full media.</p>
+</note>
+
+</page>
diff --git a/system-admin-guide/C/disk-busy.page b/system-admin-guide/C/disk-busy.page
new file mode 100644
index 0000000..6617f56
--- /dev/null
+++ b/system-admin-guide/C/disk-busy.page
@@ -0,0 +1,35 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="disk-busy">
+  <info>
+    <revision version="0.1" date="2013-08-26" status="draft"/>
+    <link type="guide" xref="index" group="disks-storage" />
+
+     <credit type="author">
+      <name>Jana Svarova</name>
+      <email>jana svarova gmail com</email>
+      <years>2013</years>
+    </credit>
+
+    <desc>What if my disk is busy?</desc>
+  </info>
+
+  <title>Busy disk</title>
+
+  <p>If you receive a notification about your disk being busy, find the
+  program/programs that keep the disk busy. All the programs currently running
+  on your computer can be found in <app>System Monitor</app> (you get to 
+  <app>System Monitor</app> by typing it in the <gui>Activities</gui> overview).</p>
+<!-- Is it true? Does the sysadmin receive a notification?
+Or does he find out from, e.g.: the desktop running slowly?-->
+
+  <p>Here are a few possible solutions what you, as a system administrator, can do.</p>
+
+<list>
+  <title>Possible solutions:</title>
+  <item><p>End regularly the programs you are running and wait for the disk to recover.</p></item>
+  <item><p>Open the System Monitor and kill the program/programs that keep your disk busy.</p></item>
+</list>
+<!--Are there any other solutions?
+Can the sysadmin find some stats to find out how busy the given disk is?-->
+</page>
diff --git a/system-admin-guide/C/disk-connection-unavailable.page 
b/system-admin-guide/C/disk-connection-unavailable.page
new file mode 100644
index 0000000..03423d3
--- /dev/null
+++ b/system-admin-guide/C/disk-connection-unavailable.page
@@ -0,0 +1,24 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="disk-connection-unavailable">
+  <info>
+    <revision version="0.1" date="2013-08-26" status="draft"/>
+    <link type="guide" xref="index" group="disks-storage" />
+
+     <credit type="author">
+      <name>Jana Svarova</name>
+      <email>jana svarova gmail com</email>
+      <years>2013</years>
+    </credit>
+
+    <desc>Net connection is not available after suspend/resume connection or
+    connectivity loss</desc>
+  </info>
+
+  <title>Unavailable connection</title>
+
+  <p>This is a known-issue which also occurs when the user is inactive for some
+  time. The only solution is to unmount and mount again the file system, which
+  should reconnect the desktop to the net.</p>
+
+</page>
diff --git a/system-admin-guide/C/disk-failing.page b/system-admin-guide/C/disk-failing.page
new file mode 100644
index 0000000..209947e
--- /dev/null
+++ b/system-admin-guide/C/disk-failing.page
@@ -0,0 +1,53 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="disk-failing">
+  <info>
+    <revision version="0.1" date="2013-08-26" status="draft"/>
+    <link type="guide" xref="index" group="disks-storage" />
+    <link type="seealso" xref="disk-busy" />
+
+     <credit type="author">
+      <name>Jana Svarova</name>
+      <email>jana svarova gmail com</email>
+      <years>2013</years>
+    </credit>
+
+    <desc>What if my disk is failing?</desc>
+  </info>
+
+  <title>Disk failure</title>
+
+<!--are there any pre-failure warnings?
+http://consultancy.edvoncken.net/index.php/HOWTO_Replace_a_failing_disk_on_Linux_Software_RAID-5#Signs_of_impending_disk_failure
+-->
+  <p>If your disk is about to fail, you will receive a pre-failure warning from
+  SMART (Self Monitoring And Reporting Technology), more concretely from the 
+  <sys>smartd</sys> deamon.</p>
+<!--Je to pravda?? Notification bubble/message?? -->
+  <p>To detect the extent of your problem, execute the disk self-test:</p>
+
+<steps>
+  <title>Running a selftest</title>
+  <item><p>Open the <gui>Disks</gui> window by typing <gui>Disks</gui> into
+  <gui>Activities</gui> overview.</p></item>
+  <item><p>In the top-right corner, click on the More actions button.</p></item>
+  <item><p>From the drop-down menu, choose SMART Data and Self Tests</p></item>
+  <item><p>From the <gui>Start Self-test</gui> drop-down menu in the bottom-left
+  corner, choose <gui>Short</gui> (and type your password if necessary)</p></item>
+  <item><p>Let the Self-test run to show you more about your desk failure.</p></item>
+</steps>
+
+  <p>Alternatively, you can run the test in the terminal by running the
+  command below. This time, the example shows the long self-test:
+  <cmd>smartctl -t long /dev/sdb</cmd></p>
+<!--Fix the cmd, WRONG -->
+
+<!--Jaký rozdíl je mezi short a long testem?
+Co z nich sysadmin vyčte? 
+jak má na konkrétní informace reagovat?-->
+
+<note style="important">
+  <p>If your disk ever fails, consider taking your device to service.</p>
+</note>
+
+</page>
diff --git a/system-admin-guide/C/disk-usb.page b/system-admin-guide/C/disk-usb.page
new file mode 100644
index 0000000..82f2737
--- /dev/null
+++ b/system-admin-guide/C/disk-usb.page
@@ -0,0 +1,36 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="disk-usb">
+  <info>
+    <revision version="0.1" date="2013-08-28" status="draft"/>
+    <link type="guide" xref="index" group="disks-storage" />
+    <link type="seealso" xref="disk-partitions"/>
+
+     <credit type="author">
+      <name>Jana Svarova</name>
+      <email>jana svarova gmail com</email>
+      <years>2013</years>
+    </credit>
+
+    <desc>What if a flash drive is connected, but it is not showing up to
+    the user?</desc>
+  </info>
+
+  <title>Connected USB disk is invisible</title>
+
+  <p>It may happen to you that you connect a flash drive, but GNOME
+  Desktop does not show it up, it is invisible. What exactly does it mean that
+  your flash drive is invisible?</p>
+<list>
+  <item><p>You cannot see the device in the <app>GNOME disks</app> list
+  (To check this, open the GNOME discs in the <gui>Activities</gui> overview)</p></item>
+  <item><p>In the terminal, you run the <code>udisksctl dump</code> command
+  which lists the current state of the <sys>udisksctl</sys> daemon and shows
+  information about all objects but your flash disk is not among them.</p></item>
+  <item><p>In your terminal, you run the <cmd>dmesg</cmd> command. Towards the
+  end of the log there is a list of detected partitions but your flash drive is
+  not among them.</p></item>
+</list>
+
+<!--What shall the sysadmin do? -->
+</page>
diff --git a/system-admin-guide/C/disk-vfs-mounts.page b/system-admin-guide/C/disk-vfs-mounts.page
new file mode 100644
index 0000000..8d5f2d0
--- /dev/null
+++ b/system-admin-guide/C/disk-vfs-mounts.page
@@ -0,0 +1,37 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="disk-vfs-mounts">
+  <info>
+    <revision version="0.1" date="2013-08-26" status="draft"/>
+    <link type="guide" xref="index" group="disks-storage" />
+
+     <credit type="author">
+      <name>Jana Svarova</name>
+      <email>jana svarova gmail com</email>
+      <years>2013</years>
+    </credit>
+
+    <desc>What if an application fails to see VFS mounts?</desc>
+  </info>
+  
+  <title>VFS mounts are invisible</title>
+
+
+  <p>If your VFS mounts are invisible, it means... <!--There are not to be found where??-->
+  Firstly, check whether your application is a native GIO client as all the GNOME
+  applications typically use <app>GIOModule</app> for module loading.</p>
+  <!-- Why? What can the sysadmin find/see there??-->
+
+  <p>If you have done so, check whether the <sys>gvfs-fuse</sys> process is running.
+  Since <sys>gvfs-fuse</sys> should run automatically and you cannot start it by
+  yourself, try logging out and logging in again.</p>
+
+<note style="important">
+  <p>The gvfs package does not have to be installed on your system automatically,
+  so you might want to install it by running the <cmd>yum install gvfs</cmd>
+  command.</p>
+</note>
+
+ <!--The mounts are stored in the <file>/run/user/useride/gvfs/ </file>directory.
+ Is this relevant information?? Should it be documented?-->
+</page>
diff --git a/system-admin-guide/C/index.page b/system-admin-guide/C/index.page
index f76d40b..60f93fb 100644
--- a/system-admin-guide/C/index.page
+++ b/system-admin-guide/C/index.page
@@ -54,6 +54,7 @@
   <title>Installing and integrating applications</title>
 </links>
 
+<<<<<<< HEAD
 <links type="topic" style="toronto" groups="extensions">
   <title>Shell extensions</title>
 </links>
@@ -71,6 +72,13 @@
 </links>
 
 <links type="topic" style="toronto" groups="prob">
+=======
+<section style="toronto" id="disks-storage">
+  <title>Disks and Storage</title>
+</section>
+
+<section style="toronto" id="prob">
+>>>>>>> 335c356... Seven disk- pages created.
   <title>Troubleshooting</title>
 </links>
 </page>
diff --git a/system-admin-guide/C/problematic-partitions.page 
b/system-admin-guide/C/problematic-partitions.page
new file mode 100644
index 0000000..6479139
--- /dev/null
+++ b/system-admin-guide/C/problematic-partitions.page
@@ -0,0 +1,41 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="disk-partitions">
+  <info>
+    <revision version="0.1" date="2013-08-26" status="draft"/>
+    <link type="guide" xref="index" group="disks-storage" />
+
+     <credit type="author">
+      <name>Jana Svarova</name>
+      <email>jana svarova gmail com</email>
+      <years>2013</years>
+    </credit>
+
+    <desc>What if Nautilus shows system, unknown, or unwanted partitions?</desc>
+  </info>
+
+  <title>Problematic partitions</title>
+
+  <p>The <file>/etc/fstab</file> file typically lists all available disks and 
+  disk partitions, and indicates how they are to be initialized or otherwise
+  integrated into the overall system's file system.</p>
+  <p>The <cmd>mount</cmd> command most commonly uses the <file>/etc/fstab</file>
+  file. The file is read to determine which options should be used when mounting
+  a specified device.</p>
+
+  <p>That's why you need to first check whether the device is listed in the
+  <file>/etc/fstab</file> file as the devices are not listed by default.</p>
+  <!--why? What can the sysadmin fix there? -->
+
+  <p>As your second option, you can open Disks and tick the "show in user
+  interface" box in the "edit mount options" menu.</p>  <!-- And then what happens? He's gonna see it in the 
interface where?? -->
+<steps>
+  <item><p>Open <app>Disks</app> in the <gui>Activities</gui> overview.</p></item>
+  <item><p>In <app>Volumes</app>, click on the <app>Edit mount options</app>.</p></item>
+  <item><p>Check the box "show in user interface" and confirm your choice by OK.</p></item>
+</steps>
+
+<note style="important">
+  <p>It is the duty of the system administrator to properly create and maintain this file.</p>
+</note>
+</page>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]