JSP - 개발환경 구축

이번 글을 통해서는 JSP 개발환경을 세팅하는 방법을 알아보도록 하겠습니다.

내용을 진행함에 앞서서 저는 MacOS 시스템을 사용하고 있고 개발환경 세팅 또한 이 MacOS를 기준으로 기록할 것임을

먼저 밝힙니다. 혹시 Windows 운영체제를 사용하시는 분들이라면 이 글에서 다소 다른 부분이 있을수 있으니

해당 사항을 참고해주시기 바랍니다.

 

 

개발환경 구축을 위해 필요한 것

JSP 개발환경을 구축하기 위해서는 다음의 요소들을 설치해야 합니다.

설치항목

JDK (버전8 이상)

Tomcat (버전 8.5.57)

Spring Tool Suite 4(STS)

Maven3

지금부터 각 항목별로 순서대로 설치과정을 알아보도록 하겠습니다.

 

 

1. JDK

JDK는 8 이상의 버전을 설치해주시면 됩니다.

우선 오라클 페이지에 접속해서 원하는 버전의 JDK를 다운로드 합니다.

https://www.oracle.com/java/technologies/javase-downloads.html

(제가 JDK를 세팅하던 시점에는 jdk13.0.2 버전이 가장 최신이었는 데 이제는 14버전이 나왔습니다.)

저는 13.0.2 버전을 사용하고 있으니 해당 부분 양해해주시기 바랍니다. 버전이다르다고해서 설치과정이 다르진 않습니다.

오라클 페이지로 이동해서 JDK Download를 클릭해줍니다.

JDK Download를 클릭하면 아래와 같은 창이 나옵니다. 여기서 macOS Installer를 클릭해서 다운로드 해주도록 합시다.

설치파일의 다운로드가 완료되면 실행해서 다음과 같이 설치과정을 진행해줍니다.

Installer에서 안내하는 데로 따라서하면 금방 설치를 완료할 수 있습니다.

설치과정을 마쳤다면 이제 JDK 환경변수를 설치해줘야 합니다. 환경변수를 설정하기 위해서는 우선 맥의 터미널을

실행해주도록 합시다. 혹시 iTerm을 사용하시는 분이라면 iTerm을 사용하셔도 무방합니다.

 

그리고 마지막으로 JDK 정상적으로 설치가 되었는 지 확인해보기 위해서 터미널을 열어서 java -version을 입력해봅니다.

만약 다음과 같이 나타난다면 JDK의 설치가 정상적으로 이뤄진 것입니다.

---

또한 추가적으로 OpenJDK로 JDK를 세팅하는 방법에 대한 설명을 추가하도록 하겠습니다. OpenJDK는 Oracle에서 제공하는 Java 개발의 여러 플렛폼들을 오픈소스로 제공하는 것 입니다.(Oracle의 Java 유료화 정책으로 인해서...) 그래서 위에서 봤던 것처럼 Oracle의 JDK를 설치하여 환경을 구축하는 것이 일반적이지만 OpenJDK 설치를 통해서도 JDK 환경을 구축할 수 있습니다.

 

OpenJDK의 공식 홈페이지는 아래의 주소 입니다.

https://openjdk.java.net

OpenJDK

하지만 이 OpenJDK를 배포하는 곳은 여러 곳이 있습니다. 그 중에서 이번에는 AWS(Amazon Web Service)에서 제공하고 있는 베포판을 사용하도록 하겠습니다. 다운로드를 위해서 아래의 페이지로 이동합니다.

aws.amazon.com/ko/corretto/

Amazon Corretto 프로덕션용 OpenJDK 배포

해당 페이지에 접속한 모습

해당 페이지로 이동하면 위와 같은 창이 나타날 것 입니다. 여기서 "Corretto11 다운로드하기"를 클릭합니다.

다양한 운영체제를 지원 한다.

그러면 위와 같이 다양한 운영체제에 따른 버전들이 존재하는 것을 확인할 수 있습니다. 현재 저는 MacOS를 사용 중이기 때문에 MacOS 용 버전을 다운로드 하도록 하겠습니다. 해당 설치파일의 용량이 꽤 큰 편(170mb) 이기 때문에 네트워크 상황이 좋지 않다면 조금 인내심을 가지고 기다려 주셔야 합니다.

설치파일을 다운로드한 모습

위와 같이 설치파일 다운로드를 마쳤다면 실행해 줍니다.

설치 진행과정 모습

이후의 설치는 installer가 안내하는 데로 진행하시면 빠르게 마치실 수 있습니다. homebrew가 아닌 위와 같이 installer로 설치를 진행하게 되면 해당 설치파일은 /Library/Java/JavaVirtualMachines 에 위치하게 됩니다. 터미널을 실행해서 해당 위치로 이동해 보겠습니다.

