交接-黃至璿 (mPOS)

--- tags: 交接 --- # 交接-黃至璿 (mPOS) [TOC] ## Setup and Deployment ### Previous Setup and installation documents - [RPi API server 快速安裝 [mpos_api_server_quick_install.md]](http://172.16.9.53/IT_MPOS/mPOS/src/branch/master/BackEnd/scops/notes/mpos_api_server_quick_install.md) - [RPi API server 詳細安裝 [mpos_server_install_from_scratch.md]](http://172.16.9.53/IT_MPOS/mPOS/src/branch/master/BackEnd/scops/notes/mpos_server_install_from_scratch.md) - [從無到有安裝Tomee [tomee_setup.md]](http://172.16.9.53/IT_MPOS/mPOS/src/branch/master/BackEnd/scops/notes/tomee_setup.md) - [mPOS 收據/發票列印服務 [mpos_printing_service.md]](http://172.16.9.53/IT_MPOS/mPOS/src/branch/master/BackEnd/scops/notes/mpos_printing_service.md) ### `/opt/tk3c/bin/store_env` - 參 [mpos_oss/README](http://172.16.9.53/IT_MPOS/mPOS/src/branch/master/BackEnd/scops/mpos_oss#store_env) - 主要環境變數 ```bash export tk3c_store_no=705 #export tk3c_scope_id=lab export tk3c_home=/opt/tk3c export TK3C_HOME=/opt/tk3c # modify following for TomEE's environment export TK3CLIB="/opt/tomcat/tk3c-lib" export sc_storeno="$tk3c_store_no" export sc_mqtt_broker="tcp://localhost:1883" export tk_api_header_key="X-Powered-TK" export tk_api_header_value="DeMGJVGtPKu/o7tlHXllpw+ekkdOOUxdTjJ0o/dyXWE=" export tk_api_url="http://10.254.249.12:18718" export wish_api_url="http://10.254.248.21:8765" export pr_api_url="http://172:16.9.188" export pr_api_clientid="mpos_tk" export pr_api_pwd="Tmjd5KXeyX8IWuiT" ``` ### Tomcat / Tomee > 詳細從無到有安裝參: [tomee_setup.md](http://172.16.9.53/IT_MPOS/mPOS/src/branch/master/BackEnd/scops/notes/tomee_setup.md) - Java version - Java 11 (LTS) - https://adoptopenjdk.net/ - Tomee version - tomee-8.0.1-plus - https://archive.apache.org/dist/tomee/tomee-8.0.1/apache-tomee-8.0.1-plus.tar.gz - Database connection setting - `<tomcat home>/conf/context.xml` ```xml <Context>   <WatchedResource>WEB-INF/web.xml</WatchedResource> <WatchedResource>WEB-INF/tomcat-web.xml</WatchedResource> <WatchedResource>${catalina.base}/conf/web.xml</WatchedResource>   <Resource name="jdbc/SCDB" type="javax.sql.DataSource" url="jdbc:oracle:thin:@scdb.mpos.local:1521:XE" driverClassName="oracle.jdbc.OracleDriver" username="admuser" password="g02he11hack2" auth="Container" testWhileIdle="true" validationQuery="select 1 from dual" testOnBorrow="true" validationQueryTimeout="30" timeBetweenEvictionRunsMillis="60000" minEvictableIdleTimeMillis="1800000" /> </Context> ``` :::warning `scdb.mpos.local` path sets in `/etc/hosts` ::: - `/opt/tomcat/<version>/bin/setenv.sh` - source `store_env` 裡的變數, 設定CLASSPATH 指向 external library ```bash . /opt/tk3c/bin/store_env CLASSPATH=$TK3CLIB/ojdbc6-11.2.0.4.jar:$TK3CLIB/org.eclipse.paho.client.mqttv3-1.2.4.jar echo "store=$sc_storeno" echo "broker=$sc_mqtt_broker" echo "tk_api=$tk_api_url $tk_api_header_key:$tk_api_header_value" echo "wish_api=$wish_api_url" echo "pr_api=$pr_api_url" ``` - `/opt/tomcat/tomcat.service` - Edit ```ini [Unit] Description=TomEE Plus After=network.target systemd-timesyncd.service [Service] Type=forking User=tomcat Group=tomcat Environment="JAVA_HOME=/usr/lib/jvm/java-11-openjdk-armhf" Environment="JAVA_OPTS=-Djava.security.egd=file:///dev/urandom -Djava.awt.headless=true -Duser.language=en" Environment="CATALINA_BASE=/opt/tomcat/latest" Environment="CATALINA_HOME=/opt/tomcat/latest" Environment="CATALINA_PID=/opt/tomcat/latest/temp/tomcat.pid" Environment="CATALINA_OPTS=-Xms512M -Xmx2048M -server -XX:+UseParallelGC" Environment="UMASK=0022" ExecStart=/opt/tomcat/latest/bin/startup.sh ExecStop=/opt/tomcat/latest/bin/shutdown.sh [Install] WantedBy=multi-user.target ``` > 若 `sudo systemctl status tomcat.service` 不存在, 則需把 tomcat.service 加入 systemd: > `sudo ln -s /opt/tomcat/tomcat.service /etc/systemd/system/tomcat.service` <hr/> ### Nginx - 安裝 - `sudo apt update -y && sudo apt install nginx` - 設定 - **`/etc/nginx/conf.d/tk3c.conf`** ``` upstream tomcat { server 127.0.0.1:8080 weight=100 max_fails=5 fail_timeout=5; } server { listen 80; listen [::]:80; listen 443 default_server ssl; listen [::]:443 default_server ssl; include snippets/ssl-params.conf; ssl_certificate /opt/tk3c/ssl/mpos_server.crt; ssl_certificate_key /opt/tk3c/ssl/mpos_server.key; server_name _; charset UTF-8; root /var/www/html; index index.html index.nginx-debian.html; location / { try_files $uri $uri/ =404; } location /mPOS/ { proxy_pass http://tomcat/mPOS/; proxy_set_header X-Forwarded-Host $host; proxy_set_header X-Forwarded-Server $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_hide_header 'X-Frame-Options'; add_header X-Frame-Options ALLOWALL; } location /logs/ { if ($scheme = 'http') { rewrite ^ https://$http_host$request_uri? permanent; } sendfile on; sendfile_max_chunk 1m; alias /opt/tk3c/logs/; autoindex on; autoindex_localtime on; add_header Access-Control-Allow-Origin *; default_type text/plain; } } ``` > 確認 `/etc/nginx/sites-enabled` 為空 <hr/> ### mosquitto - 安裝 - `sudo apt update -y && sudo apt install mosquitto` - 設定 - **/etc/mosquitto/conf.d/tk3c.conf** ```python # tk3c setting port 1883 # extra listener setting for websockets listener 9003 protocol websockets # extra listener setting for secured websockets listener 9443 protocol websockets cafile /opt/tk3c/ssl/mpos_ca keyfile /opt/tk3c/ssl/mpos_server.key certfile /opt/tk3c/ssl/mpos_server.crt require_certificate false # logging log_type all log_dest syslog # bridge settings connection bg705 address 10.254.248.41:1883 topic tk3c/log/+/705 out 0 topic tk3c/mpos/+ in 0 # for development env in A4F #address 10.1.62.97:1883 #topic tk3c/# both 0 ``` - Modify during production - if at any occation, need to modify bridge: after modifying needs to restart related services - `sudo systemctl restart mosquitto` - `sudo systemctl restart pos-keeper pos-print` #### **TROUBLESHOOT** - if after modification of topic subscription, and it didn't take effect, it's because the session is retained at default. Need `cleansession` to take effect on the changes - Ref: http://www.steves-internet-guide.com/mosquitto-bridge-configuration/ - (Weird) Solution 1. add `cleansession true` 2. `sudo systemctl restart mosquitto` 3. remove `cleansession true` 4. `sudo systemctl restart mosquitto` <hr> ### SSL - [參 MPOS安裝文件-更新SSL憑證](https://hackmd.io/@tk3c-mpos/HJkBwYZHd#3-%E6%9B%B4%E6%96%B0SSL%E6%86%91%E8%AD%89) <hr> ### API WAR Staging builds #### gradle: 自行執行 gradle 建置 WAR - `<mPOS repo>/BackEnd/mPOS/build.gradle` - built script :::spoiler show script ```gradle plugins { // Apply the java-library plugin to add support for Java Library //id 'java-library' id 'war' } sourceCompatibility = 11 compileJava.options.encoding = 'UTF-8' def tomeeLibDir = "$System.env.TOMCATLIB" def libDir = "$System.env.TK3CLIB" repositories { mavenCentral() } dependencies { if (project.hasProperty("remoterepo")){ println "Remote lib, mavenCentral" compileOnly 'org.apache.tomee:tomee-plus-webapp:8.0.1' compileOnly 'com.oracle.database.jdbc:ojdbc6:11.2.0.4' compileOnly 'org.eclipse.paho:org.eclipse.paho.client.mqttv3:1.2.4' } else { println "local lib" if (project.hasProperty("tomcatlib") && project.hasProperty("tk3clib")) { tomeeLibDir = project.getProperty("tomcatlib") libDir = project.getProperty("tk3clib") } if ( !(tomeeLibDir && libDir) || tomeeLibDir == "null" && libDir == "null") { tomeeLibDir = "/opt/tomcat/latest/lib" libDir = "/opt/tk3c/lib/jars" } compileOnly fileTree(dir: tomeeLibDir,include:['*.jar']) compileOnly files(libDir+'/ojdbc6-11.2.0.4.jar',libDir+'/org.eclipse.paho.client.mqttv3-1.2.4.jar') } } sourceSets { main.java.srcDirs = ["./src"] main.java.exclude ("**/SCSandbox.java","**/JDBCHelper.java") main.resources.srcDirs = [] // test.java.srcDirs = [] // test.resources.srcDirs = [] } task webinf() { copy{ from('./WebContent/WEB-INF/'){ exclude 'lib/org.eclipse.paho.client.mqttv3-1.2.4.jar' } into 'build/webinf' //include '*' //include 'lib/**' } } war { def rel = new Date().format('YYMMdd-HHmm') def gitHashCmd = "git rev-parse --short=7 HEAD".execute([], project.rootDir); gitHashCmd.waitFor() def gitHash = gitHashCmd.text.trim() if (project.hasProperty("githash")){ gitHash = project.getProperty("githash"); } def propertyFile = file "build/webinf/mpos.properties" def props = new Properties() propertyFile.withReader { props.load(it) } def v = props.getProperty("version") println "mPOS version: "+v+" "+rel+"_"+gitHash props.setProperty("version",v+" "+rel+"_"+gitHash) propertyFile.withWriter { props.store(it,null) } archiveFileName = 'mPOS_'+rel+'_'+gitHash+'.war' webInf {from 'build/webinf'} } war.dependsOn webinf ``` ::: - `<mPOS repo>/BackEnd/mPOS/gradlew` - 在Windows執行 ```bash <mPOS repo>/BackEnd/mPOS/gradlew.bat --debug -x test -S --info build -Premoterepo ``` - 在Linux執行 ```bash <mPOS repo>/BackEnd/mPOS/gradlew --debug -x test -S --info build [--Premoterepo] ``` > Note: > remoterepo 參數需外網連線 > 若沒外網需手動指定所需 dependency > - `gradlew --debug -x test -S --info build --Ptomcatlib=<path_to_tomcat_lib> --Ptk3clib=<path_to_tk3c_lib>` > - 或把 tomcat 放在 `/opt/tomcat/` & jars 在 `/opt/tk3c/lib/jars` > - 建置角本會自動尋找 `/opt/tomcat/latest/libs` 和 `/opt/tk3c/lib/jars` - 建置好 WAR檔在 `build/libs/mPOS_***.war`; ready to deploy #### Automatic build and staging location - From 10.1.62.97 (RPi) > the following can be done on any RPi - requirements - `/opt/tomcat/latest` - tomcat location - `/opt/tk3c/lib/jars` - external jars location (jdbc, mqtt) - `/opt/tk3c/staging/war` - folder for war files - `/opt/tk3c/repos/mPOS` - project repo location - `/opt/tk3c/bin/pos-deployapi.sh` - script for deploy to local tomcat (Optional) - execute build script: `/home/tk3c/build_mpos` :::success `build_mpos` script detail at http://172.16.9.53/IT_MPOS/mPOS_deployment/src/branch/master/README.md ::: - the script in RPi does the following 1. go to `/opt/tk3c/repos/mPOS`, checkout `backend` branch and pull 2. run gradle build (`/opt/tk3c/repos/mPOS/BackEnd/mPOS/gradlew`) - need `/opt/tk3c/lib/jars` and `/opt/tomcat/latest/libs` for compile 3. move built WAR to `/opt/tk3c/staging/war` 4. Optionally deploy WAR file to local tomcat - cron job - execute the above everyday at 22:00 ``` tk3c@rpi4tksc:~ $ crontab -l 0 22 * * * /home/tk3c/build_mpos -a -b backend -d > /opt/tk3c/logs/buildlog.log 2>&1 ``` - Staging WAR files - IDC: [10.254.241.41/builds/backend/api/](https://10.254.248.41/builds/backend/api/) - location: `/opt/tk3c/staging/war` - 97: [10.1.62.97/builds/backend/nightly/](https://10.1.62.97/builds/backend/nightly/) - location: `/opt/tk3c/staging/war` <hr> ### 部屬SOP - choose base rpi to copy - previous deployed rpi - designated base rpi (10.1.62.136) - SD Card clone methods 1. clone to another SD card [**CURRENT**] - [參 MPOS安裝文件-SD Card Clone](https://hackmd.io/@tk3c-mpos/HJkBwYZHd#SD-Card-Clone) 2. backup image remote (linux) > REF: [REMOTE BACKUP YOUR RASPBERRY PI WITH SSH VIA TERMINAL](https://pixelfriedhof.com/en/remote-backup-your-raspberry-pi-with-ssh-via-terminal/) ```bash ssh tk3c@10.1.62.136 "sudo dd if=/dev/mmcblk0 bs=1M | gzip -" | dd of=<path>/rpi_mpos_20211006.gz ``` - flash img to sd card - use [balenaEtcher](https://www.balena.io/etcher/) or `dd` command 3. backup image remote (windows) > REF: [Remote backup of Raspberry Pi sd card from Windows](https://stackoverflow.com/questions/66279359/remote-backup-of-raspberry-pi-sd-card-from-windows#comment117546553_66279359) ```bash ssh tk3c@10.1.62.136 "sudo dd if=/dev/mmcblk0 bs=1M | gzip -" > C:\<path>\rpi_mpos_20211006.gz ``` - flash img to sd card - use [balenaEtcher](https://www.balena.io/etcher/) and/or [Win32 Disk Imager](https://sourceforge.net/projects/win32diskimager/) - preparation (before flash sd card / backup) - [參 MPOS安裝文件-Prerequisite](https://hackmd.io/@tk3c-mpos/HJkBwYZHd#RPI) - configurations (after flash sd card) - [參 MPOS安裝文件-設定檔](https://hackmd.io/@tk3c-mpos/HJkBwYZHd#%E8%A8%AD%E5%AE%9A%E6%AA%94) <hr> - Update Raspberry Pi OS packages - [參 MPOS安裝文件-確認系統更新](https://hackmd.io/@tk3c-mpos/HJkBwYZHd#1-%E7%A2%BA%E8%AA%8D%E7%B3%BB%E7%B5%B1%E6%9B%B4%E6%96%B0-%E8%8B%A5%E7%84%A1%E9%9C%80%E6%9B%B4%E6%96%B0%E8%B7%B3%E8%87%B3-2) - Troubleshoot / Q&A - [參 Store RPi Maintenance](https://hackmd.io/@tk3c-mpos/H1fDbHJF_) - tools - [WinSCP](https://winscp.net/eng/index.php) - ssh - rsync - `mpos_tool.py` ([documentation](http://172.16.9.53/IT_MPOS/mPOS_deployment#mpos_toolpy)) <hr/> ## API ### Quick 97 Deployment after `backend` branch update - SSH to 97`ssh tk3c@10.1.62.97` - Run `./build_mpos -a -b backend -d` :::success **[`build_mpos` script documentation](http://172.16.9.53/IT_MPOS/mPOS_deployment#build_mpos--build_mpos_remoterepo)** - `-a`: auto build without prompt - `-b backend`: use backend branch - `-d`: auto deploy without prompt ::: ### Documents - [Eclipse/Java/Tomcat development environment setup](https://hackmd.io/@tk3c-mpos/SJrWyUoxF) - [Class diagram](https://hackmd.io/@tk3c-mpos/SJx50q3G_) - [API Reference](https://hackmd.io/@tk3c-mpos/SkZf9x2EK) - [Deployement Architecture Diagram](https://hackmd.io/@tk3c-mpos/By2q5VAXd) - [Receipt printing flow](https://hackmd.io/@tk3c-mpos/rk-NU6cV_) - [PR Interaction Flow](https://hackmd.io/@tk3c-mpos/Hyiz7mjfd) - [MM → THD/TDL mapping](https://hackmd.io/@tk3c-mpos/H1x09e3Vt) - [TDL_PAY (Payment Logging)](https://hackmd.io/@tk3c-mpos/SySGFhNQu) - [Data Entity / Model](https://hackmd.io/@tk3c-mpos/ByCIM-hEt) - [Access Token / JWT](https://hackmd.io/@tk3c-mpos/rJCLM2LOv) - Token generation (JWT) - uses `org.jose4j.*` package - [TokenUtil.java source](http://172.16.9.53/IT_MPOS/mPOS/src/branch/master/BackEnd/mPOS/src/tk3c/mpos/packer/TokenUtil.java) ### MQTT - [MQTTHelper.java source](http://172.16.9.53/IT_MPOS/mPOS/src/branch/master/BackEnd/mPOS/src/tk3c/mpos/packer/MQTTHelper.java) - Receipt printer - [PrinterProxy.java source](http://172.16.9.53/IT_MPOS/mPOS/src/branch/master/BackEnd/mPOS/src/tk3c/mpos/packer/PrinterProxy.java) ## Store/API RPi services and scripts (Python, bash scripts) **[repo source and documentation](http://172.16.9.53/IT_MPOS/mPOS/src/branch/master/BackEnd/scops/mpos_oss)** - `adapter.sh` - `TK3CPOSPrint.py` - `poskeeper.py` - `collectactivites.py` - `pos-cleanup.py` - `store_env` ## Dock RPi ### Project Repo - [`mposkit` lib](http://172.16.9.53/IT_MPOS/mPOS/src/branch/master/BackEnd/scops/mpos_dock) ### current Dock RPi - 10.1.62.132 :::info has xrdp installed, can remote using windows remote desktop ::: - location: `/home/tk3c/mposkit` - venv: `/home/tk3c/venv_mposkit` - execution: ```bash # Activate virtual environment source ~/venv_mposkit/bin/activate # Run mposkit with tk3c scope python3 -m mposkit tk3c ``` - 10.1.62.99 (partial, only USB) :::info has xrdp installed, can remote using windows remote desktop ::: ### 如果要拿現有API RPi 加上 Dock 功能: - 參 [POS Dock Library#Requirements before running the program](http://172.16.9.53/IT_MPOS/mPOS/src/branch/master/BackEnd/scops/mpos_dock#requirements-before-running-the-program) - required apt packages - usbmuxd - libusbmuxd-tools - libimobiledevice6 - libimobiledevice-utils - libusbmuxd4 ```bash sudo apt install usbmuxd libusbmuxd-tools libimobiledevice6 libimobiledevice-utils libusbmuxd4 ``` ![](https://i.imgur.com/1sb1moT.png) - venv (virtual env) - packages - evdev - paho-mqtt - pyserial - python-escpos - pyudev - RPi.GPIO (version >= 0.7.1a4) ![](https://i.imgur.com/baPqKBP.png) - `tk3c` user groups ``` tk3c kmem dialout sudo www-data plugdev input lpadmin gpio ``` ![](https://i.imgur.com/CR1wkwh.png) > ref : [How to add user to group](https://www.howtogeek.com/50787/add-a-user-to-a-group-or-second-group-on-linux/) ### IO configurations - receipt printer (USB) - `/etc/udev/rules.d/99-escpos.rules` ``` SUBSYSTEM=="usb", ATTRS{idVendor}=="076c", ATTRS{idProduct}=="0302", MODE="0666", GROUP="dialout" ``` ### `dock_tool`: Testing / Monitoring / Control Panel - http://172.16.9.53/IT_MPOS/posctrlpanel - Hosted: - http://10.1.62.97/sandbox/dock_tool/ - `/opt/tk3c/sandbox/dock_tool` - http://10.1.62.132/sandbox/dock_tool/ - `/opt/tk3c/sandbox/dock_tool` ### todos and considerations - move hardware configuration to config files (`ini`) - similar fashion as `tk3c-posprint.ini` in mPOS server - move to designated location - e.g. `/opt/tk3c/...` - create systemd service - `posdock.service` - `adapter.sh` ?? - venv - add `poskeeper.py` for monitoring ? or include new monitoring service to service directory - if using dock_tool for production monitoring, need open port 9443 ### Reference - ESC/POS commands - https://www.epson-biz.com/modules/ref_escpos/index.php?content_id=72 - https://aures-support.com/DATA/drivers/Imprimantes/Commande%20ESCPOS.pdf ## Maintenance / Enviroment control ### Store mPOS status dashboard #### Project repository - http://172.16.9.53/IT_MPOS/mPOS/src/branch/master/BackEnd/scops/dashboard #### Currently hosted - 97 (https://10.1.62.97/sandbox/dashboard/) - hosted file location: `/opt/tk3c/sandbox/dashboard` - update `storelist.json` - `10.1.62.97:/opt/tk3c/sandbox/dashboard/static/storelist.json` - IDC (https://10.254.248.41/dashboard/) - hosted file location: `/opt/tk3c/dashboard` - update `storelist.json` - `/opt/tk3c/dashboard/static/storelist.json` #### MQTT commands - topic: `tk3c/console/reload`, msg: <none> - force refresh ### `mpos_tool.py` - http://172.16.9.53/IT_MPOS/mPOS_deployment - requirement - linux - python3.7+ - rsync - ssh - files - `mpos_tool.py` - `storelist.json` - `deployment_version.ini` ### POS control panel / dock tool - http://172.16.9.53/IT_MPOS/posctrlpanel ### IDC `/opt/tk3c/staging` - oss - war ## Others ### Occational request: Print sample invoice - Use nccc 發票紙捲 (台新紙會泛黃) - 1個一般銷售發票, 1個有統編發票 - 發票號碼/交易序號不能重複 ### SSH key pair: ssh without prompting enter password - http://172.16.9.53/IT_MPOS/mPOS/src/branch/backend/BackEnd/scops/notes/SSH_Key_Pair.md ### Linux commands - Useful tool: **[explainshell](https://explainshell.com/)** - e.g. `rsync -avzh --progress /home/tk3c/somefile tk3c@10.2.219.248:/home/tk3c` ![](https://i.imgur.com/Nhh788n.png) - `man` - an interface to the on-line reference manuals - `man ssh` - `man rsync` - `man man` - `ssh` - tunnel - `ssh -R 1080 tk3c@10.2.219.248` - reverse dynamic forwarding - socks5 proxy - forward remote's port 1080 to local - `ssh -L 9000:192.168.1.251:80 tk3c@10.2.219.248` - forward local's `localhost:9000` to remote's `192.168.1.251:80` - run remote command - `ssh tk3c@10.2.219.248 'ip addr'` - `rsync` - `systemctl` - `sudo systemctl status nginx` - `tail` - `sudo tail -f /var/log/mosquitto/mosquitto.log` - `tail -f /opt/tk3c/logs/TK3CPOSPrint.log` - `ip addr` - `apt` - `date` - `lsusb` - `cat` - `nano` - `curl` ![](https://i.imgur.com/o5XUaK2.png) - `jq` (external) ![](https://i.imgur.com/aZTFx5s.png) ### **TODOs** - [ ] update store RPi API from version 0.2.21 to 0.2.24+ (at the time of this writing 20211013) - [ ] 18 new foodpanda stores need update lastest oss/bin - `TK3CPOSPrint.py` - changes: donate deliver receipt invono mask fix, - `collectactivities.py` - changes: cleanup old logs on collect, - `poskeeper.py` - changes: fix exception on closing program - wait for all stores to go online, then execute batch rsync ```bash ssh tk3c@10.1.62.97 '~/mpos.tool.py send [--dry-run] --exclude 705,999 /opt/tk3c/staging/oss/bin /opt/tk3c/bin' ``` - [ ] change first 11 stores' RPi and RP-700 ip | store | ip | | - | - | | 113 | 10.2.113.248 | | 126 | 10.2.126.248 | | 214 | 10.2.214.248 | | 219 | 10.2.219.248 | | 221 | 10.2.221.248 | | 228 | 10.2.228.248 | | 245 | 10.2.245.248 | | 285 | 10.102.31.248 | | 355 | 10.102.101.248 | | 562 | 10.112.54.248 | | 598 | 10.10.18.248 | - e.g. 219 1. Powershell: `ssh -L 9000:192.168.1.251:80 tk3c@10.2.219.248` 2. local browser `localhost:9000` ![](https://i.imgur.com/OlMycAV.png) - configure interface - change static IP - 192.168.1.251 → 10.2.219.241 - gateway 10.2.219.254 - click reboot :::warning Need to manually turn back on physically on user end ::: 3. modify `/opt/tk3c/bin/tk3c-posprint.ini` 4. restart pos-print `sudo systemctl restart pos-print.service` - [ ] Update tomcat local_access_log rotation period, currently no rotation - `/opt/tomcat/latest/conf/server.xml` - add `maxDays` to AccessLogValve (set 60 days) ```xml <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs" prefix="localhost_access_log" suffix=".txt" pattern="%h %l %u %t "%r" %s %b" maxDays="60"/> ``` :::info - Can update using `mpos_tool.py send` and `mpos_tool.py run-command` 1. send to /tmp folder because permission reason ```bash ./mpos_tool.py send --exclude 705,999 /opt/tomcat/latest/conf/server.xml /tmp ``` 2. sudo move the file to target destination ```bash ./mpos_tool.py run-command --exclude 705,999 'sudo mv /tmp/server.xml /opt/tomcat/latest/conf/server.xml' ``` ::: - [ ] Update SSL certificate to all stores (last update: 2021/09/29, expires 2022/10/31) ## Other Documentations - http://172.16.9.53/IT_MPOS/mPOS/src/branch/master/BackEnd/scops/notes - previously (partially) hosted at https://10.1.62.97/sandbox/md.html?note=readme

Syntax	Example	Reference
# Header	Header	基本排版
- Unordered List	Unordered List
1. Ordered List	Ordered List
- [ ] Todo List	Todo List
> Blockquote	Blockquote
Bold font	Bold font
Italics font	Italics font
~~Strikethrough~~	~~Strikethrough~~
19^th^	19^th
H~2~O	H₂O
++Inserted text++	Inserted text
==Marked text==	Marked text
[link text](https:// "title")	Link
![image alt](https:// "title")	Image
`Code`	`Code`	在筆記中貼入程式碼
```javascript var i = 0; ```	`var i = 0;`
:smile:		Emoji list
{%youtube youtube_id %}	Externals
$L^aT_eX$	L^aT_eX
:::info This is a alert area. :::	This is a alert area.