Skip to content

Commit e856184

Browse files
Update to hyphened spelling of front-end and back-end (#203)
* Update to hyphened spelling of front-end and back-end * Update docker-compose information
1 parent 7a5a453 commit e856184

File tree

6 files changed

+54
-49
lines changed

6 files changed

+54
-49
lines changed

wiki/markdown/add-subscription.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Add Subscription
22

3-
This form is used to add subscription through frontend GUI. Here is a
3+
This form is used to add subscription through front-end GUI. Here is a
44
description of the elements available on this form.
55

66
<img src="images/subscription_add_form1.png">

wiki/markdown/curl-examples.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Below are some examples of using CURL towards different endpoints, together with
99
Most endpoints are also documented in the [Eiffel Intelligence backend repository](https://github.com/eiffel-community/eiffel-intelligence/tree/master/wiki/markdown)
1010

1111
**Note**: If you have multiple url parameters, you need to add quotation mark around the entire query. For example:
12-
12+
1313
curl -X GET "http://localhost:8080/endpoint?varible1=1&varible2=2"
1414

1515
#### Quick access to endpoints:
@@ -178,7 +178,7 @@ The second entry is invalid due to having the same name as the first entry. The
178178

179179
#### Deleting a back-end instance via curl
180180

181-
It is possible to delete a back-end instance using curl. The full JSON object has to be specified to identify which instance should be deleted. It is not possible to delete a default backend instance.
181+
It is possible to delete a back-end instance using curl. The full JSON object has to be specified to identify which instance should be deleted. It is not possible to delete a default back-end instance.
182182

183183
{"name":"My Back-End","host":"localhost","port":8090,"contextPath":"","https":false,"defaultBackend":false},
184184

wiki/markdown/docker.md

Lines changed: 39 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Docker
22

3-
In Eiffel-Intelligence frontend source code repository, a Dockerfile is provided which helps the developer or user to build the local Eiffel-Intellegence frontend source code repository changes to a Docker image.
4-
With the Docker image user can try-out the Eiffel-Intelligence frontend on a Docker Host or in a Kubernetes cluster.
3+
In Eiffel-Intelligence front-end source code repository, a Dockerfile is provided which helps the developer or user to build the local Eiffel-Intellegence front-end source code repository changes to a Docker image.
4+
With the Docker image user can try-out the Eiffel-Intelligence front-end on a Docker Host or in a Kubernetes cluster.
55

66
## Requirements
77
- Docker
@@ -13,12 +13,12 @@ With the Docker image user can try-out the Eiffel-Intelligence frontend on a Doc
1313
Windows: https://docs.docker.com/docker-for-windows/install/
1414

1515
- Docker Compose
16-
16+
1717
Linux and Windows: https://docs.docker.com/compose/install/
1818

1919
## Follow these step to build the Docker image.
2020

21-
1. Build the Eiffel-Intelligence frontend war file:
21+
1. Build the Eiffel-Intelligence front-end war file:
2222

2323
`mvn package -DskipTests`
2424

@@ -27,7 +27,7 @@ This will produce a war file in the "target" folder.
2727

2828
2. Build the Docker image with the war file that was produced from previous step:
2929

30-
`docker build -t eiffel-intelligence-frontend:0.0.19 --build-arg URL=./target/eiffel-intelligence-frontend-0.0.19.war -f src/main/docker/Dockerfile .`
30+
`docker build -t eiffel-intelligence-frontend:0.0.19 --build-arg URL=./target/eiffel-intelligence-frontend-0.0.19.war -f src/main/docker/Dockerfile .`
3131

3232
Now docker image has build with tag "eiffel-intelligence-frontend:0.0.19"
3333

@@ -70,10 +70,10 @@ When Eiffel-Intelligence container is running on your local Docker host Eiffel-I
7070

7171
In web-browser use url with docker host ip number: "\<docker host ip\>:8071/"
7272

73-
Switch-backend functionality do not work when "localhost" address is used.
73+
Switch-back-end functionality do not work when "localhost" address is used.
7474

75-
Another option to configure Eiffel-Intelligence Front-end is to provide the application properties file into the container, which can be made in two ways:
76-
1. Put application.properties file in Tomcat Catalina config folder in container and run Eiffe-Intelligence Front-end:
75+
Another option to configure Eiffel Intelligence front-end is to provide the application properties file into the container, which can be made in two ways:
76+
1. Put application.properties file in Tomcat Catalina config folder in container and run Eiffel Intelligence front-end:
7777

7878
`docker run -p 8070:8080 --expose 8080 --volume /path/to/application.properties:/usr/local/tomcat/config/application.properties eiffel-intelligence-frontend:0.0.19`
7979

@@ -84,60 +84,66 @@ Another option to configure Eiffel-Intelligence Front-end is to provide the appl
8484

8585
# Run Docker image with provided docker-compose file
8686
This docker-compose file includes these components, [docker-compose.yml](https://github.com/Ericsson/eiffel-intelligence-frontend/blob/master/src/main/docker/docker-compose.yml):
87-
- MongoDb
87+
- MongoDB
8888
- RabbitMq
89-
- ER
90-
- EI-Backend
91-
- EI-Frontend (Using the local EI-Frontend Docker image build from previous steps)
89+
- ER (Event Repository)
90+
- Mail server
91+
- Jenkins
92+
- Eiffel REMReM services (Generate and Publish)
93+
- 3 instances of EI backend (using different rule sets)
94+
- EI frontend (Using the local EI front-end Docker image build from previous steps)
9295

93-
If you have used a different image tag when you build the EI Frontend docker image, then you need to update docker-compose.yml file.
96+
NOTE: Only MongoDB, RabbitMQ, ER and EI components are needed to start.
97+
The rest of the components can be commented out if not needed.
9498

95-
This line need to changed, in ei_backend service section:
99+
### 1 Source environment variables used in docker-compose.yml
96100

97-
"image: eiffel-intelligence-frontend:0.0.19"
101+
For easier configuration, the Docker images to be used and ports for the different
102+
services are set in [env.bash](https://github.com/Ericsson/eiffel-intelligence-frontend/blob/master/src/main/docker/env.bash)
103+
file. Update to whichever ports you want to use, or keep default values. If you have used a different image tag when you built the EI front-end
104+
docker image, then you need to update the [env.bash file](https://github.com/Ericsson/eiffel-intelligence-frontend/blob/master/src/main/docker/env.bash)
105+
with the locally built image.
98106

99-
To:
107+
To run docker-compose commands, the environment variables needs to be set:
100108

101-
"image: \<your image tag\>"
109+
source src/main/docker/env.bash
102110

103111
Two variables need to be set before we can start up all services with docker-compose tool.
104-
Set Docker host ip to the HOST variable.
105-
If on Linux:
106-
112+
Set Docker host IP to the HOST variable. This is done automatically when sourcing [env.bash](https://github.com/Ericsson/eiffel-intelligence-frontend/blob/master/src/main/docker/env.bash).
113+
But it is also possible to do it manually. If on Linux:
107114
`export HOST=$(hostname -I | tr " " "\n"| head -1)`
115+
If on Windows, get Docker Host IP with command: `dockermachine ip`
116+
Set that Docker host IP to HOST environment variable.
108117

109-
If on Windows, get Docker Host ip with command: `dockermachine ip`
110-
111-
Set that Docker host ip to HOST environment varaible.
118+
Currently we need to provide EI back-end instances list outside of docker-compose.yml file.
119+
This is also done via the [env.bash](https://github.com/Ericsson/eiffel-intelligence-frontend/blob/master/src/main/docker/env.bash)
120+
file.
112121

113-
Currently we need to provide EI Back-end instances list outside of docker-compose.yml file.
122+
### 2 Then run following docker-compose command to startup all components:
114123

115-
`export EIFFEL2_EI_FRONTEND_EI_INSTANCES_LIST=$(echo [{ \"contextPath\": \"\", \"port\": \"8080\", \"name\": \"EI-Backend\", \"host\": \"ei-backend\", \"https\": false, \"defaultBackend\": true}])`
124+
docker-compose -f src/main/docker/docker-compose.yml up -d
116125

117-
Then run following docker-compose command to startup all components:
118-
119-
`docker-compose -f src/main/docker/docker-compose.yml up -d`
120-
121-
It will take some minutes until all components has started. When all components has loaded, you should be able to access EI Front-end web page with address:
126+
It will take some minutes until all components has started. When all components has loaded, you should be able to access EI front-end web page with address:
122127
http://\<docker host ip\>:8081/
123128

124-
Curl command can be used to make request via EI Front-end bridge to EI Back-end Rest-Api, example for getting all subscriptions:
129+
Curl command can be used to make request via EI front-end bridge to EI back-end REST API, example for getting all subscriptions:
125130

126131

127132
`curl -X GET http://localhost:8081/subscriptions`
128133

129134
It is also possible to access these Rest-Api addresses in web-browser and get result presented in a Json view in web-browser.
130135

131-
Following command can be used to get the logs from the EI Front-end container/service:
136+
Following command can be used to get the logs from the EI front-end container/service:
132137

133138
`docker-compose -f src/main/docker/docker-compose.yml logs ei_frontend`
134139

135-
All service names can be retreived with following command:
140+
All service names can be retrieved with following command:
136141

137142
`docker-compose -f src/main/docker/docker-compose.yml config --services`
138143

139144
It is also possible to retrieve the logs by only using "docker logs <container_id or container_name>" command:
140145

146+
`docker logs <container_id or container_name>`
141147
`docker logs <container_id or container_name>`
142148

143149
Container id can be retrieved with docker command:

wiki/markdown/index.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,12 @@
11
# Home
22

3-
Eiffel Intelligence Frontend provides Eiffel Intelligence (EI) users a simple
4-
and easy to use GUI. More precisely, Eiffel Intelligence Frontend allows the
5-
configuration of subscription and aggregation rules in Eiffel Intelligence
3+
Eiffel Intelligence front-end provides Eiffel Intelligence (EI) users a simple
4+
and easy to use GUI. More precisely, Eiffel Intelligence front-end allows the
5+
configuration of subscription and aggregation rules in Eiffel Intelligence
66
through a graphical interface.
77

8-
EI has two components, namely Eiffel Intelligence (Backend) and Eiffel
9-
Intelligence Frontend. In Eiffel GitHub these two components are represented by
10-
two different repositories. Eiffel Intelligence (Backend) implements core
11-
functionalities of EI and Eiffel Intelligence Frontend take care of the user
8+
EI has two components, namely Eiffel Intelligence (back-end) and Eiffel
9+
Intelligence front-end. In Eiffel GitHub these two components are represented by
10+
two different repositories. Eiffel Intelligence (back-end) implements core
11+
functionalities of EI and Eiffel Intelligence front-end take care of the user
1212
interactions through an interface.
13-

wiki/markdown/subscription-handling.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Clicking on the Subscription Handling element will display some buttons in main
44
page which help perform a number of subscription related actions. A table may
55
become visible, which is populated by the information about the stored (if any)
66
subscriptions in the connected database. This view is also the default view of
7-
the Eiffel Intelligence Frontend, once the authentication (if enabled) is done.
7+
the Eiffel Intelligence front-end, once the authentication (if enabled) is done.
88

99
<img src="images/subscription_overview.png">
1010
</img>
@@ -22,9 +22,9 @@ database.
2222
This button downloads a subscription template
2323
#### _Upload Subscriptions_
2424
This button help uploads a subscription by opening a file explorer
25-
#### _EI Backend Status_
26-
This button indicates, through its color, whether a backend instance is
27-
connected with frontend or not. The green color means backend is connected
25+
#### _EI Back-end Status_
26+
This button indicates, through its color, whether a back-end instance is
27+
connected with front-end or not. The green color means back-end is connected
2828
while red means no instance is connected.
2929

3030

wiki/markdown/test-rules.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -276,7 +276,7 @@ aggregated object will show up on the screen.
276276
## Curl ##
277277

278278
It is possible to use curl to get required information. To get information
279-
about test rules status, if this functionality is enabled in back end or
279+
about test rules status, if this functionality is enabled in back-end or
280280
not, you can execute command below.
281281

282282
curl -X GET http://<host>:8080/rules/rule-check/testRulePageEnabled?backendurl="http://127.0.0.1:8090/"

0 commit comments

Comments
 (0)