키큰난쟁이의 놀이터

모델 컨텍스트 프로토콜(Model Context Protocol, MCP) : AI와 데이터 통합의 새로운 표준

키큰난쟁이 — Sun, 30 Mar 2025 11:46:54 +0900

1. 들어가며

AI 기술이 발전하면서 단순히 텍스트 응답을 생성하는 것을 넘어, 외부 데이터를 실시간으로 활용하는 능력이 중요해졌습니다. 그러나 기존 AI 모델은 특정 데이터 소스와 개별적으로 연동해야 하는 복잡한 과정이 필요했습니다. 이러한 문제를 해결하기 위해 등장한 것이 바로 모델 컨텍스트 프로토콜(Model Context Protocol, MCP)입니다.

MCP는 AI 모델과 외부 데이터 소스(API, 데이터베이스, 파일 시스템 등)를 연결하는 개방형 표준 프로토콜로,,Anthropic(Claude AI 개발사)이 2024년 11월에 처음 공개했습니다. 이를 통해 AI 모델은 실시간 데이터를 활용하거나 특정 기능을 실행할 수 있으며, 개발자들은 통합 작업의 복잡성을 크게 줄일 수 있습니다.

2. MCP란 무엇인가?

MCP는 AI 모델이 외부 데이터를 활용할 수 있도록 돕는 표준화된 인터페이스입니다. 이를 통해 AI가 다양한 도구와 데이터를 연결하여 더 똑똑하고 실용적인 응답을 생성할 수 있습니다.

2.1 기존 AI 모델의 한계

일반적으로 AI 모델은 훈련된 데이터에 기반하여 응답을 생성합니다.
그러나 실시간 데이터(날씨, 최신 뉴스, 데이터베이스 정보 등)에는 접근할 수 없다는 한계가 있었습니다.
이를 해결하려면 매번 개별 API를 통합해야 하며, 이는 개발 비용과 유지 보수 부담을 증가시켰습니다.

2.2 MPC의 역할

MCP는 다음과 같은 방식으로 기존 문제를 해결합니다.

AI가 외부 데이터와 직접 연결 가능: 웹 API, 파일 시스템, 데이터베이스 등 다양한 소스와 통합.
개별적인 API 연동 없이 통합 관리 가능: 단일 프로토콜로 모든 소스를 연결.
보안성과 확장성 보장: 안전한 데이터 교환 및 새로운 도구 추가 가능.

3. MCP의 주요 구성 요소

MCP는 클라이언트-서버 구조로 동작하며, 다음과 같은 핵심 요소로 구성됩니다.

3.1 MCP 호스트(Host)

AI 애플리케이션(예: Claude Desktop, AI 챗봇)이 사용자 요청을 처리하고 MCP 서버와 통신합니다.

3.2 MCP 클라이언트(Client)

호스트와 서버 간의 연결을 담당하며, 여러 MCP 서버에서 데이터를 가져옵니다.

3.3 MCP 서버(Server)

외부 데이터를 제공하거나 특정 작업(예: 계산)을 수행합니다.
예: 날씨 API, 파일 시스템, SQL 데이터베이스 등.

3.4 MCP 컨텍스트(Context)

컨텍스트는 MCP 서버가 제공하는 실제 데이터나 기능으로 다음과 같이 분류됩니다.

컨텍스트 요소	설명
Resources (리소스)	AI가 읽을 수 있는 데이터 (파일, DB 레코드 등)
Tools (도구)	AI가 호출할 수 있는 기능 (API 요청, 계산 등)
Prompts (프롬프트)	응답 생성을 조절하는 지침

4. FastMCP: Python 기반 MCP 서버 구현

FastMCP는 Python SDK로, 모델 컨텍스트 프로토콜(MCP)을 쉽게 구현할 수 있도록 설계된 도구입니다. Anthropic이 제안한 MCP 표준은 AI 모델과 외부 데이터 소스를 연결하는 강력한 방식이지만, 이를 직접 구축하려면 복잡한 프로토콜 관리와 많은 코드 작업이 필요합니다. FastMCP는 이러한 복잡성을 줄이고, 데코레이터 기반의 간단한 코드 작성으로 MCP 서버를 만들 수 있게 해줍니다.

4.1 FastMCP란?

FastMCP는 MCP의 모든 사양을 구현한 Python SDK로, 다음과 같은 기능을 제공합니다.

MCP 클라이언트 및 서버 생성: MCP 클라이언트와 서버를 쉽게 구축 가능
표준화된 데이터 전송 방식 지원: Stdio, SSE 등 다양한 전송 방식 지원
데코레이터 기반 코드 작성: 간단한 함수 정의와 데코레이터를 통해 MCP 리소스, 도구, 프롬프트를 설정 가능
보안 및 확장성 보장: 로컬 및 원격 데이터 소스에 안전하게 접근

4.2 예제 1: 두 숫자를 더하는 MCP 도구

from mcp.server.fastmcp import FastMCP

# MCP 서버 초기화
mcp = FastMCP("Demo")

# 두 숫자를 더하는 함수 정의
@mcp.tool()
def add(a: int, b: int) -> int:
    return a + b

if __name__ == "__main__":
    mcp.run()

FastMCP("Demo"): MCP 서버 초기화
@mcp.tool(): AI 모델이 호출할 수 있는 도구 정의
mcp.run(): 서버 실행

4.3 예제 2: SQLite 데이터베이스 탐색 MCP 서버

from mcp.server.fastmcp import FastMCP
import sqlite3

# SQLite DB 초기화
def init_db():
    conn = sqlite3.connect("example.db")
    cursor = conn.cursor()
    cursor.execute("CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, name TEXT)")
    cursor.execute("INSERT INTO users (name) VALUES ('Alice'), ('Bob')")
    conn.commit()
    conn.close()

# MCP 서버 초기화
mcp = FastMCP("SQLite Explorer")

@mcp.resource("db://users")
def list_users() -> list[dict]:
    conn = sqlite3.connect("example.db")
    cursor = conn.cursor()
    cursor.execute("SELECT * FROM users")
    rows = cursor.fetchall()
    conn.close()
    return [{"id": row[0], "name": row[1]} for row in rows]

@mcp.tool()
def add_user(name: str):
    conn = sqlite3.connect("example.db")
    cursor = conn.cursor()
    cursor.execute("INSERT INTO users (name) VALUES (?)", (name,))
    conn.commit()
    conn.close()
    return f"User {name} added successfully!"

if __name__ == "__main__":
    init_db()
    mcp.run()

list_users(): SQLite 테이블에서 사용자 목록 반환
add_user(name): 새로운 사용자를 추가하는 도구 정의

5. MCP 활용 사례

5.1 파일 시스템 연동

AI가 로컬 파일을 읽거나 요약 기능 수행 가능.
예: "이 문서에서 중요한 내용을 요약해줘."

5.2 업무 도구(Slack, Google Drive)와 연동

Slack 메시지 분석이나 Google Drive 문서 검색 가능
예: "지난주 공유된 문서를 찾아줘."

5.3 데이터베이스 질의 처리

SQL 쿼리를 실행하여 실시간 데이터를 분석
예: "지난달 매출 데이터를 보여줘."

5.4 실시간 정보 제공

날씨 API나 최신 뉴스를 활용해 실시간 정보 제공
예: "오늘 서울의 날씨는 어때?"

6. MCP가 가져올 미래 변화

MCP는 AI 기술 발전에 있어 중요한 전환점입니다. 앞으로 기대되는 변화는 다음과 같습니다.

AI 모델의 실시간 데이터 활용 능력 향상: 더 정확하고 유용한 응답 생성
API 통합 부담 감소: 개발자가 더 쉽게 새로운 기능을 추가 가능
보안성과 확장성을 갖춘 생태계 구축: 기업과 개발자 모두에게 유리한 환경 제공

현재 많은 기업들이 MCP를 도입하여 AI 서비스를 개선하고 있으며, 앞으로 이 생태계는 더욱 확장될 것으로 기대됩니다.

7. 마무리

모델 컨텍스트 프로토콜(MCP)은 AI와 외부 데이터를 연결하여 더욱 강력하고 유연한 응용 프로그램을 만들 수 있는 혁신적인 기술입니다. Anthropic이 주도하는 이 표준은 앞으로도 다양한 산업에서 폭넓게 활용될 것입니다. 이제 여러분도 MCP를 활용해 더 똑똑한 AI 애플리케이션을 만들어보세요.

Spring Boot 3에서 Swagger와 H2 Database 사용하기

키큰난쟁이 — Thu, 20 Feb 2025 18:17:42 +0900

1. 들어가며

Spring Boot 3.x 프로젝트에서 Swagger를 이용한 API 문서화와 H2 Database를 활용해서 간단한 회원 관리 시스템 예시로 구현해보겠습니다. 이 글에서는 다음 내용을 다룰 예정입니다.

Gradle을 이용한 프로젝트 설정
Swagger UI 설정 및 사용법
H2 Database 설정 및 JPA를 이용한 자동 테이블 생성
회원 관리 기능 (등록, 수정, 삭제) 구현

본 설명에서 사용하는 주요 기술 스택은 다음과 같습니다.

Java 버전: 17
Spring Boot 버전: 3.4.2
Gradle 버전: 8.x (8.4 이상)
H2 Database
Swagger

2. 프로젝트 설정

먼저 build.gradle 파일을 다음과 같이 설정합니다.

plugins {
	id 'java'
	id 'org.springframework.boot' version '3.4.2'
	id 'io.spring.dependency-management' version '1.1.7'
}

group = 'me.junu'
version = '0.0.1-SNAPSHOT'

java {
	toolchain {
		languageVersion = JavaLanguageVersion.of(17)
	}
}

repositories {
	mavenCentral()
}

dependencies {
	implementation 'org.springframework.boot:spring-boot-starter-web'
	implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
	implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.4.0'
	runtimeOnly 'com.h2database:h2'
	testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

tasks.named('test') {
	useJUnitPlatform()
}

3. Swagger 설정

Swagger UI를 설정하기 위해 SwaggerConfig 클래스를 생성합니다.

import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Info;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class SwaggerConfig {

    @Bean
    public OpenAPI customOpenAPI() {
        return new OpenAPI()
            .info(new Info()
                .title("사용자 관리 API")
                .version("1.0")
                .description("Spring Boot 3.x (Springdoc) 사용자 관리 API"));
    }
}

3. H2 Database 설정

'application.yml' 파일에 H2 Database 설정을 추가합니다.

spring:
  datasource:
    url: jdbc:h2:mem:testdb
    driver-class-name: org.h2.Driver
    username: sa
    password:
  h2:
    console:
      enabled: true
      path: /h2-console
  jpa:
    database-platform: org.hibernate.dialect.H2Dialect
    hibernate:
      ddl-auto: create-drop
    show-sql: true

springdoc:
  api-docs:
    path: /api-docs
  swagger-ui:
    path: /swagger-ui.html

3. 엔티티 클래스 생성

User 엔티티 클래스를 생성합니다.

import jakarta.persistence.*;

@Entity
@Table(name = "users")
public class User {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(nullable = false, unique = true)
    private String username;

    @Column(nullable = false)
    private String password;

    @Column(nullable = false)
    private String email;

    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }
}

5. 리포지토리 인터페이스 생성

import me.junu.auth.user.entity.User;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

import java.util.Optional;

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    Optional<User> findByUsername(String username);
}

6. 서비스 클래스 구현

import me.junu.auth.user.entity.User;
import me.junu.auth.user.repository.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class UserService {
    private final UserRepository userRepository;

    @Autowired
    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    public User registerUser(User user) {
        return userRepository.save(user);
    }

    public User updateUser(Long id, User userDetails) {
        User user = userRepository.findById(id)
                .orElseThrow(() -> new RuntimeException("User not found"));
        user.setUsername(userDetails.getUsername());
        user.setEmail(userDetails.getEmail());
        return userRepository.save(user);
    }

    public void deleteUser(Long id) {
        userRepository.deleteById(id);
    }

    public User loginUser(String username, String password) {
        User user = userRepository.findByUsername(username)
                .orElseThrow(() -> new RuntimeException("User not found"));
        // TODO: Add password verification
        return user;
    }
}

7. 컨트롤러 클래스 구현

import me.junu.auth.user.entity.User;
import me.junu.auth.user.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/api/v1/users")
public class UserController {

    private final UserService userService;

    @Autowired
    public UserController(UserService userService) {
        this.userService = userService;
    }

    @PostMapping("/register")
    public ResponseEntity<User> registerUser(@RequestBody User user) {
        User registeredUser = userService.registerUser(user);
        return ResponseEntity.ok(registeredUser);
    }

    @PutMapping("/{id}")
    public ResponseEntity<User> updateUser(@PathVariable Long id, @RequestBody User userDetails) {
        User updatedUser = userService.updateUser(id, userDetails);
        return ResponseEntity.ok(updatedUser);
    }

    @DeleteMapping("/{id}")
    public ResponseEntity<?> deleteUser(@PathVariable Long id) {
        userService.deleteUser(id);
        return ResponseEntity.ok().build();
    }
}

8. 애플리케이션 실행 및 테스트

