index.xml 11.4 KB
Newer Older
Jonathan Carter's avatar
Jonathan Carter committed
1
2
3
4
5
6
7
8
<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
  <channel>
    <title>Getting-starteds on AIMS Desktop</title>
    <link>https://desktop.aims.ac.za/getting-started/index.xml</link>
    <description>Recent content in Getting-starteds on AIMS Desktop</description>
    <generator>Hugo -- gohugo.io</generator>
    <language>en-us</language>
Jonathan Carter's avatar
Jonathan Carter committed
9
    <lastBuildDate>Wed, 12 Apr 2017 00:11:02 +0100</lastBuildDate>
Jonathan Carter's avatar
Jonathan Carter committed
10
11
12
    <atom:link href="https://desktop.aims.ac.za/getting-started/index.xml" rel="self" type="application/rss+xml" />
    
    <item>
Jonathan Carter's avatar
Jonathan Carter committed
13
      <title>Getting started</title>
Jonathan Carter's avatar
Jonathan Carter committed
14
      <link>https://desktop.aims.ac.za/getting-started/</link>
Jonathan Carter's avatar
Jonathan Carter committed
15
      <pubDate>Wed, 12 Apr 2017 00:11:02 +0100</pubDate>
Jonathan Carter's avatar
Jonathan Carter committed
16
17
      
      <guid>https://desktop.aims.ac.za/getting-started/</guid>
Jonathan Carter's avatar
Jonathan Carter committed
18
19
      <description>

Jonathan Carter's avatar
Jonathan Carter committed
20
&lt;h2 id=&#34;download-aims-desktop&#34;&gt;Download AIMS Desktop&lt;/h2&gt;
Jonathan Carter's avatar
Jonathan Carter committed
21

Jonathan Carter's avatar
Jonathan Carter committed
22
&lt;p&gt;AIMS Desktop can be downloaded from &lt;a href=&#34;https://desktop.aims.ac.za/download&#34;&gt;https://desktop.aims.ac.za/download&lt;/a&gt;.&lt;/p&gt;
Jonathan Carter's avatar
Jonathan Carter committed
23

Jonathan Carter's avatar
Jonathan Carter committed
24
25
&lt;p&gt;AIMS Desktop is a large download (over 3GB), if you&amp;rsquo;re reading this from a mobile connection,
you might want to download it on a broadband connection instead.&lt;/p&gt;
Jonathan Carter's avatar
Jonathan Carter committed
26

Jonathan Carter's avatar
Jonathan Carter committed
27
&lt;h2 id=&#34;preperation&#34;&gt;Preperation&lt;/h2&gt;
Jonathan Carter's avatar
Jonathan Carter committed
28

Jonathan Carter's avatar
Jonathan Carter committed
29
30
&lt;p&gt;AIMS Desktop installs a new operating system to your computer. It can be installed alongside
an existing system such as Microsoft Windows, Apple macOS, BSD or another GNU/Linux system.&lt;/p&gt;
Jonathan Carter's avatar
Jonathan Carter committed
31

Jonathan Carter's avatar
Jonathan Carter committed
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
&lt;p&gt;Installation Media:&lt;/p&gt;

&lt;p&gt;You will need a USB disk that is at least 4GB large. Preparing it as an installation
disk for AIMS desktop will overwrite all the data that&amp;rsquo;s on there, so if you have important files
on that USB disk, you should move it to a safer location before writing the installer to disk.&lt;/p&gt;

&lt;p&gt;If you&amp;rsquo;re familiar with the dd command, you can use that from your Linux or macOS system to write
the command directly to a raw USB device.&lt;/p&gt;

&lt;p&gt;If you&amp;rsquo;re using Windows and don&amp;rsquo;t have access to a Linux device, you can download the Rufus USB
tool at &lt;a href=&#34;https://rufus.akeo.ie/&#34;&gt;https://rufus.akeo.ie/&lt;/a&gt; which makes writing USB disks from Windows really easy and that
tool has been confirmed to work with AIMS Desktop media.&lt;/p&gt;

&lt;p&gt;Prepare your system:&lt;/p&gt;

&lt;p&gt;The AIMS installer will do most of the work, however, here are some tips:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Back up your system.&lt;/strong&gt; Even though there is a very small risk of data loss, it&amp;rsquo;s recommended
that you make a full backup of your system before installing. The installer in AIMS Desktop is
widely used and tested, but making a backup will also protect you against human error.&lt;/p&gt;&lt;/li&gt;

&lt;li&gt;&lt;p&gt;&lt;strong&gt;Disable secure boot.&lt;/strong&gt; AIMS Desktop doesn&amp;rsquo;t yet support secure boot. If your laptop has this
enabled, you should disable it in the firmware before commencing installation. You will have
to consult the manual for your laptop or do an internet search for how to do this on your
machine.&lt;/p&gt;&lt;/li&gt;

&lt;li&gt;&lt;p&gt;&lt;strong&gt;Ensure you have enough power.&lt;/strong&gt; AIMS Desktop will take some time to install. If you&amp;rsquo;re using
a laptop computer, ensure that you are connected to a power source.&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&#34;installation&#34;&gt;Installation&lt;/h2&gt;

&lt;p&gt;For the most part, the installation of AIMS Desktop is very simple. It uses a graphical installation
tool called Calamares (&lt;a href=&#34;https://calamares.io&#34;&gt;https://calamares.io&lt;/a&gt;) which guides you through the entire installation process.&lt;/p&gt;

&lt;p&gt;One aspect to be mindful though, especially if you&amp;rsquo;re dual-booting, is to be aware of the boot method
that your computer uses. Newer computers use UEFI, while older computers use BIOS/Legacy boot mode.&lt;/p&gt;

&lt;p&gt;We&amp;rsquo;ve made it really easy to identify which method your computer uses to boot up. When you start the
AIMS Desktop live USB disk, it will show you the boot method in brackets.&lt;/p&gt;

&lt;p&gt;&lt;img src=&#34;https://desktop.aims.ac.za/images/getting-started/bootmodes.png&#34; alt=&#34;Boot modes&#34; /&gt;
&lt;em&gt;Booting in Legacy/BIOS mode to the left, booting UEFI mode to the right. The red underline has been added to these images for emphasis.&lt;/em&gt;&lt;/p&gt;
Jonathan Carter's avatar
Jonathan Carter committed
76

Jonathan Carter's avatar
Jonathan Carter committed
77
78
79
&lt;p&gt;When you press enter on either boot mode, it will start loading the live environment, and you should
see a loading screen similar to the one below. Startup will take a few seconds to a few minuted depending
on what kind of computer you have.&lt;/p&gt;
Jonathan Carter's avatar
Jonathan Carter committed
80

Jonathan Carter's avatar
Jonathan Carter committed
81
82
&lt;p&gt;&lt;img src=&#34;https://desktop.aims.ac.za/images/getting-started/bootsplash.jpg&#34; alt=&#34;Boot splash screeh&#34; /&gt;
&lt;em&gt;AIMS Desktop startup screen&lt;/em&gt;&lt;/p&gt;
Jonathan Carter's avatar
Jonathan Carter committed
83

Jonathan Carter's avatar
Jonathan Carter committed
84
85
86
&lt;p&gt;When it has finished booted up, you will be presented with the AIMS Desktop Live environment. The
live environment can do a lot more than just install AIMS Desktop, you can also use it to test
whether hardware supports the system, try out the software on AIMS Desktop, or show it to a friend.&lt;/p&gt;
Jonathan Carter's avatar
Jonathan Carter committed
87

Jonathan Carter's avatar
Jonathan Carter committed
88
89
&lt;p&gt;&lt;img src=&#34;https://desktop.aims.ac.za/images/getting-started/aims-live-desktop.jpg&#34; alt=&#34;AIMS Live Desktop&#34; /&gt;
&lt;em&gt;AIMS Live Desktop&lt;/em&gt;&lt;/p&gt;
Jonathan Carter's avatar
Jonathan Carter committed
90

Jonathan Carter's avatar
Jonathan Carter committed
91
&lt;p&gt;The installer icon is the first one after the main menu button on the top left side, as highlighed below. Click on this button if you&amp;rsquo;d like to proceed installing AIMS Desktop.&lt;/p&gt;
Jonathan Carter's avatar
Jonathan Carter committed
92

Jonathan Carter's avatar
Jonathan Carter committed
93
94
&lt;p&gt;&lt;img src=&#34;https://desktop.aims.ac.za/images/getting-started/installer-icon.jpg&#34; alt=&#34;Installer Button&#34; /&gt;
&lt;em&gt;Installer button, as highlighted above&lt;/em&gt;&lt;/p&gt;
Jonathan Carter's avatar
Jonathan Carter committed
95

Jonathan Carter's avatar
Jonathan Carter committed
96
97
&lt;p&gt;You will then be greeted by the installer. If you&amp;rsquo;re unsure about some options like region,
keyboard layout, etc, then you can change it again in the settings manager after installation.&lt;/p&gt;
Jonathan Carter's avatar
Jonathan Carter committed
98

Jonathan Carter's avatar
Jonathan Carter committed
99
100
&lt;p&gt;&lt;img src=&#34;https://desktop.aims.ac.za/images/getting-started/installer-welcome.jpg&#34; alt=&#34;Installer welcome screen&#34; /&gt;
&lt;em&gt;Installer welcome screen&lt;/em&gt;&lt;/p&gt;
Jonathan Carter's avatar
Jonathan Carter committed
101

Jonathan Carter's avatar
Jonathan Carter committed
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
&lt;p&gt;Select the language that you would like to use during the installation, then click on next.&lt;/p&gt;

&lt;p&gt;Then, choose your location and timezone. The city that designates your timezone might not
be the actualy city you&amp;rsquo;re in, and is often the capital of your country.&lt;/p&gt;

&lt;p&gt;&lt;img src=&#34;https://desktop.aims.ac.za/images/getting-started/installer-timezone.jpg&#34; alt=&#34;Time zone settings&#34; /&gt;
&lt;em&gt;Time zone settings&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;Next, we&amp;rsquo;ll select a keyboard layout. Normall, you&amp;rsquo;ll want to select a keyboard layout that closest
match your physical keyboard layout. In some cases, you might want a different layout to match
another computer you&amp;rsquo;re using. The keyboard image in this screen will adapt so that you have a preview
of the option you have chosen, and you can also type test it in the typing space at the bottom.&lt;/p&gt;

&lt;p&gt;&lt;img src=&#34;https://desktop.aims.ac.za/images/getting-started/installer-keyboard.jpg&#34; alt=&#34;Keyboard selection&#34; /&gt;
&lt;em&gt;Keyboard settings&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;Next, we have to allocate some space to install AIMS desktop to. The most basic method of installation
is to use the entire disk for AIMS Desktop. Do do that, you can choose the &amp;ldquo;Erase disk&amp;rdquo; option.&lt;/p&gt;

&lt;p&gt;If you have another system installed, you can also choose to resize that system to make space for
Jonathan Carter's avatar
Jonathan Carter committed
122
123
124
125
126
AIMS Desktop, or to replace an existing partition with AIMS Desktop. To resize, click on an existing
partition and then drag the section below to choose it&amp;rsquo;s new size.&lt;/p&gt;

&lt;p&gt;We&amp;rsquo;re planning to add an advanced partitioning section to this guide in the future, in the meantime,
feel free to ask for guidance on the &lt;a href=&#34;https://groups.google.com/a/aims.ac.za/forum/#%21forum/tech/join&#34;&gt;aims-tech&lt;/a&gt; mailing list if you get stuck.&lt;/p&gt;
Jonathan Carter's avatar
Jonathan Carter committed
127
128
129
130
131
132

&lt;p&gt;&lt;img src=&#34;https://desktop.aims.ac.za/images/getting-started/installer-partition.jpg&#34; alt=&#34;Partitioning&#34; /&gt;
&lt;em&gt;Partitioning screen&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;In the next step, we&amp;rsquo;ll configure your first user for this system. This user will also be an
administrator user.&lt;/p&gt;
Jonathan Carter's avatar
Jonathan Carter committed
133
134

&lt;ul&gt;
Jonathan Carter's avatar
Jonathan Carter committed
135
136
137
138
&lt;li&gt;&lt;strong&gt;Full name:&lt;/strong&gt; You can enter your full name or part of your name in this field.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;User name:&lt;/strong&gt; The user name must not start with a capital letter, can not container numbers, spaces or other special characters. Examples of user names are &lt;code&gt;mohammed&lt;/code&gt;, &lt;code&gt;yasmine&lt;/code&gt;, &lt;code&gt;sarah&lt;/code&gt;, &lt;code&gt;mehdi&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Computer name:&lt;/strong&gt; This is a name that you can use to identify the computer. It must also be lowercase  alphabetical characters, but you can also use a dash, eg: &lt;code&gt;mohammed-pc&lt;/code&gt;, &lt;code&gt;sarah-laptop&lt;/code&gt;, &lt;code&gt;yasmine-macbook&lt;/code&gt;, &lt;code&gt;mehdi-x280&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Password:&lt;/strong&gt; Your password protects access to the computer. Use a password that won&amp;rsquo;t be easy to guess. A password such as &lt;code&gt;password&lt;/code&gt; or &lt;code&gt;latitude&lt;/code&gt; or anything you would find in a dictionary would be too weak. Instead, you might want to consider using a phrase for a password, ideally something that is easy to remember but wouldn&amp;rsquo;t exist in normal conversation, eg: &lt;code&gt;Bunnies drink water in October&lt;/code&gt;.&lt;/li&gt;
Jonathan Carter's avatar
Jonathan Carter committed
139
140
&lt;/ul&gt;

Jonathan Carter's avatar
Jonathan Carter committed
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
&lt;p&gt;&lt;img src=&#34;https://desktop.aims.ac.za/images/getting-started/installer-user.jpg&#34; alt=&#34;User setup&#34; /&gt;
&lt;em&gt;User setup screen&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;Before the installer starts making changes to your system, it will present a summary where you
can review the changes it will make. It&amp;rsquo;s a good idea to look at least at the partitioning summary,
especially if you want to keep an existing system installed as well.&lt;/p&gt;

&lt;p&gt;&lt;img src=&#34;https://desktop.aims.ac.za/images/getting-started/installer-summary.jpg&#34; alt=&#34;Installer summary&#34; /&gt;
&lt;em&gt;Summary of installer actions about to take place&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;When you&amp;rsquo;re ready, click next to proceed with the installation.&lt;/p&gt;

&lt;div class=&#34;admonition warning&#34;&gt;
&lt;p class=&#34;admonition-title&#34;&gt;Remember to plug in&lt;/p&gt;
&lt;p&gt;If you&amp;rsquo;re installing on a laptop device and haven&amp;rsquo;t yet connected it to a power source, then it is
highly recommended you do so before continuing.&lt;/p&gt;
&lt;/div&gt;

&lt;p&gt;&lt;img src=&#34;https://desktop.aims.ac.za/images/getting-started/installer-installing.jpg&#34; alt=&#34;Installation in progress&#34; /&gt;
&lt;em&gt;Installation progress&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;The rest of the installation is automated. On a fast computer, will take around 10 minutes to complete.
On a slower computer, it might take as much as an hour.&lt;/p&gt;
Jonathan Carter's avatar
Jonathan Carter committed
164
</description>
Jonathan Carter's avatar
Jonathan Carter committed
165
166
167
168
    </item>
    
  </channel>
</rss>