~ubuntu-manual/ubuntu-manual/saucy

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
132
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
%%Editorial Notes:
%%* Margin notes are tagged with {``}\marginnote{'' in the text.
%% Author: Andrew Montag
%% Original Author:Simon Lewis
%% original work (which may not be included) by: Matt Griffin matt.griffin@canonical.com

%%* Graphics filenames are shown in square brackets after the screenshot. All filename begin with 'U1\_'.
%%Not included:
%%* Ubuntu One Music
%%* Making online backups using Deja Dup 		??
%%* One Conf synchronization 					??
%%* Facebook contacts import wizard
%%* How to delete an Ubuntu One account (not sure if there is a way?)

\section{Ubuntu One}\label{sec:ubuntu-one}

\subsection{What is Ubuntu One?}

%%Ubuntu One is an optional, online storage service that allows you to save and access your data over the Internet and to share and synchronize information with other people and devices. Ubuntu One is run by Canonical, the people who develop Ubuntu.

\indexstart{Ubuntu One}
\index{cloud storage|see{Ubuntu One}}
\index{files!sync|see{Ubuntu One}}
Ubuntu One is a service for storing your files online\dash in your Ubuntu One \emph{Personal Cloud}. Your Ubuntu One Personal Cloud is your personal online storage space; it can be accessed in any web browser or using an Ubuntu One application, such as those for Ubuntu, Windows, iPhone, or Android. Because Ubuntu One stores your files online, it's the perfect way to backup your files to prevent data loss. You can also use Ubuntu One to share files with other people\dash this makes Ubuntu One a great tool for friends, families, and collaborative teams. Ubuntu One also provides services for backing up your contacts and streaming music to mobile devices. The Ubuntu One service is provided by \gls{Canonical}.  

% TODO discuss each point above in detail? Why to back up, why to share... ???

% TODO include this section?

\subsection{How safe is Ubuntu One?}
Before using Ubuntu One, you should bear the following points in mind:
\begin{itemize}
  \item{Uploading, downloading and synchronizing your information with Ubuntu One is done over an encrypted connection, which prevents anybody eavesdropping on your information as it is being transferred.}
  \item{Files are not stored by Canonical in encrypted form. It is important to keep this in mind when deciding what to upload to Ubuntu One. You can use other means to encrypt you data, such as an encrypted zip file.}
  \item{Information uploaded to Ubuntu One can potentially be accessed by Canonical. As with similar online services and websites, you are implicitly trusting them to respect your privacy, so if you feel you cannot trust them with certain information, don't upload it to Ubuntu One.}
  \item{If you violate the Ubuntu One terms and conditions and store illegal material, Canonical may be required to hand the information over to law enforcement agencies without your consent.}
  \item{Your online information can be accessed by anybody who knows (or can guess) your account name and password. For this reason, you should choose a good password and keep it secure.}
\end{itemize}

% TODO keep or throw this section? If keep, revise.

\subsection{Getting started with Ubuntu One}
\marginnote{5~\acronym{GB} is enough to store about 1,500 music files or 5,000 photographs (depending on size).}
To use Ubuntu One, you will need to create a free Ubuntu One account using an email address. This free account gives you access to 5~\acronym{GB} of online storage and the contact syncing service; access to more data storage or the music streaming service requires a paid subscription. 

There are two ways to create an Ubuntu One account. 
You can either sign up using the \application{Ubuntu One Control Panel} (pre-installed in Ubuntu), or you can sign up on the Ubuntu One website \url{https://one.ubuntu.com} by clicking the \menu{Sign Up} link.

\marginscreenshot{03-U1-launcher-icon.png}{ss:U1-launcher-icon}{This Launcher icon opens the Ubuntu One Control Panel.}

\subsubsection{Creating an Ubuntu One account using the \application{Ubuntu One Control Panel}}
In the Launcher, click the \button{Ubuntu One} icon, as shown in figure~\ref{ss:U1-launcher-icon}. This should open the dialog shown in figure~\ref{ss:U1-createacct-welcome}.

\screenshot{03-U1-createacct-welcome.png}{ss:U1-createacct-welcome}{The Ubuntu One Control Panel Welcome Page.}
Click the \button{I don't have an account yet -- sign me up} button.

\screenshot{03-U1-createacct-info-blank.png}{ss:U1-createacct-info}{Fill in all fields with your information to sign up for an Ubuntu One account.}
\marginnote{If you do not have an email address, you can get one for free at \url{gmail.com}.}
Fill in the details requested as shown in figure~\ref{ss:U1-createacct-info}. Make sure you use a valid email address that only you have access to.

%The squiggly text below your details is a \emph{captcha}. You need to re-type the captcha text back into the text box below. Because captchas are automatically generated, they can sometimes be difficult to read. If you get one that is indecipherable, just click the \button{refresh} text to generate another.

\marginnote{The captcha acts as a check that it really is a person filling in the form and not a computer (because a computer won't be able to read the captcha text).}
You should review the \menu{Terms of Service} and \menu{Privacy Policy} before signing up. When you're satisfied, click \button{Set Up Account}.

\screenshot{03-U1-createacct-verification.png}{ss:U1-createacct-verification}{Enter the verification code into the field.}
Within a few minutes, you will receive an email containing the verification code. Enter the verification code into the box as shown in figure~\ref{ss:U1-createacct-verification} and click \button{Next}.

If all goes well, you will see a window saying, ``You are now logged into Ubuntu One.'' Click the \button{Finish} button to dismiss this window. You will also get another email welcoming you to Ubuntu One.
Now that you are logged in to Ubuntu One, you can configure your Ubuntu machine for Ubuntu One file syncing.

% TODO expand on syncing concept?

\subsection{Configure your Ubuntu machine for file syncing}

\marginnote{\emph{Sync} is short for Synchronize; implying that the contents of your Ubuntu One local file system and your Ubuntu One Personal Cloud will always be identical.}
The Ubuntu One desktop application \emph{syncs} your Ubuntu One Personal Cloud with files on your local file system. After logging into the Ubuntu One desktop application the following dialog (figure~\ref{ss:U1-setup-sync}) should appear, allowing you to select which files to sync with your Ubuntu One Personal Cloud. 

\screenshot{03-U1-setup-sync.png}{ss:U1-setup-sync}{This setup dialog lets you select which existing Ubuntu One folders you would like synced with your machine.}
If you have already used your Ubuntu One account, you may have more folders in this view (figure~\ref{ss:U1-setup-sync}). You can choose which Ubuntu One cloud folders you would like synced with your local file system. If this is the first time you are using Ubuntu One, just click the \button{Next} button.

\advanced{You can also change your Ubuntu One sync connection settings at this time by clicking on the \button{Check Settings} button; you can change things like the maximum upload and download rate, or if notifications should be allowed.}

\screenshot{03-U1-setup-sync-select-empty.png}{ss:U1-setup-sync-select}{This setup dialog lets you select which folders of your local file system you would like synced with your Ubuntu One cloud storage.}
In the next dialog (figure~\ref{ss:U1-setup-sync-select}), you can choose which of your local file system folders you would like synced with your Ubuntu One cloud storage. The folder \filepath{Ubuntu One} is implicitly synced, but you can select additional folders you may like synced\dash your pictures, for instance.
Once you're finished selecting folders, click the \button{Finish} button to complete the setup process. You are now ready to begin using Ubuntu One!

\subsection{Using Ubuntu One with \application{Files}, the file manager}

\marginscreenshot{03-U1-files-sync-icons.png}{ss:U1-files-sync-icons}{These symbols indicate the sync status of a file or folder. The Checkmark indicates that the file or folder has been synced, and the circular arrows indicate that the file or folder is in the process of syncing.}
Ubuntu One integrates with \application{Files}, the program you use to view your file system. You can add, sync, and share files directly from \application{Files}.


\subsubsection{Adding and Modifying Files}

You can add files to your Ubuntu One folder (or any other folder that you have selected for sync) just as you normally would, and Ubuntu One will automatically sync them to your personal cloud. For example, if you add your vacation photos, you should see a notification message on the screen similar to figure~\ref{ss:U1-files-sync-files-notification}.

\screenshot{03-U1-files-sync-files-notification.png}{ss:U1-files-sync-files-notification}{When you add files to an Ubuntu One synced folder, they automatically sync to your personal cloud.}

After moving the files into the Ubuntu One synced folder, you should receive a notification informing you that syncing has begun. You can also see that each file shows the circular arrow icon, indicating that it is currently syncing with your personal cloud. When syncing completes, the circular arrows will be replaced with check marks. 

Whenever you add or modify files that are in folders synced with Ubuntu One, they will automatically sync to your personal cloud. After syncing is complete, you can view the files on the Ubuntu One Web \acronym{UI}, and they will also be synced to any other computers or mobile devices that you are using Ubuntu One on. 

\subsubsection{Adding Folders to Sync}

You can add other folders to be synced with your Ubuntu One Personal Cloud, not just your \emph{Ubuntu One} folder. You can add folders to be synced through \application{Files} by right-clicking the folder you would like to sync. In the right-click menu, choose \menu{Ubuntu One\then Synchronize This Folder}, as shown in figure~\ref{ss:U1-files-addfolder-rtclick}. You can also stop syncing a folder through the same right-click menu. 

\screenshot{03-U1-files-addfolder-rtclick.png}{ss:U1-files-addfolder-rtclick}{Use a folder's right-click menu to sync or un-sync the folder from your Ubuntu One Personal Cloud.}

To view which files on your system are currently syncing with Ubuntu One, open the \application{Ubuntu One Control Panel} by clicking the \button{Ubuntu One} Launcher icon, as shown in figure~\ref{ss:U1-launcher-icon}; a dialog similar to that in figure~\ref{ss:U1-files-addfolder-ctlpanel} should appear.

\screenshot{03-U1-files-addfolder-ctlpanel.png}{ss:U1-files-addfolder-ctlpanel}{The Ubuntu One Control Panel shows you which folders in your file system are synced with your Ubuntu One Personal Cloud.}

In the \application{Ubuntu One Control Panel} you can see which of your folders are synced with your Ubuntu One Personal Cloud. You can also add files from here, by clicking the \button{Add a folder from this computer} button.

\subsection{Using Ubuntu One with the Ubuntu One Web UI}

\marginnote{A \emph{Web UI} (User Interface) is a web site that you can go to and do the same things that you do on your computer. Emails, for instance, are commonly accessed through a Web UI.}
You can access your files from any computer using the Ubuntu One Web \acronym{UI} at \url{https://one.ubuntu.com}. When you first reach the web page, you will need to log in by clicking \button{Log in or Sign up} in the upper right-hand corner of the page. On the following page, fill in your email address and Ubuntu One password, then click the \button{Continue} button. 

Once logged in, you should be taken to your \emph{Dashboard}. The Dashboard shows you a summary of your data usage, and keeps you informed of new features in Ubuntu One. 

To view your files, click the \button{Files} link in the navigation bar in the upper portion of the page. 

\subsubsection{Downloading and Uploading Files}
To access your files from the Ubuntu One Web \acronym{UI}, you can simply download them from your personal cloud. To download a file, click \button{More} shown to the right of the file, as shown in the browser, then click on \button{Download file}, as shown in figure~\ref{ss:U1-webui-fileoptions}. Clicking \button{Download file} will initiate a file download through your browser.  

If you make changes to the file or want to add a new file to your personal cloud, simply click the \button{Upload file} button in the upper portion of the page. This will upload the file into the current folder and overwrite any old versions of the file. Once you have uploaded the file, it will be available in your personal cloud, and will sync to your Ubuntu machine's local file system. 

\screenshot{03-U1-webui-fileoptions.png}{ss:U1-webui-fileoptions}{A file's \button{More} button in the Web UI gives you many options.}

\subsubsection{Making Files Public}
You can make a file public on the web by clicking \button{More} and choosing the \button{Publish file} button \dash this is also shown in figure~\ref{ss:U1-webui-fileoptions}. After clicking the \button{Publish file} button, the Web \acronym{UI} will generate a \emph{Public \acronym{URL}}; you can share this \acronym{URL} with anyone. By directing a browser to the Public \acronym{URL} of the file, the browser will begin to download the file or display it, depending on what type of file it is.

You can make the file private again at any time by clicking the \button{Stop publishing} button located to the left of the Public \acronym{URL}. After you click the \button{Stop publishing} button the Public \acronym{URL} field will go away, and the \acronym{URL} will stop working. If someone tries to use a Public \acronym{URL} for a file that has been made private, they will receive an error message and the file will not be downloaded or displayed.

The Ubuntu One Control Panel, on your desktop, lists all of your public files in one place under the \button{Share links} tab. This is a convenient way to keep tabs on which files you are publishing, and allows you to easily copy their links by clicking the \button{Copy link} button located next to each public file. 

\subsubsection{Sharing Files}
Ubuntu One lets you share files with other Ubuntu One users, letting you collaborate on files with ease. When one user makes a change to a shared file the changes automatically sync to the other users' personal clouds and their local file system, so all users automatically have the most recent version of the file. 
\screenshot{03-U1-webui-share.png}{ss:U1-webui-share}{Sharing folders with other users makes collaborating on files simple.}

To share files in Ubuntu One, you must share an entire folder. Before you begin to share files, you should make sure only the files you want to share are in this folder. Then to share this folder, navigate to it in the Ubuntu One Web \acronym{UI}, and click the \button{More} button to the right of the folder name. In the \button{More} menu, click on \button{Share folder}. A dialog box similar to that shown in figure~\ref{ss:U1-webui-share} should appear. Complete the fields in the dialog box, and click the \button{Share this folder} button when you are finished. 

Once you share the folder, the user you are trying to share the folder with should receive an email informing them that you would like to share the files in the folder. They will then have to accept the share request. If the email addressee you provide does not yet have an Ubuntu One account, they must first sign up for an Ubuntu One account before they can access the shared folder.

To stop sharing a folder, navigate to it, click the \button{More} button, and click \button{Stop sharing}.

If another user shares a folder with you, you will receive an email informing you of the share, and a link to click on to accept the share request. Folders that are shared with you by other users will appear in the \emph{Shared With Me} folder inside your Ubuntu One folder (\code{\textasciitilde/Ubuntu One/Shared With Me/}). 

To stop syncing files that are shared with you, navigate to the folder in the Ubuntu One Web \acronym{UI}, click the \button{More} button, then click the \button{Delete this share} button.

\subsection{Exceeding your Ubuntu One Storage Limit}
If you exceed the storage limit of your Ubuntu One account\dash 5~\acronym{GB} is the free limit\dash Ubuntu One will stop syncing your files to your Ubuntu One Personal Cloud.

%\subsubsection{Identifying an Exceeded Storage Limit}
%TODO You will know that you have exceeded your storage limit because.... 
%NOTE I am unable to get Ubuntu One to max capacity, its having lots of issues... -ajmontag

\subsubsection{Remedying an Exceeded Storage Limit}
You can do several things to remedy an exceeded storage limit. Among them are:
\begin{itemize}
  \item Delete any files you no longer need.
  \item Move any files you no longer need synced to another location that is not synced with Ubuntu One.
  \item Purchase additional storage space\dash you can purchase additional storage in 20~\acronym{GB} blocks.
\end{itemize}

\subsubsection{Purchasing Additional Storage Space}
You can purchase additional storage space by clicking the \button{Get more storage} button at the top of the \application{Ubuntu One Control Panel}, or at \url{https://one.ubuntu.com/services/}. Additional storage is available in 20~\acronym{GB} blocks. See \url{https://one.ubuntu.com/services/} for the price of additional storage blocks. 
\screenshot{03-U1-space-buy1.png}{ss:U1-space-buy1}{You can purchase additional storage space on the Ubuntu One website. Note that the prices shown here were correct at the date this manual was published.}

% TODO keep this screenshot?

\screenshot{03-U1-space-buy2.png}{ss:U1-space-buy2}{Ubuntu One accepts credit cards, and PayPal for purchasing additional storage.}

\subsection{Getting Ubuntu One Mobile Apps}

\marginscreenshot{03-U1-mobile-icon.png}{ss:U1-mobile-icon}{This is the icon for the Ubuntu One Android and iPhone apps.}

Ubuntu One has mobile applications for Android and iPhone mobile devices. These applications allow you to access your personal cloud files on-the-go. You can get more information about the Android and iPhone applications at \url{https://one.ubuntu.com/downloads/android/} and \url{https://one.ubuntu.com/downloads/iphone/}, respectively.

\subsection{Getting Ubuntu One for Windows}

Ubuntu One also has a Windows application, which can sync your Ubuntu One Personal Cloud files to the file system of a Windows operating system. More information can be found at \url{https://one.ubuntu.com/downloads/windows/}. 

\subsection{Music Streaming Service of Ubuntu One}
In addition to file syncing, Ubuntu One offers Music Streaming services. This service is not discussed in this book, but additional information can be found at \url{https://one.ubuntu.com/services/music/}. The Music Streaming service requires a paid subscription. See \url{https://one.ubuntu.com/services/} for the price of the Music Streaming service and some attractive special offers. At the time of writing, there is an initial 6 months free and an extra 20~\acronym{GB} of storage, if you buy a track from the Music Store, and two months free on Music Streaming and Storage when you sign up for an additional 20~\acronym{GB} of storage for 12 months.

\indexend{Ubuntu One}