Difference between revisions of "OwnCloud"

From PC-BSD Wiki
Jump to: navigation, search
(Configuring ownCloud)
m
(7 intermediate revisions by 2 users not shown)
Line 3: Line 3:
 
{{citelink|url=http://owncloud.org/|txt=ownCloud}} is open source software that allows you to create your own cloud storage. This allows you to share data, contacts, and calendars with other devices and users.
 
{{citelink|url=http://owncloud.org/|txt=ownCloud}} is open source software that allows you to create your own cloud storage. This allows you to share data, contacts, and calendars with other devices and users.
  
In PC-BSD®, you can create your own private cloud service by installing ownCloud either into a traditional jail that you created using [[Warden®]] or into a [[Install a Server|TrueOS® installation]]. For security reasons, it is recommended to not install ownCloud directly onto a desktop installation as the web and database services it requires may expose the desktop to security vulnerabilities. If you are installing ownCloud on a PC-BSD® system, create a traditional jail as it isolates the software installed into the jail from your desktop operating system.
+
In PC-BSD®, you can create your own private cloud service by installing ownCloud either into a traditional jail that you created using [[Warden®]] or into a [[Install a Server|TrueOS® installation]]. For security reasons, installing ownCloud directly onto a desktop installation is not recommended, as the web and database services it requires may expose the desktop to security vulnerabilities. If you are installing ownCloud on a PC-BSD® system, create a traditional jail as it isolates the software installed into the jail from your desktop operating system.
  
 
=== Install and Start the Required Services ===
 
=== Install and Start the Required Services ===
  
If you are installing ownCloud into a traditional jail, make sure that the jail has been started, then go to the Packages tab of the jail as seen in the example in Figure 9.9a.
+
If you are installing ownCloud into a traditional jail, make sure that the jail has been started, then go to the "Packages" tab of the jail as seen in the example in Figure 9.9a.
  
 
'''Figure 9.9a: Install the Required Packages'''
 
'''Figure 9.9a: Install the Required Packages'''
Line 13: Line 13:
 
[[File:Owncloud.png]]
 
[[File:Owncloud.png]]
  
Check the boxes for Database-Servers ➜ MySQL, Languages ➜ PHP, and Web-Servers ➜ Apache, then click the Apply button to install these packages.
+
Check the boxes for Database-Servers ➜ MySQL, Languages ➜ PHP, and Web-Servers ➜ Apache, then click the "Apply" button to install these packages.
  
 
Once installed, go to Tools ➜ Service Manager which will open the screen shown in Figure 9.9b. Highlight the apache22 service and click the "Enable Service" button and then the "Start" button. Repeat for the mysql service.
 
Once installed, go to Tools ➜ Service Manager which will open the screen shown in Figure 9.9b. Highlight the apache22 service and click the "Enable Service" button and then the "Start" button. Repeat for the mysql service.
Line 47: Line 47:
 
  pass in quick on re0 proto tcp from any to (re0) port 80 keep state
 
  pass in quick on re0 proto tcp from any to (re0) port 80 keep state
  
You may wish to modify "any" just the IP addresses of the systems on your network and "re0" should be replaced with the interface used by the jail.
+
You may wish to replace ''any'' with just the IP addresses of the systems on your network. ''re0'' should be replaced with the interface used by the jail.
  
 
=== Configuring ownCloud ===
 
=== Configuring ownCloud ===
Line 60: Line 60:
 
  '''chown -R www:www owncloud'''
 
  '''chown -R www:www owncloud'''
  
Next, configure the MySQL database, substituting "ocuser" and "mypass" with the username and password that you wish to use:
+
Next, configure the MySQL database, substituting ''ocuser'' and ''mypass'' with the username and password that you wish to use:
  
 
  '''mysql -u root'''
 
  '''mysql -u root'''
Line 99: Line 99:
 
[[File:Owncloud2.png]]
 
[[File:Owncloud2.png]]
  
Input the name of the user and password that will be used to administer ownCloud, then click the advanced button. In the advanced settings, click the MySQL tab and input the MySQL username, password, and database name that you configured previously. Click the “Finish setup” button to save your chanes and enter your new cloud interface, shown in Figure 9.9d.
+
Input the name of the user and password that will be used to administer ownCloud, then click the "
 +
"Advanced" button. In the advanced settings, click the "MySQL" tab and input the MySQL username, password, and database name that you configured previously. Click the “Finish setup” button to save your changes and enter your new cloud interface -- shown in Figure 9.9d.
  
 
'''Figure 9.9d: ownCloud Interface'''
 
'''Figure 9.9d: ownCloud Interface'''
Line 105: Line 106:
 
[[File:Owncloud3.png]]
 
[[File:Owncloud3.png]]
  
Click the left panel of the interface to access a type of media. For example, if you click Files and then the New button, you can upload a file, folder, or from a URL. If you click Contacts, you can add a contact or import/export the address book.  
+
Click the left panel of the interface to access a type of media. For example, if you click "Files" and then the "New" button, you can upload a file, folder, or from a URL. If you click "Contacts", you can add a contact or import/export the address book.  
  
Click the Settings icon at the bottom of the left panel to add users, configure applications, change the administrative configuration, and to access Help.
+
Click the "Settings" icon at the bottom of the left panel to add users, configure applications, change the administrative configuration, and to access "Help".
  
 
Instructions for synchronizing the calendar and address book, integrating with a file manager, and integrating with a media player can be found in the {{citelink|url=http://owncloud.org/support/|txt=documentation section of the ownCloud website}}. Synchronization clients are available from {{citelink|url=http://owncloud.org/sync-clients/|txt=the owncloud site}}.
 
Instructions for synchronizing the calendar and address book, integrating with a file manager, and integrating with a media player can be found in the {{citelink|url=http://owncloud.org/support/|txt=documentation section of the ownCloud website}}. Synchronization clients are available from {{citelink|url=http://owncloud.org/sync-clients/|txt=the owncloud site}}.

Revision as of 13:48, 16 December 2012

(Sorry for the inconvenience)

Contents

ownCloud[1] is open source software that allows you to create your own cloud storage. This allows you to share data, contacts, and calendars with other devices and users.

In PC-BSD®, you can create your own private cloud service by installing ownCloud either into a traditional jail that you created using Warden® or into a TrueOS® installation. For security reasons, installing ownCloud directly onto a desktop installation is not recommended, as the web and database services it requires may expose the desktop to security vulnerabilities. If you are installing ownCloud on a PC-BSD® system, create a traditional jail as it isolates the software installed into the jail from your desktop operating system.

Install and Start the Required Services

If you are installing ownCloud into a traditional jail, make sure that the jail has been started, then go to the "Packages" tab of the jail as seen in the example in Figure 9.9a.

Figure 9.9a: Install the Required Packages

Owncloud.png

Check the boxes for Database-Servers ➜ MySQL, Languages ➜ PHP, and Web-Servers ➜ Apache, then click the "Apply" button to install these packages.

Once installed, go to Tools ➜ Service Manager which will open the screen shown in Figure 9.9b. Highlight the apache22 service and click the "Enable Service" button and then the "Start" button. Repeat for the mysql service.

Figure 9.9b: Start the Required Services

Owncloud1.png

Verify that you can reach the web server by typing the IP address of the jail into a web browser. You should receive an "It works!" message. You will need to first allow incoming TCP port 80 on the jail interface using Firewall Manager if you use a web browser on a different computer.

If you are installing ownCloud onto a TrueOS™ system, you will need to create the jail and install the dependencies from the command line. When creating the jail, specify the jail IP address and hostname as seen in this example:

warden create 10.0.0.1 owncloudjail --startauto
pc-metapkgmanager --pkgset warden --chroot /usr/jails/10.0.0.1 add MySQL,Apache,PHP

Once the software is installed, access the jail by its IP address in order to edit the /etc/rc.conf file within the jail so that the required services start when the jail is available:

warden chroot 10.0.0.1
vi /etc/rc.conf

Add these two lines to that file:

apache22_enable=”YES” 
mysql_enable=”YES”

Save your edits then start the services:

usr/local/etc/rc.d/apache22 start
/usr/local/etc/rc.d/mysql-server start

Verify that you can reach the web server by typing the IP address of the jail into a web browser. You should receive a "It works!" message. You will need to first edit /etc/pf.conf in order to allow incoming TCP port 80 using if you use a web browser on a different computer. An example would be to add a line to the "Nic specific rules" section:

pass in quick on re0 proto tcp from any to (re0) port 80 keep state

You may wish to replace any with just the IP addresses of the systems on your network. re0 should be replaced with the interface used by the jail.

Configuring ownCloud

You are now ready to download and configure ownCloud. If you are using a traditional jail on your desktop, go to Tools -> Launch Terminal to access the jail's command line. If you are using TrueOS™, use the warden chroot command to access the command line of the jail.

Once at the command line of the jail, download ownCloud into the Apache data directory:

cd /usr/local/www/apache22/data
fetch http://download.owncloud.org/releases/owncloud-4.0.7.tar.bz2
tar xzvf owncloud-4.0.7.tar.bz2
chown -R www:www owncloud

Next, configure the MySQL database, substituting ocuser and mypass with the username and password that you wish to use:

mysql -u root
mysql> create database owncloud;
mysql> grant all on owncloud.* to ocuser@localhost identified by "mypass";
mysql> quit

Next, add the required PHP options to Apache. Open /usr/local/etc/apache22/httpd.conf in an editor and look for this line:

#AddType application/x-gzip .tgz

Add the following lines directly below that line:

AddType application/x-httpd-php .php
AddType application/x-httpd-php-source .phps

Next, look for the following section:

<IfModule dir_module>
   DirectoryIndex index.html
</IfModule>

and change it to:

<IfModule dir_module>
   DirectoryIndex index.html index.php
</IfModule>

Save your changes and restart the Apache and MySQL services:

/usr/local/etc/rc.d/apache22 restart
/usr/local/etc/rc.d/mysql-server restart

Test your changes from a web browser by adding "owncloud" to the end of the IP address of the jail. For example, type http://10.0.0.1/owncloud/. You should see the setup screen shown in Figure 9.9c.

Figure 9.9c: ownCloud Initial Setup Screen

Owncloud2.png

Input the name of the user and password that will be used to administer ownCloud, then click the " "Advanced" button. In the advanced settings, click the "MySQL" tab and input the MySQL username, password, and database name that you configured previously. Click the “Finish setup” button to save your changes and enter your new cloud interface -- shown in Figure 9.9d.

Figure 9.9d: ownCloud Interface

Owncloud3.png

Click the left panel of the interface to access a type of media. For example, if you click "Files" and then the "New" button, you can upload a file, folder, or from a URL. If you click "Contacts", you can add a contact or import/export the address book.

Click the "Settings" icon at the bottom of the left panel to add users, configure applications, change the administrative configuration, and to access "Help".

Instructions for synchronizing the calendar and address book, integrating with a file manager, and integrating with a media player can be found in the documentation section of the ownCloud website[2]. Synchronization clients are available from the owncloud site[3].

References


  1. http://owncloud.org/
  2. http://owncloud.org/support/
  3. http://owncloud.org/sync-clients/
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox