installsystem.rst 3.07 KB
Newer Older
1 2
.. _install:

3
*********************
4
Installing the System
5
*********************
6

7 8
Please refer to the section :ref:`Troubleshooting <troubleshooting>` if ever you have errors during the installation.

9
There are two official ways to install XiVO:
10

11 12
* using the official ISO image
* using a minimal Debian installation and the XiVO installation script
13

14
XiVO can be installed on both virtual (QEMU/KVM, VirtualBox, ...) and physical machines. That said, since
15
Asterisk is sensitive to timing issues, you might get better results by installing XiVO on real
16
hardware.
17

Etienne Lessard's avatar
Etienne Lessard committed
18

19 20
Installing from the ISO image
=============================
21

22 23 24
* Download the ISO image. (`latest version`_) (`all versions`_)
* Boot from the ISO image, select ``Install`` and follow the instructions. You must select a locale
  with charset UTF-8.
Sebastien Duthil's avatar
Sebastien Duthil committed
25 26 27
* At the end of the installation, you can continue by running the :ref:`configuration
  wizard. <configuration_wizard>`

Vojtech Sodoma's avatar
Vojtech Sodoma committed
28
During the installation of Debian, only a proxy that supports proxying http/https requests may eventually be entered.
Vojtech Sodoma's avatar
Vojtech Sodoma committed
29 30 31
Otherwise GPG key of XiVO repository will not be installed and must be added manually::

   wget http://mirror.xivo.solutions/xivo_current.key -O - | apt-key add -
Vojtech Sodoma's avatar
Vojtech Sodoma committed
32

33 34
.. _all versions: http://mirror.xivo.solutions/iso/archives
.. _latest version: http://mirror.xivo.solutions/iso/xivo-current
35

Etienne Lessard's avatar
Etienne Lessard committed
36

37 38 39
Installing from a minimal Debian installation
=============================================

Etienne Allovon's avatar
Etienne Allovon committed
40
XiVO can be installed directly over a **64-bit** Debian jessie. When doing so, you are strongly
Etienne Lessard's avatar
Etienne Lessard committed
41 42 43 44
advised to start with a clean and minimal installation of Debian jessie.

The latest installation image for Debian jessie can be found at https://www.debian.org/releases/jessie/debian-installer.

45

46 47 48 49 50
Requirements
^^^^^^^^^^^^

The installed Debian must:

Etienne Allovon's avatar
Etienne Allovon committed
51
* use the architecture ``amd64``
52 53
* have a default locale with charset UTF-8

Etienne Allovon's avatar
Etienne Allovon committed
54
.. note:: In case you want to migrate a XiVO from ``i386`` to ``amd64``, see :ref:`migrate_i386_to_amd64`.
55

Pascal Cadotte Michaud's avatar
Pascal Cadotte Michaud committed
56

57 58 59
Installation
^^^^^^^^^^^^

60 61
Once you have your Debian jessie properly installed, download the XiVO installation script and make
it executable::
62

63
   wget http://mirror.xivo.solutions/xivo_install.sh
sduthil's avatar
sduthil committed
64
   chmod +x xivo_install.sh
65

66
And run it::
67

sduthil's avatar
sduthil committed
68
   ./xivo_install.sh
69

70 71
At the end of the installation, you can continue by running the :ref:`configuration
wizard. <configuration_wizard>`
72

73

74 75
Alternatives versions
^^^^^^^^^^^^^^^^^^^^^
76

77 78 79
The installation script can also be used to install an :ref:`archive version <archive-version>` of
XiVO (14.18 or later only). For example, if you want to install XiVO 16.03::

sduthil's avatar
sduthil committed
80
   ./xivo_install.sh -a 16.03
81 82 83

When installing an archive version, note that:

sduthil's avatar
sduthil committed
84
* versions 14.18 to 15.19 of XiVO can only be installed on a Debian 7 (wheezy) system
85
* the 64-bit versions of XiVO are only available starting from 15.16
Sebastien Duthil's avatar
Sebastien Duthil committed
86

sduthil's avatar
sduthil committed
87 88 89 90 91
You may also install development versions of XiVO with this script. These versions may be unstable
and should not be used on a production server. Please refer to the usage of the script::

   ./xivo_install.sh -h

Etienne Lessard's avatar
Etienne Lessard committed
92

93 94
Other installation methods
==========================
95

96
It's also possible to install XiVO by PXE. It is not documented here.
97