openJDK가 설치된 모습

디렉터리의 리스트를 보면 "amazon-corretto-11.jdk" 가 있는 것을 확인할 수 있습니다. 해당 폴더가 이번에 설치한 OpenJDK 입니다. 그렇다면 이제 OpenJDK를 위한 환경변수 설정을 진행해보도록 하겠습니다.

 

설치디렉터리의 하위 디렉터리 /Contents/Home 으로 이동

설치디렉터리의 하위 디렉터리 /Contents/Home 으로 이동 합니다(명령어는 위의 이미지를 참고해 주세요). 이동을 마쳤다면 "vi ~/.zshrc"을 입력합니다. (MacOS가 카탈리나 버전으로 버전업하면서 기본 shell이 zsh로 변경되었습니다. 그래서 bash 명령을 사용하지 않는 것 입니다.)

그러면 오른쪽 이미지에서 볼 수 있듯이 뭔가 내용이 많이 나타납니다. 여기서 G를 입력해서 파일 가장 아래로 내려갑니다.

그러면 이전에 설치를 진행하면서 이미 환경변수들을 설정했었던 JDK나 Maven과 같은 것들을 확인할 수 있습니다. 여기서 openJDK를 위한 다음의 구문을 추가해 줍니다.(Vim 창에서 i를 클릭하여 편집모드로 전환하고 입력을 마친 후 ESC 클릭, 마지막으로 ZZ를 입력하면 수정한 내용을 저장할 수 있습니다.) 다음의 구문을 추가해줍니다. 단, 해당 구문은 반드시 "export PATH=$PATH:$M2_HOME/bin" 이전에 위치해야 합니다.

export JAVA_HOME=/Library/Java/JavaVirtualMachines/amazon-corretto-11.jdk/Contents/Home

위와 같이 입력을 마쳤다면 환경변수 설정이 완료된 것 입니다.

그리고 터미널을 종료 후 다시 실행해서 "java --version" 명령어를 입력해봅니다.

위와 같이 나타난다면 정상적으로 JDK 설치가 완료된 것 입니다.

 

 

2. Tomcat

위와 같이 JDK 설치를 잘 마쳤다면 이제 다음으로 Tomcat을 설치할 차례 입니다.

이번세팅에서는 Tomcat 8.5.57 버전을 선택해서 설치하도록 하겠습니다.

 

Tomcat을 설치하기 위해서는 우선 해당링크로 이동해야 합니다.

(Tomcat 8.5.57 버전을 다운로드할 수 있는 페이지 링크 입니다.)

https://tomcat.apache.org/download-80.cgi

위의 링크로 이동하면 아래와 같은 창이 나타납니다.

해당 페이지에서 Binary Distributions 항목을 찾아보시면 다음과 같이 나옵니다.

tar.gz를 클릭해서 다운로드 합니다.

해당 부분에서 빨간색으로 밑줄 그어진 부분을 클릭해서 다운로드한 후 해당 파일의 압축을 해제해주세요.

이 과정까지 정상적으로 수행되었다면 다운로드 폴더에 다음과 같이 압축 해제된 파일이 생성 되었을 겁니다.

다운로드한 파일의 압축을 해제한 모습(왼쪽)   /    사용할 수 있는 터미널과 iTerm

이제 맥에서 터미널을 실행합니다. iTerm을 사용하시는 분이라면 iTerm을 실행하시면 됩니다.

이제 터미널로 다음의 명령어를 순서대로 입력해줍니다.

여기서 각 명령어의 의미를 다루는 것은 생략하고 넘어가도록 하겠습니다.

입력명령어

sudo mkdir -p /usr/local

sudo mv ~/Downloads/apache-tomcat-8.5.57 /usr/local

sudo ln -s /usr/local/apatch-tomcat-8.5.57 /Library/Tomcat

sudo chown -R <사용자 로그인 ID> /Library/Tomcat

