Files
XenOrchestraInstallerUpdater/README.md
Oscar Beaumont f63c5eb598 Fixed Error In The README.md
The File Name In The README.md Is Different To The File In The Git Repo.
2018-05-24 21:43:07 +08:00

99 lines
2.4 KiB
Markdown

# XenOrchestraInstallerUpdater - Install / Update Xen-Orchestra from sources
# In a nutshell
This repo consist of script to install and update [Xen Orchestra](https://xen-orchestra.com/#!/) and readymade files to create Docker image.
# Instructions
### script
Clone this repository and run xo-install.sh script as root
```
./xo-install.sh
```
Tool makes some checks and offers options:
1. Autoinstall
- Installs all dependencies (necessary packages and Xen-Orchestra itself)
- Packages listed in the end of this README
2. Update / Install without dependencies
- Installs Xen-Orchestra from latest sources (doesn't install any packages)
3. Deploy container
- Offers options to build container locally or pull from dockerhub
notes:
- If you choose to install with option 2, you need to take care that required packages are already installed
- You can change xo-server and xo-web git branch by editing xo-install.sh scripts $BRANCH variable
### docker
You can also build the docker image locally if you wish or pull it from [docker hub](https://hub.docker.com/r/ronivay/xen-orchestra/) without using the script.
![Docker hub ronivay/xen-orchestra](http://dockeri.co/image/ronivay/xen-orchestra)
```
docker build -t docker/. xen-orchestra
docker run -p 80:80 xen-orchestra
```
or
```
docker pull ronivay/xen-orchestra
docker run -p 80:80 ronivay/xen-orchestra
```
I suggest adding persistent data mounts for xo-server and redis by adding volume flags to commands above like so:
```
docker run -p 80:80 -v /path/to/xodata:/var/lib/xo-server -v /path/to/redisdata:/var/lib/redis xen-orchestra
```
## Notes
Tool has been tested to work with following distros:
- CentOS 7
- Debian 8
- Ubuntu 16.05
CentOS was tested without SELinux. You need to deal with labels and permissions yourself if you want to use it.
Tool makes all necessary changes required for Xen-Orchestra to run (including packages, user creation, permissions). Please evaluate script if needed.
I take no responsibility of possible damage caused by this tool.
Below is a list of packages that will be installed if missing.
```
CentOS:
- curl
- epel-release
- nodejs (v8)
- npm (v3)
- yarn
- gcc
- gcc+
- make
- openssl-devel
- redis
- libpng-devel
- python
- git
Debian/Ubuntu:
- apt-transport-https
- ca-certificates
- curl
- yarn
- nodejs (v8)
- npm (v3)
- build-essential
- redis-server
- libpng-dev
- git
- python-minimal
```