애플리케이션을 실행합니다.
Swagger UI (http://localhost:8080/swagger-ui.html)에 접속하여 API를 테스트합니다.
H2 Console (http://localhost:8080/h2-console)에 접속하여 데이터베이스를 확인합니다.

9. 마무리

이렇게 Spring Boot 3.x, Gradle, Swagger, H2 Database를 사용하여 간단한 회원 관리 API를 구현해보았습니다. 이 예제를 바탕으로 더 복잡한 기능을 추가하거나 실제 프로젝트에 적용해볼 수 있습니다. 주의할 점은 이 예제에서는 보안 처리나 예외 처리 등이 생략되어 있으므로, 실제 프로덕션 환경에서는 이러한 부분들을 반드시 고려해야 합니다.

auth.zip

0.17MB

Spring의 Argument Resolver 이해하기

키큰난쟁이 — Tue, 18 Feb 2025 19:30:31 +0900

1. Argument Resolver 소개

Argument Resolver는 Spring MVC에서 컨트롤러 메서드의 파라미터를 유연하게 처리할 수 있게 해주는 강력한 기능입니다. 이를 통해 개발자는 요청 데이터를 원하는 형태로 가공하여 컨트롤러에 전달할 수 있습니다.

2. Argument Resolver의 역할

HTTP 요청 데이터 변환: 요청의 파라미터, 헤더, 바디 등을 원하는 객체로 변환합니다.
공통 로직 처리: 인증 정보 추출, 데이터 검증 등의 공통 로직을 처리할 수 있습니다.
코드 중복 제거: 컨트롤러에서 반복되는 로직을 Argument Resolver로 이동시켜 코드 중복을 줄일 수 있습니다.

3. Argument Resolver 동작 원리

사용자가 HTTP Request를 보냅니다.
DispatcherServlet이 요청을 받습니다.HandlerAdapter의 Argument Resolver 호출
HandlerMapping을 통해 요청을 처리할 핸들러(컨트롤러)를 찾습니다.
HandlerAdapter가 Argument Resolver를 호출합니다.
Argument Resolver가 요청 데이터를 처리하여 핸들러 메서드의 파라미터로 전달할 객체를 생성합니다.
핸들러(컨트롤러) 메서드가 실행됩니다.

4. Argument Resolver 구현 방법

Argument Resolver를 구현하려면 HandlerMethodArgumentResolver 인터페이스를 구현해야 합니다.

public class CustomArgumentResolver implements HandlerMethodArgumentResolver {

    @Override
    public boolean supportsParameter(MethodParameter parameter) {
        return parameter.getParameterType().equals(CustomObject.class);
    }

    @Override
    public Object resolveArgument(MethodParameter parameter, ModelAndViewContainer mavContainer,
                                  NativeWebRequest webRequest, WebDataBinderFactory binderFactory) throws Exception {
        // 요청 데이터를 처리하여 CustomObject 생성 및 반환
        CustomObject customObject = new CustomObject();
        // customObject 설정...
        return customObject;
    }
}

5. Argument Resolver 사용 예시

커스텀 어노테이션 정의

@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
public @interface CurrentUser {}

Argument Resolver 구현

public class CurrentUserArgumentResolver implements HandlerMethodArgumentResolver {

    @Override
    public boolean supportsParameter(MethodParameter parameter) {
        return parameter.getParameterAnnotation(CurrentUser.class) != null
                && parameter.getParameterType().equals(User.class);
    }

    @Override
    public Object resolveArgument(MethodParameter parameter, ModelAndViewContainer mavContainer,
                                  NativeWebRequest webRequest, WebDataBinderFactory binderFactory) {
        HttpServletRequest request = (HttpServletRequest) webRequest.getNativeRequest();
        return getUserFromSession(request);
    }
}

컨트롤러에서 사용

@GetMapping("/profile")
public String getProfile(@CurrentUser User user) {
    return "User: " + user.getName();
}

6. 마무리

Argument Resolver는 Spring MVC에서 요청 데이터 처리를 유연하게 만들어주는 강력한 도구입니다. 이를 통해 코드의 재사용성을 높이고, 컨트롤러의 책임을 줄여 더 깔끔한 코드를 작성할 수 있습니다. 복잡한 비즈니스 로직이나 공통 처리 로직을 Argument Resolver로 분리함으로써, 개발자는 핵심 비즈니스 로직에 더 집중할 수 있게 됩니다.

파워목업(PowerMockup)으로 화면 설계 & 리뷰 무료 라이센스 혜택

키큰난쟁이 — Thu, 13 Feb 2025 16:53:20 +0900

1. 소개 (Power Mockup 소개)

Power Mockup은 UI/UX 디자인을 위해 설계된 뛰어난 프로토타이핑 툴입니다. 특히, PowerPoint와의 통합 덕분에 빠르고 직관적인 디자인 작업이 가능하다는 장점이 있습니다. 복잡한 툴을 배우지 않고도 쉽게 사용하며, 다양한 템플릿과 기능을 제공해 많은 디자이너들이 애용하는 툴입니다.

2. 주요 기능과 장점

PowerPoint와의 호환성
Power Mockup은 PowerPoint 내에서 바로 실행되기 때문에, 별도의 디자인 툴을 익히지 않고도 손쉽게 디자인을 시각화할 수 있습니다. PowerPoint의 기능을 그대로 활용할 수 있어, 기존 사용자가 익숙하게 사용할 수 있습니다.
다양한 UI 요소 제공
버튼, 네비게이션 바, 아이콘 등 다양한 UI 요소를 제공하여 빠르게 웹페이지나 앱 화면을 구성할 수 있습니다. 템플릿의 선택 폭도 넓어 다양한 디자인 스타일을 구현할 수 있습니다.
직관적인 인터페이스
사용자는 드래그 앤 드롭 방식으로 쉽게 요소를 배치하고 편집할 수 있어, 디자인을 만들면서 불편함 없이 작업할 수 있습니다. 또한, 고급 기능을 필요로 하지 않으면서도 뛰어난 결과물을 얻을 수 있습니다.
빠른 프로토타입 제작
빠른 프로토타입을 만들 수 있어, 디자인 컨셉을 빠르게 시각화하고 피드백을 받을 수 있습니다. 이는 팀원 간 협업에도 큰 도움이 됩니다.

3. 소개 영상

4. 설치 하기

PowerPoint Wireframe and Prototyping Tool | PowerMockup

Collaboration PowerPoint includes collaboration and sharing features that facilitate working in a team. You can share documents with others via OneDrive or SharePoint, leave comments on slides, and merge different versions of a document into a single file.

www.powermockup.com

위 링크를 통해서 설치 진행하시면 됩니다.

3. 내가 느낀 점

Power Mockup을 사용해본 후, 가장 큰 장점은 직관성과 시간 절약입니다. 특히, 기존에 PowerPoint를 사용해본 경험이 있다면 별다른 학습 없이 바로 사용할 수 있다는 점에서 매우 유용했습니다. 다양한 UI 요소를 제공하여, 디자인을 처음 시작하는 사람도 큰 부담 없이 퀄리티 높은 화면을 만들 수 있었습니다.

4. 무료 라이센스 취득 방법

Power Mockup 공식 웹사이트 가입
- 먼저 Power Mockup 공식 웹사이트에 접속하여 계정을 만듭니다. 가입 절차는 간단하며, 이메일과 비밀번호만으로 가입할 수 있습니다.
Power Mockup 다운로드
- 웹사이트에서 Power Mockup을 다운로드합니다. 설치 후 PowerPoint에서 Power Mockup을 실행할 수 있습니다. 설치 과정 중에 무료 체험 버전을 사용할 수 있는 기회도 제공됩니다.
제품 사용 후 리뷰 작성
- Power Mockup을 실제로 사용해보고, 사용 경험을 바탕으로 솔직한 리뷰를 작성합니다.
- 리뷰에는 제품의 장단점, 유용했던 기능, 디자인 작업에서 어떻게 도움이 되었는지 등을 포함하면 좋습니다.
- 리뷰를 작성하는 페이지는 웹사이트에 접속 후 안내에 따라 쉽게 찾을 수 있습니다.
리뷰 제출 후 무료 라이센스 요청
- 리뷰를 작성한 후 제출하면, Power Mockup 팀에서 리뷰를 확인하고, 무료 라이센스를 제공해줍니다.
- 보통 라이센스는 이메일을 통해 제공되며, 라이센스 코드가 포함된 메일을 수령하게 됩니다.
무료 라이센스 활성화
- 받은 라이센스 코드를 Power Mockup에 입력하면 무료 라이센스를 활성화할 수 있습니다. 이제 제한 없이 Power Mockup을 사용하실 수 있습니다!

[Docker] Jenkins와 GitHub 연동하기: 지속적 배포(Continuous Deployment, CD)

키큰난쟁이 — Mon, 21 Oct 2024 03:37:32 +0900

2024.10.05 - [데브옵스/CICD] - [Docker] Jenkins와 GitHub 연동하기: 지속적 통합(Continuous Integration, CI)

[Docker] Jenkins와 GitHub 연동하기: 지속적 통합(Continuous Integration, CI)

2024.10.04 - [데브옵스/CICD] - Docker로 Jenkins 설치하기: 단계별 가이드1. 들어가며지속적 통합(Continuous Integration, CI)은 현대 소프트웨어 개발에서 필수적인 프로세스입니다. CI를 통해 개발자들은 코

bigdwarf.blog

1. 들어가며

Jenkins를 활용해 CI/CD 파이프라인을 구축할 때 Docker 이미지 빌드가 필요한 상황이 자주 발생합니다. 일반적인 환경에서는 Jenkins 사용자에게 Docker 권한을 부여하는 것으로 충분하지만, Jenkins를 Docker 컨테이너로 실행하는 경우에는 호스트의 Docker 데몬을 사용해야 하는 특수한 설정이 필요합니다.

이 글에서는 Jenkins 컨테이너 내부에서 Docker를 설치하고, Docker 소켓을 공유하여 호스트의 Docker를 사용하는 방법을 다룹니다. 이는 컨테이너 내부에서 별도로 Docker 데몬을 실행하는 방법보다 안전하고 효율적인 방식입니다.

2. Docker와 Jenkins의 연동 개요

Jenkins와 Docker를 연동하여 CD 파이프라인을 구축하려면 Jenkins가 Docker 명령어를 실행할 수 있어야 합니다. 이를 위한 두 가지 방법이 있습니다.

Docker 소켓 공유: 호스트의 Docker 소켓을 Jenkins 컨테이너와 공유하여 Jenkins가 Docker 명령을 실행할 수 있게 합니다. (권장)
컨테이너 내부에 Docker 설치: Jenkins 컨테이너에 별도로 Docker를 설치하여 자체 데몬을 실행하는 방법 (비권장)

이 글에서는 첫 번째 방법을 다루며, Docker 소켓 공유 설정에 대해 설명합니다.

2.1 Docker 소켓 공유란?

컨테이너는 기본적으로 호스트 시스템의 Docker 데몬에 접근할 수 없습니다. 따라서 Jenkins가 Docker 명령을 실행하려면 호스트의 Docker 소켓을 공유하여 Jenkins 컨테이너가 호스트에서 Docker 명령어를 실행할 수 있게 해야 합니다. 하지만 보안적인 고려가 필요하며, 이를 잘못 설정할 경우 시스템에 위험을 초래할 수 있습니다.

2.2 Docker 소켓 공유 설정

Docker 소켓을 Jenkins 컨테이너에 마운트하려면 아래와 같이 설정합니다.

Docker 소켓을 Jenkins 컨테이너에 마운트하여 Jenkins가 호스트의 Docker 데몬에 접근할 수 있게 합니다. 이를 위해 Jenkins 컨테이너를 실행할 때 아래와 같이 /var/run/docker.sock 파일을 마운트합니다.

Docker 명령어 방식

docker run -d -p 8080:8080 -p 50000:50000 \
  -v /home/junu/docker_data/jenkins:/var/jenkins_home \
  -v /var/run/docker.sock:/var/run/docker.sock \ # 소켓 마운트
  --name jenkins jenkins/jenkins:lts

Docker Compose 방식

version: '3.9'
services:
  jenkins:
    image: jenkins/jenkins:lts
    container_name: jenkins # 컨테이너 이름을 명시적으로 표시하기 위해 추가
    ports:
      - "8080:8080"
      - "50000:50000"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock # 소켓 마운트
      - /home/junu/docker_data/jenkins:/var/jenkins_home
  networks: {}

2.3 Docker 소켓 공유 권한 문제

/var/run/docker.sock의 permission denied 발생했을 경우

/var/run/docker.sock 파일의 권한을 666으로 변경하여 그룹 내 다른 사용자도 접근 가능하게 변경

sudo chmod 666 /var/run/docker.sock

또는 chown 으로 docker group 변경

chown root:docker /var/run/docker.sock

3. Docker Engine 설치: Jenkins 컨테이너 내부에서 Docker 설치하기

3.1 Jenkins 컨테이너 내부에 직접 Docker 설치

Docker 컨테이너 내부에 별도로 Docker를 설치하기전 컨테이너 내 리눅스 환경 확인이 필요합니다. 이글에서 설치한 Jenkins 컨테이너는 Debian 계열의 리눅스로 이미지가 만들어져있습니다. 컨테이너 내에 Debian 패키지 관리자를 사용하여 Docker를 설치해야 합니다. Docker 공식 문서에서 제공하는 Install Docker Engine on Debian 가이드를 참고 또는 아래 명령어를 입력해 설치를 진행합니다.

jenkins 컨테이너 내부 root로 접속

docker exec -it --user root jenkins /bin/bash

Docker apt저장소를 설정합니다.

# Add Docker's official GPG key:
apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  tee /etc/apt/sources.list.d/docker.list > /dev/null
apt-get update

Docker 패키지를 설치합니다.

apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Docker Compose 설치 (선택사항)
docker-compose 사용 시 설치 필요

# Docker Compose 설치
curl -L "https://github.com/docker/compose/releases/download/$(curl -s https://api.github.com/repos/docker/compose/releases/latest | grep 'tag_name' | cut -d '"' -f 4)/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

이미지를 실행하여 설치가 성공적으로 완료되었는지 확인하세요.

docker run hello-world

3.2 Dockerfile를 활용하여 Jenkins 컨테이너 내 Docker 설치하기

Dockerfile을 이용한 Docker 명령어로 Jenkins 컨테이너 내 Docker 설치

Dockerfile 작성 및 저장

# Jenkins LTS 이미지를 베이스로 사용
FROM jenkins/jenkins:lts

USER root

# 필요한 패키지 설치 및 Docker 저장소 추가
RUN apt-get update && \
    apt-get -y install apt-transport-https ca-certificates curl gnupg2 && \
    curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg && \
    echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian $(grep VERSION_CODENAME /etc/os-release | cut -d'=' -f2) stable" > /etc/apt/sources.list.d/docker.list && \
    apt-get update && \
    apt-get -y install docker-ce-cli
    
# Docker Compose 설치
RUN curl -L "https://github.com/docker/compose/releases/download/v2.21.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && \
    chmod +x /usr/local/bin/docker-compose
    
USER jenkins

이미지 빌드 및 실행

docker build -t jenkins-with-docker .
docker run -d -p 8080:8080 -p 50000:50000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /home/junu/docker_data/jenkins:/var/jenkins_home \
  --name jenkins jenkins-with-docker

Dockerfile을 사용해 Docker CLI가 미리 설치된 Jenkins 이미지를 빌드한 후, 이를 Docker 명령어로 실행하여 Jenkins와 Docker를 함께 사용하는 환경을 구축합니다.

Dockerfile을 이용한 Docker Compose로 Jenkins 컨테이너 내 Docker 설치

Dockerfile과 Docker Compose를 함께 사용해 Docker CLI가 설치된 Jenkins 이미지를 빌드하고 관리하는 방법입니다.

Dockerfile 작성 및 저장

# Jenkins LTS 이미지를 베이스로 사용
FROM jenkins/jenkins:lts

USER root

# 필요한 패키지 설치 및 Docker 저장소 추가
RUN apt-get update && \
    apt-get -y install apt-transport-https ca-certificates curl gnupg2 && \
    curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg && \
    echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian $(grep VERSION_CODENAME /etc/os-release | cut -d'=' -f2) stable" > /etc/apt/sources.list.d/docker.list && \
    apt-get update && \
    apt-get -y install docker-ce-cli
    
# Docker Compose 설치
RUN curl -L "https://github.com/docker/compose/releases/download/v2.21.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && \
    chmod +x /usr/local/bin/docker-compose
    
USER jenkins

docker-compose.yml 작성

version: '3.9'

services:
  jenkins:
    build: .
    container_name: jenkins
    ports:
      - "8080:8080"
      - "50000:50000"
    volumes:
      - /home/junu/docker_data/jenkins:/var/jenkins_home
      - /var/run/docker.sock:/var/run/docker.sock
networks: {}

이미지 빌드 및 Compose 실행

docker-compose up --build -d

Dockerfile을 사용하여 Docker가 설치된 Jenkins 이미지를 빌드하고 Docker Compose를 통해 Jenkins와 Docker를 함께 사용하는 환경을 구축하는 방법을 설명합니다. 이를 통해 Jenkins 컨테이너 내에서 Docker 명령어를 실행할 수 있게 설정합니다.

4. Jenkins와 GitHub 연동 및 JAR 파일 Docker 컨테이너에 배포

4.1 Dockerfile 사용하여 배포하는 방식

Dockerfile을 소스에 미리 생성해 놓고 Jenkins 파이프라인에서 이를 활용하여 Docker 이미지를 빌드하고 배포하는 방식입니다.

Dockerfile (프로젝트 루트에 생성된 파일)

FROM openjdk:17-jdk-slim

WORKDIR /app
COPY build/libs/movie-search-app.jar app.jar

ENTRYPOINT ["java", "-jar", "app.jar"]

파이프라인 스크립트(Jenkinsfile) 작성

pipeline {
    agent any

    stages {
        stage('Clone Repository') {
            steps {
                // 소스 코드 클론
                git url: 'https://github.com/ssongjunu/movie-search-app.git', branch: 'main'
            }
        }

        stage('Build') {
            steps {
                // Gradle 빌드를 위한 실행 권한 부여 및 빌드
                sh 'chmod +x ./gradlew'
                sh './gradlew clean build'
            }
        }
        
        stage('Test') {
            steps {
                // Gradle 테스트 실행
                sh './gradlew test'
            }
        }

        stage('Deploy Docker Container') {
            steps {
                script {
                    def imageName = "movie-search-app-image"
                    def containerName = "movie-search-app-container"

                    // 기존 Docker 컨테이너 삭제
                    sh "docker rm -f ${containerName} || true"

                    // 기존 Docker 이미지 삭제 후 다시 빌드
                    sh "docker rmi ${imageName} || true"

                    // Docker 이미지 빌드 (Dockerfile 사용)
                    sh "docker build -t ${imageName} ."

                    // 새로운 Docker 컨테이너 실행
                    sh "docker run -d --name ${containerName} -p 8080:8080 ${imageName}"
                }
            }
        }
    }

    post {
        success {
            echo 'Build, tests, and deployment were successful!'
        }
        failure {
            echo 'Build, tests, or deployment failed.'
        }
    }
}

4.2 Docker Compose를 사용한 배포 방식

Docker Compose.yml 파일 (프로젝트 루트에 생성된 파일)

version: '3.9'

services:
  movie-search-app:
    image: openjdk:17-jdk-slim
    container_name: movie-search-app
    ports:
      - "8081:8080"
    volumes:
      - /home/junu/docker_data/jenkins/workspace/movie-search-app/build/libs/movie-search-app.jar:/app/app.jar # 절대경로
    working_dir: /app
    command: ["java", "-jar", "app.jar"]

파이프라인 스크립트(Jenkinsfile) 작성

pipeline {
    agent any

    stages {
        stage('Clone Repository') {
            steps {
                // 소스 코드 클론
                git url: 'https://github.com/ssongjunu/movie-search-app.git', branch: 'main'
            }
        }

        stage('Build') {
            steps {
                // Gradle 빌드를 위한 실행 권한 부여 및 빌드
                sh 'chmod +x ./gradlew'
                sh './gradlew clean build'
            }
        }

        stage('Test') {
            steps {
                // Gradle 테스트 실행
                sh './gradlew test'
            }
        }

        stage('Deploy Docker Compose') {
            steps {
                script {
                    // Docker Compose를 사용해 컨테이너 배포
                    sh 'docker-compose down || true' // 기존 컨테이너 종료
                    sh 'docker-compose up --build -d' // 새로운 컨테이너 빌드 및 실행
                }
            }
        }
    }

    post {
        success {
            echo 'Build, tests, and deployment were successful!'
        }
        failure {
            echo 'Build, tests, or deployment failed.'
        }
    }
}

5. 배포 확인

배포가 성공적으로 완료되면, Jenkins 콘솔 출력을 통해 확인할 수 있으며 애플리케이션은 지정된 포트에서 정상적으로 동작해야 합니다.

6. 마치며

이 글에서는 Jenkins와 GitHub을 연동하여 지속적 배포(CD)를 설정하고, 빌드된 애플리케이션을 Docker 컨테이너에 배포하는 방법을 다뤘습니다. Docker 소켓을 공유하여 Jenkins가 Docker 명령어를 실행할 수 있도록 설정하는 과정과, Docker Compose를 이용한 배포 방법을 설명했습니다. Docker Compose 파일은 프로젝트의 루트 디렉토리에 생성하고 GitHub 저장소에 포함시켜 팀원들과 공유하는 것이 좋습니다. 이를 통해 CI/CD 파이프라인을 더 효율적으로 관리할 수 있습니다.

[Docker] Jenkins와 GitHub 연동하기: 지속적 통합(Continuous Integration, CI)

키큰난쟁이 — Sat, 5 Oct 2024 01:21:05 +0900

2024.10.04 - [데브옵스/CICD] - Docker로 Jenkins 설치하기: 단계별 가이드

Docker로 Jenkins 설치하기: 단계별 가이드

2024.09.30 - [데브옵스/Docker] - Ubuntu에 Docker 설치 Ubuntu에 Docker 설치1. 들어가며1.1 Docker 란?Docker는 애플리케이션을 개발, 배포, 실행하기 위한 오픈소스 플랫폼입니다. 컨테이너라는 격리된

bigdwarf.blog

1. 들어가며

지속적 통합(Continuous Integration, CI)은 현대 소프트웨어 개발에서 필수적인 프로세스입니다. CI를 통해 개발자들은 코드 변경사항을 주기적으로 통합하고 자동화된 빌드와 테스트를 수행하여 소프트웨어의 품질을 지속적으로 유지할 수 있습니다. 이번 글에서는 Jenkins와 GitHub을 연동하여 빌드까지 하는 방법을 설명합니다. 이를 통해 코드 변경 시 자동으로 빌드 및 테스트를 수행 할 수있어 개발 프로세스의 효율성을 크게 높일 수 있습니다.

2. Jenkins와 GitHub 연동 하기

2.1 GitHub 자격 증명 추가 GitHub Repository에서 Token 발급

Github → 우측 상단 유저 아이콘 → Settings → Developer settings → Personal access tokens → Tokens (classic)
아래 화면과 같은 페이지에서 Generate new token (Classic) 클릭

토큰 이름을 설정 후 repo, admin_hook 체크 후 Generate token 클릭

아래 화면과 같이 토큰을 확인 하실 수 있습니다.
발급 받은 token은 다시 볼 수 없기에 따로 보관 해두시길 바랍니다.

2.2 Jenkins Plugin 설치

Dashboard → Jenkins 관리 → Plugins → Available plugins

GitHub Integration Plugin 설치
Generic Webhook Trigger Plugin 설치
GitHub API Plugin 설치

이 글에 선 GitHub API Plugin 미리 설치가 되어있습니다.

설치가 진행되고 완료되면 Jenkins를 재시작 바랍니다.

2.3 Jenkins Credentials 생성

Dashboard → Jenkins 관리 → Credentials

Stores scoped to Jenkins → Store (System) → (global) 클릭

Add Credentials 클릭

Username : GitHub 아이디
Password : 발급 받은 GitHub token
ID : Credentials
Description : 설명 (옵션)
위내용을 작성 후 Create 클릭

2.4 Jenkins Pipeline 설정

Pipeline 생성 후 Pipeline 명 → 구성(Configuration)

General → GitHub project → Project url 작성

Build Triggers → GitHub hook trigger for GITScm polling 체크

Repository URL : 자동 배포하려는 GitHub Repository URL
Credentials : Github의 Webhook을 통해 빌드하기 위해 생성한 Credentials 선택
Branch Specifier : 가져오려는 프로젝트에 Branch
Script Path : 프로젝트 루트 기준 Jenkinsfile의 위치
위 내용을 작성 한 뒤 저장 클릭

2.5 파이프라인 스크립트(Jenkinsfile) 작성

프로젝트 내 루트에 Jenkinsfile 생성 후 아래 내용 저장 (원하는 위치 지정 가능합니다.)
이 글에서는 Spring Boot Gradle 프로젝트로 진행했습니다.

pipeline {
    agent any

    stages {
        stage('Clone Repository') {
            steps {
                git url: 'https://github.com/ssongjunu/movie-search-app.git', branch: 'main'
            }
        }

        stage('Build') {
            steps {
                // gradlew 파일에 실행 권한 부여 후 빌드
                sh 'chmod +x ./gradlew'
                sh './gradlew clean build'
            }
        }
        
        stage('Test') {
            steps {
                // Gradle 테스트 실행
                sh './gradlew test'
            }
        }
    }

    post {
        success {
            echo 'Build and tests were successful!'
        }
        failure {
            echo 'Build or tests failed.'
        }
    }
}

2.6 GitHub Repository Webhooks 설정

GitHub Repository → Settings → Webhooks → Add webhook
Payload URL : http://JenkinsURL/github-webhook/
Content type : application/json
위내용 입력 후 Add webhook 클릭

2.7 빌드 테스트 진행

지금 빌드 클릭

Build 콘솔 확인

3. 마치며

Jenkins와 GitHub의 연동은 처음에는 복잡해 보일 수 있지만 일단 설정이 완료되면 개발 워크플로우를 크게 개선할 수 있습니다. 또한 Docker를 활용한 Jenkins 구축은 설치와 관리의 편의성을 높여줍니다. 앞으로 CI를 어 CD(Continuous Delivery 또는 Deployment)까지 확장하여 전체 개발 파이프라인을 자동화하는 것을 고려해볼 수 있습니다. 이는 소프트웨어 제공 속도를 더욱 높이고 운영 효율성을 개선하는 데 도움이 될 것입니다. CI/CD 도구와 방법론은 계속해서 발전하고 있으므로 최신 트렌드와 베스트 프랙티스를 지속적으로 학습하고 적용하는 것이 중요합니다. Jenkins와 GitHub을 시작으로 여러분의 개발 프로세스를 지속적으로 개선해 나가시기 바랍니다.

Docker로 Jenkins 설치하기: 단계별 가이드

키큰난쟁이 — Fri, 4 Oct 2024 01:49:51 +0900

2024.09.30 - [데브옵스/Docker] - Ubuntu에 Docker 설치

Ubuntu에 Docker 설치

1. 들어가며1.1 Docker 란?Docker는 애플리케이션을 개발, 배포, 실행하기 위한 오픈소스 플랫폼입니다. 컨테이너라는 격리된 환경에서 애플리케이션을 패키징하고 실행할 수 있게 해 줍

bigdwarf.blog

1. 들어가며

1.1 Jenkins와 Docker의 개요

Jenkins : 소프트웨어 개발에서 지속적 통합 및 지속적 배포(CI/CD)를 자동화하는 강력한 오픈소스 도구
Docker : 애플리케이션을 컨테이너 화하여 일관된 환경에서 실행할 수 있게 해주는 플랫폼

이 글에서는 Ubuntu 24.04 LTS 환경에서 Docker를 사용하여 Jenkins를 설치하고 설정하는 방법을 단계별로 안내합니다.

1.2 왜 Docker로 Jenkins를 설치하는가?

Docker를 사용하여 Jenkins를 설치하면 환경 일관성, 쉬운 업그레이드, 빠른 배포 및 확장성 등 여러 이점을 얻을 수 있습니다. 또한, 호스트 시스템에 직접 설치하는 것보다 격리된 환경에서 Jenkins를 실행할 수 있어 보안성도 향상됩니다.

2. 사전 준비

2.1 시스템 요구사항

최소 2GB RAM (4GB 이상 권장)
10GB 이상의 여유 디스크 공간

2.2 Docker 및 Docker Compose 설치 확인

다음 명령어로 Docker가 정상적으로 설치되었는지 확인

docker --version
docker run hello-world

Docker Compose도 설치되어 있는지 확인

docker-compose --version

Dokcer Compose가 설치가 안되어있을 경우

1. Docker Compose 최신 버전 다운로드

curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

2. Docker Compose 파일에 실행 권한 부여

chmod +x /usr/local/bin/docker-compose

3. 심볼릭 링크 생성 (선택 사항)

만약 docker-compose 명령어가 /usr/local/bin에 없을 경우, 심볼릭 링크를 만들어줄 수 있습니다.

ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

3. Host 시스템에 컨테이너 데이터 디렉토리 생성

3.1 디렉토리 생성 및 권한 설정

Jenkins 데이터 디렉토리 생성 (원하는 폴더 위치에 생성해주시면 됩니다.)

mkdir -p /home/user/jenkins_home

이글에선 아래와 같이 생성하였습니다.

mkdir -p /home/junu/docker_data/jenkins
chown -R junu:junu /home/junu/docker_data

4. Jenkins 설치 방법 1: Docker 명령어 사용

4.1 Jenkins Docker 이미지 다운로드

Java 버전에 따라 버전을 선택해서 설치해주시길 바랍니다.
다음 명령어로 Jenkins LTS 이미지를 다운로드

docker pull jenkins/jenkins:lts

4.2 Jenkins 컨테이너 실행

docker run -d \
  --name jenkins \
  -p 8080:8080 \
  -p 50000:50000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /home/junu/docker_data/jenkins:/var/jenkins_home \
  jenkins/jenkins:lts

4.3 포트 매핑 및 볼륨 설정 설명

-p 8080:8080: Jenkins 웹 인터페이스용 포트
-p 50000:50000: Jenkins 에이전트 통신용 포트
-v /home/junu/docker_data/jenkins:/var/jenkins_home: 호스트의 Jenkins 데이터 디렉토리를 컨테이너에 마운트
-v /var/run/docker.sock:/var/run/docker.sock: 호스트의 Docker 소켓을 컨테이너에 마운트 (선택사항)

이렇게 구성하면 Jenkins 데이터의 안전한 보관과 효율적인 관리가 가능해지며 Docker의 이점을 최대한 활용할 수 있습니다.

4.4 Jenkins 웹 접속

http://IP:8080 접속 (위에서 설정한 포트)

5. Jenkins 설치 방법 2: Docker Compose 사용

Docker Compose를 사용하면 여러 컨테이너를 쉽게 관리할 수 있으며, 설정을 파일로 버전 관리할 수 있습니다.

5.1 docker-compose.yml 파일 작성

docker-compose.yml 작성

vi docker-compose.yml

version: '3.9'
services:
  jenkins:
    image: jenkins/jenkins:lts
    container_name: jenkins # 컨테이너 이름을 명시적으로 표시하기 위해 추가
    ports:
      - "8080:8080"
      - "50000:50000"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /home/junu/docker_data/jenkins:/var/jenkins_home

5.2 Docker Compose로 Jenkins 실행

다음 명령어로 Jenkins를 실행

docker-compose up -d

Docker Compose Down 명령

Docker Compose Down 명령

docker-compose down

Docker Compose Down 추가 옵션

--volumes: 정의된 볼륨도 함께 삭제하고 싶을 때 사용합니다. (주의: 데이터가 삭제될 수 있으므로 중요 데이터는 백업하는 것이 좋습니다.)

docker-compose down --volumes

--rmi: 사용한 이미지를 제거하고 싶을 때 사용할 수 있습니다.
- local: 프로젝트에서 생성한 이미지만 삭제
- all: 모든 이미지를 삭제

docker-compose down --rmi all

이렇게 하면 docker-compose up으로 올린 서비스를 안전하게 중지할 수 있습니다.

5.3 Jenkins 웹 접속

http://IP:8080 접속 (위에서 설정한 포트)

6. Jenkins 초기 설정

6.1 관리자 비밀번호 확인

다음 명령어로 초기 관리자 비밀번호를 확인

docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword

아래에 콘솔 화면에 초기 비밀번호를 확인하실 수 있습니다.

6.2 플러그인 설치 옵션

Install suggested plugins 클릭 (추후 필요한 플러그인은 따로 설치하실 수 있습니다.)

6.3 관리자 계정 생성 및 Jenkins URL을 설정

6.4 계정 생성 및 설치 완료

7. 마치며

이 가이드를 통해 Ubuntu 24.04 LTS에서 Docker를 사용하여 Jenkins를 설치하고 기본적인 설정을 완료할 수 있습니다. 추가적인 설정이나 고급 기능은 프로젝트의 요구사항에 따라 적용하시기 바랍니다.

Ubuntu에 Docker 관리툴 Dockge 설치

키큰난쟁이 — Tue, 1 Oct 2024 01:18:31 +0900

2024.09.30 - [데브옵스/Docker] - Ubuntu에 Docker 설치

Ubuntu에 Docker 설치

bigdwarf.blog

1. 들어가며

1.1 Dockge 란?

Dockge는 Docker 컨테이너와 스택을 관리하기 위한 웹 기반 GUI 도구입니다. 사용자 친화적인 인터페이스를 통해 Docker 컨테이너를 쉽게 관리할 수 있게 해 줍니다.

1.2 Dockge를 선택한 이유

Portainer와 같은 다른 Docker 관리 도구도 있지만, Dockge를 선택한 이유 아래와 같습니다.

경량화: Dockge는 Portainer보다 더 가볍고 리소스 사용이 적습니다.
단순성: 사용자 인터페이스가 직관적이고 간단하여 학습 곡선이 낮습니다.
스택 중심 관리: Docker Compose 파일을 기반으로 한 스택 관리에 특화되어 있습니다.
오픈소스: 활발한 커뮤니티 지원과 지속적인 업데이트가 이루어집니다.

2. 사전 준비

2.1 시스템 요구사항

Docker가 설치된 환경
최소 1GB의 여유 RAM

2.2 Docker 설치 확인

docker --version

3. Dockge 설치 과정

3.1 Dockge 디렉터리 생성

mkdir -p /opt/stacks /opt/dockge

3.2 Dockge 디렉터리로 이동

cd /opt/dockge

3.3 Docker Compose 파일 다운로드

curl -fsSL https://raw.githubusercontent.com/louislam/dockge/master/compose.yaml -o compose.yaml

3.4 Dockge 실행

docker compose up -d

4. Dockge 초기 설정

4.1 Dockge 웹 인터페이스 접속

브라우저에서 http://localhost:5001 접속

4.2 Dockge 언어설정 및 계정 생성

언어 설정 및 계정 생성 해주시면 됩니다.

설정 후 아래 Dockge 메인대시보드를 보실 수 있습니다.

5. 마무리

Dockge는 Ubuntu 24.04 LTS 환경에서 Docker 컨테이너와 스택을 관리하기 위한 강력하고 사용자 친화적인 도구입니다. 이 가이드를 통해 Dockge를 성공적으로 설치하고 초기 설정을 완료했습니다.

Ubuntu에 Docker 설치

키큰난쟁이 — Mon, 30 Sep 2024 23:59:03 +0900

1. 들어가며

1.1 Docker 란?

Docker는 애플리케이션을 개발, 배포, 실행하기 위한 오픈소스 플랫폼입니다. 컨테이너라는 격리된 환경에서 애플리케이션을 패키징하고 실행할 수 있게 해 줍니다.

1.2 Docker를 사용하는 이유

일관된 환경: 개발, 테스트, 프로덕션 환경을 동일하게 유지
리소스 효율성: 가상 머신보다 더 가볍고 빠름
확장성: 쉽게 애플리케이션을 확장하고 배포할 수 있음

2. 사전준비

2.1 시스템 요구사항

Linux, Window, Mac 운영체제
64비트 아키텍처
Virtualization 지원
최소 2GB RAM 이상 필요 4GB 이상 권장
디스크 공간 최소 10GB

2.2 필요한 권한

sudo 권한이 있는 사용자 계정

2.3 실행 환경 확인

lsb_release -a
No LSB modules are available.
Distributor ID: Ubuntu
Description:    Ubuntu 24.04.1 LTS
Release:        24.04
Codename:       noble

3. Docker 설치 과정

3.1 시스템 업데이트

apt update && apt upgrade -y

3.2 필수 패키지 설치

apt install apt-transport-https ca-certificates curl software-properties-common

3.3 Docker GPG 키 추가

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

3.4 Docker 리포지토리 추가

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null

3.5 Docker 설치

apt update
apt install docker-ce docker-ce-cli containerd.io

3.5 Docker 서비스 시작 및 활성화

systemctl start docker
systemctl enable docker

3.6 설치 확인 및 실행

docker --version
docker run hello-world

4. 사용자 Docker 그룹에 추가

usermod -aG docker $USER

이 명령 후 로그아웃 후 다시 로그인하세요.

5. 마무리

Docker를 성공적으로 설치하고 기본 사용법을 익혔습니다. 이제 컨테이너화된 애플리케이션을 개발하고 배포할 준비가 되었습니다. Docker의 강력한 기능을 활용하여 개발 workflow를 개선하고 애플리케이션 배포를 간소화할 수 있습니다.

Promox VM 생성 및 설치

키큰난쟁이 — Sun, 29 Sep 2024 00:10:26 +0900

2024.09.12 - [서버/Hypervisor] - Proxmox 설치 및 초기 설정

1. 사전 준비

1.1 Proxmox VM에 올릴 ISO 파일 다운로드

저는 Ubuntu를 VM에 올리겠습니다. Ubuntu 24.04 아래 링크 통해서 다운로드 바랍니다.

[다운로드 링크]

https://ubuntu.com/download/server

ubuntu.com

저는 서버용으로 설치 할 거라 Ubuntu 24.04 LTS Server로 설치
필요에 따라 Desktop 버전으로 설치도 진행하셔도됩니다.

1.2 Proxmox VE에 ISO 파일 업로드

Promox 관리 콘솔 로그인하셔서 아래 화면 처럼 iso 이미지를 업로드

아래 화면 같이 TASK OK 까지 뜨면 업로드가 완료

2. Proxmox VM 생성 및 설치

2.1 Proxmox VM 생성

Promox 관리 콘솔 우측 상단 VM 생성 클릭

여기서 VM 이름을 정해주시고 다음 클릭

설치 할 업로드된 이미지 파일을 선택 후 다음

시스템 설정은 디폴트로 진행 다음 클릭

스토리지/디스크 크기 지정 후 캐시는 Write back으로 진행 다음 클릭

CPU 코어수 지정 후 다음 클릭

메모리 지정 후 저는 8GB 지정 후 다음 클릭

네트워크 부분은 디폴트 값으로 진행 다음 클릭

마지막으로 설정했던 부분 확인 후 마침 클릭

완료되면 오른쪽 데이터센터 부분을 보시면 생성된 VM 100(Ubuntu-SV)를 확인해보실수있습니다.

VM 시작하시고 Ubuntu 설치를 진행

2.2 Proxmox VM 설치

2024.09.09 - [운영체제/Linux] - 우분투(Ubuntu) 22.04 LTS Server 설치

XSS(Cross-Site Scripting) : 공격 유형, 예상 시나리오, 방어 기법

키큰난쟁이 — Sat, 28 Sep 2024 01:09:06 +0900

1. XSS(Cross-Site Scripting) 란?

XSS는 웹 애플리케이션의 취약점을 이용해 악성 스크립트를 삽입하는 공격 기법입니다. 공격자가 삽입한 스크립트가 다른 사용자의 브라우저에서 실행되어 사용자의 정보를 탈취하거나 악의적인 행동을 수행할 수 있습니다.

2. XSS(Cross-Site Scripting) 주요 특징

웹사이트 관리자가 아닌 공격자가 웹 페이지에 스크립트를 삽입합니다.
주로 사용자 입력값을 제대로 검증하지 않고 사용할 때 발생합니다.
공격자는 사용자의 쿠키, 세션 등 중요 정보를 탈취하거나 비정상적인 기능을 수행하게 할 수 있습니다.
SQL injection과 함께 가장 기초적인 웹 취약점 공격 방법 중 하나입니다.

3. XSS(Cross-Site Scripting) 공격 유형 및 시나리오

3.1 Stored XSS (저장형)

서버에 악성 스크립트를 저장하여 지속적으로 공격하는 방식입니다. 주로 게시판, 댓글 등에서 발생합니다.

예상 시나리오
1. 공격자는 웹사이트의 게시판이나 댓글 기능을 통해 위와 같은 스크립트를 삽입합니다. 이 스크립트는 서버에 저장됩니다.
2. 이후 해당 게시글이나 댓글을 방문하는 모든 사용자는 페이지가 로드될 때마다 자동으로 window.location.href를 통해 네이버(https://naver.com)로 리디렉션 됩니다.

<script>
  window.onload = function() {
    window.location.href = "https://naver.com";
  };
</script>

3.2 Reflected XSS (반사형)

URL 파라미터 등을 통해 전달된 악성 스크립트가 즉시 실행되는 방식입니다.

예상 시나리오
1. 사용자가 특정 링크(예: http://bigdwarf.blog/search?param=<script>alert('안녕하세요.')</script>)를 클릭하면, 서버는 param 파라미터의 값을 응답 페이지에 반사하여 사용자의 브라우저에서 악성 스크립트를 실행합니다.
2. 결과적으로, alert(' 안녕하세요.')가 실행되어 브라우저에 경고창이 뜨게 됩니다.

http://bigdwarf.blog/search?param=<script>alert('안녕하세요.')</script>

3.3 DOM-based XSS

DOM-based XSS는 서버가 아닌 클라이언트 측 즉 브라우저에서 동적으로 생성된 DOM(Document Object Model) 요소에 의해 발생하는 XSS 공격입니다. 이 유형의 XSS는 서버와 상관없이 클라이언트 측 자바스크립트 코드가 잘못된 사용자 입력을 DOM에 직접 반영하면서 발생합니다.

예상 시나리오
1. 사용자가 아래와 같은 URL을 방문합니다.
2. 페이지 로드 시 클라이언트 측 자바스크립트 코드가 URL의 해시 값(#user=...)을 읽어 DOM에 반영하도록 되어 있다고 가정합니다.
3. 자바스크립트 코드가 URL 해시 값에 포함된 <script> 태그를 DOM에 추가하면서 악성 스크립트가 브라우저에서 실행됩니다.
4. 결과적으로 alert('DOM XSS')가 실행되어 경고창이 뜨게 됩니다.

URL: http://bigdwarf.blog#user=<script>alert('DOM 안녕하세요.')</script>

<script>
  window.onload = function() {
    // URL의 해시(#) 부분을 가져와서 userName이라는 ID를 가진 요소에 삽입
    var userInput = window.location.hash.substring(1);
    document.getElementById("userName").innerHTML = userInput;
  };
</script>

4. XSS(Cross-Site Scripting) 방어 기법

4.1 입력 검증 및 필터링

사용자 입력을 받는 모든 곳에서 입력값을 철저히 검증하고 필터링해야 합니다. 필터링에는 화이트리스트 기반 접근 방식이 가장 효과적입니다. 예를 들어 사용자 이름에는 알파벳과 숫자만 허용하는 정규 표현식을 사용할 수 있습니다.

function validateInput(input) {
  // 사용자 이름은 알파벳과 숫자만 허용
  var regex = /^[a-zA-Z0-9]+$/;
  if(!regex.test(input)) {
    throw new Error('Invalid input');
  }
  return input;
}

또한, HTML 특수 문자를 이스케이프 하여 스크립트가 실행되지 않도록 해야 합니다.

function escapeHTML(str) {
  return str.replace(/[&<>"']/g, function(match) {
    return {
      '&': '&amp;',
      '<': '&lt;',
      '>': '&gt;',
      '"': '&quot;',
      "'": '&#39;'
    }[match];
  });
}

4.2 출력 인코딩

서버에서 동적으로 생성된 콘텐츠를 클라이언트에 출력할 때는 반드시 적절한 인코딩을 적용해야 합니다. 예를 들어 HTML 콘텐츠를 출력할 때는 아래와 같은 방식으로 인코딩할 수 있습니다.

function encodeForHTML(content) {
  return content.replace(/&/g, '&amp;')
                .replace(/</g, '&lt;')
                .replace(/>/g, '&gt;')
                .replace(/"/g, '&quot;')
                .replace(/'/g, '&#39;');
}

이와 같은 방식으로 자바스크립트, CSS, URL 등의 다른 컨텍스트에서도 각각 적절한 인코딩 방식을 적용해야 합니다.

4.3 Content Security Policy (CSP) 사용

CSP는 스크립트 소스, 스타일시트 소스, 이미지 소스 등을 제어하여 XSS 공격을 방지할 수 있는 강력한 도구입니다. 기본적으로 신뢰할 수 있는 소스만 실행하도록 제한할 수 있습니다.

Content-Security-Policy: default-src 'self'; script-src 'self' https://bigdwarf.blog;

이 정책은 스크립트가 'self' (현재 도메인)와 https://bigdwarf.blog에서만 로드될 수 있도록 허용합니다.

4.4 HttpOnly 쿠키 사용

쿠키에 HttpOnly 속성을 추가하면 클라이언트 측 스크립트에서 쿠키에 접근할 수 없게 됩니다. 이로 인해 XSS 공격으로부터 세션 쿠키가 보호됩니다.

Set-Cookie: sessionId=abc123; HttpOnly; Secure; SameSite=Strict;

HttpOnly: 자바스크립트에서 쿠키 접근을 차단합니다.
Secure: HTTPS를 통해서만 쿠키가 전송됩니다.
SameSite=Strict: 동일한 사이트에서만 쿠키가 전송되도록 제한합니다.

4.5 그 외 여러 방법

템플릿 엔진 사용: 템플릿 엔진(예: Thymeleaf, Handlebars 등)을 사용할 때 기본적으로 XSS 공격을 예방하는 메커니즘이 적용되는 점을 설명할 수 있습니다.
프레임워크 레벨 보안 기능: 다양한 웹 프레임워크(Spring, Django 등)에서 제공하는 기본적인 XSS 방어 기능에 대해 설명하고, 이러한 기능을 활성화하는 방법을 다룰 수 있습니다.
도구를 사용한 정적 분석: SonarQube, Fortify 같은 정적 분석 도구를 사용하여 코드에서 잠재적인 XSS 취약점을 탐지하는 방법을 소개할 수 있습니다.
보안 테스트: OWASP ZAP, Burp Suite와 같은 도구를 사용해 XSS 취약점을 스캔하고 제거하는 방법을 설명할 수 있습니다.

5. 마무리

앞서 설명한 방법들은 XSS 공격을 방지하는 데 있어 강력한 방어 수단이 될 수 있으며, 이를 통해 여러분의 웹 애플리케이션을 보다 안전하게 보호할 수 있습니다. 하지만 보안은 한 번의 조치로 끝나는 것이 아니라, 지속적인 점검과 개선이 필요한 과정입니다. 따라서 정기적으로 보안 테스트를 실시하고, 최신 보안 동향을 파악하여 꾸준히 웹 애플리케이션의 보안을 강화하는 노력이 필요합니다. XSS 공격에 대한 철저한 대비를 통해, 신뢰할 수 있는 안전한 웹 환경을 구축하시기 바랍니다.

나의 홈서버 구축 후 현재까지

키큰난쟁이 — Thu, 26 Sep 2024 03:41:05 +0900

2~3년 전, 결혼한 지 얼마 되지 않고 용돈으로 생활할 시기에 평소 서버와 개발공부할 겸 홈서버용 PC를 가지고 싶다는 생각을 가지고 있었다. 당시에 서버용도로 PC를 하나 살까 고민하던 찰나에 집 한구석에 자리 잡고 있던 시놀로지 NAS가 생각났다. 그렇게 NAS를 바라보며 고민에 빠지며 ‘이걸로 활용해 볼까?’ 생각했지만 NAS의 사양은 그리 좋지 않았고 무엇보다도 중요한 자료들이 잔뜩 들어 있어 함부로 실험대상으로 삼기엔 너무나도 아까웠다. 그렇게 고민하던 중 1개월 채 되지도 않던 어느 날 우연히 유튜브를 보다가 마치 운명처럼 한 테크 유튜버의 새 영상을 보게 되는데...?

뻘짓연구소 자작나스 영상

그렇게 운명처럼 보게 된 영상은 한 줄기 빛이었다. 영상 초반, 메인보드, CPU, 그리고 램을 포함해 겨우 15만 원이라는 가격이 눈에 들어왔고 더욱 놀라운 건 이 CPU가 비록 14nm 브로드웰 아키텍처로 당시에도 다소 오래된 모델이었지만 무려 16 코어 32 스레드를 자랑하는 것이었다. 당시 돈이 없던 내게 이 영상은 마치 어두운 터널 끝에서 반짝이는 희망의 빛처럼 느껴졌고 결국 타오바오를 통해 이 부품을 직구를 했고 그렇게 부품을 차곡차곡 모으다 보니 얼마 지나지 않아 아래의 표처럼 홈서버용 PC의 모든 부품을 모으는 데 성공했다. 대략 40만 원 정도 들인 것 같다.

구분	내용
CPU	Intel Xeon D-1581
메인보드	HSGM- D1581_R3 (제조사 : 중국)
램	64GB RAM DDR3L 16GB x2
파워	MegaMax 500W 80PLUS STANDARD ATX ZM500-TX2
SSD	SSD : 500GB x 1 / HDD : 4TB x 1

마침내 모든 부품이 배송되었고 기쁜 마음으로 조립을 시작 홈서버용 PC를 조립하고 16 코어 32 스레드나 되는 자원을 나눠 사용할 수 있도록 ESXi 6.7을 설치를 진행했다.

그러나....

문제가 발생했다. 설치 과정 중 화면은 그대로 프리징 현상처럼 멈춰버린 것! 혹시나 하는 마음에 윈도우 설치도 시도해 봤지만 똑같이 설치 과정에서 멈춰버리는 것이다. 문제를 해결하기 위해 메인보드에 Q-CODE도 확인해 보고 재조립도 해보고 램을 다른 것으로 교체해 보고 HDD도 다른 것을 사용해 보는 등 여러 가지 방법을 시도했지만 문제는 해결되지 않았다. 바이오스에서는 램 SSD, HDD, USB 모두 잘 인식되었지만 OS 설치 시마다 프리징 현상이 발생하는 문제는 끝내 해결되지 않았다. 결국 문제를 해결하지 못한 채 포기했다. 내 생각에는 메인보드에 문제가 있지 않았나 싶다. 그렇게 구매한 부품들은 창고행이 돼버릴 뻔했지만 며칠 안 돼서 마침 아버지가 집에 데스크탑이 필요하다고 컴퓨터 좀 알아봐 달라고 연락이 왔다. 아버지께 집에 남는 부품이 있으니 조립해서 드린다고 말씀드리고 당근마켓에서 CPU와 메인보드 세트를 구매하고 조립해서 윈도우까지 설치해서 아버지께 드렸다. 그 과정에서 수고비로 용돈 하라고 하시면서 30만 원을 받았다. 근데 30만 원이 생기니까. 다시 홈서버용 PC를 구매하기 위해 다시 검색을 했다. ㅋㅋㅋㅋ 그렇게 찾던 중에 컴퓨존에서 핫딜로 나온 사무용 PC를 발견!!!

이 사양은 서버용으로도 충분히 적합하다고 판단돼서 30만 원과 추가적인 지출을 합쳐 PC를 바로 구매했고 PC가 도착하자마자 집에 있던 RAM과 SSD, HDD를 추가했다. 램은 64GB로 증설했고 SSD는 1TB와 2TB를 그리고 HDD 4TB 각각 하나씩 추가해 저장 공간을 넉넉하게 업그레이드했고 후에 조립된 홈서버 PC에 ESXi 대신 오픈소스 가상화 플랫폼인 Proxmox를 설치하기로 결정했다. Proxmox는 무료이면서도 강력한 기능을 제공해 홈서버를 운영하는 데 최적의 선택이었고 설치 과정은 문제없었고 드디어 첫 홈서버 컴퓨터가 완성되었다!!!

이제 꿈꿨던 홈서버와 서버 및 개발 공부를 다양한 프로젝트들을 실현하면서 데이터 백업부터 가상 머신 관리 그리고 개발 환경 구축까지 이 서버를 통해 다양한 실험과 학습을 진행할 수 있게 되었다.

그렇게 첫 홈서버 컴퓨터를 완성한 이후, 2년의 시간이 흘렀다. 이 기간 동안 서버는 워드프레스와 라이믹스 블로그 서버가 되고 또 게임서버가 되면서 다양한 프로젝트와 실험을 뒷받침하며 충실히 서버의 역할을 다해주었다. 하지만 어느 날 서버에서 이상한 소리가 들리기 시작했다. 고주파음이 들려왔고 그 원인은 다름 아닌 HDD 였다. 어차피 2년 정도 됐기도 했고 컴퓨터 내부 청소와 HDD 교체할 겸 서버 백업 하고 난 뒤 안전하게 종료하고 컴퓨터를 꺼냈다.

사진으로 봤을때 먼지가 많이 없어 보이는데 정말 많았다. 고주파 소리가 나던 HDD 탈거하고 대신 SSD를 2TB로 업그레이드해줬다. 그리고 먼지 청소를 위해 부모님 댁으로 가서 컴프레서를 사용해 먼지를 털어냈고 집에 와서 Promox를 재설치해주었다. 백업한 데이터는 현재로선 티스토리 블로그로 옮겼기 때문에 굳이 복구시키지 않았다.

2024.09.12 - [서버/Hypervisor] - Proxmox 설치 및 초기 설정

Proxmox 설치 및 초기 설정

1. 들어가며 개인 서버 및 공부 용도로 현재 사용 중인 가상화 서비스이며 서버 재설치 겸 다시 정리하는 글1.1 Proxmox 란?데비안을 베이스로 하는 오픈소스 Type1 하이퍼바이저 운영체제로,

bigdwarf.blog

그리고 매년 여름 한두번 정전 일어나는 경우가 있어 NAS에 중요한 데이터가 날아가지 않도록 UPS까지 설치해서 정전 시 자동으로 종료되도록 설정도 해놨다.

모델 Back-UPS ES 550

현재까지 홈 네트워크 구성도이며, 여기서 변한 부분도 있다. 다음에 해야될 일은 Proxmox Backup 처리할 예정이다.

Linux에서 CUBRID 10.1 HA 구성

키큰난쟁이 — Tue, 24 Sep 2024 03:44:35 +0900

2024.09.11 - [DBMS/Cubrid] - Linux에서 CUBRID 10.1 설치

Linux에서 CUBRID 10.1 설치

1. 들어가며 CUBRID는 관계형 데이터베이스 관리 시스템의 이름이며, 오픈 소스 소프트웨어이다. DBMS 엔진 부분은 아파치 라이선스 2.0 라이선스가 적용되고 인터페이스 부분은 BSD

bigdwarf.blog

1. 들어가며

High Availability(HA)란, 하드웨어, 소프트웨어, 네트워크 등에 장애가 발생해도 지속적인 서비스를 제공하는 기능이다. 이 기능은 하루 24시간 1년 내내 서비스를 제공해야 하는 네트워킹 컴퓨팅 부분에서 필수적인 요소이다. HA 시스템은 두 대 이상의 서버 시스템으로 구성하여 시스템 구성 요소 중의 한 요소에 장애가 발생해 서비스를 중단 없이 제공할 수 있다.

2. 큐브리드 설치

2024.09.11 - [DBMS/Cubrid] - Linux에서 CUBRID 10.1 설치
2개의 서버를 준비해 주시고 위 링크 목차 3번까지 동일하게 진행하시고 오시면 됩니다.

3. HA 구성 전 주의사항 및 호스트 등록

3.1 HA 구성 전 주의사항

복제가 정상적으로 수행되기 위해서는 테이블을 생성할 때 기본키(primary key)가 반드시 존재해야 한다는 점을 주의
파라미터에서 명시한 멤버 노드들의 호스트 이름은 IP로 대체할 수 없으며, 사용자는 반드시/etc/hosts에 등록되어 있는 것을 사용

3.2 호스트 등록 작업

1번 Master 서버 호스트명(master) (IP : 192.168.0.2) / 2번 Slave 서버 호스트명(slave) (IP : 192.168.0.3)
1번 Master 호스트명 등록

#호스트네임 확인
hostname
master

# root 계정으로 변경 후 아래 내용에 호스트 이름을 등록해준다.
su -
vi /etc/hosts

127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
192.168.0.2 master
192.168.0.3 slave

2번 Slave 서버 호스트명 등록

#호스트네임 확인
hostname
slave

# root 계정으로 변경 후 아래 내용에 호스트 이름을 등록해준다.
su -
vi /etc/hosts

127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
192.168.0.2 master
192.168.0.3 slave

4. 데이터베이스 생성

CUBRID HA에 포함할 데이터베이스를 모든 CUBRID HA 노드에서 동일하게 생성한다. 데이터베이스 생성 옵션은 필요에 따라 적절히 변경
아래 내용 1번 Master 서버와 2번 Slave 서버 동일한 DB 생성

cd $CUBRID_DATABASES
mkdir testdb
cd testdb
mkdir log
cubrid createdb -L ./log testdb en_US
Creating database with 512.0M size using locale en_US. The total amount of disk space needed is 1.5G.

CUBRID 10.1

5. 큐브리드 서버 설정

5.1 큐브리드 cubrid.conf 수정

$CUBRID/conf/cubrid.conf의 ha_mode를 모든 HA 노드에 동일하게 설정한다. 특히, 로깅 관련 파라미터인 log_max_archives와force_remove_log_archives, HA 관련 파라미터인ha_mode의 설정에 주의한다.
아래 내용을 1번 Master 서버와 2번 Slave 서버 동일하게 수정

vi $CUBRID/conf/cubrid.conf

# Service parameters
[service]
service=server,broker,manager

# Common section
[common]
service=server,broker,manager

# Server parameters
server=testdb
data_buffer_size=512M
log_buffer_size=4M
sort_buffer_size=2M
max_clients=100
cubrid_port_id=1523
db_volume_size=512M
log_volume_size=512M

# HA 구성 시 추가 (Logging parameters)
log_max_archives=100
force_remove_log_archives=no

# HA 구성 시 추가 (HA 모드)
ha_mode=on

만약 Master / Slave 구성을 해야 될 DB가 더 존재할 경우 $CUBRID/conf/cubrid.conf 에서 아래 내용 수정

#기본으로 설정되어있어여됨
ha_mode=on

# HA 구성 시 추가 (HA 모드)
[@이중화할 DB명1]
ha_mode=on
[@이중화할 DB명2]
ha_mode=on

#예시
[@master]
ha_mode=on
[@slave]
ha_mode=on

5.2 큐브리드 cubrid_ha.conf 수정

$CUBRID/conf/cubrid_ha.conf의ha_port_id, ha_node_list, ha_db_list를 모든 HA 노드에 동일하게 설정한다. 다음 위에서 설정한 마스터 노드의 호스트 이름(master), 슬레이브 노드의 호스트 이름(slave)으로 설정
아래 내용을 1번 Master 서버와 2번 Slave 서버 동일하게 수정

vi $CUBRID/conf/cubrid_ha.conf

# ha_node_list=(서버계정명)@(마스터서버호스트명):(슬레이브서버호스트명)
[common]
ha_port_id=59901
ha_node_list=cubrid@master:slave
ha_db_list=testdb
ha_copy_sync_mode=sync:sync
ha_apply_max_mem_size=500

5.2 큐브리드 databases.txt 수정

$CUBRID_DATABASES/databases.txt($CUBRID_DATABASES가 설정 안 된 경우$CUBRID/databases/databases.txt)의 db-host에 마스터 노드와 슬레이브 노드의 호스트 이름을 설정(master:slave)한다.
아래 내용을 1번 Master 서버와 2번 Slave 서버 동일하게 수정

vi $CUBRID_DATABASES/databases.txt
# 이중화 시킬 db의 db-host 명을 localhost -> master:slave 변경

#db-name vol-path db-host log-path lob-base-path
testdb          /home/cubrid/CUBRID/databases/testdb    master:slave       /home/cubrid/CUBRID/databases/testdb/log        file:/home/cubrid/CUBRID/databases/testdb/lob

6. CUBRID HA 시작 및 확인

6.1 CUBRID HA 시작

CUBRID HA 그룹 내의 각 노드에서 cubrid heartbeat start를 수행한다. cubrid heartbeat start 를 가장 먼저 수행한 노드가 마스터 노드가 되므로 유의해야 한다. 이하의 예에서 마스터 노드의 호스트 이름은 master, 슬레이브 노드의 호스트 이름은 slave

1. 마스터 노드

cubrid heartbeat start

2. 슬레이브 노드

cubrid heartbeat start

6.2 CUBRID HA 상태 확인

CUBRID HA 그룹 내의 각 노드에서 cubrid heartbeat status를 수행하여 구성 상태를 확인

1. 마스터 서버 확인

cubrid heartbeat status

@ cubrid heartbeat list
 HA-Node Info (current master, state master)
   Node slave (priority 2, state slave)
   Node master (priority 1, state master)

 HA-Process Info (master 1844, state slave)
 Applylogdb testdb@localhost:/home/cubrid/CUBRID/databases/testdb_slave (pid 9423, state registered)
 Copylogdb testdb@slave:/home/cubrid/CUBRID/databases/testdb_slave (pid 9418, state registered)
 Server testdb (pid 9306, state registered_and_active)

2. 슬레이브 서버 확인

cubrid heartbeat status

@ cubrid heartbeat list
 HA-Node Info (current slave, state slave)
   Node slave (priority 2, state slave)
   Node master (priority 1, state master)

 HA-Process Info (master 1844, state slave)
 Applylogdb testdb@localhost:/home/cubrid/CUBRID/databases/testdb_master (pid 2428, state registered)
 Copylogdb testdb@master:/home/cubrid/CUBRID/databases/testdb_master (pid 2424, state registered)
 Server testdb (pid 2137, state registered_and_standby)

CUBRID HA 그룹 내의 각 노드에서 cubrid changemode 유틸리티를 이용하여 서버의 상태를 확인

1. 마스터 서버 확인

cubrid changemode testdb@localhost
The server 'testdb@localhost''s current HA running mode is active.

2. 슬레이브 서버 확인

cubrid changemode testdb@localhost
The server 'testdb@localhost''s current HA running mode is standby.

6.3 CUBRID HA 동작 여부 확인

마스터 노드의 액티브 서버에서 쓰기를 수행한 후 슬레이브 노드의 스탠바이 서버에 정상적으로 반영되었는지 확인
HA 환경에서 CSQL 인터프리터로 각 노드에 접속하려면, 데이터베이스 이름 뒤에 접속 대상 호스트 이름을 반드시 지정해야 한다(“@<호스트 이름>”). 호스트 이름을 localhost로 지정하면, 로컬 노드에 접속

1. 마스터 서버

csql -u dba testdb@localhost -c "create table abc(a int, b int, c int, primary key(a));"
csql -u dba testdb@localhost -c "insert into abc values (1,1,1);"

2. 슬레이브 서버

csql -u dba testdb@localhost -l -c "select * from abc;"
=== <Result of SELECT Command in Line 1> ===
<00001> a: 1
        b: 1
        c: 1

7. 브로커 시작 및 확인

브로커는 JDBC나 CCI, PHP 등의 응용에서 접근하기 위해 사용하는 것이다. 따라서 간단한 서버 이중화 동작을 시험하고 싶다면 브로커를 시작할 필요 없이 서버 프로세스에 직접 접속하는 CSQL 인터프리터만 실행해서 확인할 수 있다. 브로커는 cubrid broker start 를 실행하여 시작하고 cubrid broker stop 을 실행하여 정지한다.

1. 마스터 서버

cubrid broker start

2. 슬레이브 서버

cubrid broker start

8. 응용 프로그램 설정(JDBC 연결)

다양한 응용프로그램 설정이 존재한다. 큐브리드 공식 문서 통해서 확인
필자는 JDBC 프로그램 예제로 진행

# DB 접근 방법
jdbc:CUBRID:192.168.0.2:33000:testdb:::?altHosts=192.168.0.3:33000&amp;rcTime=600&amp;charSet=utf-8
jdbc:CUBRID:[마스터IP]:[브로커포트]:[DB명]:::?altHosts=[슬래이브IP]:[브로커포트]&amp;rcTime=600&amp;charSet=utf-8

# 자바 스프링 log4j DB 설정
Globals.Url=jdbc:log4jdbc:cubrid:192.168.0.2:33000:testdb:::?altHosts=192.168.0.3:33000&amp;rcTime=600&amp;charSet=utf-8

9. 마치며

더 궁금한 내용이 있으시면 CUBRID 공식 문서 확인하세요 :)

[CUBRID 공식 문서]

CUBRID 10.1 사용자 매뉴얼 — CUBRID 10.1.0 documentation

CUBRID 10.1 사용자 매뉴얼 — CUBRID 10.1.0 documentation. Quick Reference Table and Table of Contents.

www.cubrid.org

Linux에서 CUBRID 10.1 설치

키큰난쟁이 — Mon, 23 Sep 2024 03:15:16 +0900

1. 들어가며

CUBRID는 관계형 데이터베이스 관리 시스템의 이름이며, 오픈 소스 소프트웨어이다. DBMS 엔진 부분은 아파치 라이선스 2.0 라이선스가 적용되고 인터페이스 부분은 BSD 라이선스가 적용되었으며, 국제 표준화 기구의 표준 구조화 조회 언어를 지원한다. 2008년 11월 CUBRID 2008 (CUBRID 8)이 출시되면서 오픈소스 DBMS로 전환되었으며, 최신 안정화 버전은 CUBRID 11.0이다.

2. CUBRID 설치하기

2.1 설치 전 사전 점검

JRE 또는 JDK 1.6 이상 및 Linux 계열 64 Bit(Linux kernel 2.4 및 glibc 2.3.4 이상)
glibc 버전
glibc 2.3.4 버전 이상만 지원한다. glibc 버전은 다음과 같은 방법으로 확인

rpm -q glibc

32비트 또는 64비트
10.0 이후 CUBRID는 64비트 버전만 지원한다. Linux버전은 다음과 같은 방법으로 확인

uname -a
Linux host_name 2.6.18-53.1.14.el5xen #1 SMP Wed Mar 5 12:08:17 EST 2008 x86_64 x86_64 x86_64 GNU/Linux

추가로 설치할 라이브러리
1. Curses Library (rpm -q ncurses)
2. gcrypt Library (rpm -q libgcrypt)
3. stdc++ Library (rpm -q libstdc++)
/etc/hosts 파일에 호스트 이름과 IP 주소 매핑이 정상인지 확인하기
호스트 이름과 이에 맞는 IP 주소가 비정상적으로 매핑되어 있으면 DB 서버를 구동할 수 없으므로, 정상적으로 매핑되어 있는지 확인

vi /etc/hosts

서버 호스트명을 확인 후 호스트 이름을 등록 해줍니다. 차후 HA (Master,Slave) 구성 시 설정할때 필요합니다.

hostname
cubrid

127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
192.168.0.179 cubrid

java8 설치 진행

yum list java*jdk-devel // 자바 패키지 목록 확인
java-1.8.0-openjdk-devel.x86_64                        1:1.8.0.402.b06-2.el9                        appstream
java-11-openjdk-devel.x86_64                           1:11.0.22.0.7-2.el9                          appstream 
java-17-openjdk-devel.x86_64                           1:17.0.10.0.7-2.el9                          appstream 
java-21-openjdk-devel.x86_64                           1:21.0.2.0.13-1.el9                          appstream

yum install java-1.8.0-openjdk-devel.x86_64 // 자바 1.8 설치

2.2 큐브리드 다운로드 및 설치

https://ftp.cubrid.org/CUBRID_Engine/ 다운로드 링크로 가서 자신이 설치 할 버전에 맞는 CUBRID를 다운로드
설치하는 방법은 다양하게 있지만 쉘스크립트를 통해 설치 진행 궁금한사항은 큐브리드 매뉴얼 참고
CUBRID-10.1.8.7823-fa7db6b-Linux.x86_64.sh 로 다운로드

저는 wget을 이용해 직접 서버에 다운로드

wget https://ftp.cubrid.org/CUBRID_Engine/10.1_latest/CUBRID-10.1.8.7823-fa7db6b-Linux.x86_64.sh

# 파일 위치 (리눅스계정 : cubrid)
/home/cubrid/CUBRID-10.1.8.7823-fa7db6b-Linux.x86_64.sh

CUBRID-10.1.8.7823-fa7db6b-Linux.x86_64.sh 파일 실행 권한 부여 및 실행

# .sh 파일 실행 권한 부여
chmod 755 CUBRID-10.1.8.7823-fa7db6b-Linux.x86_64.sh

# .sh 실행
/home/cubrid/CUBRID-10.1.8.7823-fa7db6b-Linux.x86_64.sh

실행 후 아래 내용 확인 후 진행

# 라이센스 동의
Do you accept the license? [yN]: y

# 설치될 디렉토리 선택 Y 선택 시 "/home/cubrid/CUBRID-10.1.8.7823-fa7db6b-Linux.x86_64" 위치에 설치, N 선택 시 "/home/cubrid" 위치에 설치하게된다.
By default the CUBRID will be installed in:
  "/home/cubrid/CUBRID-10.1.8.7823-fa7db6b-Linux.x86_64"
Do you want to include the subdirectory CUBRID-10.1.8.7823-fa7db6b-Linux.x86_64?
Saying no will install in: "/home/cubrid" [Yn]: Y

Using target directory: /home/cubrid/CUBRID-10.1.8.7823-fa7db6b-Linux.x86_64
# 동의하기
Since CUBRID broker and server versions should match, please make sure that you are running the same version if you operate them in separate machines.
Do you want to continue? [Yn] : Y

설치가 완료되면 /home/cubrid/CUBRID-10.1.8.7823-fa7db6b-Linux.x86_64 경로에 폴더에 설치됨

2.3 큐브리드 환경변수 설정

설치가 완료됬다면 /home/cubrid 내에 .cubrid.sh 파일이 생성됬는지 확인

cd $HOME
ls -al
-rw-r--r--.  1 cubrid cubrid      339 Mar 19 11:27 .cubrid.csh
-rw-r--r--.  1 cubrid cubrid      370 Mar 19 12:35 .cubrid.sh

CUBRID-10.1.8.7823-fa7db6b-Linux.x86_64 폴더명을 CUBRID 로 변경

mv CUBRID-10.1.8.7823-fa7db6b-Linux.x86_64 CUBRID

폴더명 변경으로 .cubrid.sh 텍스트 편집기로 열어 아래 내용 수정

vi /home/cubrid/.cubrid.sh

# 아래 CUBRID 경로 수정
#CUBRID=/home/cubrid/CUBRID-10.1.8.7823-fa7db6b-Linux.x86_64
CUBRID=/home/cubrid/CUBRID
CUBRID_DATABASES=$CUBRID/databases
if [ "x${LD_LIBRARY_PATH}x" = xx ]; then
  LD_LIBRARY_PATH=$CUBRID/lib
else
  LD_LIBRARY_PATH=$CUBRID/lib:$LD_LIBRARY_PATH
fi
SHLIB_PATH=$LD_LIBRARY_PATH
LIBPATH=$LD_LIBRARY_PATH
PATH=$CUBRID/bin:$PATH
export CUBRID
export CUBRID_DATABASES
export LD_LIBRARY_PATH
export SHLIB_PATH
export LIBPATH
export PATH

cubrid.sh 수정이 완료 되고 설치 계정의 셸 로그인 스크립트에서 자동으로 호출하도록 .bash_profile를 수정

vi /home/cubrid/.bash_profile

# .bash_profile

# Get the aliases and functions
if [ -f ~/.bashrc ]; then
        . ~/.bashrc
fi

# User specific environment and startup programs
# 맨 아래에 추가
. /home/cubrid/.cubrid.sh

source 명령어를통해 수정된 내용을 적용

source ~/.bash_profile

echo 명령어를 이용해 적용됬는지 확인

echo $CUBRID
/home/cubrid/CUBRID

3. CUBRID 실행하기

3.1 큐브리드 실행

큐브리드를 실행 해준다.

cubrid service start
@ cubrid master start
++ cubrid master start: success
@ cubrid broker start
++ cubrid broker start: success
@ cubrid manager server start
++ cubrid manager server start: success

정상적으로 실행되는지 확인

cubrid service status

cubrid service를 구동시킨 후 정상적으로 구동되었는지 grep으로 cub_* 프로세스들이 구동되어 있는지를 확인

ps -ef | grep cub_
cubrid     33239       1  0 09:30 pts/0    00:00:00 cub_master
cubrid     33242       1  0 09:30 ?        00:00:00 cub_broker
cubrid     33243       1  0 09:30 ?        00:00:00 query_editor_cub_cas_1
cubrid     33244       1  0 09:30 ?        00:00:00 query_editor_cub_cas_2
cubrid     33245       1  0 09:30 ?        00:00:00 query_editor_cub_cas_3
cubrid     33246       1  0 09:30 ?        00:00:00 query_editor_cub_cas_4
cubrid     33247       1  0 09:30 ?        00:00:00 query_editor_cub_cas_5
cubrid     33253       1  0 09:30 ?        00:00:00 cub_broker
cubrid     33254       1  0 09:30 ?        00:00:00 broker1_cub_cas_1
cubrid     33255       1  0 09:30 ?        00:00:00 broker1_cub_cas_2
cubrid     33256       1  0 09:30 ?        00:00:00 broker1_cub_cas_3
cubrid     33257       1  0 09:30 ?        00:00:00 broker1_cub_cas_4
cubrid     33258       1  0 09:30 ?        00:00:00 broker1_cub_cas_5
cubrid     33267       1  0 09:30 ?        00:00:00 cub_manager start
cubrid     33297   33145  0 09:30 pts/0    00:00:00 grep --color=auto cub_

DB 별 큐브리드 실행/종료

#실행
cubrid server start [디비명]
#종료
cubrid server stop [디비명]

3.2 큐브리드 오류 발생 시

큐브리드 실행 시 "cubrid: error while loading shared libraries: libncurses.so.5: cannot open shared object file: No such file or directory" 메세지가 뜨면 오류가 날 경우
1. CUBRID는 ncurses library를 필요로하고 현재 빌드 환경에서 ncurses5를 사용하기 때문에 ncurses6를 사용하는 시스템에서는 symbolic link를 생성 필요
2. 보통은 $CUBRID/lib에 symbolic link를 만듭니다. 아래 명령어를 사용해 $CUBRID/lib 폴더에 symbolic link 생성

ln -s /lib64/libncurses.so.6 $CUBRID/lib/libncurses.so.5
ln -s /lib64/libform.so.6 $CUBRID/lib/libform.so.5
ln -s /lib64/libtinfo.so.6 $CUBRID/lib/libtinfo.so.5

$CUBRID/lib 폴더에 심볼릭 링크가 제대로 만들어졌는지 확인

cd $CUBRID/lib
ls -al
lrwxrwxrwx.  1 cubrid cubrid       19 Mar 19 14:05 libform.so.5 -> /lib64/libform.so.6
lrwxrwxrwx.  1 cubrid cubrid       22 Mar 19 14:05 libncurses.so.5 -> /lib64/libncurses.so.6
lrwxrwxrwx.  1 cubrid cubrid       20 Mar 19 14:05 libtinfo.so.5 -> /lib64/libtinfo.so.6

3.3 큐브리드 사용 포트

큐브리드 외부 접근 시 포트 개방 필요
큐브리드 사용 포트 표

구분	대상 장비	Linux 포트	Window 포트	방화벽
Single DB	WEB/WAS Server	33000(TCP)	33000~33040(TCP)	개방
	CUBRID Manager	30000(TCP) 8001(TCP)	30000~30040(TCP) 8001(TCP)	개방
	CUBRID CMT	30000(TCP)	30000~30040(TCP)	개방
CUBRID HA	WEB/WAS Server	33000(TCP)	33000~33040(TCP)	개방
	CUBRID Manager	30000(TCP) 8001(TCP)	30000~30040(TCP) 8001(TCP)	개방
	CUBRID CMT	30000(TCP)	30000~30040(TCP)	개방
	Master/Slave Server 양방향	1523(TCP) 7(TCP) 59901(UDP)	HA 기능 미지원	Linux : 개방 Window : 불필요
CUBRID Manager 사용자/관리자 PC	CUBRID Manager	30000(TCP) 8001(TCP)	30000~30040(TCP) 8001(TCP)	개방
CUBRID Migration Toolkit 사용자/관리자 PC	CUBRID CMT	30000(TCP)	30000~30040(TCP)	개방

4. CUBRID DB 생성

4.1 큐브리드 DB 생성

DB를 생성할 디렉터리로 이동해서 DB를 직접 생성

cd $CUBRID_DATABASES
mkdir testdb
cd testdb
cubrid createdb --db-volume-size=128M --log-volume-size=128M testdb en_US

생성하게되면 해당 디렉토리에 파일이 생성되고 databasess.txt 파일 내용에 추가 됨

cd $CUBRID_DATABASES/testdb
ls -al
drwxr-xr-x. 2 cubrid cubrid         6 Mar 20 12:31 lob
-rw-------. 1 cubrid cubrid 134217728 Mar 20 12:31 testdb
-rw-------. 1 cubrid cubrid 134217728 Mar 20 12:31 testdb_lgar_t
-rw-------. 1 cubrid cubrid 134217728 Mar 20 12:31 testdb_lgat
-rw-------. 1 cubrid cubrid       209 Mar 20 12:31 testdb_lginf
-rw-------. 1 cubrid cubrid       268 Mar 20 12:31 testdb_vinf

vi $CUBRID_DATABASES/databases.txt
#db-name        vol-path                db-host         log-path                lob-base-path
testdb          /home/cubrid/CUBRID/databases/testdb    localhost       /home/cubrid/CUBRID/databases/testdb    file:/home/cubrid/CUBRID/databases/testdb/lob

5. DB 자동 구동 및 큐브리드 자동 시작

5.1 DB 자동 구동

부팅 시 생성한 DB가 구동되게 하려면 $CUBRID/conf/cubrid.conf 에서 다음을 수정

[service]
service=server, broker, manager
server=testdb #DB명

5.2 큐브리드 rc.local 자동 실행 설정

부팅 시 rc.local로 자동 실행 설정
rc-local 데몬이 실행되어있는지 확인

systemctl status rc-local.service
○ rc-local.service - /etc/rc.d/rc.local Compatibility
     Loaded: loaded (/usr/lib/systemd/system/rc-local.service; static)
     Active: inactive (dead)
       Docs: man:systemd-rc-local-generator(8)

다음 2개(/etc/rc.local,/etc/rc.d/rc.local)의 파일 실행 권한 설정

# 권한 확인
ll /etc/rc.local
lrwxrwxrwx. 1 root root 13 Jan 23 19:22 /etc/rc.local -> rc.d/rc.local
ll /etc/rc.d/rc.local
-rw-r--r--. 1 root root 474 Jan 23 19:22 /etc/rc.d/rc.local

# 권한 설정
chmod 777 /etc/rc.d/rc.local
ll /etc/rc.d/rc.local
-rwxrwxrwx. 1 root root 474 Jan 23 19:22 /etc/rc.d/rc.local

rc-local 데몬 enable

systemctl enable rc-local.service

WantedBy 설정이 안되있어 아래 내용과 함께 실행이 되지 않습니다.

e unit files have no installation config (WantedBy=, RequiredBy=, Also=,
Alias= settings in the [Install] section, and DefaultInstance= for template
units). This means they are not meant to be enabled or disabled using systemctl.
 
Possible reasons for having this kind of units are:
• A unit may be statically enabled by being symlinked from another unit's
  .wants/ or .requires/ directory.
• A unit's purpose may be to act as a helper for some other unit which has
  a requirement dependency on it.
• A unit may be started when needed via activation (socket, path, timer,
  D-Bus, udev, scripted systemctl call, ...).
• In case of template units, the unit is meant to be enabled with some
  instance name specified.

vi 텍스트 편집기를 이용해/usr/lib/systemd/system/rc-local.service아래 내용을 추가

# 추가할 내용
[Install]
WantedBy=multi-user.target

# vi 텍스트 편집기 통해서 수정해줍니다.
vi /usr/lib/systemd/system/rc-local.service

#  SPDX-License-Identifier: LGPL-2.1-or-later
#
#  This file is part of systemd.
#
#  systemd is free software; you can redistribute it and/or modify it
#  under the terms of the GNU Lesser General Public License as published by
#  the Free Software Foundation; either version 2.1 of the License, or
#  (at your option) any later version.

# This unit gets pulled automatically into multi-user.target by
# systemd-rc-local-generator if /etc/rc.d/rc.local is executable.
[Unit]
Description=/etc/rc.d/rc.local Compatibility
Documentation=man:systemd-rc-local-generator(8)
ConditionFileIsExecutable=/etc/rc.d/rc.local
After=network-online.target
Wants=network-online.target

[Service]
Type=forking
ExecStart=/etc/rc.d/rc.local start
TimeoutSec=infinity
RemainAfterExit=yes
GuessMainPID=no

# 추가 내용
[Install]
WantedBy=multi-user.target

다시 rc-local 데몬 enable

systemctl enable rc-local.service
Created symlink /etc/systemd/system/multi-user.target.wants/rc-local.service → /usr/lib/systemd/system/rc-local.service.

systemctl list-unit-files |grep rc.local
rc-local.service                             enabled         disabled

정상적으로 등록되어 재부팅 시 rc.local 파일에 등록된 스크립트가 실행

5.3 자동 실행 될 수 있도록 rc.local 등록할 스크립트 작성

큐브리드가 부팅 후 자동 실행 될 수 있도록 스크립트를 작성 스크립트파일을 생성해 작성해도되지만 저는 rc.local에 직접 작성
큐브리드가 설치된 계정을 통해 실행 스크립트 작성

vi /etc/rc.d/rc.local

#!/bin/bash
# THIS FILE IS ADDED FOR COMPATIBILITY PURPOSES
#
# It is highly advisable to create own systemd services or udev rules
# to run scripts during boot instead of using this file.
#
# In contrast to previous versions due to parallel execution during boot
# this script will NOT be run after all other services.
#
# Please note that you must run 'chmod +x /etc/rc.d/rc.local' to ensure
# that this script will be executed during boot.

touch /var/lock/subsys/local

# cubrid 자동 실행
# su - [큐브리드 설치된 계정]
su - cubrid << EOF
cubrid service start

설정이 완료되면 재부팅 후 제대로 실행됬는지 확인

cubrid service status
@ cubrid master status
++ cubrid master is running.
@ cubrid server status
 Server testdb (rel 10.1, pid 1476)
@ cubrid broker status
  NAME                   PID  PORT    AS   JQ                  TPS                  QPS   SELECT   INSERT   UPDATE   DELETE   OTHERS     LONG-T     LONG-Q         ERR-Q  UNIQUE-ERR-Q  #CONNECT   #REJECT 
===========================================================================================================================================================================================================
* query_editor          1747 30000     5    0                    0                    0        0        0        0        0        0     0/60.0     0/60.0             0             0         0         0 
* broker1               1758 33000     5    0                    0                    0        0        0        0        0        0     0/60.0     0/60.0             0             0         0         0 
@ cubrid manager server status
++ cubrid manager server is running.

6. 마치며

큐브리드 자동 실행 공식 문서보고 했지만 잘안되는 부분이있어 재부팅 시 스크립트로 자동실행되게 작업 했습니다.

[CUBRID 공식 문서]

CUBRID 10.1 사용자 매뉴얼 — CUBRID 10.1.0 documentation

CUBRID 10.1 사용자 매뉴얼 — CUBRID 10.1.0 documentation. Quick Reference Table and Table of Contents.

www.cubrid.org

Ubuntu Linux Oracle XE 11g 설치 및 DB, 계정 생성

키큰난쟁이 — Sun, 22 Sep 2024 00:21:13 +0900

1. 들어가며

✅ Ubuntu 22.04 64bit 환경에서 Oracle 11g 설치하기

2. Oracle XE 다운로드하기

[다운로드 링크]

XE Prior Release Archive

Getting Started: Support Oracle Database Express Edition (XE) is a community supported edition of the Oracle Database family. Please go to the Oracle Database XE Community Support Forum for help, feedback, and enhancement requests. Note: Oracle Support Ser

www.oracle.com

Linux 버전을 다운로드한다.

3. Oracle XE 파일 업로드 및 압축 해제

wget을 이용해 파일 다운로드

wget https://download.oracle.com/otn/linux/oracle11g/xe/oracle-xe-11.2.0-1.0.x86_64.rpm.zip

wget 실행 안될 경우

wget 패키지 설치

sudo apt-get install wget

zip 파일 압축 해제

unzip oracle-xe-11.2.0-1.0.x86_64.rpm.zip

4. Oracle XE 설치 시 필요한 패키지 설치

Ubuntu에서는 rpm 파일을 사용하여 패키지 설치를 할 수 없으므로, RPM을 Debian의 deb 패키지로 변경이 필요하다. 변경 및 설치를 위해 필요한 패키지는 아래와 같다.

alien : RPM 패키지를 Debian 패키지로 변환
libaio1 : Linux 커널 AIOAsynchronous I/O 액세스 라이브러리
unixodbc : ODBC (Open Database Connectivity ) 라이브러리

sudo apt-get install -y alien libaio1 unixodbc

4. Oracle XE RPM → DEB 변환

다운로드한 rpm 파일을 alien을 이용해 deb 파일로 변환

alien --scripts -d  oracle-database-xe-18c_1.0-2_amd64.rpm

5. Oracle XE 환경설정

경로 /sbin/chkconfig
Redhat 패키지들은 설치 시 /sbin/chkconfig를 시용해야 하지만, Ubuntu에는 해당 파일이 없기 때문에 /bin/chkconfig 파일을 생성

sudo vi /sbin/chkconfig

#!/bin/bash 
    # Oracle 11gR2 XE installer chkconfig hack for Ubuntu 
      file=/etc/init.d/oracle-xe 
      if [[ ! `tail -n1 $file | grep INIT` ]]; then 
        echo >> $file 
        echo '### BEGIN INIT INFO' >> $file 
        echo '# Provides: OracleXE' >> $file 
        echo '# Required-Start: $remote_fs $syslog' >> $file 
        echo '# Required-Stop: $remote_fs $syslog' >> $file 
        echo '# Default-Start: 2 3 4 5' >> $file 
        echo '# Default-Stop: 0 1 6' >> $file 
        echo '# Short-Description: Oracle 11g Express Edition' >> $file
        echo '### END INIT INFO' >> $file 
      fi 
      update-rc.d oracle-xe defaults 80 01 
    #EOF

파일 생성 후 실행할 수 있도록 755 권한 설정

sudo chmod 755 /sbin/chkconfig

6. Kernel 파라미터 설정

Oracle이 Linux 커널의 파라미터를 사용하여 운영되기 때문에 Oracle 서버를 운영하기 우해서는 커널 파라미터 설정이 필요하다. 시스템 컨트롤 데몬에 시스템 파라미터 설정을 저장하여 등록한다.

file.file-max : 오픈하는 파일의 수를 지정하는 커널 파라미터(각 오라클 인스턴스는 512 * Process만큼 file descriptor를 가짐.)
net.ipv4.iplocalport_range : TCP와 UDP 트랙픽을 위한 범위를 설정하는 커널 파라미터
kernel.sem : 세마포를 지정하는 커널 파라미터
kernel.shmmax : 공유 메모리 페이지를 지정하는 커널 파라미터

sudo vi /etc/sysctl.d/60-oracle.conf

# Oracle 11g XE kernel parameters 
     fs.file-max=6815744 
     net.ipv4.ip_local_port_range=9000 65000 
     kernel.sem=250 32000 100 128 
     kernel.shmmax=536870912

커널 파라미터 로드

sudo systemctl start procps

## procps 패키지 설치가 안되있다면
sudo apt-get install procps

7. Oracle XE용 파일 추가

Oracle XE는 /bin/awk를 사용하지만, Ubuntu에서는 /usr/bin/awk에 설치되기 때문에 심볼릭 링크를 만들어 줌.

sudo ln -s /usr/bin/awk /bin/awk
## ubuntu 22.04 /bin/awk 존재하고있어 심볼릭 링크를 따로 만들필요없음
## 혹시 모르니 확인 필요

Oracle XE의 리스터가 사용할 lock 파일 생성

sudo mkdir /var/lock/subsys
## ubuntu 22.04 /var/lock/subsys 존재하고있어 따로 폴더를 만들필요없음
## 혹시 모르니 확인 필요
sudo touch /var/lock/subsys/listener

(오류 발생 시) 메모리 설정

Oracle XE를 설치하고 나서 특별한 에러 없이 Oracle 프로세스가 리스너만 시작되고 다른 프로세스가 실행되지 않는 문제를 만날 수 있다. Oralce XE를 설치할 때 정상적으로 설치가 되지 않거나 오류가 발생하게 되면 $ORACL_HOME안의 log 디렉터리를 살펴보면 된다. 설치가 정상적으로 되지 않거나, 설치는 되었는데 에러 없이 Oracle이 정상적으로 시작이 되지 않을 경우 로그를 살펴보면 ORA-000845:MEMORY_TARGET 에러가 발생하게 되는 경우가 있는데 메모리의 설정이 잘못되거나 사이즈가 부족해서 그런 경우이다. 이런 경우 메모리 설정을 위해서 다음 과정을 진행한다.

현재 설정된 shared memeory 삭제

sudo rm -rf /dev/shm

새로운 SHM을 생성하여 mount

sudo mkdir /dev/shm
sudo mount -t tmpfs shmfs -o -size=4096m /dev/shm

shm 설정을 데몬에 등록, 로드하기 위해 아래 내용을 파일로 생성

sudo vi /etc/rc2.d/S01shm_load

#!/bin/sh 
    case "$1" in 
    start) mkdir /var/lock/subsys 2>/dev/null 
    touch /var/lock/subsys/listener 
    rm /dev/shm 2>/dev/null 
    mkdir /dev/shm 2>/dev/null 
    mount -t tmpfs shmfs -o size=4096m /dev/shm ; 
    *) echo error 
    exit 1 ;; 
    esac

sudo chmod 755 /etc/rc2.d/S01shm_load

8. Oracle XE 패키지 설치

deb 패키지 설치

sudo dpkg --install oracle-xe_11.2.0-2_amd64.deb

정상적으로 설치되면 아래와 같이 나오고 데몬이 자동으로 등록된다.

Selecting previously unselected package oracle-xe.
(데이터베이스 읽는중 ...현재 205338개의 파일과 디렉터리가 설치되어 있습니다.)
Preparing to unpack oracle-xe_11.2.0-2_amd64.deb ...
Unpacking oracle-xe (11.2.0-2) ...
oracle-xe (11.2.0-2) 설정하는 중입니다 ...
Executing post-install steps...

You must run '/etc/init.d/oracle-xe configure' as the root user to configure the database.

Processing triggers for libc-bin (2.31-0ubuntu9) ...
Processing triggers for systemd (245.4-4ubuntu3.1) ...
Processing triggers for gnome-menus (3.36.0-1ubuntu1) ...
Processing triggers for desktop-file-utils (0.24-1ubuntu2) ...
Processing triggers for mime-support (3.64ubuntu1) ...

설치 후 Oracle XE 사용을 위해 Oracle 최초 설정을 /etc/init.d/oracle-xe configure로 설정한다.

sudo /etc/init.d/oracle-xe configure

최초 설정 내용은 아래와 같은 서비스 포트와 패스워드 설정이다.
포트 번호 설정은 건드리지 않고 패스워드만 설정한다. (필요시 포트번호 변경)

Specify the HTTP port that will be used for Oracle Application Express [8080]:

Specify a port that will be used for the database listener [1521]:

Specify a password to be used for database accounts.  Note that the same password will be used for SYS and SYSTEM.  Oracle recommends the use of different passwords for each database account.  
This can be done after initial configuration:
Enter password : <<password 입력>>
Confirm the password : <<password 확인 입력>>

Do you want Oracle Database 11g Express Edition to be started on boot (y/n) [y]:

Starting Oracle Net Listener...Done
Configuring database...Done
Starting Oracle Database 11g Express Edition instance...Done
Installation completed successfully.

9. Oracle XE 환경 변수 설정

리눅스 계정마다 환경 변수 설정해 줘야 된다. 필자는 testid라는 계정으로 접속하여 설정

9.1 첫 번째 방법

su - testid
vi ~/.bashrc

export ORACLE_HOME=/u01/app/oracle/product/11.2.0/xe 
export ORACLE_SID=XE 
export NLS_LANG=`$ORACLE_HOME/bin/nls_lang.sh` 
export ORACLE_BASE=/u01/app/oracle 
export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH 
export PATH=$ORACLE_HOME/bin:$PATH

9.2 두번째 방법 (저는 이 방법으로 함)

/u01/app/oracle/product/11.2.0/xe/bin/oracle_env.sh ~/.bashrc 파일에 oracle_env.sh 파일 내용을 추가하고 저장한다.

## 아래 명령어 실행 후 해당 명령어 복사
. /u01/app/oracle/product/11.2.0/xe/bin/oracle_env.sh

vi ~/.bashrc

~/.bashrc 맨 아래 복사 한 명령어를 작성하고 저장해 준다.

# ~/.bashrc: executed by bash(1) for non-login shells.
# see /usr/share/doc/bash/examples/startup-files (in the package bash-doc)
# for examples

# If not running interactively, don't do anything
case $- in
    *i*) ;;
      *) return;;
esac

# don't put duplicate lines or lines starting with space in the history.
# See bash(1) for more options
HISTCONTROL=ignoreboth

# append to the history file, don't overwrite it
shopt -s histappend

# for setting history length see HISTSIZE and HISTFILESIZE in bash(1)
HISTSIZE=1000
HISTFILESIZE=2000

# check the window size after each command and, if necessary,
# update the values of LINES and COLUMNS.
shopt -s checkwinsize

# If set, the pattern "**" used in a pathname expansion context will
# match all files and zero or more directories and subdirectories.
#shopt -s globstar

# make less more friendly for non-text input files, see lesspipe(1)
[ -x /usr/bin/lesspipe ] &amp;&amp; eval "$(SHELL=/bin/sh lesspipe)"

# set variable identifying the chroot you work in (used in the prompt below)
if [ -z "${debian_chroot:-}" ] &amp;&amp; [ -r /etc/debian_chroot ]; then
    debian_chroot=$(cat /etc/debian_chroot)
fi

# set a fancy prompt (non-color, unless we know we "want" color)
case "$TERM" in
    xterm-color|*-256color) color_prompt=yes;;
esac

# uncomment for a colored prompt, if the terminal has the capability; turned
# off by default to not distract the user: the focus in a terminal window
# should be on the output of commands, not on the prompt
#force_color_prompt=yes

if [ -n "$force_color_prompt" ]; then
    if [ -x /usr/bin/tput ] &amp;&amp; tput setaf 1 >&amp;/dev/null; then
        # We have color support; assume it's compliant with Ecma-48
        # (ISO/IEC-6429). (Lack of such support is extremely rare, and such
        # a case would tend to support setf rather than setaf.)
        color_prompt=yes
    else
        color_prompt=
    fi
fi

if [ "$color_prompt" = yes ]; then
    PS1='${debian_chroot:+($debian_chroot)}\[\033[01;32m\]\u@\h\[\033[00m\]:\[\033[01;34m\]\w\[\033[00m\]\$ '
else
    PS1='${debian_chroot:+($debian_chroot)}\u@\h:\w\$ '
fi
unset color_prompt force_color_prompt

# If this is an xterm set the title to user@host:dir
case "$TERM" in
xterm*|rxvt*)
    PS1="\[\e]0;${debian_chroot:+($debian_chroot)}\u@\h: \w\a\]$PS1"
    ;;
*)
    ;;
esac

# enable color support of ls and also add handy aliases
if [ -x /usr/bin/dircolors ]; then
    test -r ~/.dircolors &amp;&amp; eval "$(dircolors -b ~/.dircolors)" || eval "$(dircolors -b)"
    alias ls='ls --color=auto'
    #alias dir='dir --color=auto'
    #alias vdir='vdir --color=auto'

    alias grep='grep --color=auto'
    alias fgrep='fgrep --color=auto'
    alias egrep='egrep --color=auto'
fi

# colored GCC warnings and errors
#export GCC_COLORS='error=01;31:warning=01;35:note=01;36:caret=01;32:locus=01:quote=01'

# some more ls aliases
alias ll='ls -alF'
alias la='ls -A'
alias l='ls -CF'

# Add an "alert" alias for long running commands.  Use like so:
#   sleep 10; alert
alias alert='notify-send --urgency=low -i "$([ $? = 0 ] &amp;&amp; echo terminal || echo error)" "$(history|tail -n1|sed -e '\''s/^\s*[0-9]\+\s*//;s/[;&amp;|]\s*alert$//'\'')"'

# Alias definitions.
# You may want to put all your additions into a separate file like
# ~/.bash_aliases, instead of adding them here directly.
# See /usr/share/doc/bash-doc/examples in the bash-doc package.

