You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: RELEASE_PROCEDURE.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ Quickstarts Release Procedure
4
4
Testing the quickstarts
5
5
-----------------------
6
6
7
-
Most of the quickstarts require starting ${product.name.full} in standalone mode. Some require the "standalone-full" profile, some require XTS, some require Postgres and some require other quickstarts to be deployed. Profiles are used in the root POM to separate out these groups, allowing you to test the quickstarts easily. For example, to run those that require only standalone mode:
7
+
Most of the quickstarts require starting WildFly Application Server in standalone mode. Some require the "standalone-full" profile, some require XTS, some require Postgres and some require other quickstarts to be deployed. Profiles are used in the root POM to separate out these groups, allowing you to test the quickstarts easily. For example, to run those that require only standalone mode:
Copy file name to clipboardExpand all lines: app-client/README.md
+31-31Lines changed: 31 additions & 31 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,16 +1,16 @@
1
-
# app-client: Use the ${product.name} Application Client Container
1
+
# app-client: Use the WildFly Application Client Container
2
2
3
3
Author: Wolf-Dieter Fink
4
4
Level: Intermediate
5
5
Technologies: EJB, EAR, AppClient
6
-
Summary: The `app-client` quickstart demonstrates how to code and package a client app and use the ${product.name} client container to start the client Main program.
7
-
Target Product: ${product.name}
8
-
Source: <${github.repo.url}>
6
+
Summary: The `app-client` quickstart demonstrates how to code and package a client app and use the WildFly client container to start the client Main program.
7
+
Target Product: WildFly
8
+
Source: <https://github.com/wildfly/quickstart/>
9
9
10
10
11
11
## What is it?
12
12
13
-
The `app-client` quickstart demonstrates how to use the ${product.name} client container to start the client `Main` program and provide Dependency Injections (DI) for client applications in ${product.name.full}. It also shows you how to use Maven to package the application according to the JavaEE specification.
13
+
The `app-client` quickstart demonstrates how to use the WildFly client container to start the client `Main` program and provide Dependency Injections (DI) for client applications in WildFly Application Server. It also shows you how to use Maven to package the application according to the JavaEE specification.
14
14
15
15
16
16
This example consists of the following Maven projects, each with a shared parent:
@@ -27,19 +27,19 @@ The root `pom.xml` file builds each of the subprojects in the appropriate order.
27
27
28
28
## System Requirements
29
29
30
-
The application this project produces is designed to be run on ${product.name.full} ${product.version} or later.
30
+
The application this project produces is designed to be run on WildFly Application Server 11 or later.
31
31
32
-
All you need to build this project is ${build.requirements}. See [Configure Maven for ${product.name} ${product.version}](https://github.com/jboss-developer/jboss-developer-shared-resources/blob/master/guides/CONFIGURE_MAVEN_JBOSS_EAP7.md#configure-maven-to-build-and-deploy-the-quickstarts) to make sure you are configured correctly for testing the quickstarts.
32
+
All you need to build this project is Java 8.0 (Java SDK 1.8) or later and Maven 3.3.1 or later. See [Configure Maven for WildFly 11](https://github.com/jboss-developer/jboss-developer-shared-resources/blob/master/guides/CONFIGURE_MAVEN_JBOSS_EAP7.md#configure-maven-to-build-and-deploy-the-quickstarts) to make sure you are configured correctly for testing the quickstarts.
33
33
34
34
35
-
## Use of ${jboss.home.name}
35
+
## Use of WILDFLY_HOME
36
36
37
-
In the following instructions, replace `${jboss.home.name}` with the actual path to your ${product.name} installation. The installation path is described in detail here: [Use of ${jboss.home.name} and JBOSS_HOME Variables](https://github.com/jboss-developer/jboss-developer-shared-resources/blob/master/guides/USE_OF_${jboss.home.name}.md#use-of-eap_home-and-jboss_home-variables).
37
+
In the following instructions, replace `WILDFLY_HOME` with the actual path to your WildFly installation. The installation path is described in detail here: [Use of WILDFLY_HOME and JBOSS_HOME Variables](https://github.com/jboss-developer/jboss-developer-shared-resources/blob/master/guides/USE_OF_WILDFLY_HOME.md#use-of-eap_home-and-jboss_home-variables).
38
38
39
39
40
40
## Add the Application Users
41
41
42
-
If the client and server are run on different hosts, you must add the following users to the ${product.name} server side application. Be sure to use the names and passwords specified in the table as they are required to run this example.
42
+
If the client and server are run on different hosts, you must add the following users to the WildFly server side application. Be sure to use the names and passwords specified in the table as they are required to run this example.
WILDFLY_HOME\bin\add-user.bat -a -u quickuser -p quick-123
58
58
59
59
If you prefer, you can use the add-user utility interactively. For an example of how to use the add-user utility, see the instructions located here: [Add an Application User](https://github.com/jboss-developer/jboss-developer-shared-resources/blob/master/guides/CREATE_USERS.md#add-an-application-user).
60
60
61
61
62
62
## Start the Server
63
63
64
-
1. Open a command prompt and navigate to the root of the ${product.name} directory.
64
+
1. Open a command prompt and navigate to the root of the WildFly directory.
65
65
2. The following shows the command line to start the server:
66
66
67
-
For Linux: ${jboss.home.name}/bin/standalone.sh
68
-
For Windows: ${jboss.home.name}\bin\standalone.bat
67
+
For Linux: WILDFLY_HOME/bin/standalone.sh
68
+
For Windows: WILDFLY_HOME\bin\standalone.bat
69
69
70
70
71
71
## Build and Deploy the Quickstart
72
72
73
-
1. Make sure you have started the ${product.name} server as described above.
73
+
1. Make sure you have started the WildFly server as described above.
74
74
2. Open a command prompt and navigate to the root directory of this quickstart.
75
75
3. Type this command to build the artifacts:
76
76
@@ -83,10 +83,10 @@ If you prefer, you can use the add-user utility interactively. For an example of
83
83
This example shows how to invoke an EJB from a remote standalone application on the same machine. Both the client and server are on the same machine, so the defaults are sufficient and no authentication is necessary.
84
84
85
85
1. Be sure the quickstart deployed successfully as described above.
86
-
2. Navigate to the root directory of this quickstart and type the following command to run the application. Be sure to replace `${jboss.home.name}` with the path to your ${product.name} installation.
86
+
2. Navigate to the root directory of this quickstart and type the following command to run the application. Be sure to replace `WILDFLY_HOME` with the path to your WildFly installation.
87
87
88
-
For Linux: ${jboss.home.name}/bin/appclient.sh ear/target/app-client.ear#simpleClient.jar Hello from command line
89
-
For Windows: ${jboss.home.name}\bin\appclient.bat ear\target\app-client.ear#simpleClient.jar Hello from command line
88
+
For Linux: WILDFLY_HOME/bin/appclient.sh ear/target/app-client.ear#simpleClient.jar Hello from command line
89
+
For Windows: WILDFLY_HOME\bin\appclient.bat ear\target\app-client.ear#simpleClient.jar Hello from command line
90
90
91
91
3. Review the result. The client outputs the following information provided by the server application:
92
92
@@ -108,17 +108,17 @@ This example shows how to invoke an EJB from a remote standalone Java EE applica
108
108
109
109
### Configure Machine_1 (Remote Server Machine)
110
110
111
-
1. Install ${product.name} on this machine.
112
-
2. Add the application users to the ${product.name} server on this machine as described above.
113
-
3. Start the ${product.name} server with the following command. Be sure to replace `MACHINE_1_IP_ADDRESS` with the IP address of this machine. These arguments make the server accessible to the network.
111
+
1. Install WildFly on this machine.
112
+
2. Add the application users to the WildFly server on this machine as described above.
113
+
3. Start the WildFly server with the following command. Be sure to replace `MACHINE_1_IP_ADDRESS` with the IP address of this machine. These arguments make the server accessible to the network.
114
114
115
-
For Linux: ${jboss.home.name}/bin/standalone.sh -b MACHINE_1_IP_ADDRESS -bmanagement MACHINE_1_IP_ADDRESS
116
-
For Windows: ${jboss.home.name}\bin\standalone.bat -b MACHINE_1_IP_ADDRESS -bmanagement MACHINE_1_IP_ADDRESS
115
+
For Linux: WILDFLY_HOME/bin/standalone.sh -b MACHINE_1_IP_ADDRESS -bmanagement MACHINE_1_IP_ADDRESS
116
+
For Windows: WILDFLY_HOME\bin\standalone.bat -b MACHINE_1_IP_ADDRESS -bmanagement MACHINE_1_IP_ADDRESS
117
117
118
118
119
119
### Configure Machine_2 (Local Client Machine)
120
120
121
-
1. Install ${product.name} on this server. There is no need to add the application users to this server.
121
+
1. Install WildFly on this server. There is no need to add the application users to this server.
122
122
2. Download the `app-client` quickstart to this machine.
123
123
3. Create a `jboss-ejb-client.properties` file. This file can be located anywhere in the file system, but for ease of demonstration, we create it in the root directory of this quickstart. Add the following content, replacing `MACHINE_1_IP_ADDRESS` with the IP address of `Machine_1`.
124
124
@@ -137,8 +137,8 @@ This example shows how to invoke an EJB from a remote standalone Java EE applica
137
137
6. Be sure that the quickstart deployed successfully and the server is running on `Machine_1` as described above.
138
138
7. Type this command to run the `app-client` application:
139
139
140
-
For Linux: ${jboss.home.name}/bin/appclient.sh --ejb-client-properties=ejb-client.properties ear/target/app-client.ear#simpleClient.jar Hello from command line
141
-
For Windows: ${jboss.home.name}\bin\appclient.bat --ejb-client-properties=ejb-client.properties ear\target\app-client.ear#simpleClient.jar Hello from command line
140
+
For Linux: WILDFLY_HOME/bin/appclient.sh --ejb-client-properties=ejb-client.properties ear/target/app-client.ear#simpleClient.jar Hello from command line
141
+
For Windows: WILDFLY_HOME\bin\appclient.bat --ejb-client-properties=ejb-client.properties ear\target\app-client.ear#simpleClient.jar Hello from command line
142
142
143
143
8. Review the result. The client outputs the following information, which was provided by the application:
144
144
@@ -162,7 +162,7 @@ This example shows how to invoke an EJB from a remote standalone Java EE applica
162
162
163
163
Follow these instructions if you are testing the quickstart on the same machine.
164
164
165
-
1. Make sure you have started the ${product.name} server on the machine where the quickstart is deployed as described above.
165
+
1. Make sure you have started the WildFly server on the machine where the quickstart is deployed as described above.
166
166
2. Open a command prompt on that server and navigate to the root directory of this quickstart.
167
167
3. When you are finished testing, type this command to undeploy the archive from the local machine.
168
168
@@ -173,7 +173,7 @@ Follow these instructions if you are testing the quickstart on the same machine.
173
173
174
174
Follow these instructions if you are testing the quickstart on a different machine.
175
175
176
-
1. Make sure you have started the ${product.name} server on the remote server machine, `Machine_1`, where the quickstart is deployed as described above.
176
+
1. Make sure you have started the WildFly server on the remote server machine, `Machine_1`, where the quickstart is deployed as described above.
177
177
2. Open a command prompt on the local client machine, `Machine_2`, and navigate to the root directory of this quickstart.
178
178
3. When you are finished testing, type this command to undeploy the archive from the remote server machine, `Machine_1`.
Copy file name to clipboardExpand all lines: batch-processing/README.md
+16-16Lines changed: 16 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,8 +4,8 @@ Author: Rafael Benevides
4
4
Level: Intermediate
5
5
Technologies: CDI, Batch 1.0, JSF
6
6
Summary: The `batch-processing` quickstart shows how to use chunk oriented batch jobs to import a file to a database.
7
-
Target Product: ${product.name}
8
-
Source: <${github.repo.url}>
7
+
Target Product: WildFly
8
+
Source: <https://github.com/wildfly/quickstart/>
9
9
10
10
11
11
## What is it?
@@ -19,46 +19,46 @@ The Job contains two steps (tasks):
19
19
20
20
The database schema defines that the column for name is unique. For that reason, any atempt to persist a duplicate value will throw an exception. On the second attempt to run the job, the `ChunkCheckpoint` will provide information to skip the Contacts that were already persisted.
21
21
22
-
_Note: This quickstart uses the H2 database included with ${product.name.full} ${product.version}. It is a lightweight, relational example datasource that is used for examples only. It is not robust or scalable, is not supported, and should NOT be used in a production environment!_
22
+
_Note: This quickstart uses the H2 database included with WildFly Application Server 11. It is a lightweight, relational example datasource that is used for examples only. It is not robust or scalable, is not supported, and should NOT be used in a production environment!_
23
23
24
-
_Note: This quickstart uses a `*-ds.xml` datasource configuration file for convenience and ease of database configuration. These files are deprecated in ${product.name} and should not be used in a production environment. Instead, you should configure the datasource using the Management CLI or Management Console. Datasource configuration is documented in the [Configuration Guide](https://access.redhat.com/documentation/en/red-hat-jboss-enterprise-application-platform/) for ${product.name.full}._
24
+
_Note: This quickstart uses a `*-ds.xml` datasource configuration file for convenience and ease of database configuration. These files are deprecated in WildFly and should not be used in a production environment. Instead, you should configure the datasource using the Management CLI or Management Console. Datasource configuration is documented in the [Configuration Guide](https://access.redhat.com/documentation/en/red-hat-jboss-enterprise-application-platform/) for WildFly Application Server._
25
25
26
26
## System Requirements
27
27
28
-
The application this project produces is designed to be run on ${product.name.full} ${product.version} or later.
28
+
The application this project produces is designed to be run on WildFly Application Server 11 or later.
29
29
30
-
All you need to build this project is ${build.requirements}. See [Configure Maven for ${product.name} ${product.version}](https://github.com/jboss-developer/jboss-developer-shared-resources/blob/master/guides/CONFIGURE_MAVEN_JBOSS_EAP7.md#configure-maven-to-build-and-deploy-the-quickstarts) to make sure you are configured correctly for testing the quickstarts.
30
+
All you need to build this project is Java 8.0 (Java SDK 1.8) or later and Maven 3.3.1 or later. See [Configure Maven for WildFly 11](https://github.com/jboss-developer/jboss-developer-shared-resources/blob/master/guides/CONFIGURE_MAVEN_JBOSS_EAP7.md#configure-maven-to-build-and-deploy-the-quickstarts) to make sure you are configured correctly for testing the quickstarts.
31
31
32
32
33
-
## Use of ${jboss.home.name}
33
+
## Use of WILDFLY_HOME
34
34
35
-
In the following instructions, replace `${jboss.home.name}` with the actual path to your ${product.name} installation. The installation path is described in detail here: [Use of ${jboss.home.name} and JBOSS_HOME Variables](https://github.com/jboss-developer/jboss-developer-shared-resources/blob/master/guides/USE_OF_${jboss.home.name}.md#use-of-eap_home-and-jboss_home-variables).
35
+
In the following instructions, replace `WILDFLY_HOME` with the actual path to your WildFly installation. The installation path is described in detail here: [Use of WILDFLY_HOME and JBOSS_HOME Variables](https://github.com/jboss-developer/jboss-developer-shared-resources/blob/master/guides/USE_OF_WILDFLY_HOME.md#use-of-eap_home-and-jboss_home-variables).
36
36
37
37
38
38
39
39
## Start the Server
40
40
41
41
42
-
1. Open a command line and navigate to the root of the ${product.name} directory.
42
+
1. Open a command line and navigate to the root of the WildFly directory.
43
43
2. The following shows the command line to start the server with the default profile:
44
44
45
-
For Linux: ${jboss.home.name}/bin/standalone.sh
46
-
For Windows: ${jboss.home.name}\bin\standalone.bat
45
+
For Linux: WILDFLY_HOME/bin/standalone.sh
46
+
For Windows: WILDFLY_HOME\bin\standalone.bat
47
47
48
48
49
49
## Build and Deploy the Quickstart
50
50
51
-
1. Make sure you have started the ${product.name} server as described above.
51
+
1. Make sure you have started the WildFly server as described above.
52
52
2. Open a command line and navigate to the root directory of this quickstart.
53
53
3. Type this command to build and deploy the archive:
54
54
55
55
mvn clean package wildfly:deploy
56
-
4. This will deploy `target/${project.artifactId}.war` to the running instance of the server.
56
+
4. This will deploy `target/batch-processing.war` to the running instance of the server.
57
57
58
58
59
59
## Access the Application
60
60
61
-
Access the running application in a browser at the following URL: <http://localhost:8080/${project.artifactId}/>
61
+
Access the running application in a browser at the following URL: <http://localhost:8080/batch-processing/>
62
62
63
63
You are presented with a simple form that allows you to generate sample files to be imported.
64
64
@@ -148,7 +148,7 @@ _Note:_ You will see the following warnings in the server log. You can ignore th
148
148
149
149
## Undeploy the Archive
150
150
151
-
1. Make sure you have started the ${product.name} server as described above.
151
+
1. Make sure you have started the WildFly server as described above.
152
152
2. Open a command prompt and navigate to the root directory of this quickstart.
153
153
3. When you are finished testing, type this command to undeploy the archive:
154
154
@@ -157,7 +157,7 @@ _Note:_ You will see the following warnings in the server log. You can ignore th
157
157
158
158
## Run the Quickstart in Red Hat JBoss Developer Studio or Eclipse
159
159
160
-
You can also start the server and deploy the quickstarts or run the Arquillian tests from Eclipse using JBoss tools. For general information about how to import a quickstart, add a ${product.name} server, and build and deploy a quickstart, see [Use JBoss Developer Studio or Eclipse to Run the Quickstarts](${use.eclipse.url}).
160
+
You can also start the server and deploy the quickstarts or run the Arquillian tests from Eclipse using JBoss tools. For general information about how to import a quickstart, add a WildFly server, and build and deploy a quickstart, see [Use JBoss Developer Studio or Eclipse to Run the Quickstarts](https://github.com/jboss-developer/jboss-developer-shared-resources/blob/master/guides/USE_JBDS.md#use-jboss-developer-studio-or-eclipse-to-run-the-quickstarts).
0 commit comments