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=truePC 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 a4hSAP GUI 포트 확인:
Test-NetConnection localhost -Port 3200정상이라면 아래 값이 나온다.
TcpTestSucceeded : True9. 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 a4h10. 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 : EN11. 컨테이너 종료 및 재시작
컨테이너를 끌 때는 강제 종료하지 않고 아래 명령으로 종료한다.
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
Status12.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 a4h13. 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 GetProcessListDocker 메모리 설정 확인:
[wsl2]
memory=20GB
processors=4
localhostForwarding=true
COMMENTS
댓글
GitHub 계정으로 로그인하면 댓글을 남길 수 있습니다.
댓글을 불러오는 중입니다.