if [ -f ~/.bash_aliases ]; then
    . ~/.bash_aliases
fi

# enable programmable completion features (you don't need to enable
# this, if it's already enabled in /etc/bash.bashrc and /etc/profile
# sources /etc/bash.bashrc).
if ! shopt -oq posix; then
  if [ -f /usr/share/bash-completion/bash_completion ]; then
    . /usr/share/bash-completion/bash_completion
  elif [ -f /etc/bash_completion ]; then
    . /etc/bash_completion
  fi
fi

## 복사한 명령어를 맨아래 추가
. /u01/app/oracle/product/11.2.0/xe/bin/oracle_env.sh

## oracle_env.sh 파일 내용
##----start--------
   export ORACLE_HOME=/u01/app/oracle/product/11.2.0/xe
   export ORACLE_SID=XE
   export NLS_LANG=`$ORACLE_HOME/bin/nls_lang.sh`
   export PATH=$ORACLE_HOME/bin:$PATH
##----end----------

변경 사항 반영

source ~/.bashrc

10. Oracle XE 상태 확인

Oracle의 네티워크 상태 확인을 위해 리스너 확인

lsnrctl status

LSNRCTL for Linux: Version 11.2.0.2.0 - Production on 29-5월 -2020 14:09:30

Copyright (c) 1991, 2011, Oracle.  All rights reserved.

Connecting to (DESCRIPTION=(ADDRESS=(PROTOCOL=IPC)(KEY=EXTPROC_FOR_XE)))
STATUS of the LISTENER
------------------------
Alias                     LISTENER
Version                   TNSLSNR for Linux: Version 11.2.0.2.0 - Production
Start Date                29-5월 -2020 13:16:50
Uptime                    0 days 0 hr. 52 min. 40 sec
Trace Level               off
Security                  ON: Local OS Authentication
SNMP                      OFF
Default Service           XE
Listener Parameter File   /u01/app/oracle/product/11.2.0/xe/network/admin/listener.ora
Listener Log File         /u01/app/oracle/diag/tnslsnr/miris-A320M-H/listener/alert/log.xml
Listening Endpoints Summary...
(DESCRIPTION=(ADDRESS=(PROTOCOL=ipc)(KEY=EXTPROC_FOR_XE)))
(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=miris-A320M-H)(PORT=1521)))
(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=miris-A320M-H)(PORT=8080))(Presentation=HTTP)(Session=RAW))
Services Summary...
Service "PLSExtProc" has 1 instance(s).
Instance "PLSExtProc", status UNKNOWN, has 1 handler(s) for this service...
Service "XE" has 1 instance(s).
Instance "XE", status READY, has 1 handler(s) for this service...
Service "XEXDB" has 1 instance(s).
Instance "XE", status READY, has 1 handler(s) for this service...
The command completed successfully

Sqlplus 테스트 접속

sqlplus system

SQL*Plus: Release 11.2.0.2.0 Production on 금 5월 29 14:13:56 2020

Copyright (c) 1982, 2011, Oracle.  All rights reserved.

Enter password:

Connected to:
Oracle Database 11g Express Edition Release 11.2.0.2.0 - 64bit Production

SQL>

11. Oracle XE 작업 준비

Tablespace 및 사용자 등의 추가 작업 : 이 부분은 각자 상황에 따라 다르게 적용되며, SQL로 작업한다.

11.1 Tablespace 생성

우선 테이블 스페이스가 저장되는 경로 확인을 위해 테이블스페이스 파일 테이블을 조회한다.

SELECT * FROM DBA_DATA_FILES;
    ...
CREATE TABLESPACE Tablespace명
datafile '/u01/app/oracle/oradata/XE/Tablespace명.dbf'
SIZE 100M 
reuse autoextend ON;

/********************
CREATE TABLESPACE [이름]
DATAFILE [데이터 파일 경로]
SIZE[파일 사이즈][K | M]
AUTOEXTEND [ON | OFF]
[ONLINE | OFFLINE]
[PERMANENT | TEMPORARY]
EXTENT MANAGEMENT [DICTIONARY | LOCAL [AUTOALLOCATE | UNIFORM]]
BLOCKSIZE [사이즈][K | M]
**********************/

## 테이블 스페이스 삭제
DROP TABLESPACE 테이블스페이스명 INCLUDING CONTENTS;

TABLESPACE : 테이블 스페이스의 이름을 지정한다.
DATAFILE : 테이블 스페이스를 저장할 데이터 파일의 이름과 경로를 지정한다.
SIZE : 데이터 파일의 용량을 지정한다. 단위는 K(킬로바이트) 또는 M(메가바이트) 사용
AUTOEXTEND : 공간이 부족할 때 자동으로 확장할지 여부를 지정한다.
ONLINE | OFFLINE : 테이블 스페이스를 즉시 사용할지 여부를 지정한다. (Default : ONLINE)
PERMANENT | TEMPORARY : 저장할 정보가 영구적인지 임시인지를 지정한다. (Default : PERMANENT)
EXTENT MANAGEMENT DICTIONARY | LOCAL
- DICTIONARY : 테이블 스페이스 내의 EXTENT들이 DICTIONARY TABLE에서 관리된다. (기본값)
- LOCAL : 테이블 스페이스 내의 EXTENT들이 각 DATAFILE 내에서 BITMAP으로 관리된다.
  - AUTOALLOCATE : 시스템에서 관리함. 사용자가 EXTENT SIZE를 지정할 수 없음.
  - UNIFORM : 사용자가 지정한 일정한 사이즈로 생성됨. (Default : 1M)
  → LOCAL 절을 사용하면서 AUTOALLOCATE 또는 UNIFORM을 명시하지 않으면 AUTOALLOCATE이 기본값
BLOCKSIZE : 인스턴스를 구성하는 블록의 사이즈를 지정한다.

11.2 사용자 생성

## 사용자 생성
CREATE USER User명 IDENTIFIED BY User비밀번호
DEFAULT TABLESPACE Tablespace명
TEMPORARY TABLESPACE temp;

## 사용자 삭제
DROP USER UserId CASCADE;

11.3 사용자 권한 부여

권한 부여는 GRANT, 취소는 REVOKE

## 사용자 권한 부여
GRANT CONNECT, RESOURCE, DBA to User명;


## 역할 (기본적으로 사용자를 생성하면 CONNECT, RESOUCE 역할을 준다.)
-- CONNECT ROLE : 세션 생성 및 테이블 생성, 조회 등의 가장 일반적인 권한들로 이루어진다.
-- RESOURCE ROLE : Store Procedure 또는 Trigger와 같은 PL/SQL을 사용할 수 있는 권한들로 이루어진다.
-- DBA ROLE : 모든 시스템 권한이 부여된 역할이다
-- CRATE USER : 데이터 베이스 유저 생성 권한
-- SELECT ANY TABLE : 모든 유저의 테이블 조회 권한
-- CREATE ANY TABLE : 모든 유저의 테이블 생성 권한
-- CREATE SESSION : 데이터베이스 접속 권한
-- CREATE TABLE : 테이블 생성 권한
-- CREATE PROCEDURE : 프로시져 생성 권한
-- CREATE SEQUENCE : 시퀀스 생성 권한
-- SYSDBA : 데이터베이스를 관리하는 최고 권한
-- SYSOPER : 데이터베이스를 관리하는 권한

11.4 테스트용 테이블 생성 (생선 된 UserID로 로그인)

사용자별 테이블 권한 부여

CREATE TABLE test_tb (
        name varchar2(10),
        age number(3)
  );
insert into test_tb values("test", 13);

권한 부여는 GRANT, 취소는 REVOKE

grant select, insert, delete, update on 권한부여할Table명 to User명;

11.5 기타 참고용 SQL

현재 생성된 계정 확인

SELECT * FROM DBA_USERS;
SELECT * FROM ALL_USERS;

사용자에게 부여된 시스템 권한 확인

SELECT * FROM DBA_SYS_PRIVS WHERE GRANTEE='User명';

사용자에게 부여된 Role 확인

SELECT * FROM DBA_ROLE_PRIVS WHERE GRANTEE='User명';

Role에 부여된 시스템 권한 확인

SELECT * FROM DBA_SYS_PRIVS WHERE GRANTEE = 'Role명';

다른 사용자에게 부여된 객체(테이블 등) 권한 확인

SELECT 
* 
FROM DBA_SYS_PRIVS
WHERE OWNER = '테이블소유자명';
SELECT 
* 
FROM DBA_SYS_PRIVS
WHERE GRANTEE = '권한부여자명';

사용자가 소유한 모든 테이블 조회

SELECT * FROM USER_TABLES;

유저들의 DEFAULT TEMP TABLESPACE 확인

SELECT USERNAME, DEFAULT_TABLESPACE, TEMPORARY_TABLESPACE FROM DBA_USERS;

Default Temp Tablespace를 TEMP에서 TEMP2로 변경

ALTER DATABASE DEFAULT TEMPORARY TABLESPACE TEMP2;

12. Oracle XE 삭제

Oracle XE 서비스 정지

sudo systemctl stop oracle-xe

Oracle XE 패키지 삭제

sudo dpkg --purge oracle-xe

Oracle XE 디렉터리 삭제

sudo rm -rf /u01/app

Oracle XE 데몬 삭제 및 갱신

sudo rm /etc/default/oracle-xe
sudo update-rc.d oracle-xe remove

Ubuntu 설정 파일 삭제

sudo rm /sbin/chkconfig
sudo rm /etc/rc2.d/s01shm_load
sudo rm /etc/sysctl.d/60-oracle.conf

Oracle XE Ubuntu 계정 삭제

sudo userdel -r oracle
sudo delgroup dba

Redhat 계열 Linux MariaDB 설치

키큰난쟁이 — Sat, 21 Sep 2024 00:15:26 +0900

1. 들어가며

MariaDB는 오픈소스의 관계형 데이터베이스 관리 시스템(RDBMS)이다. MySQL과 소스코드를 같이 사용하므로 사용 방법과 구조가 MySQL과 동일하다. MariaDB 커뮤니티는 MySQL과 비교해 애플리케이션 부분 속도가 약 4~5천 배 정도 빠르며, MySQL이 갖는 모든 제품의 기능을 완벽히 구현하면서도 성능 면에서는 최고 70%의 향상을 보이고 있다고 주장한다.

2. MariaDB 저장소 추가

2.1 MariaDB yum 저장소 확인

아래 사이트를 이용해 MariaDB OS별 설치 버전을 선택하면 Repository 정보와 설치방법을 설명을 보고 설치한다.
저는 CentOS7 (x86_64) 환경에 MariaDB 버전 10.6을 설치 하겠습니다.

2.2 MariaDB yum 저장소 추가

vi 텍스트 편집기를 이용해 다음과 같이 입력하고 저장

vi /etc/yum.repos.d/MariaDB.repo

# MariaDB 10.6 CentOS repository list - created 2023-02-01 04:18 UTC
# https://mariadb.org/download/
[mariadb]
name = MariaDB
baseurl = https://tw1.mirror.blendbyte.net/mariadb/yum/10.6/centos7-amd64
gpgkey=https://tw1.mirror.blendbyte.net/mariadb/yum/RPM-GPG-KEY-MariaDB
gpgcheck=1

3. MariaDB 설치

yum을 통해 MariaDB설치

yum install MariaDB

설치가 완료되고 제대로 설치가 완료됐는지 확인

rpm -qa | grep MariaDB
MariaDB-compat-10.6.11-1.el7.centos.x86_64
MariaDB-client-10.6.11-1.el7.centos.x86_64
MariaDB-common-10.6.11-1.el7.centos.x86_64
MariaDB-server-10.6.11-1.el7.centos.x86_64

또는 MariaDB 버전을 통해 확인 가능

mariadb --version

4. MariaDB 시작 및 패스워드 변경

MariaDB 실행

systemctl start mariadb

MariaDB ROOT 패스워드 변경

/usr/bin/mysqladmin -u root (변경할 비밀번호)

MariaDB가 제대로 서비스가 되고 있는지 포트 확인

netstat -anp | grep 3306
tcp6       0      0 :::3306                 :::*                    LISTEN      32131/mariadbd

5. MariaDB-Server 및 MariaDB-Client 설정

MariaDB-Server 설정

## 설정파일 위치 /etc/my.cnf.d/server.cnf

vi /etc/my.cnf.d/server.cnf

server.cnf 파일 안에 [mysqld] 항목 아래에 아래와 같이 설정 추가

#
# These groups are read by MariaDB server.
# Use it for options that only the server (but not clients) should see
#
# See the examples of server my.cnf files in /usr/share/mysql/
#

# this is read by the standalone daemon and embedded servers
[server]

# this is only for the mysqld standalone daemon
[mysqld]
character-set-server=utf8mb4   ## 서버 인코딩을 utf8로 설정
collation-server=utf8mb4_bin   ## 서버 인코딩을 utf8로 설정
autocommit=0                   ## 커밋된 데이터만 읽기로 설정
lower_case_table_names=1       ## 대소문자 구문 안하기로 설정
sql_mode="ANSI_QUOTES"         ## ("", 더블 쿼테이션) 사용 허용

### utf8 과 utf8mb4 차이
### utf8은 최초 mysql 설계시 utf8 규격에 4byte에 할당 된 문자가 없어 3byte로 설계 되었으나,4byte에 할당 된 문자 (이모티콘 문자)가 나오면서 4byte 확장을 위해 utf8mb4를 추가함utf8mb4로 접근 할 것을 권장.

#
# * Galera-related settings
#
[galera]
# Mandatory settings
#wsrep_on=ON
#wsrep_provider=
#wsrep_cluster_address=
#binlog_format=row
#default_storage_engine=InnoDB
#innodb_autoinc_lock_mode=2
#
# Allow server to accept connections on all interfaces.
#
#bind-address=0.0.0.0
#
# Optional setting
#wsrep_slave_threads=1
#innodb_flush_log_at_trx_commit=0

# this is only for embedded server
[embedded]

# This group is only read by MariaDB servers, not by MySQL.
# If you use the same .cnf file for MySQL and MariaDB,
# you can put MariaDB-only options here
[mariadb]

# This group is only read by MariaDB-10.6 servers.
# If you use the same .cnf file for MariaDB of different versions,
# use this group for options that older servers don't understand
[mariadb-10.6]

MariaDB-Client 설정

## 설정파일 위치 : /etc/my.cnf.d/mysql-clients.cnf
vi /etc/my.cnf.d/mysql-clients.cnf

#
# These groups are read by MariaDB command-line tools
# Use it for options that affect only one utility
#
[mysql]
default-character-set=utf8mb4

[mysql_upgrade]

[mysqladmin]

[mysqlbinlog]

[mysqlcheck]

[mysqldump]
default-character-set=utf8mb4

[mysqlimport]

[mysqlshow]

[mysqlslap]

MariaDB 시작 또는 실행되어 있을 경우 재시작

systemctl start mariadb
##또는
systemctl restart mariadb

6. 접속 확인

MariaDB 접속 확인

mysql
## 또는
mysql -u root -p

7. 부팅 시 자동시작 설정

자동 시작

systemctl enable mariadb
## 또는
systemctl is-enabled mariadb

자동 끔

systemctl disable mariadb

Ubuntu에서 Apache2 설치 및 Tomcat 연동

키큰난쟁이 — Fri, 20 Sep 2024 10:46:39 +0900

1. Apache2 설치 및 설정

Apache2 설치하기

sudo apt-get install apache2

Apache2 실행 중인지 확인

sudo systemctl status apache2

Apache2가 실행 중이 아니라면 아래 명령어로 실행

sudo systemctl start apache2

Apache2가 부팅 시 자동 실행되도록 설정

sudo systemctl enable apache2

Apache2는 HTTP 웹 서버로, 클라이언트로부터 요청을 받아 해당하는 웹 페이지를 전달하는 역할을 합니다. 따라서 Apache2를 설치하고 실행하는 것은 Tomcat과 연동하기 위한 기본적인 준비과정입니다.

2. Tomcat 설치 및 설정

Tomcat은 Java Servlet 및 Java Server Pages와 같은 Java EE (Enterprise Edition) 기능을 제공하는 Java 웹 애플리케이션 서버입니다. Tomcat을 설치하고 압축을 해제하는 것은 Apache2와의 연동을 위한 기본적인 준비과정입니다.

Tomcat 8.5 다운로드

wget https://dlcdn.apache.org/tomcat/tomcat-8/v8.5.86/bin/apache-tomcat-8.5.86.tar.gz

Tomcat 8.5 압축 해제

tar -zxvf apache-tomcat-8.5.69.tar.gz

Tomcat 8.5 실행

#설치된 톰캣 위치
cd apache-tomcat-8.5.69/bin/
./startup.sh

Tomcat 8.5 이 실행 중인지 확인

ps -efc | grep tomcat

3. mod_jk 설치 및 설정

mod_jk 설치

sudo apt-get install libapache2-mod-jk

mod_jk workers.properties 파일 수정

sudo vi /etc/libapache2-mod-jk/workers.properties

workers.properties 아래 내용 추가

worker.list=worker1 [woker(톰캣) 인스턴스]

workers.java_home=[JDK가 설치된 경로]

worker.worker1.type=ajp13
worker.worker1.host=localhost
worker.worker1.port=8009

WAS(톰캣) 여러 개 일 경우

worker.list=worker1,worker2 [woker(톰캣) 인스턴스]

workers.java_home=[JDK가 설치된 경로]

worker.worker1.type=ajp13
worker.worker1.host=localhost
worker.worker1.port=8009 [WAS(톰캣) Server.xml 설정 할 AJP 포트] # 포트 중복 안되도록 주의

worker.worker2.type=ajp13
worker.worker2.host=localhost
worker.worker2.port=8010 [WAS(톰캣) Server.xml 설정 할 AJP 포트] # 포트 중복 안되도록 주의

Apache 설정파일 수정

