Trusted
1,351
edits
Changes
From Amahi Wiki
Owncloud Applications (view source)
Revision as of 18:43, 8 September 2015
, 18:43, 8 September 2015no edit summary
Initially an ownCloud instance provides a minimal set of applications after installation (Files, Pictures).
Many applications are available as “one click” installations that are automatically downloaded, installed, and “enabled” via the ownCloud administration user account. Other applications have to be downloaded from the '''[https://apps.owncloud.com/ ownCloud AppStore]''', installed, and "enabled" manually.
===Disable/Remove an ownCloud Application===
An ownCloud application can be removed from use users by "Disabling" it. Disabling an application does not remove it from the ownCloud instance. However, there is a remove feature provided.
*To Disable the application the ownCloud administration ID account will have to be used.*Navigate to Apps listing then moving down the list of applications until the name "Bookmarks" appears. Clicking on this title. Details for the application will appear on the right. Clicking on the "Disable" button to disable the application.
:[[File:oc_disable_bookmarks.png]]
*The Bookmarks application is no longer available to users and is disabled. Notice the "Uninstall App" button? Clicking on this will completely remove the application from the ownCloud instance. This feature is available to "some" Approved and should be available to all Experimental applications (provided the developer set it up). "Core" applications cannot be permanently removed in this fashion.
:[[File:oc_bookmarks_post_disable.png]]
:See the following section for steps on how to manually/permanently remove an application.
===Manually Installing/Removing an ownCloud Application===
Some ownCloud (i.e. Experimental) applications are not listed on the applications listing in an ownCloud instance. Applications can be downloaded from the ownCloud Applications Store or "GitHub" developer repositories. Before downloading an application check the application repository to ensure that it is compatible with the target ownCloud instance.
====Manual Installation====
:- The ownCloud Applications repository: http://apps.owncloud.com (Current versions for specific ownCloud release versions).
:- The "GitHub" Developer repository: https://github.com/owncloud (Current and past versions of the applications are stored herein the "Releases" section for each application).
For example, the "Bookmarks" application code past and present can be found at
URL: https://github.com/owncloud/bookmarks/releases Notice the name "bookmarks"? <br>
'''Please Note:'''
<blockquote>At times when the ownCloud Community has a new major version release (i.e. 6 7 to 78) some ownCloud applications may no longer function correctly under the new release. Usually the application author has not updated their software to be compatible with the new ownCloud release. However, it is possible to use an application version from the last "point ownCloud release" (i.e. 68.1.0.4, 68.01.31, ...) as a substitute until the author or ownCloud developer gets around to updating the application. In this case a download from GitHub will be required.</blockquote>
* Open a "terminal" window on the Amahi server and "su" to the "root" ID ( Linux administrator).
*Download the ownCloud application. Applications downloaded are in a "zip" file format and should be extracted to a target working directory and not the ownCloud "apps" directory.
*Set the permissions for the application directory and its dependants:
<blockquote>
:'''Ownership''': chown -Rv apache:users <owncloud application directory name>:'''Priviledges''': chmod -Rv 755 <owncloud application directory name></blockquote>
*Open a browser session, go to the ownCloud instance, login as the "administration user", and navigate to the Apps listing.
*The owncloud application should appear in the section for uninstalled disabled applications.
*Click on this application name. Details for the application will appear on the right. Click on the "Enable" button to enable the application.
*Navigate back to the "administration usersuser's" home and check the list of ownCloud applications available, it should be there.
*Test the application to ensure proper functionality. If it does not work try an another early version of the application (remembering to manually remove the application first).
====Manual Removal====
Even though an ownCloud application is "Disabled" (administration user only) the application program code remains in a the ownCloud apps directory. Sometimes it may be necessary to permanently remove the application program code from the ownCloud instance. Additionally there are some ownCloud database entries that have to be removed also.
* Ensure that the application is "Disabled" in the Apps listing.
* Using the "ls" command again will show that directory is gone.
* Close the terminal window.
* All application entries in the ownCloud MySQL MariaDB database have to be removed this can done by using Amahi "phpMyAdmin".
* In the database table "oc_appconfig", find all entries having the name of the application in the "appid" column.
* Remove those entries. This step is '''extremely''' important especially if another version of this app is to be trialled later.
* Now the application is permanently removed from ownCloud.
<br>
In order to allow multiple instances of different version releases of ownCloud on the same Amahi server naming changes to the main ownCloud application directory and database names have been implemented.
* The location where the actual ownCloud application is stored has changed to "/var/hda/web-apps/owncloudx/html" (where "x" is the major release number). For example for ownCloud release version 68.1.0.5 the directory is now named "owncloud6owncloud8".
* The ownCloud database user ID, password, and name have changed in the same manner.
