index.html 15.3 KB
Newer Older
Jonathan Carter's avatar
Jonathan Carter committed
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
<!DOCTYPE html>
  
  
  
  
   <html class="no-js"> 

  <head lang="en-us">
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
    <meta http-equiv="X-UA-Compatible" content="IE=10" />
    <title>Tips and Tricks - AIMS Desktop</title>
    <meta name="generator" content="Hugo 0.18.1" />

    
    <link rel="canonical" href="https://desktop.aims.ac.za/tips-tricks/">
    

    <meta property="og:url" content="https://desktop.aims.ac.za/tips-tricks/">
    <meta property="og:title" content="AIMS Desktop">
    <meta property="og:image" content="https://desktop.aims.ac.za/images/logo.png">
    <meta name="apple-mobile-web-app-title" content="AIMS Desktop">
    <meta name="apple-mobile-web-app-capable" content="yes">
    <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">

    <link rel="shortcut icon" type="image/x-icon" href="https://desktop.aims.ac.za/images/favicon.ico">
    <link rel="icon" type="image/x-icon" href="https://desktop.aims.ac.za/images/favicon.ico">

    <style>
      @font-face {
        font-family: 'Icon';
        src: url('https://desktop.aims.ac.za/fonts/icon.eot');
        src: url('https://desktop.aims.ac.za/fonts/icon.eot')
               format('embedded-opentype'),
             url('https://desktop.aims.ac.za/fonts/icon.woff')
               format('woff'),
             url('https://desktop.aims.ac.za/fonts/icon.ttf')
               format('truetype'),
             url('https://desktop.aims.ac.za/fonts/icon.svg')
               format('svg');
        font-weight: normal;
        font-style: normal;
      }
    </style>

    <link rel="stylesheet" href="https://desktop.aims.ac.za/stylesheets/application.css">
    <link rel="stylesheet" href="https://desktop.aims.ac.za/stylesheets/temporary.css">
    <link rel="stylesheet" href="https://desktop.aims.ac.za/stylesheets/palettes.css">
    <link rel="stylesheet" href="https://desktop.aims.ac.za/stylesheets/highlight/highlight.css">

    
    
    
    <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Ubuntu:400,700|Ubuntu&#43;Mono">
    <style>
      body, input {
        font-family: 'Ubuntu', Helvetica, Arial, sans-serif;
      }
      pre, code {
        font-family: 'Ubuntu Mono', 'Courier New', 'Courier', monospace;
      }
    </style>

    
    <script src="https://desktop.aims.ac.za/javascripts/modernizr.js"></script>

    

  </head>
  <body class="palette-primary-#fc0000 palette-accent-blue">




<div class="backdrop">
	<div class="backdrop-paper"></div>
</div>

<input class="toggle" type="checkbox" id="toggle-drawer">
<input class="toggle" type="checkbox" id="toggle-search">
<label class="toggle-button overlay" for="toggle-drawer"></label>

<header class="header">
	<nav aria-label="Header">
  <div class="bar default">
    <div class="button button-menu" role="button" aria-label="Menu">
      <label class="toggle-button icon icon-menu" for="toggle-drawer">
        <span></span>
      </label>
    </div>
    <div class="stretch">
      <div class="title">
        
	<a href="https://desktop.aims.ac.za/"><img alt="AIMS Desktop" src="https://desktop.aims.ac.za/images/aims-desktop-heading.png" /></a>
      </div>
    </div>

    

    
    
        
  </div>
  <div class="bar search">
    <div class="button button-close" role="button" aria-label="Close">
      <label class="toggle-button icon icon-back" for="toggle-search"></label>
    </div>
    <div class="stretch">
      <div class="field">
        <input class="query" type="text" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck>
      </div>
    </div>
    <div class="button button-reset" role="button" aria-label="Search">
      <button class="toggle-button icon icon-close" id="reset-search"></button>
    </div>
  </div>
</nav>

</header>

<main class="main">
	<div class="drawer">
		<nav aria-label="Navigation">
  <a href="https://desktop.aims.ac.za/download" class="project">
    <div class="banner">
      
        <div class="logo">
          <img src="https://desktop.aims.ac.za/images/logo.png">
        </div>
      
      <div class="name">
Jonathan Carter's avatar
Jonathan Carter committed
132
        <strong>AIMS Desktop <span class="version">2020.2</span></strong>
Jonathan Carter's avatar
Jonathan Carter committed
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
        
      </div>
    </div>
  </a>

  <div class="scrollable">
    <div class="wrapper">
      

      <div class="toc">
        
        <ul>
          




<li>
  
    



<a  title="AIMS Desktop" href="https://desktop.aims.ac.za/">
	
	AIMS Desktop
</a>



  
</li>



<li>
  
    



<a  title="Getting started" href="https://desktop.aims.ac.za/getting-started/">
	
	Getting started
</a>



  
</li>



<li>
  
    



<a class="current" title="Tips and Tricks" href="https://desktop.aims.ac.za/tips-tricks/">
	
	Tips and Tricks
</a>


<ul id="scrollspy">
</ul>


  
</li>



<li>
  
    



<a  title="Roadmap" href="https://desktop.aims.ac.za/roadmap/">
	
	Roadmap
</a>



  
</li>



<li>
  
    



<a  title="License" href="https://desktop.aims.ac.za/license/">
	
	License
</a>



  
</li>


        </ul>
        

        
      </div>
    </div>
  </div>
</nav>

	</div>

	<article class="article">
		<div class="wrapper">
			<h1>Tips and Tricks </h1>

			

<h2 id="managing-software">Managing software</h2>

<p>Being based on Debian, AIMS Desktop uses the APT (Advanced Package Tool) to manage software.</p>

<p>Software and its dependencies on AIMS Desktop is managed via packages, for each program on
your computer, there is at least one package. Packages can be installed, removed or upgraded.</p>

<p>Here we will show you how to manage software using APT in the command line. APT needs root
(administrator) privileges, so you need to run it using the sudo command.</p>

<p>For example, if you want to install the program &ldquo;meld&rdquo;, you would use <code>apt install</code>:</p>

<pre><code class="language-none">$ sudo apt install meld
The following NEW packages will be installed:
  meld
Do you want to continue? [Y/n] y
</code></pre>

<p>If you would like to remove that package, you can use <code>apt remove</code>:</p>

<pre><code class="language-none">$ sudo apt remove meld
The following packages will be REMOVED:
  meld
Do you want to continue? [Y/n] y
</code></pre>

<p>APT&rsquo;s remove tool plays it safe, and doesn&rsquo;t automatically remove configuration
files or data that may have been created for a package in the system. If you&rsquo;d
like to remove that as well, you can use the purge command. This does not affect
any data in your home directory.</p>

<pre><code class="language-none">$ sudo apt purge meld
The following packages will be REMOVED:
  meld*
Do you want to continue? [Y/n] y
</code></pre>

<p>You will notice an asterisk next to the package name, this indicates that the
package will be purged, as apposed to a normal removal.</p>

<p>Security updates and other important software updates happen regularly. To update
the list of the available packages for your system, you can run <code>apt update</code>. To
install any available upgrades, you can run <code>apt upgrade</code>.</p>

<pre><code class="language-none">$ sudo apt update
Hit:1 http://http.debian.net/debian stretch InRelease
Get:1 http://security.debian.org/debian-security stretch/updates InRelease [62.9 kB]
...
$ sudo apt upgrade
The following packages were automatically installed and are no longer required:
  libnfsidmap2 libtirpc1
  Use 'sudo apt autoremove' to remove them.
The following packages will be upgraded:
  busybox
Do you want to continue? [Y/n] y
</code></pre>

