Skip to content

Conversation

soenkeliebau
Copy link
Member

I've briefly documented what I believe should be the correct OS paths for some of the things we need to keep on disk.

I think this is correct according to https://refspecs.linuxfoundation.org/FHS_3.0/fhs-3.0.html but have my doubts, whether it makes sense in all cases.

Specifically I wonder about

  1. /etc/opt/stackable - I have not often seen /etc/opt used for configuration.
  2. Packages - do we want to keep these in /opt under our folder root as well?
  3. Service configs, similar question, should those be somewhere else then /etc/opt/stackable/serviceconfig maybe a level up at /etc/opt/serviceconfig to clearly separate them from config for our components?
@soenkeliebau soenkeliebau requested a review from a team March 12, 2021 22:51
@soenkeliebau soenkeliebau self-assigned this Mar 15, 2021
@lfrancke lfrancke assigned lfrancke and unassigned lfrancke Mar 15, 2021
@soenkeliebau
Copy link
Member Author

I've updated this and it is now ready for review @lfrancke

@lfrancke lfrancke self-assigned this Mar 19, 2021
The agent also requires TLS keys, these will by default be kept in a `/etc/opt/stackable/agent/secret` - but this setting can be overridden in the agent config.

=== Service Configuration
Following the logic from above, config files that are written for the actual services that are managed by Stackable (Apache Kafka, Apache Hadoop, ...) should also reside in `/etc/opt/stackable`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Following the logic from above" two times in a row but with two different conclusions. I know what you're getting at but it reads weird.

Maybe something like "As outlined above" oder "According to the standard"

@soenkeliebau
Copy link
Member Author

I have addressed a few comments, some are still left open due to a fundamental question about what we want to use ADRs for .
I was planning to update this ADR as we go along and have it be the source of truth for all os paths that the Stackable Platform uses, hence also included specifics in it.
@larsfrancke is of the opinion that we should keep this generic and leave implementation details out of it.

At the end of the day I am fine either way, but if we make this generic, then I think we should have a page detailing the paths somewhere else in the docs..

Anyone else have any thoughts on this?

@soenkeliebau soenkeliebau requested review from a team and lfrancke March 26, 2021 13:27
@soenkeliebau soenkeliebau merged commit 320b9bc into main Mar 30, 2021
@soenkeliebau soenkeliebau deleted the adr11 branch March 30, 2021 07:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

2 participants