[JSP] 항목별 동적 툴팁 적용

어장 Develop/어장 JSP 2025. 4. 3. 18:53
반응형

웹 개발을 하면서 툴팁은 생각보다 많이 쓰인다. 항목별 도움말과 같이 동작할때가 가장 큰데, 이걸 관리자가 직접 관리할 수 있었으면 좋겠다는 요구사항이 나왔다. 허미 대체 이게 뭔말이래. 그러니까 간단하게 요약하자면 다음과 같다.

 

요구사항

1. 관리자가 툴팁관리 메뉴를 통해, 항목별로 툴팁을 등록/수정 등 관리를 할 수 있을 것

2. 등록된 툴팁은 화면상에서 보여질 것

 

대충 뭐 이런건데, 우리가 예시를 들자면 '저장'버튼 에 마우스 오버를 하면 '저장을 하기 위한 버튼이에용' 이라고 툴팁이 뜰 것이다.

그런데 저 툴팁메세지를 관리화면을 통해 추후에 바꾸겠다는거다. 이게 유동적으로 돼? 처음에는 반신반의 했는데, 이게 되네?

 

 

구현 - ModelAndView

결론적으로는 매우 쉽게 유동적으로 관리가 된다.

간단히 설명하자면, 해당 화면을 로딩하기 위한 controller 에서 ModelAndView에 jsp 경로를 리턴해줄것인데, 이 ModelAndView에 툴팁 Object를 함께 넣어주는 것.

그리고 해당 jsp 에서 툴팁Object 에서 html렌더링시 해당 value를 뽑아다 쓸 수 있는 것이다. 다음의 소스코드를 보자.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
public ModelAndView viewReturns(HttpServletRequest req,HttpServletResponse res) throws Exception {
    
    // 중략
    ModelAndView mav = new ModelAndView("/common/jsp/TEST1.jsp"); //jsp 경로 반환
    
    //이걸 추후에는 DB쿼리로 변경하면 된다
    Map<String, String> tooltipMap = new HashMap<>();
    tooltipMap.put("product", "상품명");
    tooltipMap.put("productId", "상품아이디");
    tooptilMap.put("productType", "상품구분");
 
    // ModelAndView에 tooltipMap 으로 오브젝트 담    
    mav.addObject("tooptilMap", tooltipMap);
 
    return mav;
}
 cs

 

소스코드에 작성된 주석과 같이 Map 형태로 툴팁 메시지를 담고, 저걸 modelandview에 넣어준다.

현재 디비가 준비되어있지 않아Map형태로 구현하긴 했지만, 실제로 db 쿼리 시에도 vo 형태로 가져올것이기에 크게 문제가 될 부분은 없다.

 

그리고 jsp에서는 다음과 같이 꺼내쓰면 끝이다. 완전 쉬움.

1
2
3
<div title="${tooltipMap.product}"><dl><dt>Product</dt></dl></div>
<div title="${tooltipMap.productId}"><dl><dt>Product Id</dt></dl></div>
<div title="${tooltipMap.productType}"><dl><dt>ProductType</dt></dl></div>
 cs

그럼 툴팁이 별도 처리 없이 바로 저렇게 보인다. 이렇게 간단하다고?

 

 

응용 - 그리드

javascript 형태로 되어진 그리드는 거의 대부분 적용될 것으로 보인다.

ModelAndView로 tooltipMap오브젝트를 담아 jsp로 던졌으니, jsp는 해당 페이지에 매핑된 js로 값을 넘겨주면 된다.

그리고 js에서는 그리드 컬럼을 구성할 때 tooltipMap에서 꺼내 매핑하면 된다.

다음의 소스코드를 보자.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
<script>
    // ModelAndView 에서 JSP 로 전달한 tooltipMap을 JS로 주입
    var tooltipObj = {
        product : "${tooltipMap.product}"
        ,productId : "${tooltipMap.productId}"
        , productType : "${tooltipMap.productType}"
    }
 
    // 중략
 
    // 그리드 컬럼 설정부
    const columnParam = [
        {name:'상품명',dataType:'text', fieldName:'product', tooltip:tooltipObj.product}
        ,{name:'상품아이디',dataType:'text', fieldName:'productId', tooltip:tooltipObj.productId}
        , {name:'상품타입',dataType:'text', fieldName:'productType', tooltip:tooltipObj.productType}
    ]
 
    //생략
</script>
 cs

 

3번째와 같이 JSP에서 JS로 오브젝트 주입을 시도한다.

그리고 js의 그리드 컬럼 설정부에서 tooltip을 저러한 형태로 작성해주면 된다.

 

이렇게하면 상단의 검색조건/항목의 툴팁과 그리드의 툴팁을 모두 JAVA 에서 가져올 수 있게 된다. 한 건 해결! 

 

반응형
저작자표시 비영리 변경금지

'어장 Develop > 어장 JSP' 카테고리의 다른 글

[JSP] 새로고침 없이 데이터 붙이기  (0) 2019.03.19
textarea 내에서 줄바꿈  (0) 2018.05.09
Starting Tomcat v5.5 Server at localhost' has encounterd a problem.  (0) 2013.04.24
JSTL 개요  (0) 2013.04.19
에러:Choose unique values for the 'webAppRootKey' context-param in your web.xml files  (0) 2013.04.19
블로그 이미지

김생선

세상의 모든것을 어장관리

,

[tiles] JSP tiles 설정하기

어장 Develop/어장 JAVA 2025. 4. 1. 18:48
반응형

신규 플젝에 투입되면서 공통 웹 개발파트를 맡게 되었다. 그놈의 웹개발은 그만하고 싶긴 한데, 하라면 해야지 뭐. 아무튼, 공통부라길래 그냥 공통 컴포넌트 정도 만지작거릴 줄 알았는데 그게 아니었고, 이번에 많이 배우는 듯 싶다.

 

서론 . tiles 추가하기에 앞서

현재 전자정부 프레임워크 4.2 버전을 사용중이다.

SI를 하건 뭘 하건 대부분의 웹 페이지는 다음과 같은 레이아웃 구조를 가지고 있다. 

 

저기서 상단의 Header , 좌측의 Nav, 하단의 Footer는 고정형 이미지이며 Body는 개발자들이 만들어내는 업무페이지라고 보면 된다. 처음에는 Header / Nav / Footer에 해당하는 JSP를 각각 만들고 Include하는 방식으로 생각했었는데 이거 아무리봐도 나이스하지가 않단말이다. 무슨 말이냐 하면, 

1
2
3
4
5
6
7
8
9
10
11
<div class="root-container">
    <%@ include file="/WEB-INF/jsp/commons/commLeft.jsp"%> <!-- 좌측 메뉴 -->
    <div class="container-wrap">
        <%@ include file="/WEB-INF/jsp/commons/commNav.jsp"%> <!--슬라이드 메뉴 -->
    </div>
    
    <!-- 요약을 많이 했지만 jsp 화면 컴포넌트가 여기들어감. -->
 
    <div class="footer-container">
    <%@ include file="/WEB-INF/jsp/commons/commFooter.jsp"%> <!-- 하단 푸터 -->
</div>
 cs

 

 

이렇게 모든 공통 레이아웃들을 저렇게 주저리주저리 include해야 한다. 우리는 상단의 이미지와 같이 심플한 구조가 아니라 공통 헤더, 공통 타이틀, 공통 네비게이터, 공통 슬라이드 네비게이터, 공통 인피니트탭, 공통 푸터 까지 있으니 위와 같은 방식으로 include file하려면 여섯개는 더 있어야 한다.

 

가장 큰 문제는 무어냐, 저 포맷을 고대로 갖다 써서 수많은 div태그를 뚫고 업무 화면을 그려내면 좋으련만, 저건 아주 극도로 축약한 div 태그들일 뿐이고 실제로는 약 100여줄에 가까운 태그들이 난무를 하고 있다는거다.

그럼 당연히 개발자의 실수 하나로 레이아웃이 모조리 깨지기도 하고 가독성도 너무 구려서 개발 난이도가 올라간다. 이럴때 무엇을 쓴다? apache tiles다.

tiles를 적용함으로 인해 공통으로 사용하는 레이아웃은 그대로 공통부에서 처리하고 업무 화면을 지정한 div태그의 어딘가에 끼워넣는 개념이라고 보면 된다. 즉, tiles로 사전에 레이아웃을 설정하고 특정 영역만 호출하는 개념이다. 이마리야.

 

1. tiles 적용 - pom.xml

tiles를 적용하기에 앞서 기본적인 레이아웃에 대한 작업은 퍼블리셔분께서 작업해주셨다고 가정한다. 이것까지 하다간 난 죽을지도 모른다. 아무튼, pom.xml에 다음과 같이 추가했다. GPT는 몇개 안넣어줬는데 돌려보니 계속 오류가 나서, 보태보태 병에 걸려 저렇게까지 추가하고 성공함.

<dependency>
  <groupId>org.apache.tiles</groupId>
  <artifactId>tiles-core</artifactId>
  <version>3.0.8</version>
</dependency>
<dependency>
  <groupId>org.apache.tiles</groupId>
  <artifactId>tiles-jsp</artifactId>
  <version>3.0.8</version>
</dependency>
<dependency>
  <groupId>org.apache.tiles</groupId>
  <artifactId>tiles-servlet</artifactId>
  <version>3.0.8</version>
</dependency>
<dependency>
  <groupId>org.apache.tiles</groupId>
  <artifactId>tiles-api</artifactId>
  <version>3.0.8</version>
</dependency>
<dependency>
  <groupId>org.apache.tiles</groupId>
  <artifactId>tiles-el</artifactId>
  <version>3.0.8</version>
</dependency>

 

라이브러리들 이름이 참 쉬우니 대충 알아들을건데 뭐 tiles라이브러리 코어모듈, jsp 모듈, 서블릿 제어모듈, api 호출모듈, el 명령어 모듈 정도로 네이밍이 된 듯 싶다. 확실한것인지는 잘 몰루. 아무튼. 여기까지 하고 maven update~ 한다.

 

2. tiles.xml 설정

pom.xml에 라이브러리를 추가했다면 다음은 tiles.xml을 설정해준다. 공통 레이아웃을 무엇을 쓸지 선언하는 부분이라 보면 된다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
<tiles-definitions>
    <!--공통 레이아웃 정의 -->
    <definition name="tilesbase" template="/WEB-INF/jsp/commons/commLayout.jsp">
        <!--상단 헤더 -->
        <put-attributename="header" value="/WEB-INF/jsp/commons/commHeader.jsp"/>
        <!--좌측 메뉴 -->
        <put-attributename="left" value="/WEB-INF/jsp/commons/commLeft.jsp"/>
        <!--동적 바디 -->
        <put-attributename="body" value=""/>
        <!-- 하단 푸터 -->
        <put-attributename="footer" value="/WEB-INF/jsp/commons/commFooter.jsp"/>
    </definitions>
 
    <!--URL호출에 따른 동적호출부 1depth, 2depth,3depth -->
    <definition name="site/*" extends="tilesbase">
        <put-attribute name="body" value="/WEB-INF/jsp/{1}.jsp" />
    </definition>
    <definition name="site/*/*" extends="tilesbase">
        <put-attribute name="body" value="/WEB-INF/jsp/{1}/{2}.jsp" />
    </definition>
    <definition name="site/*/*/*" extends="tilesbase">
        <put-attribute name="body" value="/WEB-INF/jsp/{1}/{2}/{3}.jsp" />
    </definition>