<p>In the example above, apt points out that two of the installed packages are no longer
required. They might have been installed as dependencies of packages that have been
previously removed. To remove them, use the <code>apt autoremove</code> command:</p>

<pre><code class="language-none">The following packages will be REMOVED:
  libnfsidmap2 libtirpc1
Do you want to continue? [Y/n]
</code></pre>

<div class="admonition note">
<p class="admonition-title">Tip: GNOME Software</p>
<p>GNOME Software is a graphical front-end that supports APT. It makes it easier to
find and install software if you&rsquo;re still new to the system.</p>

<div style="text-align: center; margin-top: 1em;">
<img src="https://desktop.aims.ac.za/images/tips-tricks/gnome-software.png" alt="" />
</div>
</p>
</div>

<h2 id="connecting-to-remote-servers-via-ssh">Connecting to remote servers via SSH</h2>

<p><strong>Introduction:</strong> Servers that you normally ssh into can be accessed through
the Nautilus file manager. This allows you browse your remote files, edit them
and copy to and from the remote server.</p>

<p><strong>Step 1:</strong> Open Nautilus/Files
<div style="text-align: center; margin-top: 1em;">
<img src="https://desktop.aims.ac.za/images/tips-tricks/2017.01-nautilus-ssh-1.png" alt="" />
</div></p>

<p><strong>Step 2:</strong> In the location pane, click on <em>Other Locations</em>.
<div style="text-align: center; margin-top: 1em;">
<img src="https://desktop.aims.ac.za/images/tips-tricks/2017.01-nautilus-ssh-2.png" alt="" />
</div></p>

<p><strong>Step 3:</strong> At the bottom there is a field to <em>Connect to Server</em>.
<div style="text-align: center; margin-top: 1em;">
<img src="https://desktop.aims.ac.za/images/tips-tricks/2017.01-nautilus-ssh-3.png" alt="" />
</div></p>

<p><strong>Step 4:</strong> In this field enter <code>ssh://&lt;user&gt;:&lt;server&gt;</code>, where <code>&lt;user&gt;</code> is your
username and <code>&lt;server&gt;</code> is the address of the server you are connecting to.
Replace <code>ssh</code> with <code>sftp</code> if you wish to connect to a SFTP server.</p>

<p><strong>Step 5:</strong> This will prompt you for a password if necessary and mount the
location. You will see the server in the left panel and a listing of files on
the right.</p>

<p><strong>Step 6:</strong> If you wish to bookmark this server for future use, right-click on
the server in the location pane and select <em>Add Bookmark</em>.
<div style="text-align: center; margin-top: 1em;">
<img src="https://desktop.aims.ac.za/images/tips-tricks/2017.01-nautilus-ssh-4.png" alt="" />
</div></p>

<h2 id="changing-your-password">Changing your password</h2>

<h3 id="gnome-desktop">GNOME Desktop</h3>

<p><strong>Step 1:</strong> Open the Activities overview and start typing <em>Users</em>.
<div style="text-align: center; margin-top: 1em;">
<img src="https://desktop.aims.ac.za/images/tips-tricks/2017.01-change-password-1.png" alt="" />
</div></p>

<p><strong>Step 2:</strong> Click <em>Users</em> to open the panel.
<div style="text-align: center; margin-top: 1em;">
<img src="https://desktop.aims.ac.za/images/tips-tricks/2017.01-change-password-2.png" alt="" />
</div></p>

<p><strong>Step 3:</strong> Click the label next to <em>Password</em>.</p>

<p><strong>Step 4:</strong> Enter your current password, then a new password.</p>

<p><strong>Step 5:</strong> Enter your new password again in the <em>Verify New Password</em> field.
You can press the gear icon to automatically generate a random password.
<div style="text-align: center; margin-top: 1em;">
<img src="https://desktop.aims.ac.za/images/tips-tricks/2017.01-change-password-3.png" alt="" />
</div></p>

<p><strong>Step 6:</strong> Click <em>Change</em>.</p>

