Repository: storm Updated Branches: refs/heads/1.x-branch 52d0a23f4 -> 139a8a3b2
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/38acdad9 Tree: http://git-wip-us.apache.org/repos/asf/storm/tree/38acdad9 Diff: http://git-wip-us.apache.org/repos/asf/storm/diff/38acdad9 Branch: refs/heads/1.x-branch Commit: 38acdad9e208a7c3d7cebceafa9776e5e2c32d80 Parents: 732982d Author: Jungtaek Lim <[email protected]> Authored: Wed Mar 23 15:20:59 2016 +0900 Committer: Jungtaek Lim <[email protected]> Committed: Wed Mar 23 15:20:59 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/38acdad9/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/38acdad9/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/38acdad9/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..c3828aa --- /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
