Skip to content

Commit 441fb6c

Browse files
committed
Final change - adding "marklogic-" as a prefix
Couple small fixes in the contributing guide too.
1 parent c47a646 commit 441fb6c

File tree

6 files changed

+20
-20
lines changed

6 files changed

+20
-20
lines changed

CONTRIBUTING.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -257,15 +257,15 @@ are all synonyms):
257257

258258
./gradlew shadowJar
259259

260-
This will produce an assembly jar at `./flux-cli/build/libs/flux-1.0.0-all.jar`.
260+
This will produce an assembly jar at `./flux-cli/build/libs/marklogic-flux-1.0.0-all.jar`.
261261

262262
You can now run any CLI command via spark-submit. This is an example of previewing an import of files - change the value
263263
of `--path`, as an absolute path is needed, and of course change the value of `--master` to match that of your Spark
264264
cluster:
265265

266266
```
267267
$SPARK_HOME/bin/spark-submit --class com.marklogic.flux.spark.Submit \
268-
--master spark://NYWHYC3G0W:7077 flux-cli/build/libs/flux-1.0-SNAPSHOT-all.jar \
268+
--master spark://NYWHYC3G0W:7077 flux-cli/build/libs/marklogic-flux-1.0.0-all.jar \
269269
import-files --path /Users/rudin/workspace/flux/flux-cli/src/test/resources/mixed-files \
270270
--connection-string "admin:admin@localhost:8000" \
271271
--preview 5 --preview-drop content
@@ -276,13 +276,13 @@ After spark-submit completes, you can refresh <http://localhost:8080> to see evi
276276
The assembly jar does not include the AWS SDK, as doing so would increase its size from about 8mb to close to 400mb.
277277
spark-submit allows for dependencies to be included via its `--packages` option. The following shows an example of
278278
previewing an import of files from an S3 bucket by including the AWS SDK as package dependencies (change the bucket name
279-
to something you can access :
279+
to something you can access):
280280

281281
```
282282
$SPARK_HOME/bin/spark-submit --class com.marklogic.flux.spark.Submit \
283-
--packages org.apache.hadoop:hadoop-aws:3.3.6,org.apache.hadoop:hadoop-client:3.3.6 \
283+
--packages org.apache.hadoop:hadoop-aws:3.3.4,org.apache.hadoop:hadoop-client:3.3.4 \
284284
--master spark://NYWHYC3G0W:7077 \
285-
flux-cli/build/libs/flux-1.0-SNAPSHOT-all.jar \
285+
flux-cli/build/libs/marklogic-flux-1.0.0-all.jar \
286286
import-files --path "s3a://changeme/" \
287287
--connection-string "admin:admin@localhost:8000" \
288288
--s3-add-credentials \

build.gradle

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ task gettingStartedZip(type: Zip) {
3030
"on the GitHub release page."
3131
from "examples/getting-started"
3232
exclude "build", ".gradle", "gradle-*.properties", "flux", ".gitignore"
33-
into "flux-getting-started-${version}"
34-
archiveFileName = "flux-getting-started-${version}.zip"
33+
into "marklogic-flux-getting-started-${version}"
34+
archiveFileName = "marklogic-flux-getting-started-${version}.zip"
3535
destinationDirectory = file("build")
3636
}

docs/getting-started.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -15,18 +15,18 @@ This guide describes how to get started with Flux with some examples demonstrati
1515
## Setup
1616

