← Back to branch summary

~akapoor92/ubuntu-docs/fix-for-889089

« back to all changes in this revision

Viewing changes to serverguide/C/other-apps.xml

  • Committer: Bazaar Package Importer
  • Author(s): Matthew East
  • Date: 2010-03-29 07:56:15 UTC
  • Revision ID: james.westby@ubuntu.com-20100329075615-6j63m8ed1k2zxtdc
Tags: 10.04.2
https://launchpad.net/bugs/482862
https://launchpad.net/bugs/448618
https://launchpad.net/bugs/526320
https://launchpad.net/bugs/450567
https://launchpad.net/bugs/504981
https://launchpad.net/bugs/508572
https://launchpad.net/bugs/517776
https://launchpad.net/bugs/518119
https://launchpad.net/bugs/518170
https://launchpad.net/bugs/518117
https://launchpad.net/bugs/512556
https://launchpad.net/bugs/521243
https://launchpad.net/bugs/521508
https://launchpad.net/bugs/525349
https://launchpad.net/bugs/525431
https://launchpad.net/bugs/518175
https://launchpad.net/bugs/518107
https://launchpad.net/bugs/453459
https://launchpad.net/bugs/440826
https://launchpad.net/bugs/452647
https://launchpad.net/bugs/518460
https://launchpad.net/bugs/367569
https://launchpad.net/bugs/546193
https://launchpad.net/bugs/505708
https://launchpad.net/bugs/509653
https://launchpad.net/bugs/510703
https://launchpad.net/bugs/507624
https://launchpad.net/bugs/511090
https://launchpad.net/bugs/506800
https://launchpad.net/bugs/384148
https://launchpad.net/bugs/437446
https://launchpad.net/bugs/532661
https://launchpad.net/bugs/518289
https://launchpad.net/bugs/515298
https://launchpad.net/bugs/509355
https://launchpad.net/bugs/537167
https://launchpad.net/bugs/533582
https://launchpad.net/bugs/489819
https://launchpad.net/bugs/496184
https://launchpad.net/bugs/526083
https://launchpad.net/bugs/527905
https://launchpad.net/bugs/528808
* General:
  - Fixes to scripts/fix-url.sh (including LP: #482862)
  - Fix character encoding in contributors.xml (LP: #448618)
  - Updated version in browser-startpage html files, LP: #526320
  - Refresh pot files
* Add-applications:
  - Updates for UI changes, Phil Bull
* Config-desktop:
  - Added topic on changing window buttons from the left, Phil Bull
* Hardware:
  - Added mention of gsynaptics, Connor Imes, LP: #450567
* Internet:
  - Refresh list of plugins supplied by ubuntu-restricted-extras, branch 
    from Nathan Murray, LP: #504981
  - Updates to reflect that Ekiga no longer installed by default, Connor Imes,
    LP: #508572
  - Grammar fix from Alex Wardle, LP: #517776
  - Order adjustment for shares-admin usage, Alex Wardle, LP: #518119
  - Button name change for shares-admin app, Alex Wardle, LP: #518170
  - Use unlock icon in networking section, Alex Wardle, LP: #518117
  - Updated directions on changing text size and page zooming in firefox,
    Alison Rowland, LP: #512556
  - Fixed guilabel usage in modem section. Alex Wardle, LP: #521243
  - Updated button and tab names in Static Connections section,
    Alex Wardle, LP: #521508
  - Typo fix in adsl section. Alex Wardle, LP: #525349
  - Removed unused and empty basics.xml, LP: #525431
  - Minor wording update to directions for sharing folders via nautilus,
    Connor Imes, LP: #518175
  - Use 'NetworkManager' not 'Network Manager' for consistency, Connor Imes
    LP: #518107
  - Update to troubleshooting mobile devices, Connor Imes, LP: #453459
  - Adjusted description of NetworkManager applet icons, Connor Imes
    LP: #440826
  - Additions to VPN section of connecting guide, Alex Wardle, LP: #452647
  - Expanded on using config files for vpn connections, Connor Imes
  - Command line substitution for Services utility which is not in Karmic or
    Lucid, Connor Imes, LP: #518460
  - Structural and language changes + updates for UI changes, Phil Bull
* Musicvideophotos:
  - Added section for recording and editing video, Book 'em Dano, LP: #367569
* Newtoubuntu:
  - Complete rewrite, Matthew East
* Printing:
  - Simple Scan replaced xsane for scanning documents, Alex Wardle, LP: #546193
* Serverguide:
  - Rename link to serverguide in advanced-topics.xml, Gilbert 
    Mendoza, LP: #505708
  - Use distro-short-codename variable for vmbuilder documentation in 
    serverguide rather than static version example, Connor Imes,. LP: #509653
  - Small fixes to security chapter, Connor Imes, LP: #510703
  - Small fixes from Nathan Handler, LP: #507624
  - Configuration change for OpenLDAP, Connor Imes, LP: #511090
  - Refresh of network-config section, Gilbert Mendoza, LP: #506800
  - Update manpage links to use distro-short-codename, Connor Imes
  - Changed OpenLDAP replication to use single Provider/Consumer configuration,
    Adam Sommer
  - Removed grub-password-security section - it does not apply to Grub2,
    Gilbert Mendoza, LP: #384148
  - Reference Grub2 community doc page for advanced configuration directions,
    Connor Imes, LP: #437446
  - Added necessary configuration options for apt Periodic in automatic-updates
    section, Connor Imes, LP: #532661
  - Added subsections for consumer and provider configuration steps, Adam Sommer
  - Changed TLS Replication section to use Single-Master scheme, Adam Sommer
  - Clarified Postfix TLS/SSL using a CA configuration steps, Adam Sommer,
    LP: #518289
  - Changed Apache2 Subversion configuration to use VirtualHost file instead
    of apache2.conf, Adam Sommer, LP: #515298.
  - Adding Ubuntu Wiki links to each section's Resources subsection, Adam Sommer
  - Added note in mail section about some packages being in multiverse,
    Connor Imes, LP: #509355
  - Use default serverguide index.html file location for accessing serverguide
    in terminal, Connor Imes, LP: #537167#
  - Updated to use Grub2 directions, Connor Imes, LP: #533582
  - Updated MySQL information for mysql-server-5.1, Adam Sommer
  - Replaced screen-profiles with byobu project, Adam Sommer
  - Changed egrep command with kvm-ok script, Adam Sommer
  - Removed references to likewise-open5, Adam Sommer
  - Add reporting-bugs.xml - Steve Beattie
  - Replaced Eucalyptus section with information on UEC, Adam Sommer
  - Updated command and configuration mistakes in vpn.xml, Adam Sommer
    LP: #489819
  - Replaced update-motd section with newer pam_motd, Adam Sommer, LP: #496184
  - Updated LocalSettings.php command for new file path, and recommending upping
    the memory limit based on feedback from Cornelius Brümmer, Adam Sommer
  - Updated Installation section for Lucid, and added row seperator for UEC
    requirement tables, Adam Sommer
  - Changed OpenLDAP TLS/SSL options to use gnutls to create certificate instead 
    of OpenSSL, Adam Sommer
* Switching/Windows:
  - Updated dualboot section to use startupmanager for changing 
    boot options (valid for Grub and Grub2), Connor Imes
  - Fixed 'Ubuntu Ubuntu' typo, Alex Wardle, LP: #526083
  - Removed old string from Windows section and copied correct string to
    Switching guide, Connor Imes, LP: #527905
  - Split off directions for exporting favorites in IE8. Broke different
    IE versions down into subsections, Connor Imes, LP: #528808

Show diffs side-by-side

added added

removed removed

Lines of Context:
serverguide/C/other-apps.xml
19
19
  make administering an Ubuntu server, or many Ubuntu servers, that much easier.
20
20
  </para>
21
21
 
22
 
  <sect1 id="update-motd" status="review">
23
 
    <title>Update MOTD</title>
 
22
  <sect1 id="pam_motd" status="review">
 
23
    <title>pam_motd</title>
24
24
 
25
25
    <para>
26
26
    When logging into an Ubuntu server you may have noticed the informative Message Of The Day (MOTD).  This information
38
38
      </listitem>
39
39
      <listitem>
40
40
        <para>
41
 
        <emphasis>update-motd:</emphasis> is used to automatically update the MOTD via <application>cron</application>.
42
 
        </para>
43
 
      </listitem>
44
 
    </itemizedlist>
45
 
 
46
 
    <para>
47
 
    The <application>update-motd</application> utility has several options to further customize the MOTD:
48
 
    </para>
49
 
 
50
 
    <itemizedlist>
51
 
      <listitem>
52
 
        <para>
53
 
        <emphasis>--disable:</emphasis> prevents automatic updates of the MOTD.  Using this option creates the
54
 
        <filename>/var/lib/update-motd/disabled</filename> file, which if present stops <application>update-motd</application>
55
 
        from modifying <filename>/etc/motd</filename>.
56
 
        </para>
57
 
      </listitem>
58
 
      <listitem>
59
 
        <para>
60
 
        <emphasis>--enable:</emphasis> enables the automatic MOTD updates.  If <filename>/var/lib/update-motd</filename>
61
 
        is present it will be removed.
62
 
        </para>
63
 
      </listitem>
64
 
      <listitem>
65
 
        <para>
66
 
        <emphasis>--force:</emphasis> does a one time update of <filename>/etc/motd</filename>, overriding <application>update-motd</application>
67
 
        if it has been disabled. 
68
 
        </para>
69
 
      </listitem>
70
 
      <listitem>
71
 
        <para>
72
 
        <emphasis>d, hourly, weekly, monthly:</emphasis> option will run the scripts in <filename>/etc/update-motd.d/</filename> (default), 
73
 
        <filename>/etc/update-motd.d/hourly</filename>, <filename>/etc/update-motd.d/weekly</filename>, or
74
 
        <filename>/etc/update-motd.d/monthly</filename> respectively.
75
 
        </para>
76
 
      </listitem>
77
 
    </itemizedlist>
78
 
 
79
 
    <para>
80
 
    <application>update-motd</application> executes the scripts in <filename>/etc/update-motd.d</filename> in order based on the number 
81
 
    prepended to the script.  Separate <application>cron</application> scripts execute every ten minutes, hourly, weekly, and monthly
82
 
    running the corresponding scripts in <filename>/etc/update-motd.d</filename>.  The output of the scripts is written to 
83
 
    <filename>/var/run/update-motd/</filename>, keeping the numerical order, then concatenated with 
84
 
    <filename>/etc/motd.tail</filename> and written to <filename>/etc/motd</filename>.
 
41
        <emphasis>update-notifier-common:</emphasis> is used to automatically update the MOTD via <application>pam_motd</application> module.
 
42
        </para>
 
43
      </listitem>
 
44
    </itemizedlist>
 
45
 
 
46
    <para>    
 
47
    <application>pam_motd</application> executes the scripts in <filename>/etc/update-motd.d</filename> in order based on the number 
 
48
    prepended to the script.  The output of the scripts is written to <filename>/var/run/motd</filename>, keeping the numerical order, 
 
49
    then concatenated with <filename>/etc/motd.tail</filename>.
85
50
    </para>
86
51
 
87
52
    <para>
120
85
 
121
86
<programlisting>
122
87
#!/bin/sh
123
 
##########################################################################
124
 
#
125
 
# Prints the local weather to /var/run/update-motd/60-local-weather  
126
 
# for update-motd.
127
 
#
128
 
##########################################################################
 
88
#
 
89
#
 
90
# Prints the local weather information for the MOTD.
 
91
#
 
92
#
129
93
 
130
94
# Replace KINT with your local weather station.
131
95
# Local stations can be found here: http://www.weather.gov/tg/siteloc.shtml
132
96
 
133
 
echo "" > /var/run/update-motd/60-local-weather
134
 
weather -i KINT >> /var/run/update-motd/60-local-weather
 
97
echo
 
98
weather -i KINT
 
99
echo
135
100
 
136
101
</programlisting>
137
102
      </listitem>
146
111
      </listitem>
147
112
      <listitem>
148
113
        <para>
149
 
        Next, create a symlink to <filename>/etc/update-motd.d/60-local-weather</filename>:
 
114
        Next, create a symlink to <filename>/etc/update-motd.d/98-local-weather</filename>:
150
115
        </para>
151
116
 
152
117
<screen>
153
 
<command>sudo ln -s /usr/local/bin/local-weather /etc/update-motd.d/60-local-weather</command>
 
118
<command>sudo ln -s /usr/local/bin/local-weather /etc/update-motd.d/98-local-weather</command>
154
119
</screen>
155
120
      </listitem>
156
121
      <listitem>
157
122
        <para>
158
 
        Finally, update the MOTD:
 
123
        Finally, exit the server and re-login to view the new MOTD.
159
124
        </para>
160
 
 
161
 
<screen>
162
 
<command>sudo update-motd</command>
163
 
</screen>
164
125
      </listitem>
165
126
    </itemizedlist>
166
127
 
167
128
    <para>
168
129
    You should now be greeted with some useful information, and some information about the local weather that may not be
169
130
    quite so useful. Hopefully the <application>local-weather</application> example demonstrates the flexibility of
170
 
    <application>update-motd</application>.
 
131
    <application>pam_motd</application>.
171
132
    </para>
172
133
 
173
134
  </sect1>
301
262
    </para>
302
263
   
303
264
  </sect1>
304
 
  <sect1 id="screen-profiles" status="review">
305
 
    <title>Screen Profiles</title>
 
265
  <sect1 id="byobu" status="review">
 
266
    <title>Byobu</title>
306
267
 
307
268
    <para>
308
269
    One of the most useful applications for any system administrator is <application>screen</application>.  It allows the execution
309
270
    of multiple shells in one terminal. To make some of the advanced <application>screen</application> features more 
310
 
    user friendly, and provide some useful information about the system, the <application>screen-profiles</application> package was 
 
271
    user friendly, and provide some useful information about the system, the <application>byobu</application> package was 
311
272
    created.  
312
273
    </para>
313
274
 
314
275
    <para>
315
 
    When executing <application>screen</application> for the first time you will be presented with the 
316
 
    <application>screen-profiles-helper</application> menu.  This menu will allow you to:
 
276
    When executing <application>byobu</application> pressing the <emphasis>F9</emphasis> key will bring up the  
 
277
    <application>Configuration</application> menu.  This menu will allow you to:
317
278
    </para>
318
279
 
319
280
    <itemizedlist>
320
281
      <listitem><para>View the Help menu</para></listitem>
 
282
      <listitem><para>Change Byobu's background color</para></listitem>
 
283
      <listitem><para>Change Byobu's foreground color</para></listitem>
 
284
      <listitem><para>Toggle status notifications</para></listitem>
321
285
      <listitem><para>Change the key binding set</para></listitem>
322
 
      <listitem><para>Change screen profiles</para></listitem>
323
286
      <listitem><para>Change the escape sequence</para></listitem>
324
 
      <listitem><para>Create new screen windows</para></listitem>
 
287
      <listitem><para>Create new windows</para></listitem>
325
288
      <listitem><para>Manage the default windows</para></listitem>
326
 
      <listitem><para>Install screen by default at login</para></listitem>
 
289
      <listitem><para>Byobu currently does not launch at login (toggle on)</para></listitem>
327
290
    </itemizedlist>
328
291
 
329
292
    <para>
330
293
    The <emphasis>key bindings</emphasis> determine such things as the escape sequence, new window, change window, etc.  There 
331
 
    are two key binding sets to choose from <emphasis>common</emphasis> and <emphasis>none</emphasis>.  If you wish to use the 
 
294
    are two key binding sets to choose from <emphasis>f-keys</emphasis> and <emphasis>screen-escape-keys</emphasis>.  If you wish to use the 
332
295
    original key bindings choose the <emphasis>none</emphasis> set.
333
296
    </para>
334
297
 
335
298
    <para>
336
 
    The Ubuntu <application>screen-profiles</application> provide a menu which displays the Ubuntu release, processor information,
337
 
    memory information, and the time and date. The effect is similar to a desktop menu.  When a profile is selected it will be 
338
 
    symlinked to <filename>~/.screenrc</filename>.  The <application>select-screen-profile</application> utility can also be used 
339
 
    to change profiles, in a terminal enter:
340
 
    </para>
341
 
 
342
 
<screen>
343
 
<command>select-screen-profile -s ubuntu-light</command>
344
 
</screen>
345
 
   
346
 
    <para>
347
 
    The <emphasis>plain</emphasis> profile will change <application>screen</application> back to the defaults, which does not include
348
 
    the information menu at the bottom.
349
 
    </para>
350
 
 
351
 
    <para>
352
 
    Using the <emphasis>"Install screen by default at login"</emphasis> option will cause screen to be executed any time a terminal is opened.
353
 
    Changes made to <application>screen</application> are on a per user basis, and will not affect other users on the system.
354
 
    </para>
355
 
 
356
 
    <para>
357
 
    One difference when using screen is the <emphasis>scrollback</emphasis> mode.  If you are using one of the Ubuntu profiles press the 
358
 
    <emphasis>F7</emphasis>, or <emphasis>Ctrl+a+[</emphasis> if not, to enter scrollback mode.  Scrollback mode allows you to navigate 
 
299
    <application>byobu</application> provides a menu which displays the Ubuntu release, processor information,
 
300
    memory information, and the time and date. The effect is similar to a desktop menu. 
 
301
    </para>
 
302
 
 
303
    <para>
 
304
    Using the <emphasis>"Byobu currently does not launch at login (toggle on)"</emphasis> option will cause <application>byobu</application>
 
305
    to be executed any time a terminal is opened.  Changes made to <application>byobu</application> are on a per user basis, and will not 
 
306
    affect other users on the system.
 
307
    </para>
 
308
 
 
309
    <para>
 
310
    One difference when using byobu is the <emphasis>scrollback</emphasis> mode.  Press the 
 
311
    <emphasis>F7</emphasis> key to enter scrollback mode.  Scrollback mode allows you to navigate 
359
312
    past output using <emphasis>vi</emphasis> like commands.  Here is a quick list of movement commands:
360
313
    </para>
361
314
 
367
320
      <listitem><para><emphasis>0</emphasis> - Move to the beginning of the current line</para></listitem>
368
321
      <listitem><para><emphasis>$</emphasis> - Move to the end of the current line</para></listitem>
369
322
      <listitem><para><emphasis>G</emphasis> - Moves to the specified line (defaults to the end of the buffer)</para></listitem>
370
 
      <listitem><para><emphasis>C-u</emphasis> - Scrolls a half page up</para></listitem>
371
 
      <listitem><para><emphasis>C-b</emphasis> - Scrolls a full page up</para></listitem>
372
 
      <listitem><para><emphasis>C-d</emphasis> - Scrolls a half page down</para></listitem>
373
 
      <listitem><para><emphasis>C-f</emphasis> - Scrolls the full page down</para></listitem>
374
323
      <listitem><para><emphasis>/</emphasis> - Search forward</para></listitem>
375
324
      <listitem><para><emphasis>?</emphasis> - Search backward</para></listitem>
376
325
      <listitem><para><emphasis>n</emphasis> - Moves to the next match, either forward or backword</para></listitem>
383
332
    <itemizedlist>
384
333
      <listitem>
385
334
        <para>
386
 
        See the <ulink url="http://manpages.ubuntu.com/manpages/jaunty/en/man1/update-motd.1.html">update-motd man page</ulink> for
 
335
        See the <ulink url="http://manpages.ubuntu.com/manpages/&distro-short-codename;/en/man1/update-motd.1.html">update-motd man page</ulink> for
387
336
        more options available to <application>update-motd</application>.
388
337
        </para>
389
338
      </listitem>
402
351
      </listitem>
403
352
      <listitem>
404
353
        <para>
 
354
        The <ulink url="https://help.ubuntu.com/community/etckeeper">etckeeper Ubuntu Wiki</ulink> page.
 
355
        </para>
 
356
      </listitem>
 
357
      <listitem>
 
358
        <para>
405
359
        For the latest news and information about <application>bzr</application> see the <ulink url="http://bazaar-vcs.org/">bzr</ulink> web site.
406
360
        </para>
407
361
      </listitem>
412
366
      </listitem>
413
367
      <listitem>
414
368
        <para>
415
 
        Also, see the <application>screen-profiles</application> <ulink url="https://launchpad.net/screen-profiles">project page</ulink> for more
 
369
        And the <ulink url="https://help.ubuntu.com/community/Screen">Ubuntu Wiki screen</ulink> page.
 
370
        </para>
 
371
      </listitem>
 
372
      <listitem>
 
373
        <para>
 
374
        Also, see the <application>byobu</application> <ulink url="https://launchpad.net/byobu">project page</ulink> for more
416
375
        information.
417
376
        </para>
418
377
      </listitem>