Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update the scaling out section #233

Merged

Conversation

erimatnor
Copy link
Contributor

This updates the scaling out section to be up-to-date with the latest
multinode APIs and functionality.

getting-started/scaling-out.md Show resolved Hide resolved
* You should already have a running PostgreSQL server on an instance
that will host a data node database. The data node's database will
be created when executing the `add_data_node` command on the access
node and should _not_ exist prior to adding the data node.
Copy link
Contributor

Choose a reason for hiding this comment

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

It can exist, it will not fail, but it might be good to not encourage it.

	/* Create the database with the user as owner. This command might fail
	 * if the database already exists, but we catch the error and continue
	 * with the bootstrapping if it does. */
	res = remote_connection_execf(conn,
								  "CREATE DATABASE %s OWNER %s",
								  quote_identifier(dbname),
								  quote_identifier(username));

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Question is if we should delve into the subtleties of this here. I do say should and not must. I figure we'd keep it simple here.

getting-started/scaling-out.md Outdated Show resolved Hide resolved
distributed hypertables). Currently, such roles and permissions need
to be created manually, although there is a [utility
command][distributed_exec] that can be used to create roles and
permissions across all (or a subset of) data nodes.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggest to remove "all (or a subset of) ".

Comment on lines 57 to 59
certificate authentication. Other ways of authenticating may be
supported in the future.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggest to focus on what we have now, the last sentence is redundant.

`add_data_node` expects to be able to create a
database on the remote data node and create
a TimescaleDB extension within it.
* Provide the host name (and optionally port) of the PostgreSQL
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggest "...host name, and optionally port, of the PostgreSQL..."

Comment on lines +68 to +69
* Ensure that non-superusers have `USAGE` privileges on the
`timescaledb_fdw` foreign data wrapper and any
data node objects they will use on the access node.
Copy link
Contributor

Choose a reason for hiding this comment

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

Hmmm.... maybe something we might consider to do automatically when adding the data node. No action here though.

getting-started/scaling-out.md Outdated Show resolved Hide resolved
getting-started/scaling-out.md Outdated Show resolved Hide resolved

* You should already have a running PostgreSQL server on the data node host.
* You should already have a running PostgreSQL server on an instance
that will host a data node database. The data node's database will
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
that will host a data node database. The data node's database will
that will host a data node. The data node's database will

Any additional users that will access a distributed hypertable currently
need their own user mappings per data node with a `user` and `password` option.
A user mapping can be created for a data node as follows:
* Ensure that each user of a distributed hypertable have a way to
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
* Ensure that each user of a distributed hypertable have a way to
* Ensure that each user of a distributed hypertable has a way to

```

This will prohibit any new data to be stored on the data node. Once
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
This will prohibit any new data to be stored on the data node. Once
This will prohibit any new data from being stored on the data node. Once

@erimatnor erimatnor force-pushed the enordstr/update-scaling-out branch from 98f0af2 to 933750e Compare October 22, 2019 18:54
This updates the scaling out section to be up-to-date with the latest
multinode APIs and functionality.
@erimatnor erimatnor force-pushed the enordstr/update-scaling-out branch from 933750e to a29b2a3 Compare October 22, 2019 19:20
* Ensure that the local user has `USAGE` privileges on the `timescaledb_fdw`
foreign data wrapper on the access node.
* Ensure that each user of a distributed hypertable has a way to
[authenticate][data-node-authentication] with the data nodes they
Copy link
Contributor

Choose a reason for hiding this comment

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

I'm assuming the page-index.js will have been modified to accommodate this page (from the other PR)?

Copy link
Contributor Author

@erimatnor erimatnor Oct 22, 2019

Choose a reason for hiding this comment

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

I'm assuming that too :)

@erimatnor erimatnor merged commit af817a9 into timescale:clustering Oct 22, 2019
@erimatnor erimatnor deleted the enordstr/update-scaling-out branch October 22, 2019 19:44
k-rus pushed a commit that referenced this pull request Jul 14, 2020
This updates the scaling out section to be up-to-date with the latest
multinode APIs and functionality.
mamm0thz pushed a commit that referenced this pull request Jul 30, 2020
This updates the scaling out section to be up-to-date with the latest
multinode APIs and functionality.
mamm0thz pushed a commit that referenced this pull request Jul 30, 2020
This updates the scaling out section to be up-to-date with the latest
multinode APIs and functionality.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
added-to-branches multinode Multinode-related content
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants