Skip to content

Commit

Permalink
[WAYANG-48] Fix errors when running WordCount example and show how to…
Browse files Browse the repository at this point in the history
… run it based on current main branch
  • Loading branch information
bgeng777 committed Apr 19, 2023
1 parent 14253ab commit 5a11415
Show file tree
Hide file tree
Showing 2 changed files with 63 additions and 0 deletions.
Binary file added images/wordcount_result.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
63 changes: 63 additions & 0 deletions tutorial.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
This tutorial will show users how to run WordCount example locally with Wayang.

# Get the binary
Running following command to build Wayang and generate the tar.gz
```shell
cd incubator-wayang
./mvnw clean package -pl :wayang-assembly -Pdistribution
```
Then you can find the `wayang-assembly-0.6.1-SNAPSHOT-dist.tar.gz` under `wayang-assembly/target` directory.


# Prepare the environment
## Wayang
```shell
tar -xvf wayang-assembly-0.6.1-SNAPSHOT-dist.tar.gz
cd wayang-0.6.1-SNAPSHOT
```

In linux
```shell
echo "export WAYANG_HOME=$(pwd)" >> ~/.bashrc
echo "export PATH=${PATH}:${WAYANG_HOME}/bin" >> ~/.bashrc
source ~/.bashrc
```
In MacOS
```shell
echo "export WAYANG_HOME=$(pwd)" >> ~/.zshrc
echo "export PATH=${PATH}:${WAYANG_HOME}/bin" >> ~/.zshrc
source ~/.zshrc
```
## Others
- You need to install Apache Spark version 3 or higher. Don’t forget to set the `SPARK_HOME` environment variable.
- You need to install Apache Hadoop version 3 or higher. Don’t forget to set the `HADOOP_HOME` environment variable.

# Run the program

To execute the WordCount example with Apache Wayang, you need to execute your program with the 'wayang-submit' command:

```shell
cd wayang-0.6.1-SNAPSHOT
wayang-submit org.apache.wayang.apps.wordcount.Main java file://$(pwd)/README.md
```
Then you should be able to see outputs like this:

![img.png](images/wordcount.png)

0 comments on commit 5a11415

Please sign in to comment.