Difference between revisions of "OwnCloud"

From PC-BSD Wiki
Jump to: navigation, search
Line 9: Line 9:
 
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'''
+
[[File:Owncloud.png|thumb|393px|'''Figure 9.9a: Install the Required Packages''']]
 
+
[[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.
Line 17: Line 15:
 
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.
  
'''Figure 9.9b: Start the Required Services'''
+
[[File:Owncloud1.png|thumb|393px|'''Figure 9.9b: Start the Required Services''']]
 
+
[[File: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.
 
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.
Line 25: Line 21:
 
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:
 
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:
  
{[txtbox|box='''warden create 10.0.0.1 owncloudjail --startauto'''
+
{{txtbox|box='''warden create 10.0.0.1 owncloudjail --startauto'''
'''pc-metapkgmanager --pkgset warden --chroot /usr/jails/10.0.0.1 add MySQL,Apache,PHP'''}}
+
'''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:
 
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:
Line 53: Line 50:
 
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.
 
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:
+
Once at the command line of the jail, download ownCloud into the Apache data directory:[[File:Owncloud2.png|thumb|'''Figure 9.9c: ownCloud Initial Setup Screen''']]
 
+
{{txtbox|box='''cd /usr/local/www/apache22/data'''
{[txtbox|box='''cd /usr/local/www/apache22/data'''
+
'''fetch {{http}}download.owncloud.org/releases/owncloud-4.0.7.tar.bz2'''{{nbsp|14}}
'''fetch {{http}}download.owncloud.org/releases/owncloud-4.0.7.tar.bz2'''
+
 
'''tar xzvf owncloud-4.0.7.tar.bz2'''
 
'''tar xzvf owncloud-4.0.7.tar.bz2'''
'''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:
Line 64: Line 61:
 
{{txtbox|box='''mysql -u root'''
 
{{txtbox|box='''mysql -u root'''
 
mysql> '''create database owncloud;'''
 
mysql> '''create database owncloud;'''
mysql> '''grant all on owncloud.* to ocuser@localhost identified by "mypass";'''
+
mysql> '''grant all on owncloud.* to ocuser@localhost identified by "mypass";'''{{nbsp|6}}
mysql> '''quit'''}}
+
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:
 
Next, add the required PHP options to Apache. Open ''/usr/local/etc/apache22/httpd.conf'' in an editor and look for this line:
  
{{txtbox|box={{pound}}AddType application/x-gzip .tgz}}
+
{{txtbox|box={{pound}}AddType application/x-gzip .tgz{{nbsp|48}}}}
  
 
Add the following lines directly below that line:
 
Add the following lines directly below that line:
  
 
{{txtbox|box=AddType application/x-httpd-php .php
 
{{txtbox|box=AddType application/x-httpd-php .php
AddType application/x-httpd-php-source .phps}}
+
AddType application/x-httpd-php-source .phps{{nbsp|36}}}}
  
 
Next, look for the following section:
 
Next, look for the following section:
Line 95: Line 93:
 
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.
 
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'''
+
[[File:Owncloud3.png|thumb|393px|'''Figure 9.9d: ownCloud Interface''']]
 
+
[[File:Owncloud2.png]]
+
  
 
Input the name of the user and password that will be used to administer ownCloud, then click the "
 
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.
 
"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'''
 
 
[[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.  
Line 112: Line 104:
 
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}}.
  
<noinclude>{{refheading}}</noinclude>
 
 
<noinclude>
 
<noinclude>
 +
{{refheading}}
 
[[category:handbook]]
 
[[category:handbook]]
 
[[category:Common Tasks]]
 
[[category:Common Tasks]]
 
[[category:ownCloud]]
 
[[category:ownCloud]]
 
</noinclude>
 
</noinclude>

Revision as of 04:06, 5 March 2013

(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

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

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:
Figure 9.9c: ownCloud Initial Setup Screen
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.9d: ownCloud Interface

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.

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/