summaryrefslogtreecommitdiffstats
path: root/Readme/ReadMe.md
diff options
context:
space:
mode:
authorzheng_wenlong <wenlong_zheng@nexty-ele.com>2019-04-16 11:20:38 +0900
committerzheng_wenlong <wenlong_zheng@nexty-ele.com>2019-05-13 17:50:04 +0900
commit3b55d06b89bf64873e685c3d78fce5affbba3d17 (patch)
tree2adcff0087f4757107d2bf1e50c85ea649f04f94 /Readme/ReadMe.md
[Patch Set 2] Add ReadMe.md Change-Id: I6ade52d2490f5ca4ba107c1a27ed6d5b39048725 Signed-off-by: zheng_wenlong <wenlong_zheng@nexty-ele.com>
Diffstat (limited to 'Readme/ReadMe.md')
-rw-r--r--Readme/ReadMe.md650
1 files changed, 650 insertions, 0 deletions
diff --git a/Readme/ReadMe.md b/Readme/ReadMe.md
new file mode 100644
index 0000000..77834fc
--- /dev/null
+++ b/Readme/ReadMe.md
@@ -0,0 +1,650 @@
+
+
+
+
+# PART 1. agl-app-warehouse Environmental Construction Manual
+
+[TOC]
+
+## 1. Basic Environment
+
+### 1.1 Hardware
+
+* cpu ---------------- 3.30GHz or more
+* Memory---------- 4Gbytes or more
+* HDD--------------- 100Mbytes or more
+
+### 1.2 Software
+
+* Centos7.2
+* JDK 1.8
+* apache-tomcat-8
+* Redis
+* MySQL 5.7.22
+
+*The IP address used in this environment construction is "192.168.200.107"[^1].
+
+[^1]: The IP address in this manual is replaced by "$IP", so please rewrite it to the IP address which used in the actual environment construction.
+
+
+
+## 2. JDK
+
+### 2.1 Installation
+
+```shell
+# yum install java-1.8.0-openjdk
+```
+
+### 2.2 Configuration
+
+#### 2.2.1 Environmental Variables Configuration
+
+```shell
+# echo "export JAVA_HOME=$(readlink -e $(which java)|sed 's:/bin/java::')" > /etc/profile.d/java.sh
+```
+
+```shell
+# echo "PATH=\$PATH:\$JAVA_HOME/bin" >> /etc/profile.d/java.sh
+```
+
+```shell
+# source /etc/profile.d/java.sh
+```
+
+### 2.3 Confirmation
+
+```shell
+# java -version
+ OpenJDK version "1.8.0_171"
+ OpenJDK Runtime Environment (build 1.8.0_171-b10)
+ OpenJDK 64-Bit Server VM (build 25.171-b10, mixed mode)
+```
+
+
+
+## 3. Tomcat
+
+### 3.1 Installation
+
+#### 3.1.1 New User
+
+```shell
+# useradd -s /sbin/nologin tomcat
+```
+
+#### 3.1.2 Download
+
+```shell
+# mkdir -p /usr/local/src/tomcat
+```
+
+```shell
+# cd /usr/local/src/tomcat/
+```
+
+```shell
+# wget http://ftp.riken.jp/net/apache/tomcat/tomcat-8/v8.5.31/bin/apache-tomcat-8.5.31.tar.gz
+```
+
+#### 3.1.3 "tar.gz" Deployment
+
+```shell
+# tar zxvf apache-tomcat-8.5.31.tar.gz
+```
+
+```shell
+# mv apache-tomcat-8.5.31 /opt/
+```
+
+```shell
+# chown -R tomcat. /opt/apache-tomcat-8.5.31
+```
+
+```shell
+# ln -s /opt/apache-tomcat-8.5.31 /opt/tomcat
+```
+
+### 3.2 Configuration
+
+#### 3.2.1 Environmental Variables Configuration
+
+```shell
+# echo 'export CATALINA_HOME=/opt/tomcat' > /etc/profile.d/tomcat.sh
+```
+
+```shell
+# source /etc/profile.d/tomcat.sh
+```
+
+#### 3.2.2 Tomcat User Configuration
+
+```shell
+# vi /opt/tomcat/conf/tomcat-users.xml
+```
+
+Add the following contents in "tomcat-users.xml":
+
+```xml
+<role rolename="manager-gui"/>
+<role rolename="admin-gui"/>
+<user username="tomcat" password="tomcat" roles="manager-gui,admin-gui"/>
+```
+
+```shell
+# vi /opt/tomcat/webapps/manager/META-INF/context.xml
+```
+
+Remove "< value >... < / value > "
+
+#### 3.2.3 Service Definition File
+
+Create "/etc/systemd/system/tomcat.service" and store it as follows:
+
+Modify the permission of the created definition file to 755.
+
+```shell
+# vi /etc/systemd/system/tomcat.service
+```
+
+```shell
+# chmod 755 /etc/systemd/system/tomcat.service
+```
+
+File contents :
+
+```
+[Unit]
+Description=Apache Tomcat 8
+After=syslog.target network.target
+
+[Service]
+User=tomcat
+Group=tomcat
+Type=oneshot
+PIDFile=/opt/tomcat/tomcat.pid
+RemainAfterExit=yes
+
+ExecStart=/opt/tomcat/bin/startup.sh
+ExecStop=/opt/tomcat/bin/shutdown.sh
+ExecReStart=/opt/tomcat/bin/shutdown.sh;/opt/tomcat/bin/startup.sh
+
+[Install]
+WantedBy=multi-user.target
+```
+
+#### 3.2.4 Auto Start
+
+Auto start when the server starts.
+
+```shell
+# systemctl enable tomcat
+```
+
+#### 3.2.5 Set of Firewalld
+
+Create '/etc/firewalld/services/tomcat.xml ' and write it as follows:
+
+```shell
+# vi /etc/firewalld/services/tomcat.xml
+```
+
+```shell
+# firewall-cmd --add-service=tomcat --permanent
+```
+
+```shell
+# firewall-cmd reload
+```
+
+File contents:
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<service>
+  <short>Apache Tomcat 8</short>
+  <description>Apache Tomcat 8</description>
+ <port protocol="tcp" port="8080"/>
+</service>
+```
+
+### 3.3 Launch
+
+```shell
+# systemctl start tomcat
+```
+
+### 3.4 Confirmation
+
+Access to 'http://$IP:8080/'
+
+
+
+## 4. Redis
+
+### 4.1 Installation
+
+```shell
+# yum -y install epel-release
+```
+
+```shell
+# yum install -y redis
+```
+
+### 4.2 Configuration
+
+#### 4.2.1 "redis.conf" File Modification
+
+```shell
+# vi /etc/redis.conf
+```
+
+Before:
+
+```
+bind 127.0.0.1
+#requirepass foobared
+```
+
+After:
+
+```
+#bind 127.0.0.1
+requirepass appmarket
+```
+
+#### 4.2.2 Auto Start
+
+Auto start when the server starts.
+
+```shell
+# systemctl enable redis.service
+```
+
+#### 4.2.3 Set of Firewalld
+
+```shell
+# firewall-cmd --add-port=6379/tcp --permanent
+```
+
+```shell
+# firewall-cmd reload
+```
+
+### 4.3 Launch
+
+```shell
+# systemctl start redis.service
+```
+
+### 4.4 Confirmation
+
+```shell
+# redis-cli -a appmarket
+ redis 127.0.0.1:6379> ping
+ PONG
+```
+
+
+
+## 5. MySql
+
+### 5.1 Installation
+
+#### 5.1.1 Preparation
+
+```shell
+# yum remove mariadb-libs.x86_64
+```
+
+```shell
+# rm -rf /var/lib/mysql
+```
+
+#### 5.1.2 Installation
+
+```shell
+# yum localinstall https://dev.mysql.com/get/mysql57-community-release-el7-8.noarch.rpm
+```
+
+```shell
+# yum -y install mysql-community-server
+```
+
+#### 5.1.3 Correct Installation Confirmation
+
+```shell
+# mysqld --version
+ mysqld Ver 5.7.22 for Linux on x86_64 (MySQL Community Server (GPL))
+```
+
+### 5.2 Configuration
+
+#### 5.2.1 MySQL User Configuration
+
+##### 5.2.1.1 User Configuration
+
+Get the password generated from the record file and use it when executing the "mysql_secure_installation "command.
+
+```shell
+# systemctl start mysqld
+# cat /var/log/mysqld.log | grep root
+ xxxx[Note] A temporary password is generated for root@localhost: uhsd!Aid;3Zt
+```
+
+mysql_secure_installation Command is being executed:
+
+```
+NOTE:+E23:K42 RUNNING ALL PARTS OF THIS SCRIPT IS RECOMMENDED FOR ALL MySQL
+SERVERS IN PRODUCTION USE! PLEASE READ EACH STEP CAREFULLY!
+In order to log into MySQL to secure it, we'll need the current password for the root user. If you've just installed MySQL, and you haven't set the root password yet, the password will be blank,so you should just press enter here.
+Enter current password for root (enter for none):uhsd!Aid;3Zt
+OK, successfully used password, moving on…
+Setting the root password ensures that nobody can log into the MySQL root user without the proper authorisation.
+Set root password? [Y/n] y
+New password: 123456
+Re-enter new password: 123456
+Password updated successfully!
+Reloading privilege tables..
+… Success!
+By default, a MySQL installation has an anonymous user, allowing anyone to log into MySQL without having to have a user account created for them. This is intended only for testing, and to make the installation go a bit smoother. You should remove them before moving into a production environment.
+Remove anonymous users? [Y/n] y
+… Success!
+Normally, root should only be allowed to connect from 'localhost'. This ensures that someone cannot guess at the root password from the network.
+Disallow root login remotely? [Y/n] n
+… Success!
+By default, MySQL comes with a database named 'test' that anyone can access. This is also intended only for testing, and should be removed before moving into a production environment.
+Remove test database and access to it? [Y/n] n
+- Dropping test database…
+… Success!
+- Removing privileges on test database…
+… Success!
+Reloading the privilege tables will ensure that all changes made so far will take effect immediately.
+Reload privilege tables now? [Y/n] y
+… Success!
+Cleaning up…
+All done! If you've completed all of the above steps, your MySQL installation should now be secure.
+Thanks for using MySQL!
+[root@server1 ~]#
+```
+
+##### 5.2.1.2 Add User Permissions
+
+```shell
+# mysql -u root -p
+ Enter password:123456
+```
+
+```shell
+mysql> grant all privileges on *.* to root@'%'identified by '123456';
+```
+
+#### 5.2.2 Modification of "/etc/my.cnf "
+
+```shell
+# vi /etc/my.cnf
+```
+
+Add the following contents in my "my.cnf file":
+
+```
+[mysqld]
+character_set_server = utf8
+```
+
+#### 5.2.3 Auto Start
+
+```shell
+# systemctl enable mysqld.service
+```
+
+#### 5.2.4 Set of Firewalld
+
+```shell
+# firewall-cmd --permanent --zone=public --add-port=3306/tcp
+```
+
+```shell
+# firewall-cmd --permanent --zone=public --add-port=3306/udp
+```
+
+```shell
+# firewall-cmd --reload
+```
+
+### 5.3 Launch
+
+```shell
+# systemctl start mysqld.service
+```
+
+### 5.4 Confirmation
+
+```shell
+# mysql -u root -p
+Enter password:123456
+```
+
+```shell
+mysql> use mysql;
+Database changed
+```
+
+```
+mysql> select host,user from user;
++--------------+------+
+| host         | user |
++--------------+------+
+| localhost    | root |
+| 192.168.1.1 | root |
+| %            | root |
++--------------+------+
+```
+
+
+
+## 6. AglAppWarehouse
+
+Copy the war-file("warehouse.war" and "webservice.war" ) into the "/opt/tomcat/webapps" directory.
+
+### 6.1 Server Construction
+
+#### 6.1.1 Server Configuration
+
+##### 6.1.1.1 Redis Information Settings
+
+```shell
+# vi /opt/tomcat/webapps/webservice/WEB-INF/classes/redis.properties
+```
+
+Modify the file "redis.properties" as follows :
+
+```
+redis.host=192.168.200.107
+redis.port=6379
+redis.password=appmarket
+```
+
+##### 6.1.1.2 App File Saving Path Settings
+
+```shell
+# mkdir -p -m 777 /data/appmarket/log/web
+```
+
+```shell
+# mkdir -p -m 777 /data/appmarket/log/webservice
+```
+
+```shell
+# vi /opt/tomcat/webapps/webservice/WEB-INF/classes/fileManager.properties
+```
+
+Modify the file "fileManager.properties" as follows :
+
+```
+upload_path=/data/appmarket/filesystem/
+upload_path_checked=/data/appmarket/filesystem/
+```
+
+##### 6.1.1.3 Mybatis Info Settings
+
+```shell
+# vi /opt/tomcat/webapps/webservice/WEB-INF/classes/spring-mybatis.xml
+```
+
+Modify the file "spring-mybatis.xml" as follows :
+
+```xml
+<property name="url" value="jdbc:mysql://192.168.200.107:3306/appmarket……/>
+```
+
+##### 6.1.1.4 Log Info Saving Path Settings
+
+```shell
+# vi /opt/tomcat/webapps/webservice/WEB-INF/classes/properties.properties
+```
+
+Modify the webservice file "properties.properties" as follows :
+
+```
+log_ws_common_default=/data/appmarket/log/webservice/common-default.log
+log_ws_console_default=/data/appmarket/log/webservice/console-default.log
+log_ws_common_error=/data/appmarket/log/webservice/common-error.log
+log_ws_logistics_component=/data/appmarket/log/webservice/logistics-component.log
+```
+
+```shell
+# vi /opt/tomcat/webapps/warehouse/WEB-INF/classes/config/properties.properties
+```
+
+Modify the warehouse file "properties.properties" as follows :
+
+```
+log_ws_common_default=/data/appmarket/log/web/common-default.log
+log_ws_console_default=/data/appmarket/log/web/console-default.log
+log_ws_common_error=/data/appmarket/log/web/common-error.log
+log_ws_logistics_component=/data/appmarket/log/web/logistics-component.log
+```
+
+##### 6.1.1.5 Tomcat Server Configuration
+
+```shell
+# vi /opt/tomcat/conf/server.xml
+```
+
+Modify the webservice file "server.xml" as follows :
+
+```xml
+<Context debug="0" docBase="/data/appmarket/filesystem" path="resource" reloadable="false"/>
+```
+
+#### 6.1.2 Database Configuration
+
+```shell
+# mysql -u root -p
+Enter password:123456
+```
+
+```shell
+mysql> source /data/ftp/pub/db_data/appmarket.sql;
+```
+
+### 6.2 Launch
+
+```shell
+# systemctl start tomcat
+```
+
+### 6.3 Set of Port
+
+```shell
+# firewall-cmd --add-masquerade
+```
+
+```shell
+# firewall-cmd --add-forward-port=port=80:proto=tcp:toport=8080 --permanent
+```
+
+### 6.4 Confirmation
+
+Access to "http://$IP:8080/warehouse/"
+
+
+
+# PART 2. Code Compilation Manual
+
+## 1. Base Environment
+
+* eclipse :Neon.2 Release (4.6.2)
+* apache-tomcat-8.0
+* JDK 1.8
+
+## 2. New Project
+
+### 2.1 Create a Root Maven Project
+
+![project_start](img/new_maven_project_start.PNG)
+
+![maven_project](img/new_maven_project.PNG)
+
+![maven_project2](img/new_maven_project2.PNG)
+
+### 2.2 Create Maven Modules
+
+There are six maven modules.
+
+1. appmarket-core
+2. appmarket-model
+3. appmarket-persistence
+4. appmarket-utils
+5. warehouse
+6. webservice
+
+![maven_model_start](img/maven_model_start.PNG)
+
+Input the module name by maven modules.
+![avatar](img/new_maven_model.PNG)
+
+Selecting an archetype by maven modules( 1,2,3,4 choose ① , 5,6 choose ②)
+
+![avatar](img/new_maven_model2.PNG)
+
+![avatar](img/new_maven_model3.PNG)
+
+### 2.3 Replace Files
+
+Replace the workspace project files of eclipse with the files in the source code.
+
+
+
+## 3. Code Compilation
+
+### 3.1 Import Maven Projects
+
+![maven_import](img/maven_import.PNG)
+
+![maven_import1](img/maven_import1.PNG)
+
+![maven_import2](img/maven_import2.PNG)
+
+### 3.2 Update Project
+
+![maven_update](img/maven_update.PNG)
+
+## 4. War Export
+
+### 4.1 Export
+
+Export "warehouse.war "and "webservice.war".
+
+Right click on the project name(warehouse)
+
+![create_war1](img/create_war1.PNG)
+
+
+
+Select the save Path of war file
+
+![create_war2](img/create_war2.PNG)
+