로컬 Docker로 SAP ABAP 개발환경 구성하기

1. 구성 목표

이번 작업에서 구성한 항목은 다음과 같다.

  • Docker 기반 SAP ABAP Trial 실행
  • SAP GUI 접속
  • ABAP 프로그램 테스트
  • ALV 예제 실행
  • abapGit 설치
  • GitHub 개인 저장소 연동
  • ABAP 소스 Git 관리

2. 환경

항목 내용
OS Windows
Container Docker Desktop + WSL2
SAP 접속 SAP GUI
ABAP 환경 ABAP Cloud Developer Trial 기반 Docker 이미지
Git 연동 abapGit
Git 저장소 GitHub 개인 계정

3. Docker 이미지

원래 공식 이미지는 아래 형태로 제공되었다.

docker pull sapse/abap-cloud-developer-trial:2023

하지만 현재 공식 이미지가 정상적으로 내려받아지지 않는 경우가 있어, 실습에서는 아래 비공식 이미지를 사용했다.

docker pull weidongshen/abap-cloud-developer-trial:2023_20260501

비공식 이미지 사용 시 주의사항

  • SAP 공식 배포 이미지가 아니다.
  • 회사 PC나 회사 네트워크에서는 사용하지 않는 것을 권장한다.
  • 중요한 파일이 있는 경로를 Docker volume으로 연결하지 않는 것이 좋다.
  • 개인 학습용으로만 사용하는 것을 권장한다.

4. Windows WSL2 메모리 설정

ABAP Trial 이미지는 메모리를 많이 사용한다.
Docker Desktop이 WSL2 기반으로 동작하는 경우 .wslconfig 파일을 생성해서 메모리를 충분히 할당한다.

파일 위치:

C:\Users\<윈도우계정>\.wslconfig

파일이 없다면 직접 생성하면 된다.

PowerShell에서 아래 명령으로 생성할 수 있다.

notepad $env:USERPROFILE\.wslconfig

내용은 아래처럼 작성한다.

[wsl2]
memory=20GB
processors=4
localhostForwarding=true

PC RAM이 16GB라면 memory=12GB 정도로 낮춰서 설정하는 것이 좋다.

설정 후 WSL을 재시작한다.

wsl --shutdown

이후 Docker Desktop을 완전히 종료했다가 다시 실행한다.


5. hosts 파일 설정

SAP 컨테이너는 hostname을 vhcala4hci로 사용하는 것이 안전하다.
Windows hosts 파일에 아래 값을 추가한다.

파일 위치:

C:\Windows\System32\drivers\etc\hosts

추가할 내용:

127.0.0.1 vhcala4hci

관리자 권한으로 메모장을 실행해서 수정한다.

확인:

ping vhcala4hci

정상이라면 아래처럼 127.0.0.1로 응답한다.

Pinging vhcala4hci [127.0.0.1]

6. Docker 네트워크 생성

컨테이너 재시작 시 Hardware Key가 바뀌는 문제가 발생할 수 있다.
이를 줄이기 위해 Docker 네트워크, IP, MAC Address를 고정해서 실행한다.

먼저 Docker 네트워크를 생성한다.

docker network create --driver bridge --subnet 172.25.0.0/24 --gateway 172.25.0.1 abap-net

이미 생성되어 있다면 에러가 날 수 있는데, 기존 네트워크를 그대로 사용해도 된다.


7. 컨테이너 실행

아래 명령으로 컨테이너를 실행한다.

docker run --stop-timeout 3600 -i --name a4h --hostname vhcala4hci --network abap-net --ip 172.25.0.10 --mac-address 02:42:ac:19:00:10 -p 3200:3200 -p 3300:3300 -p 8443:8443 -p 30213:30213 -p 50000:50000 -p 50001:50001 weidongshen/abap-cloud-developer-trial:2023_20260501 -skip-limits-check -agree-to-sap-license

주요 옵션 설명:

옵션 설명
--name a4h 컨테이너 이름
--hostname vhcala4hci SAP 시스템 hostname
--network abap-net 고정 네트워크 사용
--ip 172.25.0.10 컨테이너 IP 고정
--mac-address 02:42:ac:19:00:10 MAC Address 고정
-p 3200:3200 SAP GUI 접속 포트
-p 3300:3300 RFC 포트
-p 50000:50000 HTTP 포트
-p 50001:50001 HTTPS 포트
-skip-limits-check Docker 리소스 체크 스킵
-agree-to-sap-license SAP Trial 라이선스 동의

8. 컨테이너 상태 확인

실행 중인 컨테이너 확인:

docker ps

전체 컨테이너 확인:

docker ps -a

포트 매핑 확인:

docker port a4h

SAP GUI 포트 확인:

Test-NetConnection localhost -Port 3200

정상이라면 아래 값이 나온다.

TcpTestSucceeded : True

9. SAP 프로세스 상태 확인

컨테이너가 떠 있어도 SAP 내부 프로세스가 완전히 기동되기 전에는 SAP GUI 접속이나 T-Code 실행이 불안정할 수 있다.

아래 명령으로 SAP 프로세스 상태를 확인한다.

docker exec -it a4h /usr/sap/hostctrl/exe/sapcontrol -nr 00 -function GetProcessList

아래 프로세스들이 GREEN 상태인지 확인한다.

msg_server
disp+work
gwrd
icman

로그 확인:

docker logs -f a4h

10. SAP GUI 접속

