> For the complete documentation index, see [llms.txt](https://mifos.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mifos.gitbook.io/docs/untitled-1/config-setup-build-deploy-application.md). # Config, setup, build, deploy application ## Config before build ### Configure bank access {% code title="opb-lionfintech/src/main/resources/db/changelog/sql/init-1.0.sql" %} ```sql INSERT INTO BANKS VALUES ('2293e2cf-1c54-38cf-9934-6be4e94e60f8', 'Lion', 'Lion', 'Lion Bank Ltd.', '/images/bank/lion.svg', 'https://api.lion.mlabs.dpc.hu:8243/token', 'https://api.lion.mlabs.dpc.hu:8243/open-banking/v3.1/aisp/v3.1.2', 'PttPN26uJLQgvRjSrhmh5ShaqZga', 'gUPRoq7QUgkuBkdLIkLc1d6fJhka', 'https://acefintech.mlabs.dpc.hu/lionfintech/customer/banks/authorize', 'lionfintech', 'https://api.lion.mlabs.dpc.hu:8243/authorzize', 'https://api.lion.mlabs.dpc.hu:8243/open-banking/v3.1/pisp/v3.1.2', 'http://lion.mlabs.dpc.hu/accessschema/ob'); ``` {% endcode %} #### BANKS table structure **id**\ UUID for identify a bank\ eg: 2293e2cf-1c54-38cf-9934-6be4e94e60f8\ Use only internally. We just generate random UUID value. **name**\ Name of the bank\ eg: Lion **shortName**\ Short name of the bank\ eg: Lion **longName**\ Long name of the bank\ eg: Lion Bank Ltd. **logoUrl**\ url for the bank logo.\ eg: /images/bank/lion.svg\ Bank logo images can found at GUI application. **tokenUrl**\ OAuth token url\ eg: **accounts\_url**\ Accounts API url, defined via Bank at Publisher site.\ eg: **client\_id**\ LionFintech application OAuth client id (consumer key).\ eg: PttPN26uJLQgvRjSrhmh5ShaqZga\ You can find at API Store. This value must be identical with WSO2 API Store values. **client\_secret**\ LionFintech application OAuth client secret (consumer secret).\ eg: gUPRoq7QUgkuBkdLIkLc1d6fJhka\ You can find at API Store. This value must be identical with WSO2 API Store values. **callback\_url**\ LionFintech OAuth callback url. After user OAuth authorization, the WSO2 call this url. In OAuth calls we must provide this information too, based on OAuth standard.\ eg: You can find at API Store. This value must be identical with WSO2 API Store values. **userName**\ LionFintech username at WSO2 API Store. This username must be identical that user which signed up at API Store.\ eg: lionfintech **authorize\_url**\ OAuth authorization url.\ eg: **payments\_url**\ Payments API url, defined via Bank at Publisher site.\ eg: **gateway\_url**\ Consent handler API url\ eg: ## Create environment ``` cd ~ mkdir lionfintech mkdir lionfintech/db mkdir lionfintech/config ``` ### Create and edit application.properties {% code title="lionfintech/config/application.properties" %} ``` # # This Source Code Form is subject to the terms of the Mozilla # Public License, v. 2.0. If a copy of the MPL was not distributed # with this file, You can obtain one at # # https://mozilla.org/MPL/2.0/. # server.port=8085 server.servlet.context-path=/ ####Jetty specific properties######## # Number of acceptor threads to use. server.jetty.acceptors=1 # Maximum size in bytes of the HTTP post or put content. server.jetty.max-http-post-size=32768 # Number of selector threads to use. server.jetty.selectors=1 spring.datasource.url=jdbc:hsqldb:file:/home/ec2-user/lionfintech/db/ spring.datasource.username=SA spring.datasource.password= spring.datasource.tomcat.max-wait=20000 spring.datasource.tomcat.max-active=50 spring.datasource.tomcat.max-idle=20 spring.datasource.tomcat.min-idle=15 spring.jpa.properties.hibernate.dialect = org.hibernate.dialect.HSQLDialect spring.jpa.properties.hibernate.id.new_generator_mappings = false spring.jpa.properties.hibernate.format_sql = true spring.jpa.hibernate.ddl-auto=none logging.level.org.hibernate.SQL=DEBUG logging.level.org.hibernate.type.descriptor.sql.BasicBinder=TRACE spring.liquibase.enabled=true logging.level.org.springframework.web.filter.CommonsRequestLoggingFilter=DEBUG ``` {% endcode %} ### Create startup script (start\_lionfintech.sh) {% code title="start\_lionfintech.sh" %} ```bash $ nohup java -jar lionfintech/backend-0.0.1-SNAPSHOT.jar --spring.config.location=file:./lionfintech/config/ > lionfintech.log & ``` {% endcode %} ## Compile ```bash $ mvn clean package WARNING: An illegal reflective access operation has occurred WARNING: Illegal reflective access by com.google.inject.internal.cglib.core.$ReflectUtils$1 (file:/usr/share/maven/lib/guice.jar) to method java.lang.ClassLoader.defineClass(java.lang.String,byte[],int,int,java.security.ProtectionDomain) WARNING: Please consider reporting this to the maintainers of com.google.inject.internal.cglib.core.$ReflectUtils$1 WARNING: Use --illegal-access=warn to enable warnings of further illegal reflective access operations WARNING: All illegal access operations will be denied in a future release [INFO] Scanning for projects... [INFO] [INFO] --------------< hu.dpc.openbank.fpp.lionfintech:backend >--------------- [INFO] Building LIONfintech backend 0.0.1-SNAPSHOT [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- maven-clean-plugin:3.1.0:clean (default-clean) @ backend --- [INFO] Deleting /home/tsipos/dev/dpchu/opb-lionfintech/target [INFO] [INFO] --- maven-resources-plugin:3.1.0:resources (default-resources) @ backend --- [INFO] Using 'UTF-8' encoding to copy filtered resources. [INFO] Copying 0 resource [INFO] Copying 5 resources [INFO] [INFO] --- maven-compiler-plugin:3.8.1:compile (default-compile) @ backend --- [INFO] Changes detected - recompiling the module! [INFO] Compiling 406 source files to /home/tsipos/dev/dpchu/opb-lionfintech/target/classes [INFO] /home/tsipos/dev/dpchu/opb-lionfintech/src/main/java/hu/dpc/openbank/fpp/lionfintech/backend/controller/TokenController.java: /home/tsipos/dev/dpchu/opb-lionfintech/src/main/java/hu/dpc/openbank/fpp/lionfintech/backend/controller/TokenController.java uses unchecked or unsafe operations. [INFO] /home/tsipos/dev/dpchu/opb-lionfintech/src/main/java/hu/dpc/openbank/fpp/lionfintech/backend/controller/TokenController.java: Recompile with -Xlint:unchecked for details. [INFO] [INFO] --- maven-resources-plugin:3.1.0:testResources (default-testResources) @ backend --- [INFO] Using 'UTF-8' encoding to copy filtered resources. [INFO] skip non existing resourceDirectory /home/tsipos/dev/dpchu/opb-lionfintech/src/test/resources [INFO] [INFO] --- maven-compiler-plugin:3.8.1:testCompile (default-testCompile) @ backend --- [INFO] Changes detected - recompiling the module! [INFO] [INFO] --- maven-surefire-plugin:2.22.2:test (default-test) @ backend --- [INFO] [INFO] --- maven-jar-plugin:3.1.2:jar (default-jar) @ backend --- [INFO] Building jar: /home/tsipos/dev/dpchu/opb-lionfintech/target/backend-0.0.1-SNAPSHOT.jar [INFO] [INFO] --- spring-boot-maven-plugin:2.1.5.RELEASE:repackage (repackage) @ backend --- [INFO] Replacing main artifact with repackaged archive [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 8.809 s [INFO] Finished at: 2019-08-12T15:32:38+02:00 [INFO] ------------------------------------------------------------------------ ``` ## Deploy Copy created jar file to destination. ```bash $ scp opb-lionfintech/target/backend-0.0.1-SNAPSHOT.jar acefintech.mlabs.dpc.hu:lionfintech/ ``` ## Start ``` $ ssh acefintech.mlabs.dpc.hu $ ./start_lionfintech.sh ``` ## Stop Find the required process and terminate them. ``` $ ps -ef | grep lionfintech ec2-user 11573 1 6 12:11 pts/0 00:00:33 java -jar lionfintech/backend-0.0.1-SNAPSHOT.jar --spring.config.location=file:./lionfintech/config/ ec2-user 11636 11326 0 12:19 pts/1 00:00:00 grep --color=auto lionfintech $ kill 11573 ``` ## Watch log file ``` $ tail -f lionfintech.log ```