openhab / openhab-syno-spk

openHAB Synology SPK Install Package
Eclipse Public License 2.0
161 stars 42 forks source link

Install documentation wrong about location of configuration files #80

Closed dfrap closed 7 years ago

dfrap commented 7 years ago

The current documentation is both wrong and incomplete about the location of configuration files. I suggest the following updated text:

The location of the configuration files varies depending if a shared folder named public exists. The public folder is created automatically after your Synology NAS is first set up for certain models. The administrator can also create a public shared folder if desired. Synology does not document what models will automatically create a public folder. https://www.synology.com/en-us/knowledgebase/DSM/help/DSM/AdminCenter/file_share_desc

If a public folder exists, the OpenHAB install script will place configuration files on the public folder. Note that group user must have read/write access or OpenHAB will not be able to access the configuration files. Use Control Panel, Shared Folders, edit public, Permissions, Local Groups from pull down, and give users Read/Write access.

If a public shared folder exists, the configuration files are located at: /volume1/public/openHAB2/conf/

If no public shared folder exists, the configuration files are located at: /volume1/@appstore/openHAB2/conf/

dfrap commented 7 years ago

Typo should be: If no public shared folder exists, the configuration files are located at: / volume1/ @appstore/ openHAB2/ conf/ (without the spaces - not sure how else to stop the Markdown)

SchoppAx commented 7 years ago

@cniweb can you please add the recommended text from @dfrap to the documentation for the moment (https://github.com/openhab/openhab-docs/blob/gh-pages/installation/synology.md). But without the

Note that group user must have read/write access or OpenHAB will not be able to access the configuration files. Use Control Panel, Shared Folders, edit public, Permissions, Local Groups from pull down, and give users Read/Write access.

because it is fixed in the new release.

@dfrap you can use the code tag ` /volume1/@appstore/openHAB2/conf`

cniweb commented 7 years ago

@dfrap A new PR that contains your suggestion I have created!

dfrap commented 7 years ago

Very good update. Well formatted and informative.