SAP GUI에서 신규 연결을 생성한다.

Connection Type : Custom Application Server
Application Server : localhost
Instance Number : 00
System ID : A4H
SAProuter String : 비움

또는 Application Server에 아래 값을 사용해도 된다.

vhcala4hci

로그인 정보:

Client   : 001
User     : DEVELOPER
Password : ABAPtr2023#00
Language : EN

라이선스 확인이나 관리자 작업이 필요하면 아래 계정을 사용한다.

Client   : 000
User     : SAP*
Password : ABAPtr2023#00
Language : EN

11. 컨테이너 종료 및 재시작

컨테이너를 끌 때는 강제 종료하지 않고 아래 명령으로 종료한다.

docker stop -t 7200 a4h

다시 시작할 때는 기존 컨테이너를 재사용한다.

docker start -ai a4h

주의할 점:

docker rm -f a4h
docker run ...

위 방식으로 매번 새로 만들면 Hardware Key, 라이선스, 내부 설정이 꼬일 수 있다.
이미 만든 컨테이너는 docker start -ai a4h로 재사용하는 것이 좋다.


12. 라이선스 처리

로그인 시 라이선스 오류가 발생하면 SLICENSE에서 Hardware Key를 확인한 뒤 MiniSAP 라이선스를 새로 발급받아야 한다.

12.1 SLICENSE 확인

SAP GUI에서 SAP* / Client 000으로 로그인 후 T-Code 실행:

SLICENSE

확인할 항목:

System ID
Hardware Key
Valid Until
Status

12.2 Docker로 라이선스 파일 적용

MiniSAP에서 받은 라이선스 파일을 컨테이너에 복사한다.

예시:

cd $env:USERPROFILE\Downloads
docker cp .\A4H_Multiple.txt a4h:/opt/sap/ASABAP_license

라이선스 적용 스크립트 실행:

docker exec -it a4h /usr/local/bin/asabap_license_update

컨테이너 재시작:

docker stop -t 7200 a4h
docker start -ai a4h

13. Hardware Key가 계속 바뀌는 경우

컨테이너 재시작 시 Hardware Key가 바뀐다면 Docker 네트워크, IP, MAC Address를 고정해서 다시 컨테이너를 생성해야 한다.

기존 컨테이너 삭제:

docker stop -t 7200 a4h
docker rm -f a4h

네트워크 생성:

docker network create --driver bridge --subnet 172.25.0.0/24 --gateway 172.25.0.1 abap-net

고정 IP/MAC으로 컨테이너 재생성:

docker run --stop-timeout 3600 -i --name a4h --hostname vhcala4hci --network abap-net --ip 172.25.0.10 --mac-address 02:42:ac:19:00:10 -p 3200:3200 -p 3300:3300 -p 8443:8443 -p 30213:30213 -p 50000:50000 -p 50001:50001 weidongshen/abap-cloud-developer-trial:2023_20260501 -skip-limits-check -agree-to-sap-license

이후 새로 확인한 Hardware Key로 라이선스를 다시 발급받는다.


14. 간단한 ABAP 프로그램 테스트

SAP GUI에서 SE38 실행 후 테스트 프로그램을 생성한다.

프로그램명 예시:

ZTEST_HELLO_ABAP

예제 코드:

REPORT ztest_hello_abap.

TYPES: BEGIN OF ty_member,
         id     TYPE i,
         name   TYPE string,
         module TYPE string,
       END OF ty_member.

DATA: lt_member TYPE STANDARD TABLE OF ty_member WITH EMPTY KEY,
      ls_member TYPE ty_member.

START-OF-SELECTION.

  lt_member = VALUE #(
    ( id = 1 name = '성현' module = 'ABAP' )
    ( id = 2 name = '테스트' module = 'FI' )
    ( id = 3 name = '개발환경' module = 'BASIS' )
  ).

  WRITE: / '=== ABAP 테스트 프로그램 시작 ==='.
  WRITE: / '현재 날짜:', sy-datum.
  WRITE: / '현재 시간:', sy-uzeit.
  WRITE: / '현재 사용자:', sy-uname.
  SKIP.

  LOOP AT lt_member INTO ls_member.
    WRITE: / 'ID:', ls_member-id,
             '이름:', ls_member-name,
             '모듈:', ls_member-module.
  ENDLOOP.

  SKIP.
  WRITE: / '=== 프로그램 정상 종료 ==='.

실행 순서:

SE38
→ Program 입력
→ Create
→ Source Code 작성
→ Activate
→ F8 실행

15. Runtime Error 확인

T-Code 실행 중 Runtime Error가 발생하면 ST22에서 Short Dump를 확인한다.

ST22

예를 들어 DBIF_REPO_SQL_ERROR가 발생할 수 있다.
이 경우 보통 다음을 확인한다.

  • Docker/WSL 메모리 부족 여부
  • SAP 프로세스가 모두 GREEN인지
  • HANA 기동이 완료되었는지
  • 라이선스 상태가 정상인지
  • 비공식 이미지 자체 문제는 아닌지

프로세스 확인:

docker exec -it a4h /usr/sap/hostctrl/exe/sapcontrol -nr 00 -function GetProcessList

Docker 메모리 설정 확인:

[wsl2]
memory=20GB
processors=4
localhostForwarding=true


Profile picture

@shyun_im

COMMENTS

댓글

GitHub 계정으로 로그인하면 댓글을 남길 수 있습니다.

댓글을 불러오는 중입니다.