Github user tzulitai commented on a diff in the pull request:
https://github.com/apache/flink/pull/3236#discussion_r99063127
--- Diff: docs/setup/mesos.md ---
@@ -107,29 +107,58 @@ Unvierse. Please use the following workaround in the
meantime:
## Mesos without DC/OS
-Let's take a look at how to setup Flink on Mesos without DC/OS.
+You can also run Mesos without DC/OS.
-### Prerequisites
+### Installing Mesos
-Please follow the
-[instructions on how to setup Mesos on the official
website](http://mesos.apache.org/documentation/latest/).
+Please follow the [instructions on how to setup Mesos on the official
website](http://mesos.apache.org/documentation/latest/getting-started/).
+
+After installation you have to configure the set of master and agent nodes
by creating the files `MESOS_HOME/etc/mesos/masters` and
`MESOS_HOME/etc/mesos/slaves`.
+These files contain in each row a single hostname on which the respective
component will be started (assuming SSH access to these nodes).
+
+Next you have to create `MESOS_HOME/etc/mesos/mesos-master-env.sh` or use
the template found in the same directory.
+In this file, you have to define
+
+ export MESOS_work_dir=WORK_DIRECTORY
+
+and it is recommended to uncommment
+
+ export MESOS_log_dir=LOGGING_DIRECTORY
+
+
+In order to configure the Mesos agents, you have to create
`MESOS_HOME/etc/mesos/mesos-agent-env.sh` or use the template found in the same
directory.
+You have to configure
+
+ export MESOS_master=MASTER_HOSTNAME:MASTER_PORT
+
+and uncomment
+
+ export MESOS_log_dir=LOGGING_DIRECTORY
+ export MESOS_work_dir=WORK_DIRECTORY
+
+#### Mesos Library
+
+In order to run Java applications with Mesos you have to export
`MESOS_NATIVE_JAVA_LIBRARY=MESOS_HOME/lib/libmesos.so`.
+
+#### Deploying Mesos
+
+In order to start your mesos cluster, use the deployment script
`MESOS_HOME/sbin/mesos-start-cluster.sh`.
+In order to stop your mesos cluster, use the deployment script
`MESOS_HOME/sbin/mesos-stop-cluster.sh`.
+More information about the deployment scripts can be found
[here](http://mesos.apache.org/documentation/latest/deploy-scripts/).
+
+### Installing Marathon
+
+Optionally, you may also [install
Marathon](https://mesosphere.github.io/marathon/docs/) which will be necessary
to run Flink in high availability (HA) mode.
### Optional dependencies
-Optionally,
-you may also install [Marathon](https://mesosphere.github.io/marathon/)
which
-will be necessary if you want your Flink cluster to be highly available in
the
-presence of master node failures. Additionally, you probably want to
install a
-distributed file system to share data across nodes and make use of Flink's
-checkpointing mechanism.
+Additionally, you probably want to install a distributed file system to
share data across nodes and make use of Flink's checkpointing mechanism.
--- End diff --
I bumped a bit on this sentence. The relationship between a distributed
file system and Flink's checkpointing is a bit unclear here. Perhaps change to
something like "use filesystem backend for Flink's checkpointing", and also
link to the related documents.
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---