<VirtualHost *:80>
        ServerName [도메인 주소] # ex) naver.com
        ServerAlias [서브 도메인] # ex) blog.naver.com news.naver.com
        DocumentRoot [DocumentRoot 디렉토리 설정]
        JkMount /* [workers.properties 지정한 woker(톰캣) 인스턴스 명] ex) worker1

        # 아래 내용은 http -> hhtps 리다이렉트 설정
        <IfModule mod_rewrite.c>
                RewriteEngine On
                RewriteCond %{HTTPS} off
                RewriteRule .* https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
        </IfModule>

        # 아파치 에러 로그 파일 설정 (필자는 보통 도메인명으로 설정)
        ErrorLog ${APACHE_LOG_DIR}/도메인명-error.log # ex) www.naver.com-error.log
        CustomLog ${APACHE_LOG_DIR}/도메인명-access.log combined # ex) www.naver.com-access.log
</VirtualHost>
<VirtualHost *:443>
        ServerName [도메인 주소] # ex) naver.com
        ServerAlias [서브 도메인] # ex) blog.naver.com news.naver.com
        DocumentRoot [DocumentRoot 디렉토리 설정]
        JkMount /* [workers.properties 지정한 woker(톰캣) 인스턴스 명] ex) worker1

        # www 강제로 붙이기
        <IfModule mod_rewrite.c>
                RewriteEngine On
                RewriteCond %{HTTP_HOST} !^www\. [NC]
                RewriteRule ^(.*)$ http://www.%{HTTP_HOST}/$1 [R=301,L]
        </IfModule>

        # 아파치 에러 로그 파일 설정 (필자는 보통 도메인명으로 설정)
        ErrorLog ${APACHE_LOG_DIR}/도메인명-error.log # ex) www.naver.com-error.log
        CustomLog ${APACHE_LOG_DIR}/도메인명-access.log combined # ex) www.naver.com-access.log

        # 아래 내용은 SSL 적용 필자는 무료 SSL(letsencrypt) 사용
        SSLEngine on
        SSLCertificateFile "/etc/letsencrypt/live/도메인주소/cert.pem"
        SSLCertificateKeyFile "/etc/letsencrypt/live/도메인주소/privkey.pem"
        SSLCertificateChainFile "/etc/letsencrypt/live/도메인주소/chain.pem"
</VirtualHost>

강제로 https로 접속 설정 방법

<IfModule mod_rewrite.c>
RewriteEngine on
 
RewriteRule ^ - [E=protossl]
RewriteCond %{HTTPS} on
RewriteRule ^ - [E=protossl:s]
 
# https 강제이동.
# RewriteCond %{HTTPS} !=on
# RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
 
# www 강제로 붙이기.
# RewriteCond %{HTTP_HOST} .
# RewriteCond %{HTTP_HOST} !^www\. [NC]
# RewriteRule ^ http%{ENV:protossl}://www.%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
 
# www 가 붙어있으면 떼기.
# RewriteCond %{HTTP_HOST} ^www\.(.+)$ [NC]
# RewriteRule ^ http%{ENV:protossl}://%1%{REQUEST_URI} [L,R=301]
 
</IfModule>

Apache2 재시작

sudo systemctl restart apache2

4. mod_jk와 톰캣 연동

설치된 Tomcat conf 디렉토리 server.xml 수정

#설치된 톰캣 위치
sudo vi apache-tomcat-8.5.69/conf/server.xml

#기존 주석 처리 되어 있던 아래 내용을 오픈 합니다.
<!-- Define an AJP 1.3 Connector on port 8009 -->
<Connector protocol="AJP/1.3"
               address="0.0.0.0"
               port="8009"
               redirectPort="8443"
               secretRequired = "false"
               />

설치된 Tomcat 재시작

cd apache-tomcat-8.5.69/bin/
./stop.sh

# 조금 기다린 후
./startup.sh

Tomcat 연결되었는지 확인
1. 웹 브라우저에서 ServerName주소[예) http://naver.com/ 또는 localhost로 지정했다면 http://localhost/]를 열어본다. Tomcat의 인덱스 페이지가 보인다면 mod_jk가 제대로 연동된 것이다.
2. http에서 https 접속 설정은 해놨으면 http로 접속해도 https로 접속이 됩니다.

우분투(Ubuntu) Linux MariaDB 설치 및 DB, 계정 생성

키큰난쟁이 — Thu, 19 Sep 2024 22:53:10 +0900

1. MariaDB 설치하기

MariaDB의 Server와 Client 패키지 설치

apt install mariadb-server mariadb-client

MariaDB 접속 확인

mariadb

2. MariaDB 보안 설정

아래 명령어를 입력하면 root에 대한 패스워드 및 테스트 테이블에 대한 삭제 등을 진행하실 수 있습니다.

mariadb-secure-installation

NOTE: RUNNING ALL PARTS OF THIS SCRIPT IS RECOMMENDED FOR ALL MariaDB
      SERVERS IN PRODUCTION USE!  PLEASE READ EACH STEP CAREFULLY!
 
In order to log into MariaDB to secure it, we'll need the current
password for the root user.  If you've just installed MariaDB, and
you haven't set the root password yet, the password will be blank,
so you should just press enter here.
 
Enter current password for root (enter for none):
OK, successfully used password, moving on...
 
Setting the root password ensures that nobody can log into the MariaDB
root user without the proper authorisation.
## root 암호 설정 여부 : Y 권장
Set root password? [Y/n]

New password: mariadb!
Re-enter new password: mariadb! 
Password updated successfully!
Reloading privilege tables..
 ... Success!
 
 
By default, a MariaDB installation has an anonymous user, allowing anyone
to log into MariaDB without having to have a user account created for
them.  This is intended only for testing, and to make the installation
go a bit smoother.  You should remove them before moving into a
production environment.
## 익명 사용자 삭제 여부 : Y 권장
Remove anonymous users? [Y/n]

... Success!
 
Normally, root should only be allowed to connect from 'localhost'.  This
ensures that someone cannot guess at the root password from the network.
## root 원격 접속 차단 여부 : Y 권장
Disallow root login remotely? [Y/n]

... Success!
 
By default, MariaDB comes with a database named 'test' that anyone can
access.  This is also intended only for testing, and should be removed
before moving into a production environment.
## 테스트 DB 및 접속 정보 삭제 여부 : Y 권장
Remove test database and access to it? [Y/n]

- Dropping test database...
 ... Success!
 - Removing privileges on test database...
 ... Success!
 
Reloading the privilege tables will ensure that all changes made so far
will take effect immediately.
## 지금까지 설정한 권한 정보 적용 여부 : Y 권장
Reload privilege tables now? [Y/n]

Cleaning up...
 
All done!  If you've completed all of the above steps, your MariaDB
installation should now be secure.
 
Thanks for using MariaDB!

## 설정 완료

설정 후 MariaDB 정상적으로 접속되는지 확인

#관리자 권한으로 DB접속
mariadb
#일반 계정으로 DB접속
mariadb -uroot -p
password 입력

3. MariaDB 테이블 대소문자 구분 설정 해제 및 기본 포트 변경

최초로 MariaDB를 설치하면 리눅스 파일 시스템 기본 설정 상 윈도우와 다르게 테이블 이름이 대소문자를 구분 윈도우와 함께 이용하는 에이전트등에 문제가 있을 수 있기에 해당 설정을 먼저 수정해 주는 편이나, 사내 정책에 맞춰 적용 필요

MariaDB 대소문자 구분 확인

# DB 접속
mariadb

## MariaDB 접속 후
show variables like 'lower_case_table_names';

lower_case_table_name	기능
0	테이블 대소문자 구분
1	테이블 대소문자 구분 없이 소문자로 저장
2	윈도우에서 테이블 대소문자 구분

MariaDB 서버 설정 파일을 관리자 권한으로 vi 문서 편집기를 이용하여 수정

vi /etc/mysql/mariadb.conf.d/50-server.cnf

주석처리 된 port 부분을 주석 해제한 뒤 원하는 임의의 포트를 입력 (MariaDB의 기본포트는 3306)

# this is only for the mysqld standalone daemon
[mysqld]

#
# * Basic Settings
#

#user                  = mysql
pid-file               = /run/mysqld/mysqld.pid
basedir                = /usr
#datadir                = /var/lib/mysql
#tmpdir                 = /tmp
port                   = 3306
lower_case_table_names = 0

MariaDB의 서비스를 다시 시작

service mariadb restart
## 또는
systemctl restart mysql

lower_case_table_name 설정이 변경 됬는지 확인

## MariaDB 접속 후
show variables like 'lower_case_table_names';

포트가 정상적으로 변경 되었는지 확인

telnet localhost 포트번호
## 또는
netstat -tnlp

4. 방화벽 설정

위에서 지정한 포트(3306) UFW를 이용하여 방화벽 열기

## UFW 활성화
ufw enable

## 지정한 포트(3306) 방화벽 열기
ufw allow 3306

## UFW 상태 확인
ufw status verbose

아래 우분투(Ubuntu) 방화벽(UFW) 설정 글 참고

2024.09.09 - [OS/Linux] - 우분투(Ubuntu) 방화벽(UFW) 설정

5. 외부 접속 설정

MariaDB 설정 파일 50-server.cnf 문서 편집기로 열기

## MariaDB 설정 경로로 이동
cd /etc/mysql/mariadb.conf.d/
## server 설정 파일을 vu 문서 편집기 열기
vi 50-server.cnf

50-server.cnf 설정 파일 수정

## bind-address 항목을 0.0.0.0으로 변경합니다. (혹은 #을 통한 주석 처리로도 가능함.) 

# localhost which is more compatible and is not less secure.
## 아래 주석 처리 또는 0.0.0.0으로 변경
# bind-address                = 127.0.0.1

#
# * Find Tuning
#

#key_buffer_size           = 128M
#max_allowed_packet        = 1G

변경이 완료된 후 설정 파일 적용을 위해 서비스 재시작

## MariaDB service 재시작
service mariadb restart
## 또는
systemctl restart mysql

6. DB, 계정 생성 및 권한 부여

DB, 계정 생성 및 권한 부여

## MariaDB에 접속
mariadb

## (dbname)으로 데이터베이스 생성
CREATE DATABASE DB명;
## (userID) 계정을 (password) 비밀번호로 모든 IP주소('%')를 통하여 접근 가능하게 생성
CREATE USER 'User명'@'%' IDENTIFIED BY '비밀번호';
## (dbname) 아래 있는 전체 테이블(*)에 대하여 생성된 (userID) 계정에 전체 권한을 줌
GRANT ALL PRIVILEGES ON (dbname).* TO '(User명)'@'%';
## 현재 설정된 유저 권한을 적용 함
FLUSH PRIVILEGES;
## MariaDB 접속 종료
EXIT;

7. MariaDB 삭제

MariaDB 패키지를 확인

sudo dpkg -l | grep mariadb 

ii  mariadb-client-10.3                        1:10.3.32-0ubuntu0.20.04.1            amd64        MariaDB database client binaries
ii  mariadb-client-core-10.3                   1:10.3.32-0ubuntu0.20.04.1            amd64        MariaDB database core client binaries
ii  mariadb-common                             1:10.3.32-0ubuntu0.20.04.1            all          MariaDB common metapackage
ii  mariadb-server                             1:10.3.32-0ubuntu0.20.04.1            all          MariaDB database server (metapackage depending on the latest version)
ii  mariadb-server-10.3                        1:10.3.32-0ubuntu0.20.04.1            amd64        MariaDB database server binaries
ii  mariadb-server-core-10.3                   1:10.3.32-0ubuntu0.20.04.1            amd64        MariaDB database core server files

MariaDB 패키지 삭제

sudo apt-get purge mariadb-server
sudo apt-get purge mariadb-server-10.3
sudo apt-get purge mariadb-client-10.3
sudo apt-get purge mariadb-server-core-10.3
sudo apt-get purge mariadb-client-core-10.3
sudo apt-get purge mariadb-common

Redhat 계열 Linux에 Jeus8 앱 배포

키큰난쟁이 — Wed, 18 Sep 2024 00:22:34 +0900

2024.09.10 - [서버/WAS] - Redhat 계열 Linux에 Jeus8 설치

Redhat 계열 Linux에 Jeus8 설치

1. 들어가며✅ Jeus8 설치하며 정리한 글이며, 이 정리글은 방화벽을 꺼둔상태에서 작업했기때문에 이글을 읽으신 모든 분들은 방화벽 열고 닫는 작업을 따로 해주셔야됩니다 :)2. Jeus8 설치 전 사

bigdwarf.blog

1. 들어가며

1.1 목적

✅ Linux Jeus8 앱 배포하면서 정리하는 글

1.2 구성환경

Jeus8 버전
Rocky Linux 9.2

1.3 앱 배포 방식(Archive & Exploded)

Jeus 앱 배포 방식은 Archive, Exploded 두 가지 방법이 존재합니다. 두 가지 방법 중 환경에 따라 선택해서 진행하시면 됩니다.

2. Jeus8 Archive 앱 배포

2.1 Install

http://서버IP:9736/webadmin 로그인 → Applications 이동 후 → install 버튼 클릭

애플리케이션 ID 값을 지정해 준다. 단, ID 값은 도메인에 유일한 값이어야 한다.
배포할 파일을 내 로컬 PC에서 업로드를 진행하면 됩니다.

2.2 Deploy

Deploy 진행할 앱을 목록 중 선택 후 → Deploy 클릭

앱을 배포한 서버를 선택해 준다.

고급 선택사항 하단에 context Path 지정해 주고 확인 버튼 클릭

동일한 서버에 앱이 실행되어 있으면 배포가 되지 않습니다. 아래와 같이 INSTALLED 상태에서 멈춤

정상적으로 배포가 됐을 경우

❗Archive 배포 파일 위치
   $JEUS_INSTALL_DIR/domains/domainName/.applications/application_ID/archive_file_name
   /home/jeus/domains/jeus_domain/.applications/deployTest/deployTest.war

❗배포된 소스 위치
  $JEUS_INSTALL_DIR/domains/jeus_domain/server/SERVER_ID/.workspace/deployed/application_ID/fileName_extension__
  /home/jeus/domains/jeus_domain/servers/server1/.workspace/deployed/deployTest/deployTest_war___/index.html

3. Jeus8 Exploded 앱 배포

3.1 Deploy

deploy 클릭

id : 애플리케이션 ID
path : 서버에 있는 배포파일 위치 ex) /home/jeus/application/deployTest/deployTest.war
배포파일이 아닌 직접 앱 디렉터리 Path를 지정해 줄 수도 있습니다. ex) /home/jeus/application/deployTest
Target Server : 배포할 서버

고급 선택사항 하단에 context Path 지정해 주고 확인 버튼 클릭

정상적으로 배포가 됐을 경우

❗Exploded 배포 파일 위치 (배포파일 또는 앱폴더 경로로 잡아서 작업 가능)
  /home/jeus/applicatios/deployTest.war 또는 /home/jeus/applicatios/deployTest 소스폴더

❗배포파일로 배포됬을 경우 소스 위치
 $JEUS_INSTALL_DIR/domains/jeus_domain/server/SERVER_ID/.workspace/deployed/application_ID/fileName_extension__
  /home/jeus/domains/jeus_domain/servers/server1/.workspace/deployed/deployTest/deployTest_war___/index.html

❗앱폴더로 배포됬을 경우 소스 위치
   /앱폴더 위치
  /home/jeus/applicatios/deployTest/index.html

4. http://서버IP:8088/ 접속

4.1 배포가 잘되었는지 확인

Redhat 계열 Linux에 Jeus8 설치

키큰난쟁이 — Wed, 18 Sep 2024 00:21:10 +0900

1. 들어가며

✅ Jeus8 설치하며 정리한 글이며, 이 정리글은 방화벽을 꺼둔상태에서 작업했기때문에 이글을 읽으신 모든 분들은 방화벽 열고 닫는 작업을 따로 해주셔야됩니다 :)

2. Jeus8 설치 전 사전 준비

2.1 JDK7 또는 JDK 8 설치

❗Jeus8은 JDK 7 또는 JDK 8 2GB 이상의 하드디스크 여유 공간이 필요합니다. yum을 통한 패키지 설치 진행하기전 설치가능한 JDK 버전 확인

yum을 통한 패키지 설치 진행하기전 설치가능한 JDK 버전 확인

# 설치 가능한 JDK 버전 확인
yum list java*jdk-devel

설치가능한 패키지 리스트 중 JDK 8 확인 (java-1.8.0-openjdk-devel.x86_64)

Last metadata expiration check: 1:53:20 ago on Thu 14 Sep 2023 12:17:02 PM KST.
Available Packages
java-1.8.0-openjdk-devel.x86_64     1:1.8.0.382.b05-2.el9               appstream
java-11-openjdk-devel.x86_64        1:11.0.20.0.8-3.el9                 appstream
java-17-openjdk-devel.x86_64        1:17.0.8.0.7-2.el9                  appstream

yum을 통한 패키지 설치 진행

# JAVA 8 설치
yum install java-1.8.0-openjdk-devel.x86_64

버전 확인

# JAVA 버전 확인
java -version

openjdk version "1.8.0_382"
OpenJDK Runtime Environment (build 1.8.0_382-b05)
OpenJDK 64-Bit Server VM (build 25.382-b05, mixed mode)

2.2 데모 라이센스 발급

[technet.tmax.co.kr] 해당 링크 통해서 라이센스 발급

https://technet.tmax.co.kr/

technet.tmax.co.kr

로그인 후 데모라이센스 신청 클릭

항목 작성 후 라이센스 발급 진행하되, HostName은 꼭 서버 HostName과 동일하게 작성해주시면 됩니다.

필요에 따라 선택해서 라이센스 발급 받으시면됩니다. 저는 Jeus 5Fix#19 or Later Demo로 라이센스 발급받았습니다.

발급 신청하시면 작성하신 메일주소로가서 첨부된 라이센스 확인 후 잘보관해둡니다.

2.3 Jeus 설치 파일 다운로드

[technet.tmax.co.kr] 해당 링크 통해 다운로드

https://technet.tmax.co.kr/

technet.tmax.co.kr

설치 하실 JEUS 버전을 확인후 다운로드 버튼을 클릭합니다. 저는 JEUS8을 설치하기때문에 JEUS8 다운로드 클릭

자신의 운영체제, 아키텍쳐에 맞는 설치파일을 다운로드 받고 보관해둡니다. 저는 Linux (x86) 64-bit 다운로드

3. Jeus8 계정 생성

Jeus 계정 생성

# jeus 계정 생성
sudo adduser jeus
# jeus 비밀번호 설정
sudo passwd jeus

Changing password for user jeus.
New password: // 입력 후 엔터
Retype new password:  // 입력 후 엔터
passwd: all authentication tokens updated successfully.

4. Jeus8 설치

❗목차 2.3에서 다운받은 파일 설치할 서버로 업로드 해주시길 바랍니다.

업로드된 파일 확인 및 실행권한 부여

# 업로드 된 파일 확인
pwd
/home/jeus/jeus8001_unix_generic_ko.bin

# 실행 권한 부여
chmod u+x jeus8001_unix_generic_ko.bin

콘솔에서 다음의 명령을 입력한 후 <ENTER> 키를 누른다.

# 업로드한 파일 실행
./jeus8001_unix_generic_ko.bin

Preparing to install...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...

Launching installer...

Preparing CONSOLE Mode Installation...

JEUS 라이선스 준수 화면이 나타난다.

===============================================================================
License Agreement
-----------------

Installation and Use of JEUS8 Requires Acceptance of the Following License 
Agreement:

JEUS (Java Enterprise User Solution) Release JEUS 8
TmaxSoft Co., Ltd. (hereafter, TmaxSoft) End-User License Agreement

Product : JEUS

This is a legal agreement between you (either an individual or an company) and 
TmaxSoft, Incorporated.  By opening the sealed software package and/or by using
the software, you agree to be bound by the terms of this agreement.

TmaxSoft License
1.  Grant of License:  This TmaxSoft License Agreement ("License") permits you 
to use one copy of the TmaxSoft product JEUS, on any single computer, provided 
the software is in use on only one computer at any one time.  If this package 
is a license pack, you may make and use additional copies of the software up to
the number of licensed copies authorized.  If you have multiple licenses for 
the software, then at any time you may have as many copies of the software in 
use as you have licenses.
  The software is "in use" on a computer when it is loaded into the temporary 
memory (i.e., RAM) or installed into the permanent memory (e.g., hard disk, 
CD-ROM, or other storage devices) of that computer, except that a copy 
installed on a network server for the sole purpose of distribution to other 
computers is not "in use".  If the anticipated number of users of the software 
will exceed the number of applicable licenses, then you must have a reasonable

JEUS 라이선스 준수에 대한 다음 정보를 보기 위해 <ENTER> 키를 누른다.

PRESS <ENTER> TO CONTINUE: 

mechanism or process in place to ensure that the number of persons using the 
software concurrently does not exceed the number of licenses.

2.  Copyright:  The software (including any images, "applets," photographs, 
animations, video, audio, music and text incorporated into the software) is 
owned by TmaxSoft or its suppliers and international treaty provisions. 
Therefore, you must treat the software like any other copyrighted materials 
(e.g., a book or musical recording) except that you may either (a) make one 
copy of the software solely for backup or archival purposes, or (b) transfer 
the software to a single hard disk provided you keep the original solely for 
backup or archival purposes.  You may not copy the printed materials 
accompanying the software, nor print copies of any user documentation provided 
in "online" or electronic form.

3.  Other restrictions: This license is your proof of license to exercise the 
rights granted herein and must be retained by you. You may not rent, lease, or 
transfer your rights under this license on a permanent basis provided you 
transfer this license, the software, and all accompanying printed materials, 
retain no copies, and the recipient agrees to the terms of this license. You 
may not reverse engine, decompile, or disassemble the software, except to the 
extent that the foregoing restriction is expressly prohibited by applicable 
law.

라이선스 동의 여부를 결정한다. 동의를 하면 ‘y’를 입력한 후 <ENTER> 키를 누르고, 아니면 ‘n’을 입력한 후 <ENTER> 키를 누른다.

PRESS <ENTER> TO CONTINUE: 

DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): Y

플랫폼 목록 중 설치할 플랫폼을 입력한다.

===============================================================================
Choose Platform
---------------

Choose the operating system and architecture :
1)HP-UX PA-RISC
2)HP-UX Itanium
3)Solaris UltraSPARC
4)Solaris x86
5)Solaris x64
6)AIX 5.x, 6.x, 7.x PowerPC
7)Linux Itanium
8)Linux x86
9)Linux x64
10)Linux PowerPC 64
Quit) Quit Installer

Choose Current System (DEFAULT: 9): 9

설치 디렉터리를 선택한다. 기본적으로 제공되는 값을 사용하려면 <ENTER> 키를 누르고, 디렉터리 변경을 원하면 설치 경로를 입력한다. 필자는 기본 경로를 /home/jeus 로 변경

===========================================================
Installation Folder
-------------------

Enter the installation folder.

  Default Install Folder: /home/jeus/jeus8

ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT
      : /home/jeus

설치 디렉터리를 선택한다. 기본적으로 제공되는 값을 사용하려면 <ENTER> 키를 누르고, 디렉터리 변경을 원하면 설치 경로를 입력한다.

===========================================================
Installation Folder
-------------------

Enter the installation folder.

  Default Install Folder: /home/jeus/jeus8

ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT
      : /home/jeus
INSTALL FOLDER IS: /home/jeus
   IS THIS CORRECT? (Y/N): Y

폴더가 존재하면 Overwrite 진행

===============================================================================
Directory Check
---------------

User Specified Directory exists. To overwrite JEUS 8, click 'Overwrite'. To 
choose Different directory, click 'Change'. To cancel the installation, click 
'Cancel'.

  ->1- Overwrite
    2- Change...
    3- Cancel

ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE 
   DEFAULT: 1

JDK의 위치를 입력한다. <ENTER> 키를 누르면 자동으로 인식한 JDK의 위치를 사용한다. 디렉터리를 변경하려면 설치 경로를 입력한다.

===============================================================================
Enter the JDK path.
-------------------

Enter the JDK path:

Enter the JDK path (Default: /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.382.b05-2.
   el9.x86_64):

Domain Admin Server(DAS)와 Managed Server(MS), Cloud Server 중 설치할 서버를 선택한다. 기본적으로는 Domain Admin Server가 설정된다.

===============================================================================
Installation type
-----------------

Please choose the Install Set to be installed by this installer.

  ->1- Domain Admin Server
    2- Managed Server
    3- Cloud Server

ENTER THE NUMBER FOR THE INSTALL SET, OR PRESS <ENTER> TO ACCEPT THE DEFAULT
   : 1

각 설치 항목에 대한 설명이다.

항목	설명
Domain Admin Server	Domain Admin Server(DAS)와 Managed Server(MS)를 설치한다. Domain Admin Server는 Managed Server를 관리하기 위한 서버이다.
Managed Server	Managed Server를 설치한다.
Cloud Server	Cloud Server를 설치한다.

Domain Admin Server를 선택한 경우 Installation Mode를 선택한다. 기본적으로는 Production Mode가 설정된다. 필자는 개발목적이기때문에 2번 Development Mode 선택

==========================================================
Installation Mode
-----------------

* Production Mode
- Disables JEUS Hot Swap.
- Disables Automatic Reloading.
- Displays a warning message and recommends using a full license if a demo 
license is used.

* Development Mode
- Enables JEUS Hot Swap.
- Enables Automatic Reloading.

  ->1- Production Mode
    2- Development Mode
    3- Cancel

ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE 
   DEFAULT: 2

각 설치 항목에 대한 설명이다.

항목	설명
Production Mode	Production Mode로 설치한다. JEUS Hot Swap, Automatic Reloading을 사용하지 않는다. demo license가 사용되면 경고 메시지가 출력된다.
Development Mode	Development Mode로 설치한다. JEUS Hot Swap, Automatic Reloading을 사용한다.

Domain Admin Server를 선택한 경우 Domain Admin Server에 사용할 도메인 이름을 입력한다.

===============================================================================
input JEUS Environments :: JEUS Domain Name
-------------------------------------------

Enter the
- JEUS Domain Name
- Enter alphanumeric characters (case-sensitive).

Domain Name (DEFAULT: jeus_domain):

사용할 Domain Admin Server의 이름을 입력한다.

===============================================================================
input JEUS Environments :: DAS Server Name
------------------------------------------

Enter the
- DAS Server Name
- Enter alphanumeric characters (case-sensitive).

DAS Server Name (DEFAULT: adminServer):

사용할 Domain Admin Server의 BASEPORT를 입력한다.

===============================================================================
input JEUS Environments :: JEUS BASEPORT
----------------------------------------

Enter the
- JEUS BASEPORT
- Enter digits Only

JEUS BASEPORT (DEFAULT: 9736):

사용할 JEUS 관리자의 이름을 입력한다.

===============================================================================
input JEUS Environments :: Admin User Name
------------------------------------------

Enter the
- Admin User Name
- Enter alphanumeric characters (case-sensitive).

Admin User Name (DEFAULT: administrator):

Domain Admin Server를 선택한 경우 JEUS 관리자의 패스워드를 입력한다. 이 패스워드는 “administrator” ID로 할당된다.

===============================================================================
Password Input
--------------

Enter the Password for the administrator account.

Input Password ::*

# 참고사항 
1. 패스워드는 JEUS를 기동하는 필수적인 요소이다. 입력한 패스워드는 기억장치에 기록되며, 주의 깊게 입력해야 한다. 
2. 패스워드는 8자 이상으로 설정해야 하며, 연속 3개 이상 같은 문자, 공백, 'Admin User Name'과 입력한 값과 동일하게 설정할 수 없다.

Domain Admin Server를 선택한 경우 사용할 노드 매니저를 선택한다. 기본적으로는 Java 타입의 노드 매니저가 설정된다.

===============================================================================
Node Manager
------------

select either ssh or java node manager

  ->1- java
    2- ssh
    3- Cancel

ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE
   DEFAULT:

각 설치 항목에 대한 설명이다.

항목	설명
java	Java로 구현된 노드 매니저
ssh	OS에서 제공하는 SSH를 사용하는 노드 매니저이다.

Sample Directory 설치 선택한다.

===============================================================================
Sample Directory
----------------

Do you want Sample Directory?

  ->1- yes
    2- no
    3- Previous

ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE
   DEFAULT:

다음 화면은 설치에 관련한 요약정보를 보여준다. <ENTER> 키를 누르면 설치가 진행된다.

===============================================================================
Pre-Installation Summary
------------------------

Review the Following Before Continuing:

Product Name:
    JEUS 8

Install Folder:
    /home/jeus

Install Set:
    Domain Admin Server

Disk Space Information (for Installation Target): 
    Required:  516,452,041 Bytes
    Available: 43,698,216,960 Bytes

PRESS <ENTER> TO CONTINUE:

진행 바와 함께 설치가 진행된다.

===========================================================
Installing...
-------------

[===============|===============|===============|===============]
[---------------|---------------|---------------|---------------]

설치가 완료된다.
===============================================================================
Installation Complete
---------------------

JEUS8 has been successfully installed to:

     /home/jeus

PRESS <ENTER> TO EXIT THE INSTALLER:

Jeus 버전정보 확인

jeusadmin -fullversion
8.0.0.1-b105067

5. Jeus8 기동 및 종료

5.1 Jeus8 기동 전 작업

.Bash_profile 갱신 (설치 후 Jeus Path가 자동으로 등록해주기때문에 갱신 필요)

# jeus 계정 디렉토리 이동 후
source .bash_profile

라이센스 파일 /home/jeus/license/ 경로에 저장

# 업로드 파일 확인
cd /home/jeus/license
ls -al
drwx------.  2 jeus jeus   21 Sep 14 15:41 .
drwx------. 16 jeus jeus 4096 Sep 14 15:40 ..
-rw-r--r--.  1 jeus jeus  350 Sep 14 15:41 license

jeus 사용자 정보 등록 (서버 기동 시 아이디 및 비밀번호 입력 생략을 위한 작업)

vi /home/jeus/bin/jeus.properties

username=administrator # 설치과정에서 디폴트값으로 지정했으면
password=              # 설치과정에서 입력한 비밀번호

5.2 Jeus8 Domain Admin Server(DAS) 기동 및 종료

Domain Admin Server(DAS) 기동

## Domain Admin Server(DAS) 기동
## /home/jeus/bin 디렉토리 이동 후 아래 명령어 실행

startDomainAdminServer -domain [도메인명] -u [관리자ID] -p [관리자 PW]
ex) startDomainAdminServer -domain jeus_domain -u administrator -p 111111

Domain Admin Server(DAS) 종료

## Domain Admin Server(DAS) 종료
## /home/jeus/bin 디렉토리 이동 후 아래 명령어 실행

jeusadmin -host [DAS IP:DAS PORT] -domain [도메인명] -u [관리자ID] -p [관리자 PW] "local-shutdown -to 120"
ex) jeusadmin -host localhost:9736 -domain jeus_domain -u administrator -p 111111 "local-shutdown -to 120"

5.3 Jeus8 NodeManager 기동 및 종료

NodeManager 기동

## NodeManager 기동
## /home/jeus/bin 디렉토리 이동 후 아래 명령어 실행

nohup startNodeManager > /home/jeus/nodemanager/logs/nm.log &amp;
[1] 3208

NodeManager 로그 확인

## NodeManager 로그 확인
cat /home/jeus/nodemanager/logs/nm.log

NodeManager 종료

## NodeManager 종료

stopNodeManager -properties [jeusnm.xml 파일 경로]
ex) stopNodeManager -properties /home/jeus/nodemanager/jeusnm.xml

5.4 Jeus8 Jeusadmin 콘솔 기동

## Managed Server(MS) 종료
## /home/jeus/bin 디렉토리 이동 후 아래 명령어 실행

jeusadmin -host [DAS IP:DAS PORT] -domain [도메인명] -u [관리자ID] -p [관리자 PW]
ex) jeusadmin -host localhost:9936 -domain jeus_domain -u administrator -p 111111

5.5 Server1 기동 예제

## /home/jeus/bin 디렉토리 이동 후 아래 명령어 실행
## jeus 사용자 정보 등록 했을 경우 계정 및 비밀번호 생략 가능

# AdminServer 기동
startDomainAdminServer -domain jeus_domain

# NodeManager 기동
nohup startNodeManager > /home/jeus/nodemanager/logs/nm.log &amp;

# ManagedServer 기동
startManagedServer -dasurl 192.168.0.7:9736 -domain jeus_domain -server server1

# jeusadmin 콘솔 확인 (jeusadmin콘솔 확인은 계정 비밀번호 생략 안됨)
jeusadmin -host 192.168.0.7:9736 -domain jeus_domain -u administrator -p 비밀번호

192.168.0.7:8088 서버1 페이지 확인

6. Jeus8 WebAdmin 접속

계정 : administrator (jeus 설치 시 생성했던 계정명)

Git이란? GitHub? SVN?

키큰난쟁이 — Wed, 18 Sep 2024 00:20:53 +0900

1. 들어가며

Git 관련해서 정리하기 위해 정리 시작한 글

2. Git이란 무엇인가?

Git은 2005년 리누스 토발즈가 개발한 분산 버전 관리 시스템으로, 현대 소프트웨어 개발에서 필수적인 도구로 자리 잡았습니다. 코드의 변경 사항을 효과적으로 추적하고 여러 개발자 간의 협업을 원활하게 만드는 Git의 강력한 기능들은 많은 개발 팀들이 기존의 SVN(Subversion)에서 Git으로 전환하게 만든 주요 요인입니다.

2.1 Git의 구조

Git은 크게 세 가지 영역으로 구성됩니다.

작업 디렉터리(Working Directory) : 실제 파일들이 존재하는 곳
스테이징 영역(Staging Area) : 커밋할 파일들의 정보를 저장하는 곳
저장소(Repository) : 커밋된 파일들의 버전을 저장하는 곳

2.2 Git의 주요 특징

분산 버전 관리 : 중앙 서버 없이도 로컬에서 버전 관리가 가능합니다.
빠른 속도 : 대규모 프로젝트에서도 뛰어난 성능을 보입니다.
비선형적 개발 : 여러 브랜치를 통해 동시다발적인 개발이 가능합니다.
데이터 무결성 : 모든 파일의 체크섬을 통해 데이터의 정확성을 보장합니다.

2.3 Git을 사용해야 하는 이유

버전관리 : 프로젝트의 변경 이력을 쉽게 추적하고 관리할 수 있습니다.
협업 용이성 : 여러 개발자가 동시에 작업하고 코드를 공유할 수 있습니다.
백업과 복구 : 언제든 이전 버전으로 돌아갈 수 있어 실수를 쉽게 복구할 수 있습니다.
브랜치 기능 : 새로운 기능을 개발하거나 실험할 때 메인 코드에 영향을 주지 않고 작업할 수 있습니다.

3. Git과 GitHub

많은 사람들이 Git과 GitHub를 혼동하지만, 이 둘은 다릅니다.

Git : 버전 관리 시스템 자체
GitHub : Git을 사용하는 프로젝트를 호스팅 하고 협업할 수 있는 웹 서비스

4. Git과 SVN

4.1 Git과 SVN 차이점 표

특성	Git	SVN
구조	분산형	중앙집중식
저장소	로컬 복사본	중앙 서버
오프라인 작업	가능	제한적
성능	빠름(로컬 작업)	상대적으로 느림
학습곡선	가파름	완만함

5. 마무리

Git은 현대 소프트웨어 개발에서 없어서는 안 될 중요한 도구입니다. SVN에 비해 더 유연하고 강력한 기능을 제공하며, 현대적인 개발 환경과 잘 어울립니다. Git으로의 전환은 팀의 생산성과 협업 능력을 크게 향상할 수 있습니다. Git을 익히는 것은 모든 개발자에게 필수적인 기술이 되었으며, 이를 통해 더 나은 코드 관리와 팀 협업을 실현할 수 있습니다.

Redhat 계열 Linux에 WebtoB 5 설치

키큰난쟁이 — Tue, 17 Sep 2024 00:36:46 +0900

1. 들어가며

WebtoB 5 설치할 겸 정리하는 글

2. WebtoB 5 설치 전 사전 준비

2.1 JDK 6 이상 설치 필요

✅ WebtoB5 JDK 버전은 Java 버전 6 또는 그 이상의 버전이 필요합니다. 저는 JDK 8 버전으로 설치

yum을 통한 패키지 설치 진행하기 전 설치가능한 JDK 버전 확인

# 설치 가능한 JDK 버전 확인
yum list java*jdk-devel

설치가능한 패키지 리스트 중 JDK 8 확인 (java-1.8.0-openjdk-devel.x86_64)

Last metadata expiration check: 1:53:20 ago on Thu 14 Sep 2023 12:17:02 PM KST.
Available Packages
java-1.8.0-openjdk-devel.x86_64     1:1.8.0.382.b05-2.el9               appstream
java-11-openjdk-devel.x86_64        1:11.0.20.0.8-3.el9                 appstream
java-17-openjdk-devel.x86_64        1:17.0.8.0.7-2.el9                  appstream

yum을 통한 패키지 설치 진행

JAVA 8 설치
yum install java-1.8.0-openjdk-devel.x86_64

버전 확인

# JAVA 버전 확인
java -version

openjdk version "1.8.0_382"
OpenJDK Runtime Environment (build 1.8.0_382-b05)
OpenJDK 64-Bit Server VM (build 25.382-b05, mixed mode)

2.2 WebtoB 5 데모 라이센스 발급

[technet.tmax.co.kr] 해당 링크 통해서 라이센스 발급

https://technet.tmax.co.kr/

technet.tmax.co.kr

로그인 후 데모라이센스 신청 클릭

항목 작성 후 라이센스 발급 진행하되, HostName은 꼭 서버 HostName과 동일하게 작성해 주시면 됩니다.

라이선스 파일이 첨부된 이메일이 왔는지 입력하신 메일 접속하여 확인

2.3 WebtoB 5 설치 파일 다운로드

[technet.tmax.co.kr] 해당 링크 통해 다운로드

https://technet.tmax.co.kr/

technet.tmax.co.kr

설치 하실 WebtoB 버전을 확인 후 다운로드 버튼을 클릭합니다. 저는 WebtoB5를 설치하기 때문에 WebtoB5 다운로드 클릭

자신의 운영체제, 아키텍쳐에 맞는 설치파일을 다운로드하고 보관해 둡니다. 저는 Linux (x86) 64-bit 다운로드

3. WebtoB 5 설치

3.1 WebtoB 5 계정 생성

# webtob 계정 생성
sudo adduser webtob
# webtob 비밀번호 설정
sudo passwd webtob

Changing password for user jeus.
New password: // 입력 후 엔터
Retype new password:  // 입력 후 엔터
passwd: all authentication tokens updated successfully.

3.2 설치파일 /home/webtob 계정 경로 업로드 및 실행 권한 부여

❗목차 2.3에서 다운받은 파일 설치할 서버로 업로드 해주시길 바랍니다.

업로드된 파일 확인 및 실행권한 부여

# 업로드 된 파일 확인
pwd
/home/webtob/WEBTOB5_0_SP0_Fix0_LinuxK2_6_x64.bin

# 실행 권한 부여
chmod u+x WEBTOB5_0_SP0_Fix0_LinuxK2_6_x64.bin

3.3 WebtoB 5 설치 진행

콘솔에서 다음의 명령을 입력한 후 키를 누른다.

# 업로드한 파일 실행
./WEBTOB5_0_SP0_Fix0_LinuxK2_6_x64.bin

설치 파일을 실행시키면 WebtoB를 설치하기 위한 준비작업을 진행한 후 간단한 사용 안내와 함께 진행 여부를 선택한다. 계속 진행하려면 <ENTER> 키를 누르고, 중단하려면 ‘quit’를 입력한다.

Preparing to install...
Extracting the JRE from the installer archive...
Unpacking the JRE...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...

Launching installer...

Preparing CONSOLE Mode Installation...

===============================================================================
WEBTOB5_0_SP0_Fix#0               (created with InstallAnywhere by Macrovision)
-------------------------------------------------------------------------------




===============================================================================
Introduction
------------

InstallAnywhere will guide you through the installation of WEBTOB5_0_SP0_Fix#0.

It is strongly recommended that you quit all programs before continuing with 
this installation.

Respond to each prompt to proceed to the next step in the installation.  If you
want to change something on a previous step, type 'back'.

You may cancel this installation at any time by typing 'quit'.

PRESS <ENTER> TO CONTINUE:

WebtoB 라이선스에 대한 내용이 출력되고, 동의 여부를 묻는다. 라이선스에 동의하면 ‘Y’를 입력하여 다음 단계로 진행하고, ‘N’을 입력하여 라이선스에 동의하지 않으면 설치는 중단된다.

===============================================================================
License Agreement
-----------------

Installation and use of WEBTOB5_0_SP0_Fix#0 requires acceptance of the 
following License Agreement:

WebtoB Release
Tmax Soft Co., Ltd. (hereafter, Tmax Soft) End-User License Agreement

Product : WebtoB

This is a legal agreement between you (either an individual or an company) and 
Tmax Soft, Incorporated.  By opening the sealed software package and/or by 
using the software, you agree to be bound by the terms of this agreement.

Tmax Soft License
1.  Grant of License:  This Tmax Soft License Agreement ("License") permits you
to use one copy of the Tmax Soft product Tmax, on any single computer, provided
the software is in use on only one computer at any one time.  If this package 
is a license pack, you may make and use additional copies of the software up to
the number of licensed copies authorized.  If you have multiple licenses for 
the software, then at any time you may have as many copies of the software in 
use as you have licenses.
  The software is "in use" on a computer when it is loaded into the temporary 
memory (i.e., RAM) or installed into the permanent memory (e.g., hard disk, 
CD-ROM, or other storage devices) of that computer, except that a copy 
installed on a network server for the sole purpose of distribution to other 
computers is not "in use".  If the anticipated number of users of the software 
will exceed the number of applicable licenses, then you must have a reasonable 

PRESS <ENTER> TO CONTINUE:

라이선스에 대한 내용을 계속해서 보려면 <ENTER> 키를 누르고, 설치를 중단하려면 ‘quit’을 입력한다.

===============================================================================
License Agreement
-----------------

Installation and use of WEBTOB5_0_SP0_Fix#0 requires acceptance of the 
following License Agreement:

WebtoB Release
Tmax Soft Co., Ltd. (hereafter, Tmax Soft) End-User License Agreement

Product : WebtoB

This is a legal agreement between you (either an individual or an company) and 
Tmax Soft, Incorporated.  By opening the sealed software package and/or by 
using the software, you agree to be bound by the terms of this agreement.

Tmax Soft License
1.  Grant of License:  This Tmax Soft License Agreement ("License") permits you
to use one copy of the Tmax Soft product Tmax, on any single computer, provided
the software is in use on only one computer at any one time.  If this package 
is a license pack, you may make and use additional copies of the software up to
the number of licensed copies authorized.  If you have multiple licenses for 
the software, then at any time you may have as many copies of the software in 
use as you have licenses.
  The software is "in use" on a computer when it is loaded into the temporary 
memory (i.e., RAM) or installed into the permanent memory (e.g., hard disk, 
CD-ROM, or other storage devices) of that computer, except that a copy 
installed on a network server for the sole purpose of distribution to other 
computers is not "in use".  If the anticipated number of users of the software 
will exceed the number of applicable licenses, then you must have a reasonable 

PRESS <ENTER> TO CONTINUE:

다음은 <ENTER> 키를 눌러 라이선스를 끝까지 조회한 화면이다.

mechanism or process in place to ensure that the number of persons using the 
software concurrently does not exceed the number of licenses.

2.  Copyright:  The software (including any images, "applets," photographs, 
animations, video, audio, music and text incorporated into the software) is 
owned by Tmax Soft or its suppliers and international treaty provisions. 
Therefore, you must treat the software like any other copyrighted materials 
(e.g., a book or musical recording) except that you may either (a) make one 
copy of the software solely for backup or archival purposes, or (b) transfer 
the software to a single hard disk provided you keep the original solely for 
backup or archival purposes.  You may not copy the printed materials 
accompanying the software, nor print copies of any user documentation provided 
in "online" or electronic form.

3.  Other restrictions: This license is your proof of license to exercise the 
rights granted herein and must be retained by you. You may not rent, lease, or 
transfer your rights under this license on a permanent basis provided you 
transfer this license, the software, and all accompanying printed materials, 
retain no copies, and the recipient agrees to the terms of this license. You 
may not reverse engine, decompile, or disassemble the software, except to the 
extent that the foregoing restriction is expressly prohibited by applicable 
law.

PRESS <ENTER> TO CONTINUE: 



DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): Y

Install Set을 선택한다. WebtoB만 설치하려면 1번을 선택한다. WebtoB Standard Edition에서 제공되는 Servlet Engine과 함께 설치하려면 2번을 선택한다. Servlet Engine 기능은 데모 라이선스에서 제한 없이 제공되지만 정식 라이선스의 경우에는 반드시 Standard 라이선스를 적용해야 한다.

===============================================================================
Choose Install Set
------------------

Please choose the Install Set to be installed by this installer.

  ->1- WebtoB
    2- Servlet + WebtoB

ENTER THE NUMBER FOR THE INSTALL SET, OR PRESS <ENTER> TO ACCEPT THE DEFAULT
   : 1

WebtoB가 설치될 디렉터리를 설정한다. 기본값을 사용하려면 <Enter> 키를 누르고, 디렉터리를 변경하려면 직접 절대 경로를 입력한다. (기본값:$HOME/webtob) 저는 기본 경로를 /home/webtob 로 변경

===============================================================================
Choose Install Folder
---------------------

Where would you like to install?

   Default Install Folder: /home/webtob/webtob

ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT
      :/home/webtob

WebtoB 파일의 설치에 앞서 제품, 설치 경로, Install Set(Servlet Engine 설치 여부), 디스크 용량 정보 등을 확인한다. 계속 진행하려면 <ENTER> 키를 누르고, 중단하려면 ‘quit’을 입력한다.

===============================================================================
Pre-Installation Summary
------------------------

Please Review the Following Before Continuing:

Product Name:
    WEBTOB5_0_SP0_Fix#0

Install Folder:
    /home/webtob

Install Set
    WebtoB

Disk Space Information (for Installation Target): 
    Required:  118,357,437 bytes
    Available: 3,114,831,872 bytes

PRESS <ENTER> TO CONTINUE:

설치 정보를 확인하면 설치 준비 여부를 다시 한 번 확인한다. 준비가 완료되었다면 <ENTER> 키를 눌러 계속 진행하고, 중단하려면 ‘quit’을 입력한다.

===============================================================================
Ready To Install
----------------

Ready to install WEBTOB5_0_SP0_Fix#0 onto your system at the following 
location:

   /home/webtob

PRESS <ENTER> TO INSTALL:

WebtoB 파일을 설치하고, WebtoB 설치에 필요한 작업들을 수행한 후 해당 플랫폼에서 open file descriptors 조회 및 영구 수정 방법을 출력한다. 정보를 모두 확인하였으면 <ENTER> 키를 눌러 다음 단계로 진행한다.

==============================================================================
Installing...
-------------

 [==================|==================|==================|==================]
 [------------------|------------------|------------------|------------------]


===============================================================================
Information
-----------

The administrator can set the maximum number of file descriptors as follows.
The machine needs a reboot in order for the configuration change to take
effect.

Linux 2.4 and later
-------------------
To check the current maximum number of file descriptors:
- Run "ulimit -Hn" on the command line.
This shows the hard liit.

To permanently change the maximum number of file descriptors:
- Open "/etc/security/limits.conf" with a text editor.
- Add a new line "*       hard      nofile     65536".
  65536 is the new maximum.  Change it as necessary.

PRESS <ENTER> TO CONTINUE:

설치가 완료되면 “WebtoB의 설치가 성공적으로 마무리되었다”는 메시지가 출력된다. <ENTER> 키를 눌러 설치 작업을 완료한다.

===============================================================================
Installation Complete
---------------------

Congratulations. WEBTOB5_0_SP0_Fix#0 has been successfully installed to:

   /home/webtob

PRESS <ENTER> TO EXIT THE INSTALLER:

설치 확인 지정된 설치 경로($WEBTOBEDIR)로 디렉터리가 생성되고 그 하위에 파일들이 설치된 것을 확인한다.

$WEBTOBEDIR
     |----ap
     |----bin 
     |----cgi-bin
     |----config
     |----docs
     |----icons
     |----lib
     +----license
     |----log
     |----path 
     |----ssl
     |----svct
     +----UninstallerData
     |----usrinc

################# 각 디렉토리 설명
ap
애플리케이션 파일이 위치한다.

bin
실행 파일(wsm, wscfl, wsuncfl wsracd, wsgst, wsboot, wsdown 등)들이 위치한다.

cgi-bin
CGI 파일이 위치한다.

config
WebtoB 환경 파일이 위치한다.

docs
기본적으로 설치되는 HTML 파일이 위치한다.

icons
DIRINDEX에서 사용할 아이콘이 위치한다.

lib
라이브러리(Library) 파일이 위치한다.

license
라이선스 파일이 위치한다.

log
로그 파일들이 위치한다.

path
프로세스 간의 내부 통신을 위한 Named-pipe가 생성된다.

ssl
SSL 관련 파일이 위치한다.

svct
WBAPI의 서비스 테이블이 위치한다.

UninstallerData
설치 제거를 위한 파일이 위치한다.

usrinc
API의 헤더 파일들이 위치한다

설치 확인 환경변수 확인 .profile(ksh일 경우) 또는 .bash_profile(bash shell일 경우)에 다음과 같이 환경변수가 등록된 것을 확인한다.

# New environment setting added by WEBTOB5.0_SP0_Fix#0 on Wed Mar 30 14:52:54 KST 2016 1.
# The unmodified version of this file is saved in /home/webtob1/.bash_profile625190227.
# Do NOT modify these lines; they are used to uninstall.
WEBTOBDIR=/home/webtob1/webtob
export WEBTOBDIR
# End comments by InstallAnywhere on Wed Mar 30 14:52:54 KST 2016 1.

# New environment setting added by WEBTOB5.0_SP0_Fix#0 on Wed Mar 30 14:52:54 KST 2016 2.
# The unmodified version of this file is saved in /home/webtob1/.bash_profile625190227.
# Do NOT modify these lines; they are used to uninstall.
PATH="${WEBTOBDIR}/bin:${PATH}"
export PATH
# End comments by InstallAnywhere on Wed Mar 30 14:52:54 KST 2016 2.

# New environment setting added by WEBTOB5.0_SP0_Fix#0 on Wed Mar 30 14:52:54 KST 2016 3.
# The unmodified version of this file is saved in /home/webtob1/.bash_profile625190227.
# Do NOT modify these lines; they are used to uninstall.
LD_LIBRARY_PATH="${WEBTOBDIR}/lib:${LD_LIBRARY_PATH}"
export LD_LIBRARY_PATH
# End comments by InstallAnywhere on Wed Mar 30 14:52:54 KST 2016 3.

4. WebtoB 5 기동 및 종료

4.1 WebtoB 5 기동 전 작업

.Bash_profile 갱신 (설치 후 Jeus Path가 자동으로 등록해주기때문에 갱신 필요)

# webtob 계정 디렉토리 이동 후
source .bash_profile 
또는 
. ~/.bash_profile

라이센스 파일 /home/webtob/license/ 경로에 저장

# 업로드 파일 확인
cd /home/webtob/license
ls -al
drwxrwxr-x.  2 webtob webtob    63 Sep 18 17:15 .
drwxrwxr-x. 16 webtob webtob  4096 Sep 18 17:10 ..
-rw-r--r--.  1 webtob webtob    80 Sep 18 17:15 license.dat
-rwxrwxr-x.  1 webtob webtob 12301 Sep 18 17:09 ncpu
-rwxrwxr-x.  1 webtob webtob  2738 Sep 18 17:09 WebtoB_License.txt

환경 파일 작성 환경 파일은 ${WEBTOBDIR}/config 디렉터리에 기본적으로 제공되는 http.m 파일을 사용해서 설정한다. <http.m>

*DOMAIN
webtob1

*NODE
HostName      WEBTOBDIR="/home/webtob", 
              SHMKEY = 54000,
              DOCROOT="/home/webtob/docs",
              PORT = "8080", 
              HTH = 1,
              #Group = "nobody",
              #User = "nobody",
              NODENAME = "$(NODENAME)",
              ERRORDOCUMENT = "503",
              #JSVPORT = 9900,
              LOGGING = "log1",
              ERRORLOG = "log2",
              SYSLOG = "log3"

*HTH_THREAD
hth_worker
                  SendfileThreads = 4,
                  AccessLogThread = Y,
                  #ReadBufSize=1048576, #1M
                  #HtmlsCompression="text/html",
                  #SendfileThreshold=32768,
                  WorkerThreads=8

*SVRGROUP
htmlg           NODENAME = "qpsx1", SVRTYPE = HTML
cgig            NODENAME = "qpsx1", SVRTYPE = CGI
ssig            NODENAME = "qpsx1", SVRTYPE = SSI

*SERVER
cgi             SVGNAME = cgig, MinProc = 2, MaxProc = 10, ASQCount = 1
ssi             SVGNAME = ssig, MinProc = 2, MaxProc = 10, ASQCount = 1

*URI
uri1          Uri = "/cgi-bin/",   Svrtype = CGI
uri2          Uri = "/examples/",  SvrType=JSV, SvrName=MyGroup

*ALIAS
alias1        URI = "/cgi-bin/", RealPath = "/home/webtob/cgi-bin/"

*LOGGING
log1          Format = "DEFAULT", FileName = "/home/webtob/log/access.log_%M%%D%%Y%", 
              Option = "sync"
log2          Format = "ERROR", FileName = "/home/webtob/log/error.log_%M%%D%%Y%", 
              Option = "sync"
log3          Format = "SYSLOG", FileName = "/home/webtob/log/system_%M%%D%%Y%.log",
              Option = "sync"

*ERRORDOCUMENT
503           status = 503,
              url = "/503.html"

*EXT

다음은 http.m 파일의 수정이 필요한 항목에 대한 설명이다.

항목	설명
SHMKEY	다른 프로그램과 충돌이 발생하는 경우 WebtoB를 기동시킬 때 에러 메시지가 발생하므로 수정한다.
PORT	이미 사용 중인 포트 번호일 경우 WebtoB가 정상적으로 동작하지 않으므로 중복되지 않는 번호로 설정한다.
JSVPORT	이미 사용 중인 포트 번호일 경우 내장 Servlet이 정상적으로 동작하지 않으므로 중복되지 않는 번호로 설정한다.

환경 파일 컴파일 환경 파일을 확인한 후 다음과 같이 환경 파일을 컴파일한다. 정상적으로 컴파일하면 wsconfig라는 파일이 생성된다.

wscfl –i http.m
Current configuration:
        Number of client handler(HTH) = 1
        Supported maximum user per node = 16339
        Supported maximum user per handler = 16339

Successfully created the configuration file (/home/webtob1/webtob5/config/wsconfig) for node qpsx1.
The host name of the running machine is qpsx1.

4.2 WebtoB 5 기동

wsboot 명령어를 실행한다.

$ wsboot

Booting WebtoB on node (qpsx1)
Welcome to WebtoB Demo system. It will expire on 2016-04-18
Today is 2016-03-30
Starting WSM at Wed Mar 30 15:14:16 2016
Starting HTL at Wed Mar 30 15:14:16 2016
Starting HTH at Wed Mar 30 15:14:16 2016
         Current WebtoB Configuration:
                Number of client handlers (HTH) = 1
                Supported maximum user per node = 8153
                Supported maximum user per handler = 8153
Starting SVR(cgis) at Wed Mar 30 15:14:16 2016
Starting SVR(cgis) at Wed Mar 30 15:14:16 2016
Starting SVR(ssis) at Wed Mar 30 15:14:16 2016
Starting SVR(ssis) at Wed Mar 30 15:14:16 2016

WebtoB가 기동되면 브라우저로 서비스를 요청한다.

http://<ip-address>:<port>/

WebtoB가 정상적으로 기동된 경우 다음과 같은 화면이 표시된다.

4.3 WebtoB 5 종료

WebtoB를 종료하려면 wsdown 명령어를 실행한다. 다음은 WebtoB를 종료하는 과정에 대한 예

$ wsdown
Do you really want to shut down WebtoB? (y : n): y

WSDOWN for node(qpsx1) is starting: 
        WSDOWN: SERVER(cgi:0) downed: Wed Mar 30 15:14:45 2016
        WSDOWN: SERVER(cgi:1) downed: Wed Mar 30 15:14:45 2016
        WSDOWN: SERVER(ssi:10) downed: Wed Mar 30 15:14:45 2016
        WSDOWN: SERVER(ssi:11) downed: Wed Mar 30 15:14:45 2016
        WSDOWN: HTL downed: Wed Mar 30 15:14:45 2016
        WSDOWN: HTH downed: Wed Mar 30 15:14:45 2016
        WSDOWN: WSM downed: Wed Mar 30 15:14:45 2016
        WSDOWN: WebtoB is down

5. WebtoB 5 제거

5.1 WebtoB 5 제거 실행

WebtoB를 제거하기 위해 다음 경로의 Uninstaller를 실행한다.

$WEBTOBDIR/UninstallerData/Uninstall

Uninstaller를 실행시키면 다음과 같이 제거에 대한 안내 메시지가 출력된다. 제거 작업에서는 설치 과정에서 생성되었던 파일과 디렉터리를 삭제하며, 설치 후 생성된 파일들은 별도로 삭제해야 한다. <ENTER> 키를 눌러 다음 단계로 진행한다.

$ ./Uninstall
Preparing CONSOLE Mode Installation...

===============================================================================
WEBTOB5_0_SP0_Fix#0               (created with InstallAnywhere by Macrovision)
-------------------------------------------------------------------------------




===============================================================================
Uninstall WEBTOB5_0_SP0_Fix#0
-----------------------------

About to uninstall...

WEBTOB5_0_SP0_Fix#0

This will remove features installed by InstallAnywhere.  It will not remove 
files and folders created after the installation.

PRESS <ENTER> TO CONTINUE:

다음과 같은 화면이 나타나면서 각종 파일 및 환경변수 삭제 등의 작업을 수행한다.

===============================================================================
Uninstalling...
---------------

...*
*
*************************

제거 과정이 성공적으로 완료되면 다음과 같은 메시지가 출력되고 Uninstaller 실행을 종료한다.

===============================================================================
Uninstall Complete
------------------

All items were successfully uninstalled.

5.2 WebtoB 5 제거 확인

파일 삭제 확인 : 설치했던 파일들이 모두 삭제된 것을 확인한다. 단, 설치 이후 생성된 파일들은 남아 있을 수 있으므로 별도로 삭제해야 한다.
환경변수 삭제 확인 : WebtoB를 설치할 때 등록된 환경변수들과 ‘PATH’에 설정된 경로들이 정상적으로 삭제된 것을 확인한다.

브라우저 저장소 : 로컬 스토리지, 세션 스토리지, 쿠키

키큰난쟁이 — Mon, 16 Sep 2024 22:49:07 +0900

1. 들어가며

브라우저 로컬 스토리지를 이용해 검색어 자동 저장 기능을 만들면서 브라우저 저장소 개념 정리

1.2 브라우저 저장소 이해하기

웹 애플리케이션을 개발하거나 사용하는 동안, 데이터를 저장하고 유지하는 것은 필수적인 기능 중 하나입니다. 브라우저는 사용자의 데이터를 클라이언트 측에 저장할 수 있는 몇 가지 옵션을 제공합니다. 이 글에서는 로컬 스토리지(Local Storage), 세션 스토리지(Session Storage), 그리고 쿠키(Cookie)에 대해 살펴보겠습니다.

2. 로컬 스토리지 (Local Storage)

로컬 스토리지는 사용자의 브라우저에 영구적으로 데이터를 저장할 수 있는 WebAPI입니다. 이 데이터는 브라우저나 탭을 닫아도 유지되며, 심지어 컴퓨터를 다시 시작해도 사라지지 않습니다. 로컬 스토리지는 보통 사용자 설정, 즐겨찾기 정보, 상태 유지 정보 등을 저장하는 데 유용합니다.

2.1 로컬 스토리지의 특징

영구적 데이터 저장 : 삭제되지 않는 한 데이터를 영구적으로 유지할 수 있습니다.
브라우저 기반 : 도메인 단위로 데이터를 관리하며, 동일한 도메인에서 접근할 수 있습니다. 도메인이 다른 웹 페이지 간에는 데이터를 공유할 수 없습니다.
보안 고려사항 : 민감한 데이터를 로컬 스토리지에 저장하면 브라우저가 해킹당했을 때 데이터 유출 위험이 있습니다. 따라서 로그인 토큰이나 비밀번호 등 중요한 데이터는 로컬 스토리지에 저장하지 말아야 합니다.

2.2 로컬 스토리지의 장점

데이터를 오래 유지할 수 있으며, 재방문 시에도 사용자 맞춤형 환경을 제공할 수 있습니다.
JSON 형태의 구조적 데이터를 저장할 수 있어 데이터 구조화에 용이합니다.

2.3 로컬 스토리지의 단점

보안 위험 : 스크립트를 통해 클라이언트가 쉽게 접근할 수 있기 때문에, 중요한 데이터를 저장하는 것은 피해야 합니다.
동기식 처리 : 로컬 스토리지는 동기적으로 작동하여, 큰 데이터를 저장하거나 가져오는 과정에서 성능 저하를 초래할 수 있습니다.

2.4 로컬 스토리지 예제

// 데이터 저장
localStorage.setItem('name', 'junu');

// 데이터 가져오기
let theme = localStorage.getItem('name');
console.log(name); // 'junu'

// 데이터 삭제
localStorage.removeItem('name');

// 모든 데이터 삭제
localStorage.clear();

3. 세션 스토리지 ( Session Storage)

세션 스토리지는 현재 브라우저 탭이 유지되는 동안만 데이터를 저장합니다. 즉, 사용자가 탭이나 창을 닫으면 데이터는 삭제됩니다. 세션 스토리지는 주로 특정 세션 내에서만 필요한 데이터를 저장하는 데 사용되며, 쇼핑 카트 정보나 일시적인 사용자 활동 추적 등에 유용합니다.

3.1 세션 스토리지의 특징

세션 기반 데이터 저장 : 탭을 닫으면 데이터가 삭제되며, 각 탭에 독립적으로 적용됩니다.
브라우저 종료 시 데이터 삭제 : 세션이 종료되면 데이터가 사라집니다.
탭 간 독립성 : 서로 다른 탭에서 같은 페이지를 열어도 세션 데이터는 서로 공유되지 않으며, 각각 독립된 세션을 유지합니다.

3.2 세션 스토리지의 장점

짧은 기간 동안의 데이터를 안전하게 저장할 수 있습니다.
복잡한 로그인이나 상태 관리를 필요로 하지 않는 간단한 웹 애플리케이션에서 유용합니다.

3.3 세션 스토리지의 단점

데이터가 브라우저 세션이 끝나면 삭제되므로, 영구적인 데이터 저장에는 적합하지 않습니다.
동기식이므로, 많은 양의 데이터를 처리할 때 성능 문제가 발생할 수 있습니다.

3.4 세션 스토리지 예제

// 데이터 저장
sessionStorage.setItem('cart', JSON.stringify(['item1', 'item2']));

// 데이터 가져오기
let cart = JSON.parse(sessionStorage.getItem('cart'));
console.log(cart); // ['item1', 'item2']

// 데이터 삭제
sessionStorage.removeItem('cart');

// 모든 데이터 삭제
sessionStorage.clear();

4. 쿠키 (Cookies)

쿠키는 브라우저에 저장할 수 있는 소량의 데이터로, 주로 서버와 클라이언트 간의 상태 정보를 주고받는 데 사용됩니다. 쿠키는 세션 유지, 사용자 인증, 추적 등에 유용하며, 브라우저는 HTTP 요청 시마다 서버에 쿠키를 자동으로 전송합니다.

4.1 쿠키의 특징

서버와 클라이언트 간 자동 전송 : 쿠키는 서버에 의해 설정될 수 있으며, 클라이언트가 HTTP 요청을 할 때마다 자동으로 서버에 쿠키가 포함되어 전송됩니다.
만료 시간 설정 가능 : 쿠키는 설정에 따라 만료 시간(예: 7일, 1년 등)을 지정할 수 있으며, 만료 시간이 지나면 자동으로 삭제됩니다.
보안 옵션 : Secure 속성을 사용하면 HTTPS를 통해서만 쿠키가 전송되며, HttpOnly 옵션을 설정하면 자바스크립트에서 접근할 수 없습니다.

4.2 쿠키의 장점

쿠키는 서버와의 세션 상태 유지를 위해 가장 흔하게 사용됩니다.
만료 시간과 도메인을 설정하여 다양한 용도로 쿠키를 관리할 수 있습니다.

4.3 쿠키의 단점

용량 제한 : 쿠키는 최대 4KB의 데이터를 저장할 수 있습니다.
보안 위험 : HTTP를 통해 쿠키가 전송될 경우, 공격자가 가로챌 수 있습니다. HTTPS 및 Secure, HttpOnly 옵션을 사용하여 보안을 강화해야 합니다.

4.4 쿠키 예제

// 쿠키 설정 (쿠키 만료 시간 설정 가능)
document.cookie = "username=seoring; expires=Fri, 31 Dec 2024 23:59:59 GMT; path=/";

// 쿠키 가져오기
function getCookie(name) {
  const value = `; ${document.cookie}`;
  const parts = value.split(`; ${name}=`);
  if (parts.length === 2) return parts.pop().split(';').shift();
}
let username = getCookie('username');
console.log(username); // 'seoring'

// 쿠키 삭제 (만료 시간으로 삭제)
document.cookie = "username=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/";

5. 로컬 스토리지 vs 세션 스토리지 vs 쿠키: 차이점 비교

구분	로컬 스토리지	세션 스토리지	쿠키
데이터 유지 기간	영구적	세션 동안	설정한 만료 시간까지
용량	5MB	5MB	4KB
주 용도	사용자 설정 저장	일시적인 세션 데이터	인증 정보, 사용자 세션 관리
서버와의 통신	통신 없음	통신 없음	요청 시마다 서버로 전송
보안	HTTPS가 아닌 경우 위험	HTTPS가 아닌 경우 위험	HTTPS, Secure, HttpOnly 사용 가능

6. 스토리지 사용 시 보안 고려 사항

스토리지를 사용할 때 보안은 매우 중요한 요소입니다. 다음은 브라우저 스토리지 사용 시 고려해야 할 보안 팁입니다.

민감한 데이터 저장 금지 : 로컬 스토리지나 세션 스토리지에 민감한 정보(예: 비밀번호, 신용카드 정보 등)를 저장하지 않도록 주의하세요.
HTTPS 사용 : HTTPS를 통해 통신하면 데이터 전송 중에 가로채는 것을 방지할 수 있습니다.
쿠키 보안 속성 설정 : Secure 및 HttpOnly 속성을 사용하여 쿠키를 보호할 수 있습니다.

7. 마무리

이 글에서는 브라우저 스토리지의 기본 개념부터 실제 사용법, 보안에 이르기까지 자세히 살펴보았습니다. 각 스토리지의 장단점을 이해하고, 적절한 용도를 선택하여 효율적인 웹 애플리케이션을 개발할 수 있기를 바랍니다.

Rocky Linux 9 설치

키큰난쟁이 — Mon, 16 Sep 2024 02:04:29 +0900

1. 들어가며

✅ Rocky Linux 9 설치하며 정리한 글

2. Rocky Linux 9 다운로드 링크

[설치링크]

Download - Rocky Linux

Download Download the latest Rocky Linux versions here. Get Involved As you download and use Rocky Linux, the Rocky Enterprise Software Foundation invites you to be a part of the community as a contributor. There are many ways to contribute to the project,

rockylinux.org

설치할 환경의 아키텍처를 선택해 다운로드한다. 저는 가벼운 버전 x86_64 Minimal 이미지를 다운로드하였습니다.

3. Rocky Linux 9 설치

3.1 Rocky Linux 9 설치 진입

Install Rocky Linux 9.2 선택 후 설치 진행

3.2 Rocky Linux 9 언어 선택

언어는 자신에 취향에 맞게 선택하시길 바랍니다. 저는 영어로 선택 후 진행했습니다.

3.3 Rocky Linux 9 환경설정 진입

키보드, 언어, 시간, 네트워크 등 설정해 주시되 파티션 설정 및 루트 비밀번호 설정은 필수 항목이기 때문에 진행 필요

3.4 Rocky Linux 9 루트 비밀번호 설정

비밀번호 설정 및 필요에 따라 ROOT 계정을 잠금 또는 ROOT 비밀번호로 SSH 로그인하도록 허용 설정 기본적으로 ROOT 계정은 잠금 하도록 하는 게 좋습니다. (Lock root account 체크박스 선택)

3.5 Rocky Linux 9 하드 파티션 설정

파티션 설정은 따로 설명해드리지 않겠습니다. 저는 기본 설정으로 진행했습니다.

3.6 Rocky Linux 9 설치 진행

Begin Installation 클릭 후 설치 진행

3.7 Rocky Linux 9 설치 진행 완료

Reboot System 클릭 후 재부팅 진행

3.8 Rocky Linux 9 부팅 완료

로그인하시고 계정생성, 네트워크, 보안 설정 등을 진행하시면 됩니다.

스프링 Filter, Interceptor, AOP 정리

키큰난쟁이 — Sun, 15 Sep 2024 10:25:29 +0900

1. 들어가며

스프링은 자바 기반의 오픈 소스 프레임워크로, 애플리케이션 개발을 위한 다양한 기능을 제공합니다. 스프링의 중요한 개념 중에는 필터(Filter), 인터셉터(Interceptor) 및 관점 지향 프로그래밍(AOP, Aspect-Oriented Programming)이 있습니다. 이들은 애플리케이션의 동작을 제어하고 조정하는 데 사용됩니다. 스프링 필터, 인터셉터 및 AOP의 차이와 각각의 역할에 대해 알아보겠습니다.

2. 스프링 Filter, Interceptor, AOP의 흐름

2.1 Filter, Interceptor, AOP의 흐름도

2.2 Filter, Interceptor, AOP의 흐름도 설명

서버를 실행시켜 서블릿이 올라오는 동안에 init이 실행되고, 그 후 doFilter가 실행된다.
컨트롤러에 들어가기 전 preHandler가 실행된다
컨트롤러에서 나와 postHandler, after Completion, doFilter 순으로 진행이 된다.
서블릿 종료 시 destroy가 실행된다.

3. 스프링 필터(Filter)

3.1 필터란?

스프링 필터(Filter)는 HTTP 요청 및 응답을 처리하기 전후에 특정 작업을 수행하는 컴포넌트입니다. 필터는 서블릿 컨테이너 내에서 동작하며, 클라이언트로부터 오는 요청이나 서버에서 클라이언트로 보내는 응답을 가로채서 가공할 수 있습니다.

3.2 필터의 동작 원리

스프링 필터는 DispatcherServlet 이전에 실행되며, 요청과 응답을 처리하는 도중에 개입하여 특정 작업을 수행합니다. 일반적으로 웹 애플리케이션의 전체적인 동작에 영향을 주는 역할을 합니다. 필터는 javax.servlet.Filter 인터페이스를 구현하여 작성하며, doFilter() 메서드를 통해 요청과 응답을 가로채고 처리합니다.

3.3 필터의 주요 용도

인증과 권한 부여 : 필터를 사용하여 사용자의 인증과 권한 부여를 처리할 수 있습니다. 인증된 사용자만이 액세스할 수 있는 리소스에 대한 요청을 거부하거나, 특정 권한을 가진 사용자에 대한 요청을 처리할 수 있습니다.
로깅과 감사 : 필터를 사용하여 요청 및 응답의 로그를 기록하고 감사할 수 있습니다. 이를 통해 애플리케이션의 동작을 모니터링하고 문제를 식별하는 데 도움이 됩니다.
데이터 변환 및 처리 : 필터를 사용하여 요청 및 응답의 데이터를 변환하거나 처리할 수 있습니다. 예를 들어, 요청의 인코딩을 변경하거나 응답의 데이터를 압축할 수 있습니다.
예외 처리 : 필터를 사용하여 애플리케이션 내에서 발생하는 예외를 처리할 수 있습니다. 예외를 적절히 처리하고 사용자에게 적절한 오류 메시지를 표시함으로써 애플리케이션의 안정성을 향상시킬 수 있습니다.
캐싱과 성능 최적화 : 필터를 사용하여 요청 및 응답을 캐시하고 성능을 향상시킬 수 있습니다. 반복적인 요청에 대한 응답을 캐시하여 서버 부하를 줄이고 응답 시간을 단축시킬 수 있습니다.

3.4 필터 사용 방법

init()
- init() 메소드는 필터 객체가 생성되고 준비 작업을 위해 딱 한번 호출된다. 서블릿의 init()과 같은 용도이다. 이 메소드의 매개변수는 FilterConfig의 인스턴스이다. 이 인스턴스를 통해 필터 초기화 매개변수의 값을 꺼낼수 있다. 위 코드에서는 doFilter()에서 사용하기 위해 인스턴스 변수 config에 저장한다.
doFilter()
- 필터와 매핑된 URL에 요청이 들어올때마다 doFilter()가 호출된다. 이 메소드에 필터가 할 작업을 작성한다.
- filterChain은 다음 필터를 가리키고 filterChain.doFilter()는 다음 필터를 호출한다. 다음 필터가 없다면 내부적으로 서블릿의 service()를 호출한다.
- 서블릿이 실행되기 전에 처리할 작업은 filterChain.doFilter() 이전에, 서블릿이 실행된 후에 처리할 작업은 filterChain.doFilter() 이후에 작성한다.
- 본 예제에서는 서블릿이 실행되기 전에 request parameter의 문자 집합을 먼저 설정하기 위해 filterChain.doFilter() 이전에 setCharacterEncoding()을 호출했다.
destroy()
- 서블릿 컨테이너는 웹 어플리케이션을 종료하기 전에 필터들에 대해 destroy()를 호출해서 마무리 작업을 한다. 본 예제는 특별히 마무리할 작업이 없으므로 빈 메소드로 둔다.

import javax.servlet.*;
import java.io.IOException;

public class MyFilter implements Filter {
    public void init(FilterConfig config) throws ServletException {
        // 필터 초기화 작업
    }

    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        // 요청 및 응답 처리 작업
        chain.doFilter(request, response); // 다음 필터로 전달
    }

    public void destroy() {
        // 필터 종료 작업
    }
}

↓ 필터를 어떤 URL 패턴에 적용할지 설정합니다. 이를 위해 web.xml 필터를 등록해야됩니다.

<filter>
    <filter-name>myFilter</filter-name>
    <filter-class>com.example.MyFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>myFilter</filter-name>
    <url-pattern>/example/*</url-pattern> <!-- 적용할 URL 패턴 설정 -->
</filter-mapping>

4. 스프링 인터셉터(Interceptor)

4.1 인터셉터란?

스프링 인터셉터(Interceptor)는 스프링 MVC에서 컨트롤러의 호출 전후에 특정 작업을 수행하는 기능입니다. 인터셉터는 스프링의 핸들러 인터셉터 인터페이스를 구현하여 작성됩니다.

4.2 인터셉터의 동작 원리

인터셉터는 컨트롤러의 실행 전후에 개입하여 추가적인 작업을 수행합니다. 예를 들어, 인증 및 권한 확인, 세션 관리, 로깅 등의 작업을 수행할 수 있습니다. 인터셉터는 컨트롤러 실행 전에 호출되는 preHandle() 메서드와 컨트롤러 실행 후에 호출되는 postHandle() 메서드로 구성됩니다.

4.3 인터셉터의 주요 용도

요청 및 응답 로깅 : Interceptor를 사용하여 요청 및 응답 데이터를 로깅하고, 디버깅 및 모니터링 목적으로 사용할 수 있습니다. 이는 시스템의 동작을 추적하고 문제를 해결하는 데 도움이 됩니다.
보안 : Interceptor를 사용하여 인증 및 권한 부여를 구현할 수 있습니다. 예를 들어, 로그인 여부를 확인하고 특정 URL이나 리소스에 접근하는 권한을 확인할 수 있습니다.
예외 처리 : Interceptor를 사용하여 예외를 처리하고, 예외 상황에 대한 적절한 응답을 생성할 수 있습니다. 이는 애플리케이션의 안정성을 향상시키고, 사용자에게 더 좋은 경험을 제공하는 데 도움이 됩니다.
성능 측정 : Interceptor를 사용하여 애플리케이션의 성능을 측정하고, 부하가 많은 부분을 식별할 수 있습니다. 이를 통해 성능 최적화를 수행하고, 애플리케이션의 반응 시간을 개선할 수 있습니다.
데이터 변환 : Interceptor를 사용하여 요청 및 응답 데이터를 변환할 수 있습니다. 예를 들어, JSON 데이터를 객체로 변환하거나, 객체를 JSON으로 변환할 수 있습니다.

4.4 인터셉터 사용 방법

preHandler() – 컨트롤러 메서드가 실행되기 전
postHanler() – 컨트롤러 메서드 실행직 후 view페이지 렌더링 되기 전
afterCompletion() – view페이지가 렌더링 되고 난 후

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;

public class CustomInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
            throws Exception {
        // preHandle 로직 구현
        // 요청 처리 전에 실행됩니다.
        return true; // 또는 false를 반환하여 요청 처리를 중단할 수 있습니다.
    }

    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
            ModelAndView modelAndView) throws Exception {
        // postHandle 로직 구현
        // 요청 처리 후에 실행됩니다.
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
            throws Exception {
        // afterCompletion 로직 구현
        // 응답 완료 후에 실행됩니다.
    }
}

↓ Interceptor가 적용될 URL 패턴을 설정합니다. 이를 위해 dispatcher-servlet.xml 요소를 등록해야됩니다.

<!-- XML 설정 파일 내에서 Interceptor 등록 -->
<mvc:interceptors>
    <!-- 첫 번째 Interceptor 등록 -->
    <mvc:interceptor>
        <!-- 첫 번째 Interceptor의 적용 URL 패턴 설정 -->
        <mvc:mapping path="/secure/**"/>
        <!-- 첫 번째 Interceptor 클래스 등록 -->
        <bean class="com.example.FirstInterceptor"/>
    </mvc:interceptor>
    
    <!-- 두 번째 Interceptor 등록 -->
    <mvc:interceptor>
        <!-- 두 번째 Interceptor의 적용 URL 패턴 설정 -->
        <mvc:mapping path="/public/**"/>
        <!-- 두 번째 Interceptor 클래스 등록 -->
        <bean class="com.example.SecondInterceptor"/>
    </mvc:interceptor>
</mvc:interceptors>

5. 스프링 AOP(관점 지향 프로그래밍)

5.1 AOP란?

관점 지향 프로그래밍(AOP)은 소프트웨어 개발에서 횡단 관심사(cross-cutting concern)를 모듈화하는 기법입니다. AOP는 주요 비즈니스 로직과는 별개로 횡단 관심사를 분리하여 개발하고, 이를 필요한 부분에 적용할 수 있도록 지원합니다.

5.2 AOP의 동작 원리

AOP는 프록시 패턴을 이용하여 동작합니다. 핵심 로직을 실행하는 주요 객체는 프록시 객체에 의해 감싸져서 호출되며, 횡단 관심사는 프록시 객체 내에서 처리됩니다. AOP는 주로 메서드 호출, 예외 처리, 트랜잭션 관리 등의 측면에서 활용됩니다.

5.3 AOP의 주요 용도

로깅 : AOP를 사용하여 애플리케이션의 다양한 부분에서 로그를 기록할 수 있습니다. 예를 들어, 메서드 호출 시간, 인자 값, 반환 값 등을 기록할 수 있습니다.
트랜잭션 관리 : AOP를 사용하여 애플리케이션의 트랜잭션 처리를 자동화할 수 있습니다. 예를 들어, 메서드 실행 전후에 트랜잭션을 시작하고 커밋 또는 롤백할 수 있습니다.
보안 : AOP를 사용하여 애플리케이션의 보안 기능을 구현할 수 있습니다. 예를 들어, 특정 메서드에 대한 인가 또는 인증을 수행하거나, 암호화 및 복호화를 자동으로 처리할 수 있습니다.
캐싱 : AOP를 사용하여 반복적으로 실행되는 메서드의 결과를 캐싱할 수 있습니다. 이를 통해 애플리케이션의 성능을 향상시킬 수 있습니다.
예외 처리 : AOP를 사용하여 애플리케이션에서 발생하는 예외를 처리할 수 있습니다. 예를 들어, 특정 예외가 발생했을 때 특정 작업을 수행하거나 예외를 변환하여 처리할 수 있습니다.
권한 부여 : AOP를 사용하여 애플리케이션의 권한 부여 기능을 구현할 수 있습니다. 예를 들어, 특정 메서드에 대한 접근 권한을 확인하고 부여할 수 있습니다.

5.4 AOP의 주요 개념

Aspect : 위의 사진에서 처럼 Aspect 안에 모듈화 시킨 것을 의미한다.
Advice : 실질적으로 어떤 일을 해야하는지를 담고 있다.
Pointcut : 어디에 적용해야 하는지에 대한 정보를 담고 있다.
Target : Aspect에 적용이 되는 대상
Join point : Advice가 적용될 위치, 끼어들 수 있는 지점. 메서드 진입 지점, 생성자 호출 시점, 필드에서 값을 꺼내올 때 등 다양한 시점에 적용가능(여러가지 합류 지점임)

5.5 AOP의 사용 방법

before, after, after-returning, after-throwing, around 5가지의 동작 시점이 존재
- @Before: 대상 메소드의 수행 전
- @After: 대상 메소드의 수행 후
- @After-returning: 대상 메소드의 정상적인 수행 후
- @After-throwing: 예외발생 후
- @Around: 대상 메소드의 수행 전, 후

↓ 5가지의 동작 시점 예시

import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.*;
import org.springframework.stereotype.Component;

@Aspect
@Component
public class LoggingAspect {

    @Before("execution(* com.example.MyService.*(..))")
    public void beforeMethod(JoinPoint joinPoint) {
        System.out.println("메서드 호출 전에 실행됩니다.");
    }

    @After("execution(* com.example.MyService.*(..))")
    public void afterMethod(JoinPoint joinPoint) {
        System.out.println("메서드 실행 후에 실행됩니다.");
    }

    @AfterReturning(pointcut = "execution(* com.example.MyService.*(..))", returning = "result")
    public void afterReturningMethod(JoinPoint joinPoint, Object result) {
        System.out.println("메서드 정상 반환 후에 실행됩니다.");
    }

    @AfterThrowing(pointcut = "execution(* com.example.MyService.*(..))", throwing = "exception")
    public void afterThrowingMethod(JoinPoint joinPoint, Exception exception) {
        System.out.println("예외 발생 후에 실행됩니다.");
    }

    @Around("execution(* com.example.MyService.*(..))")
    public Object aroundMethod(ProceedingJoinPoint joinPoint) throws Throwable {
        System.out.println("메서드 호출 전에 실행됩니다.");

        Object result = joinPoint.proceed();

        System.out.println("메서드 호출 후에 실행됩니다.");

        return result;
    }
}

6. 필터, 인터셉터 및 AOP의 차이점

6.1 개념적 차이

필터 : HTTP 요청 및 응답을 처리하기 위해 사용되며, 서블릿 컨테이너 내에서 동작합니다.
인터셉터 : 스프링 MVC에서 컨트롤러의 호출 전후에 특정 작업을 수행하기 위해 사용됩니다.
AOP : 횡단 관심사를 모듈화하여 주요 비즈니스 로직과 분리시키는 프로그래밍 기법입니다.

6.2 동작 원리의 차이

필터 : 서블릿 컨테이너에서 요청과 응답을 가로채어 처리합니다.
인터셉터 : 스프링 MVC의 핸들러 호출 전후에 추가 작업을 수행합니다.
AOP : 프록시 패턴을 이용하여 횡단 관심사를 주요 로직과 분리하여 처리합니다.

6.3 사용의 차이

필터 : 인증, 권한 부여, 데이터 변환 등과 같이 요청 및 응답 전체에 영향을 주는 작업에 사용됩니다.
인터셉터 : 세션 관리, 인증, 권한 부여 등 컨트롤러 호출 전후에 추가 작업이 필요한 경우에 사용됩니다.
AOP : 로깅, 예외 처리, 트랜잭션 관리 등과 같이 주요 비즈니스 로직과 별개로 횡단 관심사를 처리해야 하는 경우에 사용됩니다.

7. 마치며

스프링 필터, 인터셉터 및 AOP에 대해 알아보았습니다. 필터는 HTTP 요청 및 응답을 처리하기 위해 사용되며, 인터셉터는 스프링 MVC에서 컨트롤러 호출 전후에 특정 작업을 수행합니다. AOP는 횡단 관심사를 모듈화하여 주요 비즈니스 로직과 분리시키는 프로그래밍 기법입니다. 각각의 역할과 동작 원리, 주요 용도에 대해 이해하고 적절하게 사용하는 것이 중요합니다. 스프링 개발에서 필요에 따라 필터, 인터셉터, 그리고 AOP를 조합하여 애플리케이션을 효과적으로 개발하고 관리할 수 있습니다.

PHP에서 TCPDF로 HTML화면을 PDF문서로 변환 작업

키큰난쟁이 — Sat, 14 Sep 2024 09:39:11 +0900

1. 들어가며

1.1 TCPDF - PHP class for PDF

PDF 문서를 생성하는 PHP 라이브러리
오픈소스
UTF-8 지원
라이선스 : LGPL

2. 설치 전 준비 작업

리눅스 unzip 설치
TCPDF 설치
TCPDF 한글 폰트 설치

3. TCPDF 설치 및 폰트 적용

3.1 TCPDF 다운로드 및 업로드

설치 주소 [GitHub] 최신 소스 사용 하고 싶으면 GitHub에서 최신소스 다운로드 진행
https://jaist.dl.sourceforge.net/project/tcpdf 접속 후 tcpdf_6_3_2.zip 파일 직접 다운로드 후 자신의 서버에 업로드
필자는 wget 통해서 설치 진행

#자신의 서버의 /usr/share/php 폴더 다운로드 후 압축 해제
cd /usr/share/php/
wget https://jaist.dl.sourceforge.net/project/tcpdf/tcpdf_6_3_2.zip --no-check-certificate
unzip tcpdf_6_3_2.zip

3.2 나눔 폰트 설치

cd /usr/share/fonts/
wget http://cdn.naver.com/naver/NanumFont/fontfiles/NanumFont_TTF_ALL.zip
unzip NanumFont_TTF_ALL.zip -d NanumFont
cd /usr/share/php/tcpdf/tools/
ls /usr/share/fonts/NanumFont/*
ls /usr/share/fonts/NanumFont/* | xargs -I TTF php tcpdf_addfont.php -i TTF
ll /usr/share/php/tcpdf/fonts/ | grep nanum

4. PDF 변환 PHP 예제 코드

<?php
require_once('/usr/share/php/tcpdf/examples/tcpdf_include.php');

$html = <<<EOD
<h3>PDF 변환 테스트</h3>
<i>PDF 변환 작업 완료</i>
EOD;

$pdf = new TCPDF(PDF_PAGE_ORIENTATION, PDF_UNIT, PDF_PAGE_FORMAT, true, 'UTF-8', false);
$pdf->SetCreator(PDF_CREATOR);
$pdf->SetMargins(PDF_MARGIN_LEFT, PDF_MARGIN_TOP, PDF_MARGIN_RIGHT);
$pdf->SetHeaderMargin(PDF_MARGIN_HEADER);
$pdf->SetFooterMargin(PDF_MARGIN_FOOTER);

//$pdf->SetFont('nanumgothic', '', 14, '', true);
$pdf->SetFont('nanumgothic');
$pdf->SetDefaultMonospacedFont("nanumgothic_coding");

$pdf->AddPage();
$pdf->writeHTMLCell(0, 0, '', '', $html, 0, 1, 0, true, '', true);
//$pdf->Output(getcwd().'/temp.pdf', 'F'); // 실제 파일 생성됨
$pdf->Output('temp.pdf', 'I'); // 화면으로 보여줌
?>

5. TCPDF 오류

"TCPDF ERROR: Some data has already been output, can't send PDF file" 오류

php버전에 따라 차이가 있어 아래 내용 추가 필요
$pdf->Output 함수 실행 전 아래 내용 추가

ob_end_clean();

우분투(Ubuntu) 방화벽(UFW) 설정

키큰난쟁이 — Fri, 13 Sep 2024 13:22:29 +0900

1. 들어가며

우분투(Ubuntu)의 기본적인 방화벽은 UFW입니다. 이는 iptables를 좀 더 쉽게 설정할 수 있도록 한 것인데 간단한 방화벽 구성에는 문제가 없지만 수준 높은 방화벽 구성에는 iptables룰을 직접 사용해야 합니다.

2. 우분투(Ubuntu) 방화벽(UFW) 패키지 설치

UFW 패키지 설치

## 패키지가 없을 경우 설치
apt-get install ufw

3. 우분투(Ubuntu) 방화벽(UFW) 활성화/비활성화

활성화

## UFW 활성화
ufw enable

비활성

## UFW 활성화
ufw disable

4. 우분투(Ubuntu) 방화벽(UFW) 기본 룰

UFW에 설정되어 있는 기본 룰은 아래와 같다.

들어오는 패킷에 대해서는 전부 거부(deny)
나가는 패킷에 대해서는 전부 허가(allow)

기본 룰 확인

ufw show raw

기본 정책 차단

ufw default deny

기본 정책 허용

ufw default allow

5. 우분투(Ubuntu) 방화벽(UFW) 허용/차단

5.1 UFW 허용

사용 방법

ufw allow <port>/<optional: protocal>

SSH 포트 22번 허용(tcp/udp 22번 포트를 모두 허용)

ufw allow 22

tcp 22번 포트만을 허용

ufw allow 22/tcp

udp 22번 포트만을 허용

ufw allow 22/udp

5.2 UFW 거부

사용 방법

ufw deny <port>/<optional: protocol>

ssh 포트 22번 거부(tcp/udp 22번 포트를 모두 거부)

ufw deny 22

tcp 22번 포트만을 거부

ufw deny 22/tcp

udp 22번 포트만을 거부

ufw deny 22/udp

6. 우분투(Ubuntu) 방화벽(UFW) 룰의 삭제

ufw deny 22/tcp 설정이 되어있다고 가정

ufw delete deny 22/tcp

7. 우분투(Ubuntu) 방화벽(UFW) service 명을 이용한 설정

서비스명 보기

less /etc/services

서비스명으로 허용

allow <service name>

예시 (SSH 서비스)

ufw allow ssh
ufw deny ssh

8. 우분투(Ubuntu) 방화벽(UFW) 로그 기록

UFW 로그 기록

ufw logging on
ufw logging off

9. 우분투(Ubuntu) 방화벽(UFW) Advanced Syntax

문법을 확장하여 목적지 주소와 포트, 프로토콜 등을 지정할 수 있다.

9.1 특정한 IP 주소 허가/거부

특정한 IP 주소 허용 사용 방법

ufw allow from <ip address>

192.168.0.100 주소 허용(IP 주소192.168.0.100 에서만 접속이 가능해진다.)

ufw allow from 192.168.0.100

네트워크 단위로 지정하여 같은 네트워크 상에 있는 컴퓨터들은 접속가능해진다.

ufw allow from 192.168.0.0/24

특정한 IP 주소와 일치하는 포트 허용

ufw allow from <ip address> to <protocol> port <port number>

192.168.0.100 주소와 tcp 프로토콜 22번 포트 허용

ufw allow from 192.168.0.100 to any port 22 proto tcp

위의 예제에서 allow 대신 deny를 입력하면 거부가 된다.

10. 우분투(Ubuntu) 방화벽(UFW) ping (icmp) 허용/거부

UFW 기본설정은 ping 요청을 허용하도록 되어있다.

vi /etc/ufw/before.rules

# ok icmp codes
-A ufw-before-input -p icmp --icmp-type destination-unreachable -j ACCEPT
-A ufw-before-input -p icmp --icmp-type source-quench -j ACCEPT
-A ufw-before-input -p icmp --icmp-type time-exceeded -j ACCEPT
-A ufw-before-input -p icmp --icmp-type parameter-problem -j ACCEPT
-A ufw-before-input -p icmp --icmp-type echo-request -j ACCEPT

위 코드들의 ACCEPT 부분을 모두 DROP으로 변경하거나 삭제하면 ping 요청을 거부하게 된다.

11. 우분투(Ubuntu) 방화벽(UFW) ping (icmp) numbered rules

UFW 룰들에 숫자를 붙여서 볼 수 있다. 이를 이용해 룰에 수정이나 삭제, 추가를 할 수 있다.

ufw number 보기

ufw status numbered

ufw numbered 수정

ufw delete 1
ufw insert 1 allow from 192.168.0.100

12. 우분투(Ubuntu) 방화벽(UFW) 추천 방화벽 정책

추천 방화벽

ufw enable
ufw allow from 192.168.0.3 to any port 22 proto tcp
ufw allow 123/udp
ufw allow 80/tcp
ufw allow 3306/tcp
ufw status

Proxmox WOL 설정

키큰난쟁이 — Fri, 13 Sep 2024 11:46:22 +0900

1. 들어가며

현재 집에서 개인 용도로 쓰고 있는 Proxmox 원격으로 부팅할 수 있도록 설정하기 위해 정리하는 글

1.1 WOL(Wake-on-Lan) 란?

패킷을 이용해 원격으로 컴퓨터를 부팅하는 기술이며 네트워크에 연결된 컴퓨터의 전원을 켜기 위한 표준 특별하게 약속된 형태의 패킷을 대상 컴퓨터로 보내 컴퓨터가 꺼져있더라도 컴퓨터의 랜카드가 해당 패킷을 읽고 컴퓨터를 부팅하는 기술. LAN 뿐 아니라 WAN에서도 패킷만 잘 전달이 되면 작동이가 가능합니다. WI-FI 망에서 작동하는 보조 표준은 WoWLAN(Wake on Wireless LAN)이라고 부른다.

2. 메인보드 WOL 활성화

메인보드 별 회사별 바이오스 설정이 다르므로 참고 바랍니다.
저는 메인보드가 ASUS이며 아래 링크와 같이 설정 했습니다.

[Commercial DT] WOL(Wake on LAN) 기능을 활성화하는 방법 | 공식지원 | ASUS 한국

www.asus.com

3. Proxmox WOL 설정

ip addr 명령어로 현재 사용하고 있는 어댑터 이름/ MAC 주소 / IP를 확인

ip addr

그리고 ethtool로 현재 랜카드 상태 확인 wake-on : d 인 것을 확인

ethtool [어댑터이름]

아래 명령어로 WOL 기능을 활성화 ( g:enable, d:disable)

ethtool -s [어댑터이름] wol g

재부팅 시 자동으로 WOL 켤 수 있게 옵션 추가

post-up /usr/sbin/ethtool -s [인터페이스이름] wol g

vi /etc/network/interfaces

내용을 저장해주시고 proxmox를 shutdown 명령어로 꺼주시면 됩니다.

4. Proxmox 원격(WOL)으로 켜기

저는 iptime 공유기 WOL 기능을 통해 실행하도록 하겠습니다.
iptime접속 후 특수기능 → WOL 기능 → 등록된 PC 켜기

iptime 모바일 앱에서도 WOL 사용

우분투(Ubuntu) 22.04 LTS Server 설치

키큰난쟁이 — Thu, 12 Sep 2024 15:30:50 +0900

1. 들어가며

우분투(Ubuntu) 22.04 LTS Server 설치 정리

2. 우분투(Ubuntu) 이미지 다운로드

2.1 우분투(Ubuntu) 다운로드 링크

[다운로드 링크]

Ubuntu 22.04.4 LTS (Jammy Jellyfish)

Select an image Ubuntu is distributed on three types of images described below. Desktop image The desktop image allows you to try Ubuntu without changing your computer at all, and at your option to install it permanently later. This type of image is what m

releases.ubuntu.com

server용으로 설치하기 위해 ubuntu-22.04.1-live-server-amd64.iso 다운로드 받습니다.

3. 우분투(Ubuntu) 부팅 USB 만들기

3.1 부팅 USB 만들기

부팅 USB 만들기위해서 프로그램 설치 필요 – [Rufus 설치 링크]

Rufus - 간편하게 부팅 가능한 USB 드라이브 만들기

Rufus는 USB 메모리 및 플래시 드라이브를 포맷하고 부팅할 수 있도록 만드는 도구입니다. 이 페이지 아래에 나열된 ISO 이미지 이외에도 Rufus는 여러 종류의 ISO 이미지를 지원합니다. (1) Windows 8 이

rufus.ie

4. 우분투(Ubuntu) 22.04 LTS Server 설치

4.1 우분투(Ubuntu) 22.04 LTS Server 설치 진행

아래 네트워크 설정은 기본적인 DHCP 네트워크 환경이라면 아래처럼 IP가 자동으로 할당됩니다. 필요에 따라 IP 수동으로 잡아주시면 됩니다.

아래 DISK 설정 부분입니다. DISK 커스텀이 필요할 경우 설정 해주시면됩니다. 필자는 기본값으로 진행

Proxmox 설치 및 초기 설정

키큰난쟁이 — Thu, 12 Sep 2024 01:27:38 +0900

1. 들어가며

개인 서버 및 공부 용도로 현재 사용 중인 가상화 서비스이며 서버 재설치 겸 다시 정리하는 글

1.1 Proxmox 란?

데비안을 베이스로 하는 오픈소스 Type1 하이퍼바이저 운영체제로, 특이점으로 Qemu/KVM 기반 VM 이외에, 도커의 베이스가 되는 LXC를 지원한다.

1.2 하이퍼바이저(Hypervisor) 란?

하이퍼바이저는 호스트 컴퓨터로 다수의 운영체제를 동시에 실행하기 위한 논리적 플랫폼으로서 게스트 운영체제와 그 운영체제에서 구동되는 프로그램을 실제 물리적 장치에서 분리하는 프로세스를 가리킨다. 주로 소프트웨어 형태로 구현되지만, 임베디드 된 하드웨어의 형태로 제작되기도 한다. 하이퍼바이저는 '가상화 머신 모니터(virtual machine monitor)' 또는 '가상화 머신 매니저(virtual machine manager)'로 불리기도 하며, 준말인 'VMM'로도 불린다.

Type 1 하이퍼바이저는 하드웨어에서 직접 하이퍼바이저가 실행되고 게스트 운영체제는 그 위에서 돌아가는 형태로, 게스트 운영체제가 하드웨어에서 두 번째 수준으로 실행된다.
Type 2 하이퍼바이저는 운영체제 위에 하이퍼바이저가 있고, 그 위에 게스트 운영체제가 돌아가는 형태이다. 따라서 게스트 운영체제는 하드웨어에서 세 번째 수준으로 실행된다.

2. Proxmox 설치 전 준비

2.1 Proxmox 이미지 다운로드

아래 링크 통해서 ISO 파일을 다운로드
현재 설치하는 버전은 Proxmox 8.2 버전

Downloads

Proxmox VE 8.2 ISO Installer Version 8.2-2 File Size 1.39 GB Last Updated August 22, 2024 SHA256SUM c96ad84eacbbcef299ab8f407f9602f832abb5ceb08a9aa288c1e1164df2da97

www.proxmox.com

2.2 부팅 USB 만들기

아래 링크 통해서 부팅 USB 드라이브 만들 수 있는 프로그램을 다운로드

Rufus - 간편하게 부팅 가능한 USB 드라이브 만들기

rufus.ie

3. Proxmox 설치하기

3.1 PC 부팅 순서 변경

메인보드 BIOS 메뉴로 들어가서 부팅 순서를 USB가 먼저 부팅되도록 변경

3.2 Proxmox 설치 과정

Install Proxmox VE (Graphical)을 선택하여 설치를 계속 진행합니다. Proxomx GUI가 잘되어있기 때문에 CLI(Terminal UI)로 설치하실 필요는 없습니다. Install Proxmox VE (Graphical) 클릭

라이선스 관련 부분인데 읽어보시고 동의하시면 됩니다. I agree 클릭

디스크 설정 부분인데 Options 버튼 통해 설정해 주시면 되는데 저는 기본값으로 진행하였습니다. Next 클릭

Location and Time Zone 설정 국가 타임존 및 키보드 설정입니다. 저는 국가 South Korea 선택 키보드는 기본값(U. S. English)으로 진행하였습니다. Next 클릭

서버의 root 계정의 패스워드 설정하는 부분입니다. WebUI에서 사용하는 root의 패스워드로 사용됩니다. Proxmox 서버 이슈에 대한 내용을 메일로 받아볼 수 있습니다. 받아보실 이메일 계정을 입력해 줍니다. Next 클릭

Network Configuration 네트워크 설정하는 부분으로 IP 설정과 호스트네임 설정을 진행합니다. 저는 기본 값으로 진행하였습니다. Next 클릭

지금까지 설정한 것을 확인해 주시고 수정하실 게 없으시다면 Install을 수정하실게 필요하시다면 Previous을 선택하셔서 다시 작성하시면 됩니다. 확인을 다하셨다면 Install 클릭

설치 진행 중

설치가 완료되었으면 CLI 콘솔 화면이 띄워지게 됩니다.

4. Proxmox WebUI 접속

https://Proxmox IP:8006으로 접속하시면 됩니다. 위에서 설정한 비밀번호를 입력 후 로그인

Proxmox WebUI 모습을 보실 수 있습니다.

5. Proxmox 초기 설정

5.1 엔터프라이즈 리포지토리 비활성화

Proxmox WebUI 통해서 확인하시면 Enterprise 라이선스의 리포지터리가 포함되어 있는 것을 보실 수 있습니다.

해결하기에 앞서 유료 구독 서비스를 사용하지 않고 개인 용도로 사용할 경우 Proxmox에서 공식적으로 구독 내용을 스킵하도록 가이드라인 존재 합니다.
Proxmox 쉘로 접속 진행

/etc/apt/sources.list.d/pve-enterprise.list에서 enterprise를 주석 처리

vi /etc/apt/sources.list.d/pve-enterprise.list

# deb https://enterprise.proxmox.com/debian/pve bookworm pve-enterprise

/etc/apt/sources.list.d/ceph.list에서 enterprise를 주석 처리

vi /etc/apt/sources.list.d/ceph.list

#deb http://download.proxmox.com/debian/ceph-quincy bookworm enterprise

Proxmox WebUI에서 아래와 같이 비활성화 된것을 볼 수 있습니다.
비활성화는 WebUI에서도 가능하며 참고바랍니다.

5.2 미구독자용 리포지토리 추가

/etc/apt/sources.list.d/ceph.list 에서 미구독자용 리포지토리를 추가

vi /etc/apt/sources.list.d/ceph.list

맨 아래에 추가

# No Subscription
deb http://download.proxmox.com/debian/ceph-quincy bookworm no-subscription

/etc/apt/sources.list에 미구독자용 리포지토리 추가

vi /etc/apt/sources.list

맨 아래에 추가

# No Subscription
deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription

vi 편집기 저장 후 Proxmox WebUI 확인

apt 업데이트 및 업그레이드

apt update && apt upgrade

만약 아래와 같은 경고가 뜰 경우 DNS 등록이 안되어서 뜨는 경고이므로 DNS 설정 필요

8.8.8.8 / 8.8.4.4 (구글 네임서버)

5.3 라이선스 구독 팝업창 지우기

두 가지 방법이 있으며 선택하여 설정하시면 됩니다.

첫 번째 자동으로 수정하기

cp /usr/share/javascript/proxmox-widget-toolkit/proxmoxlib.js /usr/share/javascript/proxmox-widget-toolkit/proxmoxlib.js.bak
sed -i "s/\tExt.Msg.show/void/g" /usr/share/javascript/proxmox-widget-toolkit/proxmoxlib.js

두 번째 수동으로 수정하기

cd /usr/share/javascript/proxmox-widget-toolkit

cp proxmoxlib.js proxmoxlib.js.bak

vi proxmoxlib.js

vi 편집기에서 /No valid 문자 검색을 하여 아래 내용을 수정

# 변경 전
Ext.Msg.show({
# 변경 후
void({ // Ext.Msg.show({

vi 편집기 저장

첫 번째 두 번째 선택해서 설정하신 뒤 아래 명령어를 통해 서비스 재시작

systemctl restart pveproxy.service

VMware Workstation Pro 17 설치 및 한글패치

키큰난쟁이 — Wed, 11 Sep 2024 22:24:58 +0900

1. VMware Workstation Pro 17 다운로드 및 설치

[다운로드 링크]

Desktop Hypervisor Solutions | VMware

VMware Workstation and VMware Fusion desktop hypervisors are the industry leaders in local virtualization. Learn how VMware’s local virtualization solutions provide an easier way to build, test and deliver any app for any device or cloud.

www.vmware.com

자신과 맞는 OS 환경을 선택해 다운로드 받아주시면 됩니다.

설치 파일을 실행 → Next 클릭

I accept the terms in the License Agreement ✅ → Next 클릭

Add VMware Workstation console tools into system PATH ✅ → Next 클릭

Check for produck updates on startup / join the VMware Customer Experience Improvement Program ✅ → Next 클릭

Desktop / Start Menu Programs Folder ✅ → Next 클릭

Install 클릭

설치 진행 중

설치가 정상적으로 되었으면 Finish 클릭

라이센스키는 공개된 키들이 존재하나 여기서 설명은 따로 드리지 않겠습니다.

2. VMware Workstation Pro 17 한글패치

아래 블로그에 가셔서 진행하시면 됩니다.

[한글패치 링크]

[한글] VMware Workstation 17 Pro 17.6.0 Build 24238078

한국어 홈페이지: https://www.vmware.com/kr/products/workstation-pro/workstation-pro-evaluation.html 언어지원: 영어, 일어, 중국어 Vmware Workstation 17 버전에 해당하는 언어 파일만 있습니다 1차 작업완료 (2022-12-02) -

uniblog.tistory.com

SVN(Subversion) 백업 및 복구

키큰난쟁이 — Wed, 11 Sep 2024 18:40:40 +0900

1. 들어가며

개발 형상관리 툴 SVN(Subversion) 오류로 백업 작업하면서 정리

2. SVN(Subversion) Dump (백업)

2.1 도커 SVN 설치 되있는 경우

도커 컨테이너 접속 후 진행

# 도커 컨테이너 확인
docker ps -a

컨테이너 NAMES 확인

# 아래 리스트에서 접속할 컨테이너의 아이디 또는 네임을 확인한다.
CONTAINER ID   IMAGE                                        COMMAND                  CREATED        STATUS          PORTS                                                                                            NAMES
66f9622cb80c   mcr.microsoft.com/mssql/server:2019-latest   "/opt/mssql/bin/perm…"   5 months ago   Up 59 minutes   0.0.0.0:1433->1433/tcp, :::1433->1433/tcp                                                        mssql
09aada2c8ee2   elleflorio/svn-server                        "/init"                  6 months ago   Up 2 hours      0.0.0.0:80->80/tcp, :::80->80/tcp, 0.0.0.0:3690->3690/tcp, :::3690->3690/tcp, 443/tcp            svn-server
e45a0abf71aa   portainer/portainer-ce                       "/portainer"             6 months ago   Up 2 hours      0.0.0.0:8000->8000/tcp, :::8000->8000/tcp, 0.0.0.0:9000->9000/tcp, :::9000->9000/tcp, 9443/tcp   portainer

컨테이너 접속

# SVN 컨테이너 접속
docker exec -it svn-server /bin/sh

2.2 SVN(Subversion) Dump 진행

svnadmin dump /svn/repoName -r 100(리비전 번호) > /원하는디렉토리/repoName.dump // 100번 리비전 덤프
svnadmin dump /svn/repoName -r head > /원하는디렉토리/repoName.dump // Head 리비전 덤프
svnadmin dump /svn/repoName -r 100:head > /원하는디렉토리/repoName.dump // 100~head 리비전 덤프
svnadmin dump /svn/repoName -r 1:100> /원하는디렉토리/repoName.dump // 1~100 리비전 덤프

2.3 SVN(Subversion) Load 진행

svnadmin load /svn/repoName < /덤프파일디렉토리/repoName.dump

2.4 SVN(Subversion) Dump 및 Load 예시

svnadmin dump /svn/test -r 1:100> /root/svnbackup/test.dump // 리포지토리 덤프(백업)
svnadmin create test2 // 리포지토리 생성
svnadmin load /svn/test2 < /root/svnbackup/test.dump // 백업 리포지토리 > test2로 이전 작업
## 정상 동작 하는지 확인 후 기존 리포지토리 삭제
rm -rf /svn/test

JAVA에서 네이버클라우드플랫폼 Cloud Outbound Mailer API 사용

키큰난쟁이 — Tue, 10 Sep 2024 00:10:25 +0900

1. 들어가며

nCloud 통해서 서비스되고 있는 프로젝트에 클라우드 메일 전송 서비스를 개발하면서 정리한 글
네이버 클라우드는 개인/일반 기업용과 공공기관용이 따로 있으며 가이드 내용이 상이할 수 있습니다.

2. Cloud Outbound Mailer 사전 준비

2.1 JAVA SDK 다운로드

지원하는 API 별로 SDK 제공되고 있어 확인 후 다운로드 [바로가기]
Cloud Outbound Mailer 제공하는 SDK 다운로드 (공공기관용이 따로 있으니 확인 후 다운로드 바랍니다.)

2.2 JAVA SDK 사용하기 위한 준비

압출 풀면 나오는 java 소스 또는nes-client-1.6.1.jar를 추가
SDK 사용에 있어 필요한 라이브러리 설치 필자는 maven 프로젝트로 pom.xml 아래 내용을 추가

<!-- https://mvnrepository.com/artifact/junit/junit -->
<dependency>
  <groupId>junit</groupId>
  <artifactId>junit</artifactId>
  <version>4.12</version>
  <scope>test</scope>
</dependency>
<!-- https://mvnrepository.com/artifact/com.squareup.okhttp3/okhttp -->
<dependency>
  <groupId>com.squareup.okhttp3</groupId>
  <artifactId>okhttp</artifactId>
  <version>${okhttp-version}</version>
</dependency>
<!-- https://mvnrepository.com/artifact/com.squareup.okhttp/logging-interceptor -->
<dependency>
  <groupId>com.squareup.okhttp3</groupId>
  <artifactId>logging-interceptor</artifactId>
  <version>${okhttp-version}</version>
</dependency>
<!-- https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-databind -->
<dependency>
  <groupId>com.fasterxml.jackson.core</groupId>
  <artifactId>jackson-databind</artifactId>
  <version>${fasterxml-version}</version>
</dependency>
<!-- https://mvnrepository.com/artifact/com.fasterxml.jackson.dataformat/jackson-dataformat-xml -->
<dependency>
  <groupId>com.fasterxml.jackson.dataformat</groupId>
  <artifactId>jackson-dataformat-xml</artifactId>
  <version>${fasterxml-version}</version>
</dependency>
<!-- https://mvnrepository.com/artifact/commons-codec/commons-codec -->
<dependency>
  <groupId>commons-codec</groupId>
  <artifactId>commons-codec</artifactId>
  <version>${common-codec-version}</version>
</dependency>
<!-- https://mvnrepository.com/artifact/org.apache.commons/commons-lang3 -->
<dependency>
  <groupId>org.apache.commons</groupId>
  <artifactId>commons-lang3</artifactId>
  <version>3.7</version>
</dependency>

2.3 credentials.properties 파일 생성

type=iam
apiKey="API Gateway에 설정된 API Key"
accessKey="Sub Account에 설정된 서브계정의 Access Key"
secretKey="Sub Account에 설정된 서브계정의 Secret Key"

3. Cloud Outbound Mailer JAVA 구현 소스

3.1 ApiClient 객체 인증 정보 설정

프로퍼티 파일을 이용한 인증

public void setUp() {
  apiClient = new ApiClient.ApiClientBuilder()
    .addMarshaller(JsonMarshaller.getInstance())
    .addMarshaller(XmlMarshaller.getInstance())
    .addMarshaller(FormMarshaller.getInstance())
    .setCredentials(new PropertiesFileCredentialsProvider("credentials.properties").getCredentials()) // 인증 정보 설정
    .setLogging(true)
    .build();

  api = new V1Api(apiClient);
}

3.2 createMailRequest (메일 발송)

Email 발송을 요청합니다. 요청 파라미터는 공식 API 문서 확인 바랍니다. [바로가기]

public class CloudOutboundMailer {

    public V1Api setUp() {
        ApiClient apiClient = new ApiClient.ApiClientBuilder()
                .addMarshaller(JsonMarshaller.getInstance())
                .addMarshaller(XmlMarshaller.getInstance())
                .addMarshaller(FormMarshaller.getInstance())
                .setCredentials(new PropertiesFileCredentialsProvider("lib/credentials.properties").getCredentials())
                .setLogging(true)
                .build();

        V1Api apiInstance = new V1Api(apiClient);

        return apiInstance;
    }

    public void createMailRequest() {
        V1Api apiInstance = setUp();

        List<EmailSendRequestRecipients> esrrList = new ArrayList<EmailSendRequestRecipients>();
        EmailSendRequestRecipients emailSendRequestRecipients = new EmailSendRequestRecipients();
        emailSendRequestRecipients.setAddress("수신자 메일");
        emailSendRequestRecipients.setName("수신자 이름");
        emailSendRequestRecipients.setType("R");
        esrrList.add(emailSendRequestRecipients);

        EmailSendRequest requestBody = new EmailSendRequest();
        //requestBody.setTemplateSid({templateID}); 템플릿 사용시 템플릿 번호
        //requestBody.attachFileIds("{fileID}"); // createFile를 통해서 생성된 fileId 리스트
        requestBody.setRecipients(esrrList);
        requestBody.setBody("본문영역");

        requestBody.setSenderAddress("발송자 메일");
        requestBody.setSenderName("발송자 이름");
        requestBody.setTitle("메일 제목");
        requestBody.setConfirmAndSend(false);

        String X_NCP_LANG = "ko-KR"; // String | 언어 (ko-KR, en-US, zh-CN), default:en-US
        System.out.println(requestBody);
        try {
            // Handler Successful response
            ApiResponse<EmailSendResponse> result = apiInstance.mailsPost(requestBody, X_NCP_LANG);
        } catch (ApiException e) {
            // Handler Failed response
            int statusCode = e.getHttpStatusCode();
            Map<String, List<String>> responseHeaders = e.getHttpHeaders();
            InputStream byteStream = e.getByteStream();
            e.printStackTrace();
        } catch (SdkException e) {
            // Handle exceptions that occurred before communication with the server
            e.printStackTrace();
        }
    }
}

3.3 createFile (메일에 파일 첨부가 필요할 경우)

파일을 업로드할 수 있는 기능을 제공합니다. 업로드된 파일의 fileId는 업로드 후 24시간 동안 재사용할 수 있습니다. 24시간이 경과하면 업로드된 파일은 삭제되며 fileId도 유효하지 않게 됩니다. 요청 파라미터는 공식 API 문서 확인 바랍니다. [바로가기]

ublic class CloudOutboundMailer {

    public V1Api setUp() {
        ApiClient apiClient = new ApiClient.ApiClientBuilder()
                .addMarshaller(JsonMarshaller.getInstance())
                .addMarshaller(XmlMarshaller.getInstance())
                .addMarshaller(FormMarshaller.getInstance())
                .setCredentials(new PropertiesFileCredentialsProvider("lib/credentials.properties").getCredentials())
                .setLogging(true)
                .build();

        V1Api apiInstance = new V1Api(apiClient);

        return apiInstance;
    }

    public void createFile() {
        V1Api apiInstance = setUp();

        File files = new File("업로드할 파일 경로");

        String X_NCP_LANG = "ko-KR"; // String | 언어 (ko-KR, en-US, zh-CN), default:en-US
        try {
            // Handler Successful response
            ApiResponse<FileUploadResponse> result = apiInstance.filesPost(files, X_NCP_LANG);
        } catch (ApiException e) {
            // Handler Failed response
            int statusCode = e.getHttpStatusCode();
            Map<String, List<String>> responseHeaders = e.getHttpHeaders();
            InputStream byteStream = e.getByteStream();
            e.printStackTrace();
        } catch (SdkException e) {
            // Handle exceptions that occurred before communication with the server
            e.printStackTrace();
        }
    }
}

createFile 통해서 리턴 받는 fileId 사용해 메일에 파일 첨부 하시면 됩니다.

4. 마치며

나머지 궁금한 사항 등은 공식 API 가이드 문서 통해서 확인 바랍니다. [바로가기]

맥 실리콘 M1 환경에서 JDK 버전 변경하기

키큰난쟁이 — Mon, 9 Sep 2024 00:10:44 +0900

2024.09.05 - [Language/JAVA] - 맥 실리콘 M1 환경에서 JDK8 설치하기

맥 실리콘 M1 환경에서 JDK8 설치하기

1. 맥 실리콘 M1 ARM용 JDK 설치1.1 JDK 설치[설치링크] Azul DownloadsNo matter the size of your company, Azul offers competitive pricing options to fit your needs, your budget, and your ambition.www.azul.com해당 링크에서 설치할 JDK를

bigdwarf.blog

1. 맥 실리콘 M1 ARM용 환경변수 추가 설정

1.1 정상적으로 설치가 완료되었는지 JDK 경로 확인

현재 JDK 8 버전 설치 되어있어 필자는 JDK 11 버전을 설치
필요한 JDK 설치가 완료 후 경로 /Library/Java/JavaVirtualMachines/설치한 버전/Contents/Home 복사합니다.

1.2 ~/.zshrc 파일에 조금 전 복사한 경로를 JAVA_PATH 환경 변수로 등록

vi 편집기를 통해 ~/.zshrc 열기

vi ~/.zshrc

#JAVA 8
#export JAVA_HOME=/Library/Java/JavaVirtualMachines/zulu-8.jdk/Contents/Home

#JAVA 11
export JAVA_HOME=/Library/Java/JavaVirtualMachines/zulu-11.jdk/Contents/Home

→JAVA8 #export JAVA_HOME=/Library/Java/JavaVirtualMachines/zulu-8.jdk/Contents/Home 주석 처리 후 저장

1.3 환경변수에서 변경한 JDK 적용 시키려면 아래의 명령어를 입력

source ~/.zshrc

1.4 현재 사용하고있는 JDK 버전 확인

java -version

맥 실리콘 M1 환경에서 JDK8 설치하기

키큰난쟁이 — Sun, 8 Sep 2024 00:10:39 +0900

1. 맥 실리콘 M1 ARM용 JDK 설치

1.1 JDK 설치

[설치링크]

Azul Downloads

No matter the size of your company, Azul offers competitive pricing options to fit your needs, your budget, and your ambition.

www.azul.com

해당 링크에서 설치할 JDK를 원하는 포맷에 파일(.dmg,.tar.gz,.zip)중 선택 후 설치 진행
편하게 .dmg 파일을 선택해 설치하도록 한다.

1.2 설치된 JAVA 버전 확인

설치가 완료 됐으면,Command + space키를 눌러 터미널을 열고 JDK가 정상적으로 설치가 됐는지 확인

java -version

2. 맥 실리콘 M1 ARM용 환경 변수 설정

2.1 정상적으로 설치가 완료 됐는지 JDK 경로를 확인

.dmg를 통해 설치했다면 JDK 경로는 기본 경로인/Library/Java/JavaVirtualMachines입니다.

cd /Library/Java/JavaVirtualMachines
ls

2.2 JDK 설치 확인 후 JAVA_HOME 및 PATH 설정

조금 전 확인한 JDK 경로/Library/Java/JavaVirtualMachines/zulu-8.jdk에서/Contents/Home까지 경로를 복사

pwd

2.3 ~/.zshrc 파일에 조금 전 복사한 경로를 JAVA_PATH 환경 변수로 등록

vi 편집기를 통해~/.zshrc열기

vi ~/.zshrc

## 자바 설정
export JAVA_HOME=/Library/Java/JavaVirtualMachines/zulu-8.jdk/Contents/Home
export PATH=${PATH}:$JAVA_HOME/bin

i를 눌러 INSERT 모드로 전환 아래 구문을 작성 esc키를 누르고 :wq를 입력 한 뒤 Enter키를 눌러 저장

JAVA 예외처리(Exception) try-catch, throw, throws 무엇인가?

키큰난쟁이 — Sat, 7 Sep 2024 00:10:40 +0900

1. 들어가며

자바(JAVA) 예외처리(Exception)에 대해 정리

2. JAVA 예외처리(Exception) 정의

2.1 try-cach 란?

try-catch블록은 예외가 발생할 수 있는 상황에서 안정적인 프로그램 실행을 위해 사용됩니다.try블록 안에는 예외가 발생할 가능성이 있는 코드를 넣습니다. 만약try블록 내에서 예외가 발생하면, 이후의 코드는 실행되지 않고, 즉시 catch 블록으로 제어가 이동합니다.

catch 블록은 발생한 예외를 처리하는 코드를 포함하며, 이는 예외의 유형에 따라 다를 수 있습니다. 예외 객체를 인자로 받아 그 정보를 활용할 수 있습니다. 또한, 여러 종류의 예외를 처리하기 위해 여러catch블록을 사용할 수 있습니다.

마지막으로finally블록은try-catch블록 이후에 무조건 실행되는 코드를 포함합니다. finally블록은 선택적이며, 주로 자원을 해제하는 등의 마무리 작업에 사용됩니다.

try {
    // 예외 발생 가능성이 있는 코드
} catch (ExceptionType1 e1) {
    // ExceptionType1 예외를 처리하는 코드
} catch (ExceptionType2 e2) {
    // ExceptionType2 예외를 처리하는 코드
} finally {
    // 무조건 실행되는 코드
}

2.2 throws 란?

throws키워드는 메서드나 생성자에서 처리하지 않은 예외를 호출한 곳에 알리기 위해 사용됩니다. 메서드나 생성자의 선언부에 이 키워드를 표시함으로써 해당 메서드나 생성자가 특정 유형의 예외를 처리하지 않고 던질 가능성이 있음을 명시적으로 알립니다. 이렇게 하면 해당 메서드나 생성자를 사용하는 측에서는 이를 감안한 적절한 예외 처리를 준비해야 합니다.

public void someMethod() throws IOException {
    // 메소드 본문
}

2.3 throws 란?

throw키워드는 프로그래머가 직접 예외를 발생시키기 위해 사용됩니다. throw키워드 뒤에는Throwable클래스의 하위 클래스인 예외 클래스의 인스턴스가 와야 합니다. 이렇게 하면 그 위치에서 즉시 특정 예외가 발생하며, 이는 주로 특정 조건을 만족하지 않을 때 사용됩니다. 발생시킨 예외는 적절한catch블록에서 처리되거나, 해당 메소드에서throws를 통해 던져져 메소드를 호출한 곳에서 처리됩니다.

public void someMethod() {
    if (someConditionNotMet) {
        throw new SomeException("SomeException occurred");
    }
}

이런 방식으로 JAVA에서는try, catch, throw, throws를 이용하여 예외 상황을 효과적으로 처리할 수 있습니다. 이를 통해 프로그램의 안정성과 가독성을 높일 수 있습니다.

3. JAVA 예외처리(Exception) 정의

throws는 메소드메서드 또는 생성자 선언에서 사용되며, 해당 메서드 또는 생성자가 예외를 처리하지 않고 던질 수 있다는 것을 명시하는 데 사용됩니다. 즉, 이 메서드를 호출하는 곳에서 이 예외를 처리해야 함을 알립니다.

throw는 특정 조건에서 직접 예외를 발생시키는 데 사용됩니다. 이는 실행 흐름을 즉시 중단하고 해당 예외를 처리할 수 있는 가장 가까운catch블록으로 제어를 이동시킵니다. 만약 적절한catch블록이 없다면, 이 예외는 메소드를 호출한 곳으로 던져집니다.

이 두 상황에 따라 적절하게 사용되어, 예외 상황을 효과적으로 관리할 수 있습니다.

라이믹스 → 티스토리 이사

키큰난쟁이 — Fri, 6 Sep 2024 12:30:31 +0900

워드프레스 → 라이믹스 → 티스토리

워드프레스, 라이믹스 블로그는 개인 서버에서

운영했지만 관리하기 힘들어 결국 티스토리로 정착....

현재 라이믹스에 작성된 글 이전 중입니다.

우분투 서버 IP 변경하기

키큰난쟁이 — Fri, 6 Sep 2024 00:10:23 +0900

1. 들어가며

서버 IP 변경이 필요해서 정리하는 글

2. NIC와 Gateway 정보 확인

route -n

Kernel IP routing table
Destination     Gateway         Genmask         Flags Metric Ref    Use Iface
0.0.0.0         192.168.0.1     0.0.0.0         UG    0      0        0 eno1
192.168.0.0     0.0.0.0         255.255.255.0   U     0      0        0 eno1

Gateway : 192.168.0.1
NIC : eno1

3. IP 변경하기

vi /etc/netplan/50-cloud-init.yaml

network:
  version: 2
  renderer: networkd
  ethernets:
    eno1: #route -n으로 확인한 NIC
      addresses: [192.168.0.5/24] #지정할 ip
      gateway4: 192.168.0.1 #route -n 으로 확인 한 gateway ip
      nameservers:
        addresses: [8.8.8.8, 8.8.4.4] # 네임서버 주소 (구글 네임서버로 설정)

↑ 위와 같이 내용을 수정

4. 적용하기

netplan apply

5. 확인하기

ifconfig

eno1: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 192.168.0.5  netmask 255.255.255.0  broadcast 192.168.0.255
        inet6 fe80::3ea8:2aff:fe1e:5454  prefixlen 64  scopeid 0x20<link>
        ether 3c:a8:2a:1e:54:54  txqueuelen 1000  (Ethernet)

자바스크립트 템플릿 리터럴 : 백틱(“)

키큰난쟁이 — Thu, 5 Sep 2024 04:36:25 +0900

1. 들어가며

인터넷 익스플로러 2022년 6월 15일 부로 지원 종료됨으로써 ES6에서 새로운 문자열 표기법으로 큰따옴표(" ")가 아닌 백틱(` `)을 사용해 문자열을 사용하려고 정리

2. 자바스크립트 백틱 사용법

2.1 변수와 함께 사용

/* '${변수명}'을 사용하여 문자열 안에 변수를 삽입 */

let name = "키큰난쟁이";
console.log(`안녕하세요, ${name}님!`); // "안녕하세요, 키큰난쟁이님!" 출력

2.2 다중 라인 문자열

/* 백틱을 사용하면 문자열을 여러 줄에 걸쳐 작성 */

let message = `
    여러줄의
    문자열을 쉽게
    작성할 수 있습니다.
`;
console.log(message);

2.3 표현식 사용

/* 백틱 내부에서 표현식도 사용 가능 */

let x = 5;
let y = 10;
console.log(`두 수의 합은 ${x + y}입니다.`); // "두 수의 합은 15입니다." 출력

3. JSP에서 자바스크립트 백틱 사용 시 주의점

3.1 JSP를 사용할 경우

/* JSP의 EL 표현식과 JavaScript의 템플릿 문자열이 겹치게 됩니다. */

// JAVA Controller
request.setAtteinute("msg", "서버에서 넘어온 데이터");

// JavaScript
let msg = '자바스크립트 변수 데이터'
let message = `나는 ${msg} 입니다.`; // "나는 서버에서 넘어온 데이터 입니다." 출력

3.2 JSP에서 백틱 함수를 사용하기 위한 해결 방법

// JAVA Controller
request.setAtteinute("msg", "서버에서 넘어온 데이터");

// JavaScript
let msg = '자바스크립트 변수 데이터'

// 첫번째 방법
let message = `나는 ${"${msg}"} 입니다.`; //"나는 자바스크립트 변수 데이터 입니다." 출력

// 두번째 방법
let message = `나는 \${msg} 입니다.`; //"나는 자바스크립트 변수 데이터 입니다." 출력