</tiles-definitions>
 cs

 

간단히 설명하자면 공통 레이아웃을 commLayout.jsp로, tilesbase라는 이름으로 정의하고

commHeader.jsp를 header , commLeft.jsp는 left , commFooter.jsp는 footer로 태그로 정의하고

하단에는 3depth url 규격에 맞춰서 호출한다는 의미이다. 

 

현재 우리 시스템은 3depth url규격으로 되어있다. localhost:8080/test/test/test.jsp 라는 형태.

그래서 site/*/*/* 로만 정의해도 문제 없으나, 일단은 혹시몰라 3depth를 모두 개별로 정의했다.

tilesbase, tiles.xml 및 site/* 등등 모든것들은 개발에 맞춰 설정하면 된다.

 

3. commLayout.jsp생성

예시로 맨 위의 이미지와 같이 첨부하는 방법을 들어줄 것이다. 기본 공통 레이아웃은 div태그별로 잘게 잘 쪼개서 commHeader.jsp, commLeft.jsp, commFooter.jsp와 같은 형태로 만들어준다. 

저 comm시리즈와 함께 우리가 업무에서 만들 것들을 조립하는 큰 판을 commLayout.jsp라고 칭한다. 이 commLayout.jsp에서 블록을 조립하듯 퍼블리셔분께서 작업해주신 div태그 class별로 조립을 하는거다.

 

노파심에 덧붙여(미래의 이 작업을 할 내게) jsp의 div class 별로 큰 구획들이 잡혀있으니 이것들을 잘게 쪼개면 된다.

큰 class 별로 쪼개서 commHeader, commLeft, commFooter 등등을 만들어 jsp로 만들어두고, commLayout 에서 tiles 에서 설정한 각각의 jsp들을 조립하는 형태다. 다음의 소스코드를 보자.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
(중략)
 
<div class="wrapper">
    <!--공통 Header -->
    <tiles:insertAttribute name="header" />
 
    <div class="root-container">
        <div class="left-wrap">
            <tiles:insertAttribute name="left" />
        </div>
        <div class="contents-wrap">
            <tiles:insertAttribute name="body" />
            <tiles:insertAttribute name="footer" />
        </div>    
    </div>
</div>
 cs

commLayout.jsp 에서 tiles태그를 사용하여 tiles.xml에서 정의한 jsp들을 include하는 형태이다.

예제 소스코드라서 간략하게 되어있지만, 실제로는 div class의 구조가 복잡하느라 퍼블리셔 작업물을 몇 번이나 확인했는지 모르겠다.

일단 여기까지 설정을 온전하게 잘 했다면 큰 고비는 넘긴것이다.

 

4. dispatcher-servlet.xml 설정

dispatcher-servlet에서는 spring mvc 구조에서 모든 클라이언트의 요청을 받아 처리하는 부분으로, 일반적으로 jsp view resolver로 설정이 되어있다.

그런데 이렇게 설정했다가는 호출하는 jsp가 먼저 먹어버리니까, 우선순위를 tiles 로 먹도록 설정해야한다. 다음의 설정을 보자. 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
(중략)
 
<!-- Tiles 설정 -->
<bean id="tilesConfigurer"
    class="org.springframework.web.servlet.view.tiles3.TilesConfigurer"
    p:checkRefresh ="true">
    <property name="definitions">
        <list>
            <value>/WEB-INF/tiles/tiles.xml</value>
        </list>
    </property>
</bean>
 
<!-- Tiles 설정 -->
<bean class="org.springframework.web.servlet.view.UrlBasedViewResolver"
    p:viewClass="org.springframework.web.servlet.view.tiles3.TilesView"
    p:order="0" />
 
<!--기존의 ViewResolver 설정 - order를 후순위(3)로 설정 -->
<bean class="org.springframework.web.servlet.view.UrlBasedViewResolver"
    p:viewClass="org.springframework.web.servlet.view.JstlView"
    p:prefix="/WEB-INF/jsp/"
    p:suffix=".jsp"
    p:order="3" />
 cs

 

dispatcher-servlet에 tiles관련 설정을 넣어준다. 동시에, 모든 view호출은 tiles 우선으로 처리하도록 (그래야 레이아웃이 먹으니) p:order를 0으로 주고, 기존의 view Resolver설정을 유지함과 동시에 후순위(나는 3순위로)로 설정한다.

이게 끝이 아니다. 우리는 Controller 에서 url을 호출하는 부분도 수정해야 한다.

 

 

5. 공통 컨트롤러 수정 

나는 위에서 site/*/*/* 형태로 설정했다. 이 말은, ModelAndView 에서 return 하는 uri에 대해 tiles definition이 가로채서 WEB-INF/jsp/{1}/{2}/{3}.jsp 에 있는 jsp를 리턴해준다는 의미이다.

기존에 설정된 viewResolver도 동일하다. 하지만 내가 설정한 것은 site/를 반환하도록 되어있으니, 공통부 ModelAndView에서도 site/ 형태로 반환해야 한다.

 

그냥 별거 없이, ModelAndView return시 "site/"를 StringBuilder 에서 append해주면 된다. 이건 개발자 구현 나름이니까.

그래서 최종 형태는 다음과 같아야 한다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
public ModelAndView commonVie(HttpServletRequestreq, HttpServletResponse resp
        , @PathVariable String oneDepth
        , @PathVariable String twoDepth
        , @PathVariable String threeDepth) throws Exception{
    
    // 중략
 
    StringBuilder pagePath = new StringBuilder();
    pagePath.append("site/")
        .append(oneDepth)
        .append("/")
        .append(twoDepth)
        .append("/")
        .append(threeDepth);
    
    // site/oneDepth/twoDepth/threeDepth 형태로 반환
    ModelAndView mav = new ModelAndView(pagePath.toString());
    
    return mav;
}
 cs

 

이렇게 해줘야 site/ 형태로 url을 리턴하고, tilesResolver가 캐치해서 tiles.xml의 구조로 리턴하게 될 것이다.

 

그런데 왜 site/형태를 쓸까?

site/ 형태의 url을 쓰지 않으면 모든 경로는 /one/two/three형태로 리턴이 될 것이고, 모든 페이지에 대해 tiles 가 적용이 될 것이다. 이 말인 즉, /login , /error와 같은 수많은 퍼블릭 페이지들도 tiles영향을 받게 된다는 점이다.

 

그래서 퍼블릭 페이지와의 구분을 위해 내부 페이지들의 구분자 역할을 하는 개념이라 보면 된다.

 

일단 여기까지, 이 설정을 내부망에서 한다고 얼마나 삽질했던지. 아휴 힘들었다. 

반응형
저작자표시 비영리 변경금지

'어장 Develop > 어장 JAVA' 카테고리의 다른 글

[Eclipse] XML 기본 에디터 설정  (0) 2024.11.13
[Eclipse] console 한글 깨짐 문제  (2) 2024.10.24
[java] Async Queue Key 활용법  (0) 2024.04.25
[Java] UTC to SimpleDateFormat  (0) 2024.04.01
[Java] PKIX path building failed 오류 및 SSL 통신 설정  (0) 2024.04.01
블로그 이미지

김생선

세상의 모든것을 어장관리

,

[QMK/VIA] 커스텀 키보드 설정

어장 컴퓨터 2024. 12. 10. 14:59
반응형

얼마전 알리익스프레스에서 yaml 기반으로 동작하는 매크로 키보드를 구매해서 사용하다가, 본격적으로 커스텀 매크로를 작성해서 사용하면 어떨까? 하는 욕심이 올라왔다. 해당 키보드의 경우에는 키 하나에 대략 5가지의 조합키를 매핑할 수 있었지만, shift 라거나 마우스 클릭과 같은 특수동작 매핑은 불가능했다. 그러다가 결국, 오래전부터 알고지낸(?) QMK/VIA 커스텀 키보드까지 알아보게 되었다.

 

87배열의 QMK/VIA 커스텀 키보드를 새로 추가해서 사용하기에는 부담스러웠고 그냥 자그만한 매크로 키보드를 구매하고자, 알리익스프레스를 뒤져보았더니 15키 + 3노브 커스텀 키보드가 존재했다. 좋아, 이번 장난감은 이거다.

 

3Knob+9Key, 1Knob+6Key, 3Knob+15Key 키보드 외에 회사에 1Knob+3Key 키보드도 있다. 대체 커스텀 키보드가 몇개인지원.

 

이번에는 RGB 뿜뿜하면서 화려하게 즐기고 싶어, 투명 아크릴 하우징으로 된 3Knob + 15Key 조합으로 구매, 말로만 듣던 VIA 부터 세팅해보려고 했으나 여러 문제에 닥치게 되었고, 이하 기본적인 QMK/VIA, VIAL 사용기를 나중에 리마인드하기 위해 작성해보고자 한다.

 

0. 개념잡기

QMK , VIA, 조금 더 깊게 들어가면 VIAL에 QMK toolbox에 QMK Configurator,  등등 오만잡다한것들이 많다. 일단 기본적인 용도와 개념을 잡고 진행하고자 한다. ( 어느정도 틀린 부분이 있어도 너그럽게 이해 부탁드립니다. )

1. QMK MSYS * Windows 기반
- 키보드 펌웨어 소스코드의 빌드, 이후 결과물은 *.hex 파일이 생성된다
- Mac 기반에서는 QMK MSYS 없이 직접 빌드할 수 있다. 이건 집에서 해봐야지

2. QMK ToolBox
- QMK MSYS에서 빌드한 hex 파일을 키보드에 업로드하여 Flash(설치) 하기 위한 툴. 키보드의 OS/SW를 설치하는 개념으로 이해하면 편하다

3. VIA / VIAL
- https://usevia.com 이라는 VIA 설정 웹 사이트가 있으며, VIAL은 https://vial.rocks 이 존재한다. VIAL 웹사이트 속도가 조금 느려 난 직접 클라이언트를 설치하여 사용중
- VIA 에서 조금 더 기능이 확장된 것으로 VIAL이 존재한다. 일단 직접적인 체감상으로는 VIAL 에서 조금 더 세부적인 설정이 가능했고, 마우스의 키 이벤트를 설정할 수 있다는 점에서 대표적으로 달랐다.
- 탭댄스나 콤보와 같은 부가 기능들도 VIAL 에서 설정이 가능했다.
- 여기서부터는 사용자가 사용하기 위한 키보드의 설정 단계로, 복잡한거 싫다면 그냥 VIA 에서 직접 설정하고 끝내는것이 제일 좋은듯

4. QMK Configurator
- https://config.qmk.fm/
- 키보드의 기본 hex 파일을 생성하는 웹사이트
- QMK MSYS에서 직접 빌드하다가 꼬여서 기본 펌웨어도 못올릴 때, 이 사이트에서 디폴트 hex 파일을 생성해서 QMK ToolBox로 Flash하면 된다
- 물론 여기서도 부가적인 키 매핑등을 이용할 수 있지만, QMK 보다는 VIA가 기능이 더 많고, VIA 보다는 VIAL이 기능이 더 많다

5. KBFirmware
- https://kbfirmware.com/
- 직접 키보드 펌웨어를 만들 수 있는 사이트
- 아직은 내공이 딸려 이정도밖에 모르겠다.

 

1. QMK MSYS 설치부터 설정까지

뭐가 되어도 일단 설치부터 해야한다. 다음의 사이트에서 클라이언트를 다운로드한다.

- 설치가이드 : https://msys.qmk.fm/guide

 

Getting Started | QMK MSYS

 

msys.qmk.fm

- 설치사이트 : https://github.com/qmk/qmk_distro_msys/releases/tag/1.10.0

 

Release 1.10.0 · qmk/qmk_distro_msys

Minor dependency updates

github.com

 

QMK MSYS를 설치하고 실행하면 터미널 창이 하나 열린다. 여기에서 다음과 같이 명령어를 입력한다.

[KimFish@KimFishs-ThinkPad13 ~]$ qmk setup

해당 명령어는 기본적인 qmk 설치를 위한 준비단계로, 꽤 오랜 시간동안 설정이 진행된다.

 

setup 단계는 대략 다음과 같이 진행된다.

Welcome to QMK MSYS!
  * Documentation:    https://docs.qmk.fm
  * Support:          https://discord.gg/qmk

If you have not already done so,
  run qmk setup to get started.
  run qmk compile -kb <keyboard> -km default to start building.
  run qmk config user.hide_welcome=True to hide this message.
[KimFish@KimFishs-ThinkPad13 ~]$ qmk setup
☒ Could not find qmk_firmware!
Would you like to clone qmk/qmk_firmware to C:/Users/KimFish/qmk_firmware? [y/n] y
'/c/Users/KimFish/qmk_firmware'에 복제합니다...
Updating files:   0% (145/21779)
Updating files:   1% (218/21779)
Updating files:   1% (258/21779)
Updating files:   1% (340/21779)

(중략)
                                                                                                          
Updating files:  99% (21728/21779)                                                                                                               
Updating files: 100% (21779/21779)                                                                                                               
Updating files: 100% (21779/21779), 완료.                                                                                                          
'lib/chibios' 경로에 대해 'lib/chibios' (https://github.com/qmk/ChibiOS) 하위 모듈 등록
'lib/chibios-contrib' 경로에 대해 'lib/chibios-contrib' (https://github.com/qmk/ChibiOS-Contrib) 하위 모듈 등록
'lib/googletest' 경로에 대해 'lib/googletest' (https://github.com/qmk/googletest) 하위 모듈 등록
'lib/lufa' 경로에 대해 'lib/lufa' (https://github.com/qmk/lufa) 하위 모듈 등록
'lib/lvgl' 경로에 대해 'lib/lvgl' (https://github.com/qmk/lvgl.git) 하위 모듈 등록
'lib/pico-sdk' 경로에 대해 'lib/pico-sdk' (https://github.com/qmk/pico-sdk.git) 하위 모듈 등록
'lib/printf' 경로에 대해 'lib/printf' (https://github.com/qmk/printf) 하위 모듈 등록
'lib/vusb' 경로에 대해 'lib/vusb' (https://github.com/qmk/v-usb) 하위 모듈 등록
'/c/Users/KimFish/qmk_firmware/lib/chibios'에 복제합니다...
'/c/Users/KimFish/qmk_firmware/lib/chibios-contrib'에 복제합니다...
'/c/Users/KimFish/qmk_firmware/lib/googletest'에 복제합니다...
'/c/Users/KimFish/qmk_firmware/lib/lufa'에 복제합니다...
'/c/Users/KimFish/qmk_firmware/lib/lvgl'에 복제합니다...
'/c/Users/KimFish/qmk_firmware/lib/pico-sdk'에 복제합니다...
'/c/Users/KimFish/qmk_firmware/lib/printf'에 복제합니다...                                                                                             
'/c/Users/KimFish/qmk_firmware/lib/vusb'에 복제합니다...                                                                                               
Submodule path 'lib/chibios': checked out 'be44b3305f9a9fe5f2f49a4e7b978db322dc463e'
Submodule path 'lib/chibios-contrib': checked out '77cb0a4f7589f89e724f5e6ecb1d76d514dd1212'
'lib/chibios-contrib/ext/mcux-sdk' 경로에 대해 'ext/mcux-sdk' (https://github.com/NXPmicro/mcux-sdk) 하위 모듈 등록
'/c/Users/KimFish/qmk_firmware/lib/chibios-contrib/ext/mcux-sdk'에 복제합니다...
Submodule path 'lib/chibios-contrib/ext/mcux-sdk': checked out '102c27d7cc2aaac87c133702e7829a105e0cb433'
Submodule path 'lib/googletest': checked out 'e2239ee6043f73722e7aa812a459f54a28552929'
Submodule path 'lib/lufa': checked out '549b97320d515bfca2f95c145a67bd13be968faa'
Submodule path 'lib/lvgl': checked out 'e19410f8f8a256609da72cff549598e0df6fa4cf'                                                                
Submodule path 'lib/pico-sdk': checked out 'a3398d8d3a772f37fef44a74743a1de69770e9c2'
Submodule path 'lib/printf': checked out 'c2e3b4e10d281e7f0f694d3ecbd9f320977288cc'
Submodule path 'lib/vusb': checked out '819dbc1e5d5926b17e27e00ca6d3d2988adae04e'
Ψ Successfully cloned https://github.com/qmk/qmk_firmware to C:/Users/KimFish/qmk_firmware!
Ψ Added https://github.com/qmk/qmk_firmware as remote upstream.                                                                                  
Ψ QMK Doctor is checking your environment.                                                                                                       
Ψ CLI version: 1.1.6                                                                                                                             
Ψ QMK home: C:/Users/KimFish/qmk_firmware                                                                                                        
Ψ Detected Windows 11 (10.0.26100).                                                                                                              
Ψ QMK MSYS version: 1.10.0                                                                                                                       
Ψ Userspace enabled: False                                                                                                                       
Ψ Git branch: master                                                                                                                             
Ψ Repo version: 0.27.1                                                                                                                           
Ψ - Latest master: 2024-12-09 07:34:07 +0100 (847257c3c7) -- Addition of EC TKL X (#24647)
Ψ - Latest upstream/master: 2024-12-09 07:34:07 +0100 (847257c3c7) -- Addition of EC TKL X (#24647)
Ψ - Latest upstream/develop: None                                                                                                                
Ψ - Common ancestor with upstream/master: 2024-12-09 07:34:07 +0100 (847257c3c7) -- Addition of EC TKL X (#24647)
Ψ - Common ancestor with upstream/develop: None                                                                                                  
Ψ All dependencies are installed.                                                                                                                
Ψ Found arm-none-eabi-gcc version 13.3.0                                                                                                         
Ψ Successfully compiled using arm-none-eabi-gcc                                                                                                  
Ψ Successfully tested arm-none-eabi-binutils using arm-none-eabi-size                                                                            
Ψ Found avr-gcc version 14.2.0                                                                                                                   
Ψ Successfully compiled using avr-gcc                                                                                                            
Ψ Successfully tested avr-binutils using avr-size                                                                                                
Ψ Found avrdude version 7.3-2024041                                                                                                              
Ψ Found dfu-programmer version 1.1.0                                                                                                             
Ψ Found dfu-util version 0.11                                                                                                                    
Ψ Submodules are up to date.                                                                                                                     
Ψ Submodule status:                                                                                                                              
Ψ - lib/chibios: 2024-02-17 19:20:06 +0000 --  (be44b3305f)                                                                                      
Ψ - lib/chibios-contrib: 2024-04-03 20:39:24 +0800 --  (77cb0a4f)                                                                                
Ψ - lib/googletest: 2021-06-11 06:37:43 -0700 --  (e2239ee6)                                                                                     
Ψ - lib/lufa: 2022-08-26 12:09:55 +1000 --  (549b97320)                                                                                          
Ψ - lib/vusb: 2022-06-13 09:18:17 +1000 --  (819dbc1)                                                                                            
Ψ - lib/printf: 2022-06-29 23:59:58 +0300 --  (c2e3b4e)                                                                                          
Ψ - lib/pico-sdk: 2023-02-12 20:19:37 +0100 --  (a3398d8)                                                                                        
Ψ - lib/lvgl: 2022-04-11 04:44:53 -0600 --  (e19410f8)                                                                                           
Ψ QMK is ready to go                                                                                                                             
[KimFish@KimFishs-ThinkPad13 ~]$

 

2. QMK MSYS - Git Clone

QMK MSYS 의 설정이 모두 끝났다면 Git에 등록된 키보드 오픈소스 펌웨어를 로컬 리포지토리에 복제해야한다. git 사이트에서 zip으로 압축받는 것은 하위 상관관계의 라이브러리 종속성 문제가 있을 수 있으니 꼭 다음 명령어를 통해 git clone을 수행해야 한다. 다운로드 받고자 하는 경로로 가서 아래의 명령어를 수행한다.

git clone --recursive https://github.com/vial-kb/vial-qmk.git

 

다음 QMK MSYS 터미널에서는 다음과 같이 수행된다.

[KimFish@KimFishs-ThinkPad13 ~]$ git clone --recursive https://github.com/vial-kb/vial-qmk.git 
'vial-qmk'에 복제합니다...                                                                                                            
remote: Enumerating objects: 557188, done.                                                                                      
remote: Counting objects: 100% (8/8), done.                                                                                     
remote: Compressing objects: 100% (8/8), done.                                                                                  
remote: Total 557188 (delta 0), reused 2 (delta 0), pack-reused 557180 (from 1)                                                 
오브젝트를 받는 중: 100% (557188/557188), 231.12 MiB | 21.44 MiB/s, 완료.                                                                 
델타를 알아내는 중: 100% (343726/343726), 완료.                                                                                           
Updating files: 100% (24242/24242), 완료.                                                                                         
'lib/chibios' 경로에 대해 'lib/chibios' (https://github.com/qmk/ChibiOS) 하위 모듈 등록                                                    
'lib/chibios-contrib' 경로에 대해 'lib/chibios-contrib' (https://github.com/qmk/ChibiOS-Contrib) 하위 모듈 등록                            
'lib/googletest' 경로에 대해 'lib/googletest' (https://github.com/qmk/googletest) 하위 모듈 등록                                           
'lib/lufa' 경로에 대해 'lib/lufa' (https://github.com/qmk/lufa) 하위 모듈 등록                                                             
'lib/lvgl' 경로에 대해 'lib/lvgl' (https://github.com/qmk/lvgl.git) 하위 모듈 등록                                                         
'lib/pico-sdk' 경로에 대해 'lib/pico-sdk' (https://github.com/qmk/pico-sdk.git) 하위 모듈 등록                                             
'lib/printf' 경로에 대해 'lib/printf' (https://github.com/qmk/printf) 하위 모듈 등록                                                       
'lib/vusb' 경로에 대해 'lib/vusb' (https://github.com/qmk/v-usb) 하위 모듈 등록                                                            
'/c/Users/KimFish/vial-qmk/lib/chibios'에 복제합니다...                                                                               
remote: Enumerating objects: 264269, done.                                                                                      
remote: Counting objects: 100% (23013/23013), done.                                                                             
remote: Compressing objects: 100% (5887/5887), done.                                                                            
remote: Total 264269 (delta 16584), reused 22905 (delta 16534), pack-reused 241256 (from 1)                                     
오브젝트를 받는 중: 100% (264269/264269), 178.51 MiB | 20.86 MiB/s, 완료.                                                                 
델타를 알아내는 중: 100% (200627/200627), 완료.                                                                                           
'/c/Users/KimFish/vial-qmk/lib/chibios-contrib'에 복제합니다...                                                                       
remote: Enumerating objects: 26224, done.                                                                                       
remote: Counting objects: 100% (26213/26213), done.                                                                             
remote: Compressing objects: 100% (8428/8428), done.                                                                            
remote: Total 26224 (delta 16906), reused 25613 (delta 16583), pack-reused 11 (from 1)                                          
오브젝트를 받는 중: 100% (26224/26224), 10.75 MiB | 21.79 MiB/s, 완료.                                                                    
델타를 알아내는 중: 100% (16906/16906), 완료.                                                                                             
'/c/Users/KimFish/vial-qmk/lib/googletest'에 복제합니다...                                                                            
remote: Enumerating objects: 22998, done.                                                                                       
remote: Total 22998 (delta 0), reused 0 (delta 0), pack-reused 22998 (from 1)                                                   
오브젝트를 받는 중: 100% (22998/22998), 8.84 MiB | 18.18 MiB/s, 완료.                                                                     
델타를 알아내는 중: 100% (17080/17080), 완료.                                                                                             
'/c/Users/KimFish/vial-qmk/lib/lufa'에 복제합니다...                                                                                  
remote: Enumerating objects: 76748, done.                                                                                       
remote: Counting objects: 100% (3098/3098), done.                                                                               
remote: Compressing objects: 100% (78/78), done.                                                                                
remote: Total 76748 (delta 3049), reused 3027 (delta 3020), pack-reused 73650 (from 1)                                          
오브젝트를 받는 중: 100% (76748/76748), 18.93 MiB | 19.78 MiB/s, 완료.                                                                    
델타를 알아내는 중: 100% (61670/61670), 완료.                                                                                             
'/c/Users/KimFish/vial-qmk/lib/lvgl'에 복제합니다...                                                                                  
remote: Enumerating objects: 62969, done.                                                                                       
remote: Counting objects: 100% (2036/2036), done.                                                                               
remote: Compressing objects: 100% (196/196), done.                                                                              
remote: Total 62969 (delta 1862), reused 1840 (delta 1840), pack-reused 60933 (from 1)                                          
오브젝트를 받는 중: 100% (62969/62969), 92.04 MiB | 20.88 MiB/s, 완료.                                                                    
델타를 알아내는 중: 100% (49384/49384), 완료.                                                                                             
'/c/Users/KimFish/vial-qmk/lib/pico-sdk'에 복제합니다...                                                                              
remote: Enumerating objects: 6628, done.                                                                                        
remote: Total 6628 (delta 0), reused 0 (delta 0), pack-reused 6628 (from 1)                                                     
오브젝트를 받는 중: 100% (6628/6628), 2.45 MiB | 19.88 MiB/s, 완료.                                                                       
델타를 알아내는 중: 100% (3529/3529), 완료.                                                                                               
'/c/Users/KimFish/vial-qmk/lib/printf'에 복제합니다...                                                                                
remote: Enumerating objects: 1578, done.                                                                                        
remote: Counting objects: 100% (627/627), done.                                                                                 
remote: Compressing objects: 100% (100/100), done.                                                                              
remote: Total 1578 (delta 567), reused 539 (delta 522), pack-reused 951 (from 1)                                                
오브젝트를 받는 중: 100% (1578/1578), 797.96 KiB | 14.00 MiB/s, 완료.                                                                     
델타를 알아내는 중: 100% (978/978), 완료.                                                                                                 
'/c/Users/KimFish/vial-qmk/lib/vusb'에 복제합니다...                                                                                  
remote: Enumerating objects: 1372, done.                                                                                        
remote: Counting objects: 100% (73/73), done.                                                                                   
remote: Compressing objects: 100% (50/50), done.                                                                                
remote: Total 1372 (delta 32), reused 46 (delta 18), pack-reused 1299 (from 1)                                                  
오브젝트를 받는 중: 100% (1372/1372), 476.46 KiB | 9.93 MiB/s, 완료.                                                                      
델타를 알아내는 중: 100% (832/832), 완료.                                                                                                 
Submodule path 'lib/chibios': checked out 'be44b3305f9a9fe5f2f49a4e7b978db322dc463e'                                            
Submodule path 'lib/chibios-contrib': checked out '77cb0a4f7589f89e724f5e6ecb1d76d514dd1212'                                    
'lib/chibios-contrib/ext/mcux-sdk' 경로에 대해 'ext/mcux-sdk' (https://github.com/NXPmicro/mcux-sdk) 하위 모듈 등록
'/c/Users/KimFish/vial-qmk/lib/chibios-contrib/ext/mcux-sdk'에 복제합니다...                                                          
remote: Enumerating objects: 80982, done.                                                                                       
remote: Counting objects: 100% (18997/18997), done.                                                                             
remote: Compressing objects: 100% (5244/5244), done.                                                                            
remote: Total 80982 (delta 14060), reused 17970 (delta 13620), pack-reused 61985 (from 1)                                       
오브젝트를 받는 중: 100% (80982/80982), 229.18 MiB | 19.09 MiB/s, 완료.                                                                   
델타를 알아내는 중: 100% (55271/55271), 완료.                                                                                             
Submodule path 'lib/chibios-contrib/ext/mcux-sdk': checked out '102c27d7cc2aaac87c133702e7829a105e0cb433'
Submodule path 'lib/googletest': checked out 'e2239ee6043f73722e7aa812a459f54a28552929'                                         
Submodule path 'lib/lufa': checked out '549b97320d515bfca2f95c145a67bd13be968faa'                                               
Submodule path 'lib/lvgl': checked out 'e19410f8f8a256609da72cff549598e0df6fa4cf'                                               
Submodule path 'lib/pico-sdk': checked out 'a3398d8d3a772f37fef44a74743a1de69770e9c2'                                           
Submodule path 'lib/printf': checked out 'c2e3b4e10d281e7f0f694d3ecbd9f320977288cc'                                             
Submodule path 'lib/vusb': checked out '819dbc1e5d5926b17e27e00ca6d3d2988adae04e'                                               
[KimFish@KimFishs-ThinkPad13 ~]$ pwd                                                                                            
/c/Users/KimFish

 

여기까지 했다면 QMK MSYS의 기본 설정과 QMK/VIA 키보드의 펌웨어 준비단계까지 모두 완료된 셈이다.

3. VIA/VIAL 펌웨어 빌드

준비단계가 모두 끝났다면 QMK MSYS에서 펌웨어를 빌드한다. 내가 작업할 키보드는 winry315 키보드로, git 저장소 내에 다음과 같이 펌웨어 소스코드가 존재한다. 다른 키보드도 git에 소스코드가 있다면 같은 방식으로 펌웨어를 찾을 수 있을 것이다.

git clone 경로는 위에서 pwd로 보여지는 경로의 하위에 생성되며, 나의 경우에는 C:\Users\KimFish 에서 git Clone을 수행했기 때문에 해당 경로 하위에 vial-qmk 디렉토리가 생성되어있다. vial-qmk 하위에 keyboards/winry/winry315/keymaps 디렉토리를 찾으면 defaults, left_numpad, vial 디렉토리가 존재하는데 이는 기본 키맵 펌웨어, 왼손 넘버패드 펌웨어, vial 전용 펌웨어로 이해할 수 있다.

 

각 펌웨어의 설정은 다음 단계에서 알아보기로 하고, 이번에는 VIAL 빌드를 수행한다.

컴파일 명령어는 다음과 같다. 주의할 점은 vial-qmk 디렉토리에서 수행해야 한다는 점이다.

 

qmk compile -j 8 -kb winry/winry315 -km vial

[KimFish@KimFishs-ThinkPad13 vial-qmk]$ qmk compile -j 8 -kb winry/winry315 -km vial
C:/Users/KimFish/vial-qmk/lib/python/qmk/decorators.py:20: UserWarning: cli._subcommand has been deprecated, please use cli.subcommand_name to get the subcommand name instead.
  if cli.config_source[cli._subcommand.__name__]['keyboard'] != 'argument':
C:/Users/KimFish/vial-qmk/lib/python/qmk/decorators.py:40: UserWarning: cli._subcommand has been deprecated, please use cli.subcommand_name to get the subcommand name instead.
  if cli.config_source[cli._subcommand.__name__]['keymap'] != 'argument':
Ψ Compiling keymap with make --jobs=8 --output-sync=target -r -R -f builddefs/build_keyboard.mk -s KEYBOARD=winry/winry315 KEYMAP=vial KEYBOARD_ FILESAFE=winry_winry315 TARGET=winry_winry315_vial VERBOSE=false COLOR=true SILENT=false QMK_BIN="qmk"


avr-gcc.exe (GCC) 14.2.0
Copyright (C) 2024 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Size before:
   text    data     bss     dec     hex filename
      0   27306       0   27306    6aaa winry_winry315_vial.hex

Compiling: quantum/bitwise.c                                                                        [OK]
Compiling: keyboards/winry/winry315/winry315.c                                                      [OK]
Compiling: .build/obj_winry_winry315_vial/src/default_keyboard.c                                    [OK]
Compiling: quantum/keymap_introspection.c                                                           [OK]
Compiling: quantum/quantum.c                                                                        [OK]
Compiling: quantum/led.c                                                                            [OK]
Compiling: quantum/action.c                                                                         [OK]
Compiling: quantum/action_layer.c                                                                   [OK]
Compiling: quantum/action_tapping.c                                                                 [OK]

(중략) 

Compiling: lib/lufa/LUFA/Drivers/USB/Core/AVR8/Endpoint_AVR8.c                                      [OK]
Compiling: lib/lufa/LUFA/Drivers/USB/Core/AVR8/Host_AVR8.c                                          [OK]
Compiling: lib/lufa/LUFA/Drivers/USB/Core/AVR8/PipeStream_AVR8.c                                    [OK]
Compiling: lib/lufa/LUFA/Drivers/USB/Core/AVR8/Pipe_AVR8.c                                          [OK]
Compiling: lib/lufa/LUFA/Drivers/USB/Core/AVR8/USBController_AVR8.c                                 [OK]
Compiling: lib/lufa/LUFA/Drivers/USB/Core/AVR8/USBInterrupt_AVR8.c                                  [OK]
Compiling: lib/lufa/LUFA/Drivers/USB/Core/ConfigDescriptors.c                                       [OK]
Compiling: lib/lufa/LUFA/Drivers/USB/Core/DeviceStandardReq.c                                       [OK]
Compiling: lib/lufa/LUFA/Drivers/USB/Core/Events.c                                                  [OK]
Compiling: lib/lufa/LUFA/Drivers/USB/Core/HostStandardReq.c                                         [OK]
Compiling: lib/lufa/LUFA/Drivers/USB/Core/USBTask.c                                                 [OK]
Compiling: tmk_core/protocol/lufa/usb_util.c                                                        [OK]
Linking: .build/winry_winry315_vial.elf                                                             [OK]
Creating load file for flashing: .build/winry_winry315_vial.hex                                     [OK]
Copying winry_winry315_vial.hex to qmk_firmware folder                                              [OK]
Checking file size of winry_winry315_vial.hex                                                       [OK]
 * The firmware size is fine - 27306/28672 (95%, 1366 bytes free)

 

정상적으로 빌드되었다면 해당 펌웨어의 용량과 hex 파일이 출력된다. 설정파일에서 기능을 많이 넣게 된다면 빌드는 실패하게 된다. 맨 마지막줄의 굵은 글씨가 해당 펌웨어 hex 파일과 펌웨어 용량정보이다. 이걸 이제, QMK Toolbox로 플래싱하게 된다.

 

4. QMK Toolbox 플래싱

QMK MSYS 는 키보드 펌웨어를 빌드한다면 QMK Toolbox는 해당 빌드 결과물인 펌웨어를 키보드에 업로드하는 작업을 수행한다. 크게 어렵지 않다.

https://qmk.fm/toolbox

 

QMK Firmware

QMK Toolbox A collection of flashing tools for QMK keyboards

qmk.fm

해당 사이트에서 OS 버전에 맞춰 다운로드 한 후, 키보드 연결하여 실행한다.

 

 

아무런 화면도 출력되지 않지만, 키보드의 reset 버튼(일반적으로 키보드 기판에 작게 붙어있음)을 눌러주면 화면에 다음과 같이 출력된다. 

Atmel DFU device connected (WinUSB): Atmel Corp. ATm32U4DFU (03EB:2FF4:0000)

이 메세지는 키보드에 펌웨어 업로드가 준비되었다는 의미이다. 

 

이제 Local file 의 Open 버튼을 클릭하여 3 단계에서 수행한 결과물인 hex 파일을 선택한다. hex 파일은 vial-qmk 디렉토리에 존재한다. MCU는 노란 글씨에서 보여지는 것을 선택한다. 나의 경우에는 ATm32U4DFU 이다.

그리고 Flash 버튼을 클릭한다.

Atmel DFU device connected (WinUSB): Atmel Corp. ATm32U4DFU (03EB:2FF4:0000)

Attempting to flash, please don't remove device
> dfu-programmer.exe atmega32u4 erase --force
> Erasing flash...  Success
> Checking memory from 0x0 to 0x6FFF...  Empty.
> dfu-programmer.exe atmega32u4 flash --force "C:\Users\KimFish\vial-qmk\winry_winry315_vial.hex"
> Programming 0x6B00 bytes...
> Success
> Reading 0x7000 bytes...
> Success
> Validating...  Success
> 0x6B00 bytes written into 0x7000 bytes memory (95.54%).
> dfu-programmer.exe atmega32u4 reset
Flash complete
Atmel DFU device disconnected (WinUSB): Atmel Corp. ATm32U4DFU (03EB:2FF4:0000)

 

정상적으로 Flash가 된 모습이다. 이제부터는 VIA/VIAL 에서 접속해서 사용이 가능하다.

 

5. VIA / VIAL

VIA 및 VIAL 모두 웹사이트 설정, 클라이언트 설정이 가능하다.

각각의 정보는 다음과 같다.

 

* VIA WEB - https://usevia.app/

 

VIA

Your keyboard's best friend

usevia.app

 

*VIA Client - https://github.com/the-via/releases/releases

 

Releases · the-via/releases

Contribute to the-via/releases development by creating an account on GitHub.

github.com

 

* VIAL WEB - https://vial.rocks/

 

Vial Web

You can check web browser support at caniuse.com. Latest versions of Chrome, Chromium or Edge are recommended to use Vial Web. You can also download the standalone Vial application from get.vial.today.

vial.rocks

* VIAL Client - https://get.vial.today/download/

 

Download

Vial is an open-source cross-platform (Windows, Linux and Mac) GUI and a QMK fork for configuring your keyboard in real time.

get.vial.today

 

 

이후 세부적인 설정정보들은 다음에 더 쓰는 걸로. 

반응형
저작자표시 비영리 변경금지

'어장 컴퓨터' 카테고리의 다른 글

게임이야기 #12 - XBOX, 그리고 헤일로 (2)  (1) 2023.10.31
게임이야기 #11 - XBOX, 그리고 헤일로 (1)  (0) 2023.10.25
게임이야기 #10 - PC 온라인 게임 2  (0) 2023.10.20
게임이야기 #9 - 마비노기 (2004~2011)  (0) 2023.10.19
아파트 네트워크 구성 (AP)  (0) 2018.05.01
블로그 이미지

김생선

세상의 모든것을 어장관리

,

[Eclipse] XML 기본 에디터 설정

어장 Develop/어장 JAVA 2024. 11. 13. 14:52
반응형

회사에서 자체적으로 제작한 Spring 기반의 프레임워크/튜닝 Eclipse로 개발을 할 일이 생겼는데, 쿼리 작성하는 xml이 뭔가 좀... 다르다? 

대충 내가 지금까지 써온 xml 형태랑 다르다. 

 

쓰다보니 가장 큰 문제가 바로 Ctrl-z / Ctrl-y를 이용한 되돌리기 기능이 안먹힌다는 것인데, 이러다보니 뭐 하나 잘못 지워버리면 되돌리기가 안되서 -_-;; 아주 난감했다. 어떻게 이 상태로 한 달을 개발했는지 모르겠는데.

 

아무튼 구글링을 대충 Eclipse xml 되돌리기 로 검색해보니 원인을 찾을 수 있었다.

원인은 '기본 xml 열기 속성이 XML (Spring XML Config File)로 설정' 되어 있었던 것. 이것을 XML Editor로 변경해주니 아주 잘 동작한다.

 

그래 이렇게 등록되어야 tag 자동완성도 되고 좋지. ㅋㅋㅋ

 

설정 방법은 다음과 같다. 

 

Windows -> Preferences -> General -> Editors -> File Associations -> *.xml -> XML Editor 선택 후, Default 클릭.

이렇게 설정하면 XML 에디터로 열려 태그 자동완성부터 시작해서 안먹히던 되돌리기/복구하기도 잘 되고. 코드하이라이터(?)도 잘 보이고 아무튼 좋다. ㅋㅋㅋ 아 진짜 별놈의 설정이 다 있었네. ㅋㅋㅋㅋ 

반응형
저작자표시 비영리 변경금지

'어장 Develop > 어장 JAVA' 카테고리의 다른 글

[tiles] JSP tiles 설정하기  (0) 2025.04.01
[Eclipse] console 한글 깨짐 문제  (2) 2024.10.24
[java] Async Queue Key 활용법  (0) 2024.04.25
[Java] UTC to SimpleDateFormat  (0) 2024.04.01
[Java] PKIX path building failed 오류 및 SSL 통신 설정  (0) 2024.04.01
블로그 이미지

김생선

세상의 모든것을 어장관리

,

[Eclipse] console 한글 깨짐 문제

어장 Develop/어장 JAVA 2024. 10. 24. 14:46
반응형

갑자기 몇년만에 웹 개발을 지원요청받아서 투입되었다. 거기에 생전 처음보는 울 회사 자체 프레임워크로 커스터마이징된 SpringBoot 기반 프레임워크;; 아 이건 또 뭐야. 대체.

 

아무튼 개발 잘 하고 있는데 엑셀 파싱하고 sysout 으로 출력하는데 한글 인코딩이 깨져서 보인다. 다른 한글들은 잘 출력되는걸 봐서 뭔가 문제가 있는것 같은데, 일단 급한대로 한글이 잘 나오는데만 초점을 두고 GPT 에게 물어보았다.

 

DATA ROW : 1 : �� ,,,,,, : [Lv, ����ID, ��������, ��ȹ, ����, ����, �����, ����, ��ȹ������, ��ȹ������, ����������, ����������, ���⹰, ���, �޼���]
DATA ROW : 2 : �� ,,,,,, : [4, PJ_001_IFT_001_002_001, �����û, 92.86%, 90.91%, ������, , , 2024-10-01, 2024-10-15, 2024-10-04, , , ������?����, ]

이렇게 보이는 상황 -_-;

디버깅 모드로 찍어보니 오브젝트 내의 데이터들은 모두 한글로 잘 가져온 상황. 그러니까 파싱문제는 아니다, 이마리야.

 

일단은 Run Configuration의 VM Argument를 -Dfile.encoding=UTF-8 로 준다거나 하는 설정은 싹 다 줘봤고, windows - preference 의 text encoding 같은것도 UTF-8로 줬는데 문제가 해결되지는 않았다.

다른방법을 더 강구하니 이거 함 써보라고 던져준다.

 

1
2
3
4
5
try {
    System.setOut(new PrintStream(System.out, true, "UTF-8"));
} catch (UnsupportedEncodingException e) {
        e.printStackTrace();
}
 cs

 

일단 이렇게 하니까 잘 나온다. 원인 분석까지는 시간이 조금 걸릴듯. 이런건 또 생전 첨보네 ㅡㅡ;; 

반응형
저작자표시 비영리 변경금지

'어장 Develop > 어장 JAVA' 카테고리의 다른 글

[tiles] JSP tiles 설정하기  (0) 2025.04.01
[Eclipse] XML 기본 에디터 설정  (0) 2024.11.13
[java] Async Queue Key 활용법  (0) 2024.04.25
[Java] UTC to SimpleDateFormat  (0) 2024.04.01
[Java] PKIX path building failed 오류 및 SSL 통신 설정  (0) 2024.04.01
블로그 이미지

김생선

세상의 모든것을 어장관리

,

[알리익스프레스] 매크로 키보드 사용자 설정

어장 제품리뷰/중국산 어장 2024. 10. 22. 09:00
반응형

알리에서 업무용으로 매크로 키보드를 구매했다.

구매하고나서는 셀러에게 연락해서 별도 키보드 매핑 프로그램을 전송해달라고 요청해야하는데, 이게 뭐 악성코드가 있을 줄 알고 조마조마한게 한두번이 아닌데다, 프로그램에 따라 다른데 해당 매크로 키보드의 USB 전원을 뽑기라도 하면 그냥바로 초기화가 된다거나 하는 문제가 발생하는게 한두번이 아니다.

 

내가 구매한 키보드는 다음과 같은 3Key 1Knob 제품이다.

 

 

그래서 구글을 뒤져보니 해외 능력자 형님께서 깃헙에 프로그램과 대략적인 사용설명서를 올려두셨다. 깃헙 바로 가보자.

https://github.com/kriomant/ch57x-keyboard-tool/releases

 

Releases · kriomant/ch57x-keyboard-tool

Utility for programming ch57x small keyboard. Contribute to kriomant/ch57x-keyboard-tool development by creating an account on GitHub.

github.com

 

그리고 이를 실행하기 위해서는 USB 키보드 개발킷의 일종인 USBDK를 설치해야한다.

아래의 링크에서 설치가 가능하다.

https://github.com/daynix/UsbDk/releases

 

Releases · daynix/UsbDk

Usb Drivers Development Kit for Windows. Contribute to daynix/UsbDk development by creating an account on GitHub.

github.com

 

USBDK를 설치하였다면, ch57 release 에서 OS 버전에 맞게 압축파일을 다운로드 한다. 나는 Windows OS 이기 때문에 ch57x-keyboard-tool-x86_64-pc-windows-msvc.zip 를 다운로드 했다.

 

기본적인 설명은 메인 페이지에 다 들어 있어서 어렵지는 않고, 파워쉘을 이용해 yaml 파일을 업로드하는 방식으로 매핑이 진행된다.

 

간단하게 내가 사용하는 위 키보드 기준으로, 설정은 다음과 같다.

orientation: normal

rows: 1
columns: 3
knobs: 1

layers:
  - buttons:
      # Multimedia commands are also supported. They cannot be mixed with
      # normal keys and modifiers.
      # 이클립스 새파일 / 이클립스 git commit / 스프링부트런
      - ["ctrl-n", "ctrl-shift-3" , "alt-shift-x,b"]
    knobs:
      - ccw: 'shift-wheelup'
        press: 'alt-shift-x,m'
        cw: 'shift-wheeldown'

# LED 끄기
#ch57x-keyboard-tool led 0
# LED 누른 키만 켜기
#ch57x-keyboard-tool led 1
# LED 순차켜짐
#ch57x-keyboard-tool led 2

# shift-wheelup - 왼쪽 가로스크롤
# shift-wheeldown - 오른쪽 가로스크롤

 

파워쉘에서의 대략적인 명령어는 다음과 같다.

 

./ch57x-keyboard-tool show-keys - 지원되는 키 리스트 확인

./ch57x-keyboard-tool validate your-config.yaml - yaml 설정파일 검증

./ch57x-keyboard-tool upload your-config.yaml - yaml 설정파일 업로드

 

일단은 내가 쓰는 키보드는 잘 동작한다. 아, 이거 도네라도 해야하나. 아무튼 참 감사한 일. 

 

 

반응형
저작자표시 비영리 변경금지

'어장 제품리뷰 > 중국산 어장' 카테고리의 다른 글

[알리발 지름] 코스프레 의상  (0) 2019.03.18
[알리발 지름] 피규어 셋  (0) 2018.12.28
[알리발 지름] 이것저것 덕질용품들  (0) 2018.12.22
[알리발 지름] 게임 및 덕질 뱃지  (0) 2018.12.10
[알리발 지름] 자장구 의류 - 져지와 바람막이  (0) 2018.12.09
블로그 이미지

김생선

세상의 모든것을 어장관리

,

[CentOS7] Could not retrieve mirrorlist ~

어장 Develop/어장 Linux 2024. 8. 26. 11:04
반응형

CentOS 7 설치 후 yum update -y 하는데 오류가 발생했다.

[root@0370a17ebb47 /]# yum update -y
Loaded plugins: fastestmirror, ovl
Loading mirror speeds from cached hostfile
Could not retrieve mirrorlist http://mirrorlist.centos.org/?release=7&arch=x86_64&repo=extras&infra=container error was
14: curl#6 - "Could not resolve host: mirrorlist.centos.org; Unknown error"


 One of the configured repositories failed (Unknown),
 and yum doesn't have enough cached data to continue. At this point the only
 safe thing yum can do is fail. There are a few ways to work "fix" this:

     1. Contact the upstream for the repository and get them to fix the problem.

     2. Reconfigure the baseurl/etc. for the repository, to point to a working
        upstream. This is most often useful if you are using a newer
        distribution release than is supported by the repository (and the
        packages for the previous distribution release still work).

     3. Run the command with the repository temporarily disabled
            yum --disablerepo=<repoid> ...

     4. Disable the repository permanently, so yum won't use it by default. Yum
        will then just ignore the repository until you permanently enable it
        again or use --enablerepo for temporary usage:

            yum-config-manager --disable <repoid>
        or
            subscription-manager repos --disable=<repoid>

     5. Configure the failing repository to be skipped, if it is unavailable.
        Note that yum will try to contact the repo. when it runs most commands,
        so will have to try and fail each time (and thus. yum will be be much
        slower). If it is a very temporary problem though, this is often a nice
        compromise:

            yum-config-manager --save --setopt=<repoid>.skip_if_unavailable=true

Cannot find a valid baseurl for repo: extras/7/x86_64

 

아 이게 뭔가 하고 찾아보니 CentOS7 지원중단에 따른 미러사이트 오류로 확인되었고, 아래와 같은 수정을 통해 yum update를 수행했다. #ori 항목은 기존의 설정으로 주석처리하고, #new 항목을 신규로 작성하면 된다.

[root@0370a17ebb47 /]# vi /etc/yum.repos.d/CentOS-Base.repo

[base]
name=CentOS-$releasever - Base
# ori
#mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=os&infra=$infra
#baseurl=http://mirror.centos.org/centos/$releasever/os/$basearch/
# new
baseurl=http://centos.mirror.cdnetworks.com/7/os/x86_64
gpgcheck=1
enabled=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7

#released updates
[updates]
name=CentOS-$releasever - Updates
# ori
#mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=updates&infra=$infra
#baseurl=http://mirror.centos.org/centos/$releasever/updates/$basearch/
#gpgcheck=1
#gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7
# new
baseurl=http://centos.mirror.cdnetworks.com/7/updates/x86_64
gpgcheck=1
enabled=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7

#additional packages that may be useful
[extras]
name=CentOS-$releasever - Extras
# ori 
#mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=extras&infra=$infra
#baseurl=http://mirror.centos.org/centos/$releasever/extras/$basearch/
# new 
baseurl=http://centos.mirror.cdnetworks.com/7/extras/x86_64
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7

#additional packages that extend functionality of existing packages
[centosplus]
name=CentOS-$releasever - Plus
# ori
#mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=centosplus&infra=$infra
#baseurl=http://mirror.centos.org/centos/$releasever/centosplus/$basearch/
# new
baseurl=http://centos.mirror.cdnetworks.com/7/centosplus/x86_64
gpgcheck=1
enabled=0
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7

 

그 후에 정상 업데이트가 됨을 확인할 수 있다.

[root@0370a17ebb47 /]# yum update -y
Loaded plugins: fastestmirror, ovl
Loading mirror speeds from cached hostfile
base                                                                           | 3.6 kB  00:00:00
extras                                                                         | 3.4 kB  00:00:00
updates                                                                        | 3.4 kB  00:00:00
(1/4): base/group_gz                                                           | 166 kB  00:00:00
(2/4): extras/primary_db                                                       | 156 kB  00:00:00
(3/4): updates/primary_db                                                      | 1.3 MB  00:00:00
(4/4): base/primary_db                                                         | 6.0 MB  00:00:00
No packages marked for update
반응형
저작자표시 비영리 변경금지

'어장 Develop > 어장 Linux' 카테고리의 다른 글

[PostgreSQL13] PostgreSQL 13 설치하기  (0) 2024.08.21
[SVN] Linux SVN 백업  (0) 2024.08.16
[SVN] 리눅스 SVN 설치 및 실행, 연동까지.  (0) 2024.08.14
[Linux] OS 설치 후 신규 설정할 몇가지들  (0) 2024.08.07
[Docker] RockyLinux 8.10 설치 후 사용까지  (0) 2024.08.07
블로그 이미지

김생선

세상의 모든것을 어장관리

,

[PostgreSQL13] Database 백업 준비 및 백업

어장 Develop/어장 DBMS 2024. 8. 23. 11:42
반응형

OS 변경설치를 위해 개인적으로 테스트하기 위해 작성한다.

 

1. 테스트 데이터 베이스 생성 및 테스트 계정 생성

먼저 테스트용 서버에 PostgreSQL 13을 설치, 신규 데이터베이스 생성과 신규 계정을 생성한다.

만약 순서가 잘못된다면 권한과 관련해서 조금 많이 꼬여버리니까 주의해야한다. 모든 내용은 psql 명령어로 수행했다. 

# psql 명령어를 이용하여 postgres 계정에 접속
[postgres@82559cbe0973 data]$ psql -h localhost -p 18081
psql (13.16)
Type "help" for help.
postgres=#

# 계정 및 비밀번호 생성
postgres=# create user [계정명] with password '[비밀번호]';
CREATE ROLE

# 데이터베이스 생성 후, 계정 권한 부여
postgres=# create database [데이터베이스명];
CREATE DATABASE

#해당 계정에 해당 데이터베이스의 모든 권한 부여
postgres=# grant all privileges on database [데이터베이스명] to [계정명];
GRANT

#생성 후 exit 로 psql 종료, 신규로 생성한 계정으로 접속
postgres=# exit
[postgres@82559cbe0973 data]$ psql -U [계정명] -d [데이터베이스명] -h localhost -p 18081
psql (13.16)
Type "help" for help.

kimfishs=>

 

2. 신규 테이블 생성 및 데이터 입력

여기서부터는 일반 SQL 쿼리와 크게 다르지 않다. 사실 위의 grant 명령어들도 SQL 이나 다를바 없긴 하지만 뭐...

# 테이블 생성, 해당 테이블에 접속할 계정으로 생성해야 한다
kimfishs=> create table [테이블명] ( [컬럼명] varchar(50) , ... [컬럼명n] varchar (50)) ;
CREATE TABLE

# 테이블에 데이터 입력
kimfishs=> insert into [테이블명] ( id , name ) values ( 'kimfish', '리고기');
INSERT 0 1

# 테이블 데이터 조회
kimfishs=> select * from [테이블명] ;
   id    |  name
---------+--------
 kimfish | 리고기
(1 row)

 

처음에 postgres로 테이블 생성하고 이후에 DBEaver로 신규생성계정으로 접속하니 권한이 없어 select도 못하는 상황이 존재했다. 이후에 권한문제임을 깨닫고 접속 자체를 신규계정으로 접속, create table 명령어를 수행하는 방식으로 재설정했다.

 

3. PostgreSQL 데이터 베이스 백업 및 복구

임시데이터들도 모두 갖춰졌겠다, 이젠 해당 데이터베이스 설정 및 파일들을 모두 tar 압축백업을 할 예정이다.

그리고 신규 서버에 OS 설치 후 이걸 고대로 갖다 놓았을 때 정상적으로 접속이 되는지 확인할 것이다.

 

아마도 PostgreSQL 버전이 같다면 큰 문제 없이 수행되리라 예상하고 있다.

 

일단 PostgreSQL 설정파일 및 데이터베이스 파일이 위치해있는 디렉토리로 이동, tar 압축을 수행한다.

# PostgreSQL의 기본 설정 디렉토리는 /var/lib/pgsql 에 위치해있다
[root@82559cbe0973 lib]# cd /var/lib
[root@82559cbe0973 lib]# ls
alternatives  dnf    misc   private  rpm-state  systemd
dbus          games  pgsql  portables       rpm      selinux    tpm
[root@82559cbe0973 lib]# tar -cvf pgsql_back.tar pgsql
[root@82559cbe0973 lib]# ls
alternatives  dnf    misc   pgsql_back.tar  private  rpm-state  systemd
dbus          games  pgsql  portables       rpm      selinux    tpm

생성된 tar파일을 고대로 다운로드 한 후, 신규 서버에 업로드한다.

 

https://kimfish.tistory.com/361

 

[PostgreSQL13] PostgreSQL 13 설치하기

Docker에 설치된 RockyLinux 8.10 버전에 PostgreSQL 13을 설치 후 데이터 이관 테스트를 진행하려 한다.Docker에서 PostgreSQL 13을 설치할 때에는 몇가지 추가로 설정해줘야 할 것들이 있어 정리할 겸 작성한

kimfish.co.kr

이 내용을 참조하여 신규 서버에 PostgreSQL을 설치한 후, tar 파일을 업로드 한 이후, 다음의 과정을 수행한다.

#자세히 보면 서버가 다르다
[root@93e37f9f73ea lib]# ls
alternatives  dbus  games  misc          private  rpm-state  systemd
dav           dnf   httpd  pgsql_back.tar  portables   rpm      selinux    tpm
[root@93e37f9f73ea lib]#
[root@93e37f9f73ea lib]# tar -xvf pgsql_back.tar
pgsql/
pgsql/.bash_profile
pgsql/.bash_history
pgsql/.psql_history
pgsql/13/
pgsql/13/data/

(중략)

[root@93e37f9f73ea lib]# ls
alternatives  dbus  games  misc   pgsql_back.tar  portables  rpm        selinux  tpm
dav           dnf   httpd  pgsql      private    rpm-state  systemd
[root@93e37f9f73ea lib]# cd pgsql/13/data
[root@93e37f9f73ea data]# ls
PG_VERSION        log           pg_ident.conf  pg_replslot   pg_stat_tmp  pg_wal                postmaster.opts
base              pg_commit_ts  pg_logical     pg_serial     pg_subtrans  pg_xact               postmaster.pid
current_logfiles  pg_dynshmem   pg_multixact   pg_snapshots  pg_tblspc    postgresql.auto.conf
global            pg_hba.conf   pg_notify      pg_stat       pg_twophase  postgresql.conf

# 이전 서버에서 접속포트를 18081로 설정했는데, 그대로 잘 압축해제 되었는지 확인
# 의도적으로 18081 에서 8084로 변경후 실행해본다.
[postgres@93e37f9f73ea data]$ vi postgresql.conf

#------------------------------------------------------------------------------
# CONNECTIONS AND AUTHENTICATION
#------------------------------------------------------------------------------

# - Connection Settings -

listen_addresses = '*'          # what IP address(es) to listen on;
                                        # comma-separated list of addresses;
                                        # defaults to 'localhost'; use '*' for all
                                        # (change requires restart)
port = 8084                             # (change requires restart)


# PostgreSQL 서버 실행
[postgres@93e37f9f73ea data]$ /usr/pgsql-13/bin/pg_ctl -D /var/lib/pgsql/13/data start
pg_ctl: another server might be running; trying to start server anyway
waiting for server to start....2024-08-21 07:36:04.797 UTC [6143] LOG:  redirecting log output to logging collector process
2024-08-21 07:36:04.797 UTC [6143] HINT:  Future log output will appear in directory "log".
 done
server started

 

뭐 그런데 결과가 당연하게도, 잘 구동 되었다.

 

문제는 기존 PostgreSQL 설정파일의 위치나 데이터베이스 파일, 테이블 스페이스 경로 등이 커스텀화 되지 않았는지 파악하는것이 가장 중요하다.

다음에는 직접 PostgreSQL 서버에 접속 후, 각종 테이블스페이스와 데이터베이스 설정 위치들을 쿼리를 통해 알아볼 예정이다.

 

반응형
저작자표시 비영리 변경금지

'어장 Develop > 어장 DBMS' 카테고리의 다른 글

[PostgreSQL13] 초기 DB 설정  (0) 2024.08.22
[MariaDB] 권한 및 root 패스워드 변경  (0) 2020.08.20
[MySQL] 전체 테이블에서 특정 컬럼 조회  (0) 2019.03.25
[MySQL] update 서브쿼리  (1) 2019.01.28
[Oracle 11g] update replace query  (0) 2018.06.22
블로그 이미지

김생선

세상의 모든것을 어장관리

,

[PostgreSQL13] 초기 DB 설정

어장 Develop/어장 DBMS 2024. 8. 22. 10:22
반응형

얼마전에 docker linux에 PostgreSQL13 Server를 설치하였고 DBEaver를 통한 접속테스트를 수행했다.

이번에는 신규 계정 생성 및 TableSpace 생성, 기본적인 임시 테이블 서너개를 생성 후 백업 테스트를 위한 준비를 수행해볼 예정이다.

DB의 admin 계정으로 접속해서 직접 쿼리로 관리해도 되지만, 이번에는 새로운 방법(?)으로 해보려 했다.

 

아래의 순서는 다음과 같다.

데이터베이스 설정 - 테이블스페이스 설정 - 계정 생성 및 권한 설정

 

1. psql 접속 

docker linux에 접속 후, postgres 계정으로 변경한다.

이후, 설정에 따라 다르지만 아래의 명령어를 통해 psql에 접속한다.

# PostgreSQL 이 기본 포트로 동작하는 경우
[postgres@82559cbe0973 data]$ psql

#PostgreSQL 이 다른 포트로 동작하는 경우
[postgres@82559cbe0973 data]$ psql -h localhost -p [포트]

 

2. 데이터베이스 설정

이제 막 PostgreSQL을 설치했으므로 기본 데이터베이스 외에는 존재하지 않으므로, 데이터베이스 생성부터 수행한다.

다음과 같이 명령어를 입력한다.

create database [DB명];

\l 명령어는 생성된 database를 확인하는 명령어이다.

postgres=# create database kimfish_database;
CREATE DATABASE
postgres=# \l
                                 List of databases
       Name       |  Owner   | Encoding | Collate |  Ctype  |   Access privileges
------------------+----------+----------+---------+---------+-----------------------
 kimfish_database | postgres | UTF8     | C.UTF-8 | C.UTF-8 |
 postgres         | postgres | UTF8     | C.UTF-8 | C.UTF-8 |
 template0        | postgres | UTF8     | C.UTF-8 | C.UTF-8 | =c/postgres          +
                  |          |          |         |         | postgres=CTc/postgres
 template1        | postgres | UTF8     | C.UTF-8 | C.UTF-8 | =c/postgres          +
                  |          |          |         |         | postgres=CTc/postgres
(4 rows)

 

3. DB 계정 생성 및 권한 부여

#계정 생성

postgres=# create user [계정 아이디] with password '[비밀번호]';
CREATE ROLE

#계정에 데이터베이스 권한 부여
postgres=# grant connect on database [데이터베이스명] to [계정 아이디];
GRANT
postgres=# \l
                                 List of databases
       Name       |  Owner   | Encoding | Collate |  Ctype  |   Access privileges
------------------+----------+----------+---------+---------+-----------------------
 kimfish_database | postgres | UTF8     | C.UTF-8 | C.UTF-8 | =Tc/postgres         +
                  |          |          |         |         | postgres=CTc/postgres+
                  |          |          |         |         | kimfish=c/postgres
 postgres         | postgres | UTF8     | C.UTF-8 | C.UTF-8 |
 template0        | postgres | UTF8     | C.UTF-8 | C.UTF-8 | =c/postgres          +
                  |          |          |         |         | postgres=CTc/postgres
 template1        | postgres | UTF8     | C.UTF-8 | C.UTF-8 | =c/postgres          +
                  |          |          |         |         | postgres=CTc/postgres
(4 rows)

 

여기까지 기본적인 PostgreSQL 설정이 모두 완료되었다.

DBEaver를 통해 접속했을 때 정상적으로 보여지는 것 또한 확인했다.

반응형
저작자표시 비영리 변경금지

'어장 Develop > 어장 DBMS' 카테고리의 다른 글

[PostgreSQL13] Database 백업 준비 및 백업  (0) 2024.08.23
[MariaDB] 권한 및 root 패스워드 변경  (0) 2020.08.20
[MySQL] 전체 테이블에서 특정 컬럼 조회  (0) 2019.03.25
[MySQL] update 서브쿼리  (1) 2019.01.28
[Oracle 11g] update replace query  (0) 2018.06.22
블로그 이미지

김생선

세상의 모든것을 어장관리

,

[PostgreSQL13] PostgreSQL 13 설치하기

어장 Develop/어장 Linux 2024. 8. 21. 14:15
반응형

Docker에 설치된 RockyLinux 8.10 버전에 PostgreSQL 13을 설치 후 데이터 이관 테스트를 진행하려 한다.

Docker에서 PostgreSQL 13을 설치할 때에는 몇가지 추가로 설정해줘야 할 것들이 있어 정리할 겸 작성한다.

 

Docker에서 설치할 때의 에러 및 해결방법을 같이 작성하니, 일반 서버OS(Docker가 아닌)에서는 불필요한 내용도 다소 존재한다.

 

1. PostgreSQL Repository 등록

다음의 명령어로 공식 Repository를 등록한다.

yum install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm

[root@93e37f9f73ea pgsql]# yum install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm

PostgreSQL common RPMs for RHEL / CentOS 8 - x86_64                  2.3 MB/s | 2.4 kB     00:00
PostgreSQL common RPMs for RHEL / CentOS 8 - x86_64                  560  B/s | 659  B     00:01
PostgreSQL common RPMs for RHEL / CentOS 8 - x86_64                  2.3 MB/s | 2.4 kB     00:00
PostgreSQL common RPMs for RHEL / CentOS 8 - x86_64                  552  B/s | 659  B     00:01
Error: Failed to download metadata for repo 'pgdg-common': repomd.xml GPG signature verification error: Bad GPG signature

위 오류는 GPG 서명검증 실패 오류로, 다음의 명령어로 재시도한다.

 

yum install -y --nogpgcheck https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm

[root@93e37f9f73ea pgsql]# yum install -y --nogpgcheck https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm

PostgreSQL common RPMs for RHEL / CentOS 8 - x86_64                  244 kB/s | 468 kB     00:01
pgdg-redhat-repo-latest.noarch.rpm                                    20 kB/s |  15 kB     00:00
Dependencies resolved.
=====================================================================================================
 Package                     Architecture      Version                 Repository               Size
=====================================================================================================
Upgrading:
 pgdg-redhat-repo            noarch            42.0-43PGDG             @commandline             15 k

Transaction Summary
========================================================================================================================
Install  1 Package

Total size: 15 k
Installed size: 15 k
Downloading Packages:
Running transaction check
Transaction check succeeded.
Running transaction test
Transaction test succeeded.
Running transaction
  Preparing        :                                                                                                1/1
  Installing       : pgdg-redhat-repo-42.0-43PGDG.noarch                                                            1/1
  Verifying        : pgdg-redhat-repo-42.0-43PGDG.noarch                                                            1/1

Installed:
  pgdg-redhat-repo-42.0-43PGDG.noarch

Complete!

 

2. 기본 PostgreSQL 모듈 비활성화

RockyLinux 8.10 버전에서는 기본 PostgreSQL 모듈 활성화가 되어있으니, 비활성화 작업을 거친다.

이 작업은 약간의 시간을 소요한다.

 

yum module disable -y postgresql

[root@82559cbe0973 /]# yum module disable -y postgresql
PostgreSQL common RPMs for RHEL / Rocky / AlmaLinux 8 - x86_64                          364  B/s | 659  B     00:01
PostgreSQL common RPMs for RHEL / Rocky / AlmaLinux 8 - x86_64                          2.4 MB/s | 2.4 kB     00:00
Importing GPG key 0x08B40D20:

(중략)

Dependencies resolved.
========================================================================================================================
 Package                     Architecture               Version                       Repository                   Size
========================================================================================================================
Disabling modules:
 postgresql

Transaction Summary
========================================================================================================================

Complete!

 

3. PostgreSQL 13 Server버전 설치

이제 PostgreSQL 13 Server를 설치한다.

 

yum install -y postgresql13 postgresql13-server

[root@82559cbe0973 /]# yum install -y postgresql13 postgresql13-server
Last metadata expiration check: 0:00:42 ago on Wed Aug 21 02:01:09 2024.
Dependencies resolved.
========================================================================================================================
 Package                            Architecture          Version                           Repository             Size
========================================================================================================================
Installing:
 postgresql13                       x86_64                13.16-2PGDG.rhel8                 pgdg13                1.5 M
 postgresql13-server                x86_64                13.16-2PGDG.rhel8                 pgdg13                5.5 M
Installing dependencies:
 libicu                             x86_64                60.3-2.el8_1                      baseos                8.8 M
 postgresql13-libs                  x86_64                13.16-2PGDG.rhel8                 pgdg13                420 k

Transaction Summary
========================================================================================================================
Install  4 Packages

(중략)

Installed:
  libicu-60.3-2.el8_1.x86_64                                postgresql13-13.16-2PGDG.rhel8.x86_64
  postgresql13-libs-13.16-2PGDG.rhel8.x86_64                postgresql13-server-13.16-2PGDG.rhel8.x86_64

Complete!

 

4. PostgreSQL 설정 및 구동

PostgreSQL DB 초기화 및 권한과 관련해서 설정을 진행해주어야 한다. 다음의 명령어를 수행한다.

 

4-1. PostgreSQL DB 초기화

해당 디렉토리가 존재하지 않는다면 해당 디렉토리를 생성한다.

존재한다면 이 단계는 건너뛰어도 된다.

[root@82559cbe0973 bin]# mkdir /var/lib/pgsql/13/data
[root@82559cbe0973 bin]# cd /var/lib/pgsql/13/data
[root@82559cbe0973 data]# pwd
/var/lib/pgsql/13/data

 

4-2. postgres 계정 권한부여 및 계정전환

PostgreSQL 13 을 설치하면 postgres 라는 계정이 생성된다. 해당 계정으로 PostgreSQL13을 구동하는 등, PostgreSQL 기능과 관련된 여러 동작을 수행한다.

해당 계정에 위 4-1. 디렉토리의 접근권한을 부여해준 후, 해당 계정으로 접속한다.

[root@93e37f9f73ea var]# chown postgres:postgres /var/lib/pgsql/13/data
[root@93e37f9f73ea var]#
[root@93e37f9f73ea var]# su - postgres

 

4-3. DB 클러스터 초기화

postgres 계정으로 아래의 명령어를 수행하여 DB 클러스터를 초기화해준다.

[postgres@93e37f9f73ea ~]$ /usr/pgsql-13/bin/initdb -D /var/lib/pgsql/13/data

The files belonging to this database system will be owned by user "postgres".
This user must also own the server process.

The database cluster will be initialized with locale "C.UTF-8".
The default database encoding has accordingly been set to "UTF8".
The default text search configuration will be set to "english".

Data page checksums are disabled.

fixing permissions on existing directory /var/lib/pgsql/13/data ... ok
creating subdirectories ... ok
selecting dynamic shared memory implementation ... posix
selecting default max_connections ... 100
selecting default shared_buffers ... 128MB
selecting default time zone ... Etc/UTC
creating configuration files ... ok
running bootstrap script ... ok
performing post-bootstrap initialization ... ok
syncing data to disk ... ok

initdb: warning: enabling "trust" authentication for local connections
You can change this by editing pg_hba.conf or using the option -A, or
--auth-local and --auth-host, the next time you run initdb.

Success. You can now start the database server using:

    /usr/pgsql-13/bin/pg_ctl -D /var/lib/pgsql/13/data -l logfile start

 

4-4. PostgreSQL 실행 및 중지

아래의 명령어를 통해 실행 또는 중지한다.

/usr/pgsql-13/bin/pg_ctl -D /var/lib/pgsql/13/data start 

/usr/pgsql-13/bin/pg_ctl -D /var/lib/pgsql/13/data stop

로그는 /var/lib/pgsql/13/data/log 경로에 위치해있다.

 

5. 호스트 PC에서 접속하기 위한 설정

Docker에서 PostgreSQL을 구동시켰으니 호스트PC인 Windows 에서 DBEaver를 통해 접속하려 한다. 꽤 많은(?) 삽질이 필요했는데, 아래의 방법을 진행하여 연결에 성공했다.

 

5-1. 접속 포트 설정

현재 Docker는 18081 포트로 포트포워딩이 설정된 상태이다. postgreSQL은 5432 포트가 기본포트이므로, 아래의 설정파일을 편집한다. 모든 과정은 postgres 계정으로 진행한다.

아래 항목 중, listen_address 항목을 모든 IP주소인 '*' 로 설정하고, port는 5432 에서 변경할 포트인 18081로 수정한다.

기본적으로 주석처리가 되어있으므로 주석 또한 해제한다.

 

postgresql 서버를 재시작해야 설정이 적용된다.

[postgres@82559cbe0973 data] cd /var/lib/pgsql/13/data
[postgres@82559cbe0973 data] vi postgresql.conf

(중략)

# - Connection Settings -

listen_addresses = '*'          # what IP address(es) to listen on;
                                        # comma-separated list of addresses;
                                        # defaults to 'localhost'; use '*' for all
                                        # (change requires restart)
port = 18081                            # (change requires restart)

 

5-2. 외부 접근 허용 정책 설정

외부 접근을 허용하는 정책을 설정하기 위해 같은 디렉토리에 있는 pg_hba.conf 파일을 열어준다.

최하단의 볼드체로 표시된 항목 두 개를 추가한다.

 

postgresql 서버를 재시작해야 설정이 적용된다.

[postgres@82559cbe0973 data] cd /var/lib/pgsql/13/data
[postgres@82559cbe0973 data] vi pg_hba.conf

(중략) 

# replication privilege.
local   replication     all                                     trust
host    replication     all             127.0.0.1/32            trust
host    replication     all             ::1/128                 trust
host    all     all             0.0.0.0/0               md5
host    all     all             ::/0                    md5

 

5-3. 기본계정 postgres 비밀번호 설정

어디에선가 본 것으로는 postgres 계정의 비밀번호는 postgres라던데 사실 아니었나보다 -_-;

그래서 직접 접속 후, postgres 계정의 비밀번호를 설정해준다.

 

위 5-1. 항목에서 5432 포트를 18081로 변경하였기 때문에, 기본 접속 명령어인 psql  명령어가 오류가 나게 된다.

이럴 때에는 당황하지 말고 변경한 포트설정 옵션을 넣어주어야 한다.

(오류 예시)
[postgres@82559cbe0973 data]$ psql
psql: error: could not connect to server: No such file or directory
        Is the server running locally and accepting
        connections on Unix domain socket "/run/postgresql/.s.PGSQL.5432"?

 

(포트변경 후 옵션 설정)
[postgres@82559cbe0973 data]$ psql -h localhost -p 18081
psql (13.16)
Type "help" for help.

postgres=#

 

접속이 되었다면 아래의 쿼리를 입력하여 비밀번호를 설정해주자.

postgres=# alter user postgres password 'test1!';
ALTER ROLE

 

그리고 DBEaver 에서 접속하면 정상적으로 접속됨을 확인할 수 있다.

 

DB를 로컬 Windows PC에는 많이 설치해보고 개발용으로 설정한 적은 많아도, Docker Linux에 세팅한 후 접속해보는 건 처음인것 같다. 여러모로 설정이 많아 헷갈리기도 하고 조금 많이 어렵기도 했다. 실제 Linux 서버에 설치하는건 조금 다를것이고, 보안을 고려한다면 외부 접속 설정 정책 부분도 손을 좀 더 봐야 할 것으로 예상된다. 뭐, 그래도 해본게 어딘가 싶긴 하지만 말이다.

반응형
저작자표시 비영리 변경금지

'어장 Develop > 어장 Linux' 카테고리의 다른 글

[CentOS7] Could not retrieve mirrorlist ~  (0) 2024.08.26
[SVN] Linux SVN 백업  (0) 2024.08.16
[SVN] 리눅스 SVN 설치 및 실행, 연동까지.  (0) 2024.08.14
[Linux] OS 설치 후 신규 설정할 몇가지들  (0) 2024.08.07
[Docker] RockyLinux 8.10 설치 후 사용까지  (0) 2024.08.07
블로그 이미지

김생선

세상의 모든것을 어장관리

,
04-04 10:42
반응형

티스토리툴바