Repository: storm Updated Branches: refs/heads/master d22d8450b -> f118060dc
STORM-1630 "create symbolic link" needs elevation or setting privilege about creating symbolic link * Add document to guide how to setup account to be able to 'create symbolic link' on Windows Project: http://git-wip-us.apache.org/repos/asf/storm/repo Commit: http://git-wip-us.apache.org/repos/asf/storm/commit/21ed0a37 Tree: http://git-wip-us.apache.org/repos/asf/storm/tree/21ed0a37 Diff: http://git-wip-us.apache.org/repos/asf/storm/diff/21ed0a37 Branch: refs/heads/master Commit: 21ed0a37916d878632812f4ad7d1d2d663f5bf48 Parents: a91abdb Author: Jungtaek Lim <[email protected]> Authored: Wed Mar 23 15:13:42 2016 +0900 Committer: Jungtaek Lim <[email protected]> Committed: Wed Mar 23 15:13:42 2016 +0900 ---------------------------------------------------------------------- docs/Documentation.md | 50 ---------------------------------------- docs/index.md | 3 ++- docs/windows-users-guide.md | 21 +++++++++++++++++ 3 files changed, 23 insertions(+), 51 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/storm/blob/21ed0a37/docs/Documentation.md ---------------------------------------------------------------------- diff --git a/docs/Documentation.md b/docs/Documentation.md deleted file mode 100644 index 8da874c..0000000 --- a/docs/Documentation.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -layout: documentation ---- -### Basics of Storm - -* [Javadoc](javadocs/index.html) -* [Concepts](Concepts.html) -* [Configuration](Configuration.html) -* [Guaranteeing message processing](Guaranteeing-message-processing.html) -* [Fault-tolerance](Fault-tolerance.html) -* [Command line client](Command-line-client.html) -* [Understanding the parallelism of a Storm topology](Understanding-the-parallelism-of-a-Storm-topology.html) -* [FAQ](FAQ.html) - -### Trident - -Trident is an alternative interface to Storm. It provides exactly-once processing, "transactional" datastore persistence, and a set of common stream analytics operations. - -* [Trident Tutorial](Trident-tutorial.html) -- basic concepts and walkthrough -* [Trident API Overview](Trident-API-Overview.html) -- operations for transforming and orchestrating data -* [Trident State](Trident-state.html) -- exactly-once processing and fast, persistent aggregation -* [Trident spouts](Trident-spouts.html) -- transactional and non-transactional data intake - -### Setup and deploying - -* [Setting up a Storm cluster](Setting-up-a-Storm-cluster.html) -* [Local mode](Local-mode.html) -* [Troubleshooting](Troubleshooting.html) -* [Running topologies on a production cluster](Running-topologies-on-a-production-cluster.html) -* [Building Storm](Maven.html) with Maven - -### Intermediate - -* [Serialization](Serialization.html) -* [Common patterns](Common-patterns.html) -* [Clojure DSL](Clojure-DSL.html) -* [Using non-JVM languages with Storm](Using-non-JVM-languages-with-Storm.html) -* [Distributed RPC](Distributed-RPC.html) -* [Transactional topologies](Transactional-topologies.html) -* [Kestrel and Storm](Kestrel-and-Storm.html) -* [Direct groupings](Direct-groupings.html) -* [Hooks](Hooks.html) -* [Metrics](Metrics.html) -* [Lifecycle of a trident tuple]() - -### Advanced - -* [Defining a non-JVM language DSL for Storm](Defining-a-non-jvm-language-dsl-for-storm.html) -* [Multilang protocol](Multilang-protocol.html) (how to provide support for another language) -* [Implementation docs](Implementation-docs.html) http://git-wip-us.apache.org/repos/asf/storm/blob/21ed0a37/docs/index.md ---------------------------------------------------------------------- diff --git a/docs/index.md b/docs/index.md index ff36693..8c6859e 100644 --- a/docs/index.md +++ b/docs/index.md @@ -40,7 +40,8 @@ Trident is an alternative interface to Storm. It provides exactly-once processin * [CGroup Enforcement](cgroups_in_storm.html) * [Pacemaker reduces load on zookeeper for large clusters](Pacemaker.html) * [Resource Aware Scheduler](Resource_Aware_Scheduler_overview.html) -* [Deamon Metrics/Monitoring](storm-metrics-profiling-internal-actions.html) +* [Daemon Metrics/Monitoring](storm-metrics-profiling-internal-actions.html) +* [Windows users guide](windows-users-guide.html) ### Intermediate http://git-wip-us.apache.org/repos/asf/storm/blob/21ed0a37/docs/windows-users-guide.md ---------------------------------------------------------------------- diff --git a/docs/windows-users-guide.md b/docs/windows-users-guide.md new file mode 100644 index 0000000..75bb0fc --- /dev/null +++ b/docs/windows-users-guide.md @@ -0,0 +1,21 @@ +--- +title: Windows Users Guide +layout: documentation +documentation: true +--- + +This page guides how to set up environment on Windows for Apache Storm. + +## Symbolic Link + +Starting at 1.0.0, Apache Storm utilizes `symbolic link` to aggregate log directory and resource directory into worker directory. +Unfortunately, `creating symbolic link` on Windows needs non-default privilege, so users should configure it manually to make sure Storm processes can create symbolic link on runtime. + +Below pages (MS technet) guide how to configure that policy to the account which Storm runs on. + +* [How to Configure Security Policy Settings](https://technet.microsoft.com/en-us/library/dn452420.aspx) +* [Create symbolic links](https://technet.microsoft.com/en-us/library/dn221947.aspx) + +One tricky point is, `administrator` group already has this privilege, but it's activated only process is run as `administrator` account. +So if your account belongs to `administrator` group (and you don't want to change it), you may want to open `command prompt` with `run as administrator` and execute processes within that console. +If you don't want to execute Storm processes directly (not on command prompt), please execute processes with `runas /user:administrator` to run as administrator account. \ No newline at end of file