<h3 id="command-line">Command Line</h3>

<p><strong>Step 1:</strong> Open the terminal.
<strong>Step 2:</strong> Enter</p>

<pre><code>passwd
</code></pre>

<p>and follow the prompts.</p>

<p><strong>Step 3:</strong> Enter your current password, your new password and then confirm your
new password. You will not be able to see your password when you type it in.</p>

<div class="admonition note">
<p class="admonition-title">How to choose a strong password</p>
<p><ul>
<li>Make your passwords easy enough for you to remember, but very difficult to for
others to guess. Your password guards your personal information, so you should
make sure it is a strong one.</li>
<li>Use a mixture of upper-case and lower-case letters, numbers, symbols and
spaces in the password. A good way of doing this to the take the first letter of
each word and the grammar of a phrase you can remember.</li>
<li>Make your password as long as possible. This makes it difficult for a person
or computer to guess it.</li>
<li>Do not use one or two words from a dictionary in any language. These are what
programs use to try crack your password.</li>
<li>Do not use any personal information such as a date, family member&rsquo;s name or a
pet.</li>
<li>Never write your password down.</li>
<li>Use different passwords for different things.</li>
</ul>
</p>
</div>

<h2 id="file-templates">File Templates</h2>

<p>In previous versions, you could right-click anywhere in the file manager and
create a new blank file. In the current version, this has been extended so that
you can create any kind of file as a template for a new file. This could be a
shell script, document, blank file or any other kind of document that you create
on a regular basis.</p>

<p>To do this, all you need to do is place new documents as template files in your
Templates directory.</p>

<p><img alt="" width="100%" title="Templates directory in file browser"
src="/images/templates/templates-1.png" /></p>

<p>Then, those documents will be available when you right-click in the file
browser:</p>

<p><img alt="" width="100%" title="Templates being accessed in file browser"
src="/images/templates/templates-2.png" /></p>


			<aside class="copyright" role="note">
				
Copyright © 2017 <a href="https://aims.ac.za">African Institute for Mathematical Sciences</a>. Released under <a href="https://desktop.aims.ac.za/license">free licences</a>.

			</aside>

			<footer class="footer">
				

			</footer>
		</div>
	</article>

	<div class="results" role="status" aria-live="polite">
		<div class="scrollable">
			<div class="wrapper">
				<div class="meta"></div>
				<div class="list"></div>
			</div>
		</div>
	</div>
</main>

    <script>
    
      var base_url = '';
      var repo_id  = '';
    
    </script>

    <script src="https://desktop.aims.ac.za/javascripts/application.js"></script>
    

    <script>
      /* Add headers to scrollspy */
      var headers   = document.getElementsByTagName("h2");
      var scrollspy = document.getElementById('scrollspy');

      if(scrollspy) {
        if(headers.length > 0) {
          for(var i = 0; i < headers.length; i++) {
            var li = document.createElement("li");
            li.setAttribute("class", "anchor");

            var a  = document.createElement("a");
            a.setAttribute("href", "#" + headers[i].id);
            a.setAttribute("title", headers[i].innerHTML);
            a.innerHTML = headers[i].innerHTML;

            li.appendChild(a)
            scrollspy.appendChild(li);
          }
        } else {
          scrollspy.parentElement.removeChild(scrollspy)
        }


        /* Add permanent link next to the headers */
        var headers = document.querySelectorAll("h1, h2, h3, h4, h5, h6");

        for(var i = 0; i < headers.length; i++) {
            var a = document.createElement("a");
            a.setAttribute("class", "headerlink");
            a.setAttribute("href", "#" + headers[i].id);
            a.setAttribute("title", "Permanent link")
            a.innerHTML = "#";
            headers[i].appendChild(a);
        }
      }
    </script>

    

    <script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/highlight.min.js"></script>
    <script>hljs.initHighlightingOnLoad();</script>
  </body>
</html>