From dbaaacf53bc7b6e1b1d354f4a42f7293c000d731 Mon Sep 17 00:00:00 2001 From: Carla Schroder Date: Mon, 14 Sep 2015 09:46:17 -0700 Subject: [PATCH] typo & formatting corrections --- .../installation/appliance_installation.rst | 66 +++++++++++-------- 1 file changed, 40 insertions(+), 26 deletions(-) diff --git a/admin_manual/installation/appliance_installation.rst b/admin_manual/installation/appliance_installation.rst index eb6b38ae2..6b4d84871 100644 --- a/admin_manual/installation/appliance_installation.rst +++ b/admin_manual/installation/appliance_installation.rst @@ -1,55 +1,69 @@ +============================ ownCloud Community Appliance -=================== -ownCloud has a publically developed community appliance `on GitHub`_. Download the latest release from the Appliances tab at the `ownCloud server installation page`_. The easiest way to get the VM up and running is by using `VirtualBox`_ and downloading the OVA image from the installation page. +============================ + +ownCloud has a publicly developed community appliance `on GitHub`_. Download the +latest release from the Appliances tab on the `ownCloud server installation +page`_. The easiest way to get the VM up and running is by using `VirtualBox`_ +and downloading the OVA image from the installation page. Instructions for VirtualBox and OVA -~~~~~~~~~~~~~~~~~~~ +----------------------------------- Follow these steps to get the appliance working: -1. Download the Virtual Machine image zip file and unpack it -2. Start VirtualBox and click on *File ...* > *Import Appliance ...* -3. Click the green Start arrow. After a minute you should see the console greeting message. +1. Download the Virtual Machine image zip file and unpack it. + +2. Start VirtualBox and click on *File ...* > *Import Appliance* and import + your new ownCloud image. + +3. Click the green Start arrow. After a minute you should see the console + greeting message. .. figure:: images/community-vm-console.png + :alt: screenshot of Ubuntu console login for newly-created virtual machine -4. Note the username and password here. It is a random password that we generate for you on first boot. - If you log in at the console, you'll be prompted to change the password. This is optional. -5. With your web-browser try ``http://localhost:8888`` or ``http://localhost:80`` or the addess printed on the console. - One of them should work. If not, please review and adjust the network setup of virtualbox to bridged mode. -6. You should see a webpage with login credentials (if you haven't changed them already) and a list of URLs to try to reach the ownCloud web service. Which one works, again depends on the network setup of your hypervisor. +4. Note the username and password here. It is a random password that we generate + for you on first boot. If you log in at the console, you'll be prompted to + change the password. This is optional. + +5. With your web-browser try ``http://localhost:8888`` or + ``http://localhost:80`` or the addess printed on the console. One of them + should work. If not, please review and adjust the network setup of + virtualbox to bridged mode. + +6. You should see a Web page with login credentials (if you haven't changed + them already) and a list of URLs to try to reach the ownCloud web + service. Which one works, again depends on the network setup of your + hypervisor. .. figure:: images/community-vm-splash.png :scale: 50% + :alt: screenshot of new virtual machine Web GUI with login credentials *Click to enlarge* -.. note:: Before diving into ownCloud, please consider memorizing the admin password, and cmake sure the login credentials are no longer displayed. Click the *[Hide Credentials]* button. When using the ownCloud Proxy app, this web-page may be publicly visible. +.. note:: You should write down your admin password, and make sure the login + credentials are no longer displayed. Click the *[Hide Credentials]* button. + When using the ownCloud Proxy app, this Web page may be publicly visible. -.. note:: Inside the VM, ownCloud runs with a default disk size of 40 GB and its own mysql database. The ownCloud admin user is also a valid account on the ubuntu system that runs inside the VM. You can ssh into the machine and do sudo from there, and administrate the system. +.. note:: Inside the VM, ownCloud runs with a default disk size of 40 GB and its + own MySql database. The ownCloud admin user is also a valid account on the + Ubuntu system that runs inside the VM. You can administer the VM via SSH. **For VMware** You can follow most of the steps above, however, after opening the VMX file, you will have to configure ``Bridged Network`` as *Network Adapter* Software Appliances -~~~~~~~~~~~~~~~~~~~ +------------------- There are a number of unofficial pre-made virtual machine-based appliances: -- `SUSE Studio, ownCloud on openSuSE`_, runnable directly from an USB stick. +- `SUSE Studio, ownCloud on openSuSE`_, which runs directly from an USB stick. - `Amahi home server`_ -- `ownCloud VM on Ubuntu 14.04 with MySQL and Apache`_, fully configured from start - -.. ownCloud on Hardware Appliances -.. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. These are tutorials provided by the user communities of the respective appliances: - -.. - `ownCloud 7 on Raspberry Pi (Arch Linux) using Lighttpd`_ for the popular credit-card sized computer -.. - `QNAP Guide`_ for QNAP NAS appliances -.. - `OpenWrt Guide`_ for the popular embedded distribution for routers and NAS devices. -.. - `Synology Package`_ for Synology NAS products +- `ownCloud VM on Ubuntu 14.04 with MySQL and Apache`_, fully configured + environment. .. _on Github: https://github.com/ownCloud/vm .. _VirtualBox: https://www.virtualbox.org