sudo chmod +x /Library/Tomcat/bin/*.sh

터미널 상에서 위의 명령어들을 정상적으로 입력했다면 아래와 같이 진행되었을 것입니다.

(만약 명령어 입력에 잘못된 부분이 있을 경우 오류나 경고창이 나타납니다. 잘못된 부분을 찾아서 수정해주세요.)

위와 같이 정상적으로 진행되었다면 Tomcat에 대한 설치과정이 끝난 것입니다. 이제 다음의 명령어를 입력해서

Tomcat을 실행하거나 중지시킬 수 있습니다.

명령어	내용
sudo /Library/Tomcat/bin/startup.sh	Tomcat 서버를 시작합니다.
sudo /Library/Tomcat/bin/shutdown.sh	Tomcat 서버를 중지합니다.

지금까지 Tomcat이 정상적으로 설치과 진행되었고 위의 명령어를 정확하게 입력하였다면 아래와 같이 나타납니다.

sudo /Library/Tomcat/bin/startup.sh를 입력한 모습, 정상적으로 실행되면 다음과 같이 나타납니다.

sudo /Library/Tomcat/bin/shutdown.sh 를 입력한 모습, 정상적으로 중지되면 다음과 같이 창이 나타납니다.

---

이번에 버전업된 Tomcat을 사용해야하는 수요가 발생해서 기존의 tomcat을 삭제하고 새로운 버전의 tomcat을 설치하는 과정에 대한 내용을 추가하도록 하겠습니다. 우선, 설치를 진행하기 전에 기존에 설치되어있던 Tomcat을 완전히 삭제해줘야 합니다. 이를 위해서는 2개의 경로에 접근해서 tomcat 관련 파일들을 삭제해줘야 합니다.

1. /usr 경로에 있는 Tomcat 디렉터리 삭제
2. /Users/(username)/Library 로 접근하여 Tomcat 디렉터리 삭제

(위의 과정에서 username의 경우 사용중인 PC의 계정명을 입력해주시면 됩니다.) 위의 과정은 터미널을 이용하면 어렵지 않게 수행하실 수 있을 겁니다. 다음으로 해당 사이트로 이동해서 새로운 tomcat 설치파일을 다운로드 합니다.

 

https://tomcat.apache.org/download-90.cgi

Apache Tomcat® - Apache Tomcat 9 Software Downloads

다운로드 방법 및 세팅 방법은 위에서 설명한 방식과 동일하게 진행해주시면 됩니다.

(새로운 버전 설치 후에 STS에도 새로 설치한 Tomcat Server를 다시 등록해줘야 하는 점 잊지 마시길 바랍니다.)

 

Tomcat 서버가 제대로 돌아가는 지 확인하기 위해서는 "sudo /Library/Tomcat/bin/startup.sh"를 통해서 Tomcat 서버를 시작한 후에 웹 브라우져로 이동해서 "localhost:8080" 으로 접속해봐야 합니다.

Tomcat이 제대로 설치되고 동작하는 경우, localhost:8080 화면

위와 같은 창을 확인하였다면 정상적으로 설치가 완료된 것 입니다. 혹시 위의 창이 나타나지 않는 경우 Tomcat 설치과정에서 어떤 과정이 누락되거나 잘못된 것이니 확인해보시기 바랍니다.

 

 

3. Spring Tool Suite4(STS)

 

이제 다음으로 STS를 설치해보도록 하겠습니다. STS를 설치하기 위해서는 다음 링크로 이동해야 합니다.

https://spring.io/tools

Spring Tools 4 is the next generation of Spring tooling

해당 링크로 접속하면 아래와 같은 창이 나타납니다.

위의 링크를 클릭하여 페이지로 이동한 모습

해당페이지의 Spring Tools 4 for Eclipse 항목에서 MACOS 64-BIT을 클릭하여 다운로드 해줍니다.

해당 파일은 용량이 조금 커서 네트워크 환경에 따라서 다운로드를 마치는 데 꽤 긴 시간이 소요될 수도 있습니다.

다운로드가 정상적으로 완료되면 아래와 같이 나타날 겁니다.

이제 해당 파일을 실행해서 설치과정을 진행하면 됩니다.

안내하는 데로 Spring Tool Suite 4 실행파일을 Application 폴더로 드래그하여 이동시켜 줍니다.

그리고 Launch Pad 상에 다음과 같이 아이콘이 나타났다면 정상적으로 설치가 완료된 것입니다.

이제 STS를 실행해봅시다. STS를 실행하면 다음과 같은 창이 나오면서 여러가지 세팅을 진행하게 됩니다.

실행을 하기에 앞서서 STS도 Java 프로그래밍을 하기위한 Eclipse를 실행할 때처럼 WorkSpace를 설정해줘야 합니다.

아래와 같이 원하는 위치에 WorkSpace로 사용할 폴더를 만들어주고 해당폴더를 WorkSpace로 지정합니다.

그 후 설정한 WorkSpace를 기본값으로 사용한다는 체크박스에 체크를 해주고 Launch를 눌러주면 정상적으로

STS가 실행됩니다. STS 설치를 마친 후에는 인코딩 형식에 대한 설정을 해줘야 하는데 이는 STS를 통해서 작업한 내용이

한글과 같은 문자도 제대로 표현할 수 있도록 설정하는 과정입니다.

 

이를 위해서 STS에서 관련 설정으로 접근해야하는 데 접근하는 순서는 다음과 같습니다.

우선 STS를 실행 후 상단바에서 Spring Tool Suite 4를 클릭하면 아래와 같이 관련 옵션이 나오는 데

여기서 Preferences...를 클릭해 줍니다.

Preferences - General - Workspace로 이동해서 Text file encoding 항목을 찾습니다.

그리고 위와 같이 Text file encoding 항목이 UTF-8로 되어 있는 지 확인해줍니다. 이미 Default로 UTF-8이 설정되어

있다면 따로 설정해줄 필요가 없고 만약 UTF-8이 아닌 다른 값으로 설정되어 있다면 Other를 선택한 후 UTF-8을

선택하여 저장한 후 설정을 마치면 됩니다.

 

 

4. Maven3

사실 Maven도 Homebrew를 이용하면 굉장히 쉽고 간편하게 설치할 수 있습니다.

하지만 이번 글에서는 특정 버전을 골라서 설치하는 방향으로 진행하기 위해서 Homebrew를 사용하지 않고

설치파일을 다운로드 해서 Maven을 설치하는 과정을 수행해보도록 하겠습니다.

 

Maven3는 아래의 링크로 이동해서 다운로드 합니다.

http://maven.apache.org/download.cgi

Maven – Download Apache Maven

해당 페이지로 이동하면 다음과 같이 Files 항목에서 Binary tar.gz archive의 Link를 클릭해서 다운로드 해줍니다.

그리고 다운로드한 압축파일의 압축을 해제합니다.

그리고 압축을 해제하여 생성한 apach-maven-3.6.3 폴더를 자신이 원하는 위치로 이동시킵니다.

저같은 경우에는 /Library에 해당 폴더를 이동시켰습니다.

(단순히 이동만 시키면 되기 때문에 터미널로 하시는 게 불편하시면 그냥 드래그앤 드랍으로 이동하셔도 됩니다.)

라이브러리로 압축을 해제한 apache-maven-3.6.3 폴더를 이동시킨 모습

 

이제 Tomcat을 세팅할 때처럼 터미널을 실행해줍니다.

그리고 다음과 같이 명령어를 입력해줍니다.

vim ~/.bash_profile

위의 명령어를 입력하면 vim에디터로 .bash_profile을 열게됩니다.

.bash_profile을 vim 에디터로 연 모습, 아직 코드를 추가하지 않은 상태

그리고 위의 상태에서 아래와 같이 다음 두 줄의 코드를 입력합니다.

export M2_HOME=(자신이 지정한 apache-maven-3.6.3 폴더의 경로)
export PATH=$PATH:$M2_HOME/bin

 

ZZ를 입력하여 해당 내용을 저장해줍니다. 그리고 변경사항을 반영하기 위해서 다음의 명령어를 입력합니다.

source ~/.bash_profile

마지막으로 터미널에 mvn-version을 입력해봅니다. 만약 아래와 같이 나타난다면 정상적으로 세팅이 완료된 것입니다.

다음과 같이 나온다면 정상적으로 설치가 완료된 것입니다.

 

터미널을 새로 실행할 때마다 source ~/.bash_profile을 입력해줘야 하는 문제

 

그런데 여기까지만 세팅을 하게되면 문제가 있습니다. 현재 실행 중인 터미널을 종료하고 다시 실행해서 이전에 입력한

mvn -version을 입력해보면 mvn을 인식하지 못하면서 찾을 수 없는 명령어라는 경고가 나옵니다.

이 경우 다시 source ~/.bash_profile을 입력해주면 다시 정상적으로 mvn을 인식하게 되긴 하지만 매번 터미널을 새로

실행할 때 이 과정을 반복해야하니 상당히 번거로워집니다.

 

그래서 이를 해결하기 위한 방법을 제시합니다.

(zsh 쉘을 사용하는 경우에 해당하는 내용입니다.)

 

터미널을 실행한 후 vim ~/.zshrc를 입력합니다. 그렇게 되면 긴 내용의 파일이 나타날텐데 shift + g 키를 입력해서

파일의 가장 아래부분으로 커서를 내립니다.

그리고 파일의 가장 아래부분에 다음 내용을 추가합니다.

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

해당 내용을 추가한 후에 저장해주면 터미널을 새로 다시 실행하더라도 

source ~/.bash_profile을 입력할 필요없이 바로 mvn을 인식합니다.

 

 

 

이것으로 JSP 개발환경 구축에 대한 글을 마치도록 하겠습니다.

긴 글 읽어주셔서 감사합니다.