1717
You can download the latest release of the Flux application zip from [the latest Flux release page](https://github.com/marklogic/flux/releases).
18-
The Flux application zip is titled `flux-1.0.0.zip`. You can extract this zip to any location on your
18+
The Flux application zip is titled `marklogic-flux-1.0.0.zip`. You can extract this zip to any location on your
1919
filesystem that you prefer.
2020

2121
### Deploying the example application
2222

2323
The examples in this guide, along with examples found throughout this documentation, depend on a small MarkLogic
2424
application that can be deployed to your own instance of MarkLogic server. The application can be downloaded from
2525
[the latest Flux release page](https://github.com/marklogic/flux/releases) in a zip titled
26-
`flux-getting-started-1.0.0.zip`. To use Flux with this example application, perform the following steps:
26+
`marklogic-flux-getting-started-1.0.0.zip`. To use Flux with this example application, perform the following steps:
2727

28-
1. Extract the `flux-getting-started-1.0.0.zip` file to any location on your local filesystem.
29-
2. Run `cd flux-getting-started-1.0.0` to change to the directory created by extracting the zip file.
28+
1. Extract the `marklogic-flux-getting-started-1.0.0.zip` file to any location on your local filesystem.
29+
2. Run `cd marklogic-flux-getting-started-1.0.0` to change to the directory created by extracting the zip file.
3030
3. Create a file named `gradle-local.properties` and add `mlPassword=your MarkLogic admin user password` to it.
3131
4. Examine the contents of the `gradle.properties` file to ensure that the value of `mlHost` points to your MarkLogic
3232
server and that the value of `mlRestPort` is a port available for a new MarkLogic app server to use.
@@ -38,15 +38,15 @@ privileges for running the examples in this guide. Finally, the application incl
3838
[MarkLogic TDE template](https://docs.marklogic.com/guide/app-dev/TDE) that creates a view in MarkLogic for the purpose
3939
of demonstrating commands that utilize a [MarkLogic Optic query](https://docs.marklogic.com/guide/app-dev/OpticAPI).
4040

41-
It is recommended to extract the Flux application zip into the `flux-getting-started-1.0.0` directory so that
41+
It is recommended to extract the Flux application zip into the `marklogic-flux-getting-started-1.0.0` directory so that
4242
you can easily execute the examples in this guide. After extracting the application zip, the directory should have a
4343
structure similar to this (not all files may be shown):
4444

4545
```
46-
./flux-getting-started-1.0.0
46+
./marklogic-flux-getting-started-1.0.0
4747
build.gradle
4848
./data
49-
./flux-1.0.0
49+
./marklogic-flux-1.0.0
5050
./gradle
5151
gradle.properties
5252
gradlew
@@ -59,7 +59,7 @@ structure similar to this (not all files may be shown):
5959
You can run Flux without any options to see the list of available commands. If you are using Flux to run these examples,
6060
first change your current directory to where you extract Flux:
6161

62-
cd flux-1.0.0
62+
cd marklogic-flux-1.0.0
6363

6464
And then run the Flux executable without any options:
6565

docs/spark-integration.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ Flux integrates with [spark-submit](https://spark.apache.org/docs/latest/submitt
3535
submit a Flux command invocation to a remote Spark cluster. Every Flux command is a Spark application, and thus every
3636
Flux command, along with all of its option, can be invoked via `spark-submit`.
3737

38-
To use Flux with `spark-submit`, first download the `flux-1.0.0-all.jar` file from the
38+
To use Flux with `spark-submit`, first download the `marklogic-flux-1.0.0-all.jar` file from the
3939
[GitHub release page](https://github.com/marklogic/flux/releases/tag/1.0.0). This jar file includes Flux and all of
4040
its dependencies, excluding those of Spark itself, which will be provided via the Spark cluster that you connect to
4141
via `spark-submit`.
@@ -46,7 +46,7 @@ The following shows a notional example of running the Flux `import-files` comman
4646
```
4747
$SPARK_HOME/bin/spark-submit --class com.marklogic.flux.spark.Submit \
4848
--master spark://changeme:7077 \
49-
flux-1.0.0-all.jar \
49+
marklogic-flux-1.0.0-all.jar \
5050
import-files \
5151
--path path/to/data
5252
--connection-string user:password@host:8000

examples/getting-started/.gitignore

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,4 +4,4 @@ lib
44
export
55
nt
66
flux
7-
7+
marklogic-flux

flux-cli/build.gradle

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -94,7 +94,7 @@ updateJavadoc.dependsOn deleteJavadoc, javadoc, copyJavadoc
9494

9595
distributions {
9696
main {
97-
distributionBaseName = "flux"
97+
distributionBaseName = "marklogic-flux"
9898
}
9999
applicationDistribution.from("..") {
100100
include "LICENSE"
@@ -212,7 +212,7 @@ sonar {
212212
// See https://imperceptiblethoughts.com/shadow/configuration/dependencies/ .
213213
shadowJar {
214214
configurations = [project.configurations.shadowDependencies]
215-
archiveBaseName = "flux"
215+
archiveBaseName = "marklogic-flux"
216216
}
217217

218218
// Publishing setup - see https://docs.gradle.org/current/userguide/publishing_setup.html .

0 commit comments

Comments
 (0)