owncloud-archive / documentation

:blue_book: The ownCloud documentation and manual
https://doc.owncloud.com/
Other
186 stars 168 forks source link

add instructions how to enable calendar and contacts app #826

Closed jnweiger closed 9 years ago

jnweiger commented 9 years ago

http://doc.owncloud.org/server/8.0/user_manual/pim/contacts.html http://doc.owncloud.org/server/8.0/user_manual/pim/calendar.html

both start with the assumption, that the app is already installed and enabled in ownCloud.

With 8.0 we no longer ship these apps. So enabling them involves download from apps.owncloud.com Should we explain what to do, if the enable buttons are missing?

ghost commented 9 years ago

So enabling them involves download from apps.owncloud.com Should we explain what to do, if the enable buttons are missing?

Mhhh, maybe a link to:

http://doc.owncloud.org/server/8.0/admin_manual/installation/apps_management_installation.html https://github.com/owncloud/documentation/blob/master/admin_manual/installation/apps_management_installation.rst

could be enough in this case?

eltrai commented 9 years ago

No, it's not enough. The apps.owncloud.com ssl certificat seems messed up and is not accepted by openssl, which results in those two apps not being installable anymore, even following those links recommandations.

Btw, could you clarify why contact and calendar are not shipped by default, which results in effectivly disabling it from upgrading users ? Seems a very bad way to proceed to me.

danimo commented 9 years ago

@eltrai We currently have no means to change the certificate chain (intermediate is missing). The issue will be fixed in a few hours once the responsible person in the US is awake.

ghost commented 9 years ago

@eltrai Way out of context of my post. Please read it completely... ;-)

Btw, could you clarify why contact and calendar are not shipped by default, which results in effectivly disabling it from upgrading users ? Seems a very bad way to proceed to me.

The reason why those apps are not shipped anymore is described here:

http://owncloud.10557.n7.nabble.com/ownCloud-8-alpha-1-td13757.html

But thats also out of the context of this issue which is about how to install/enable the contacts/calendar app. If you want to have a description / announcement just create a new issue here. :)

ghost commented 9 years ago

@jnweiger

both start with the assumption, that the app is already installed and enabled in ownCloud

Which i think is also fine here. The linked docs are the User-Guides which describes how to use an app. There should be no admin-tasks like "how to enable an app" in a User-Guide in my opinion.

eltrai commented 9 years ago

@danimo Thanks for the update. I will wait for that then :-)

@RealRancor ok, I understand the reasoning. Still, I would have appreciated a warning, so that I wouldn't have had to "discover" that my apps disappeared and that I needed to enable the app store in my config file to get them again. Btw, once I figured out that those apps were indeed in the app store (which is not obvious because they don't have good review yet), it was straightforward enough for me to find the link you mentionned in the Admin-Guide to enable the app store.

ghost commented 9 years ago

@eltrai Unfortunately thats always the problem with ownCloud. Some stuff like the removal of those apps are not announced at all or just within some mailings at the mailinglist.

jnweiger commented 9 years ago

My first tests were inconsistent with later tests:

First impression: The enable buttons for contacts and calendar were found under 'Recommended Apps'. When user clicks on one, the app is pulled from the appstore and enabled. Worked fine! Second impression: I cannot find the buttons any more.

Hence I am asking for documentation. As role user, I'd like to know how to handle that situation. A reference to the admin manual is fine too -- if the topic is explained there. I am not in the admin area of owncloud, it's a user's apps settings. So the user manual should also have a hint.

ghost commented 9 years ago

Sure, you're right. A short note "your admin needs to enable this app" could be useful here.

jnweiger commented 9 years ago

If the owncloud server can reach the appstore, an admin user can click on 'Apps' and sees this: Enabled, Not enabled, Recommended, Multimedia, PIM, Productivity, Game, Tool, other, More apps ..., Add your app... When the admin opens 'Recommended' or 'PIM', he sees Contacts and Calendar (amongst others).

If the ownCloud server cannot reach the appstore, the admin user will only get: Enabled, Not enabled, Recommended, More apps ..., Add your app ... and Recommended is empty.

MorrisJobke commented 9 years ago

From IRC:

12:32 <tribut> btw is it really mentioned nowhere, that calendar and some other apps are no longer packaged with core?
12:32 <tribut> this should really be in the release notes
12:33 <tribut> or *at least* in the changelog
12:34 <tribut> i had been using appstoreenabled=false for years and it took me quite a while to figure out what was going on...
carlaschroder commented 9 years ago

And down the rabbit hole again...so when a user upgrades from oC7, and was already using Calendar and Contacts, does the upgrade to 8 remove them?

MorrisJobke commented 9 years ago

The update says: "remove all folders except config and data" -> so yes. But the data in the database still is there. So enabling them will download them from the apps store and use the old data from the database -> all works like before :)

90vvv commented 9 years ago

So enabling them will download them from the apps store and use the old data from the database -> all works like before

No it doesn't:

cat /etc/os-release

NAME=openSUSE VERSION="13.1 (Bottle)" VERSION_ID="13.1" PRETTY_NAME="openSUSE 13.1 (Bottle) (x86_64)" ID=opensuse ANSI_COLOR="0;32" CPE_NAME="cpe:/o:opensuse:opensuse:13.1" BUG_REPORT_URL="https://bugs.opensuse.org" HOME_URL="https://opensuse.org/" ID_LIKE="suse"

zypper update owncloud

... Then in owncloud's /index.php/settings/apps clicking on "Enable" on both Calendar and Contacts results in the message "App directory already exists", and the application staying disabled. Not good.

90vvv commented 9 years ago

Going to /apps and doing an "rm -rf contacts calendar" allows one to re-enable those plugins. Data is kept in the database not in the filesystem so nothing should be lost (but best to backup just in case).

ghost commented 9 years ago

https://doc.owncloud.org/server/8.0/user_manual/pim/calendar.html https://doc.owncloud.org/server/8.1/user_manual/pim/contacts.html

now describes that the calendar and contacts apps are not shipped anymore and needs to be enabled after the installation. Should be enough here if the appstore is working as expected?

ghost commented 9 years ago

@90vvv

Ah, btw. The "App directory already exists" message was a bug in core: https://github.com/owncloud/core/issues/14711 . In general its always recommended to discuss / report such stuff in the core bugtracker instead of an documentation tracker.

carlaschroder commented 9 years ago

I will add some more language explaining all this stuff.

carlaschroder commented 9 years ago

This should take care of it. If the docs don't need any more tweaks I think this can be closed. https://github.com/owncloud/documentation/pull/1055

ghost commented 9 years ago

I think that is fine :+1: