2.8.4 Installing MySQL Using a Standard Source Distribution

2.8.4 Installing MySQL Using a Standard Source Distribution

표준 소스 배포본에서 MySQL을 설치하려면 다음을 수행합니다:

1. 시스템이 Section 2.8.2, “Source Installation Prerequisites”에 나열된 도구 요구 사항을 충족하는지 확인합니다.

2. Section 2.1.3, “How to Get MySQL”의 지침에 따라 배포 파일을 구합니다.

3. 이 섹션의 지침에 따라 배포본을 구성(configure), 빌드(build), 설치(install)합니다.

4. Section 2.9, “Postinstallation Setup and Testing”의 지침에 따라 설치 후(postinstallation) 절차를 수행합니다.

MySQL은 모든 플랫폼에서 빌드 프레임워크로 CMake를 사용합니다. 여기 제시된 지침으로 동작하는 설치를 만들 수 있습니다. CMake를 사용하여 MySQL을 빌드하는 추가 정보는
How to Build MySQL Server with CMake를 참조하십시오.

소스 RPM에서 시작하는 경우, 설치 가능한 바이너리 RPM을 만들기 위해 다음 명령을 사용하십시오. rpmbuild가 없는 경우에는 rpm을 대신 사용하십시오.

1$> rpmbuild --rebuild --clean MySQL-VERSION.src.rpm

이 결과로 하나 이상의 바이너리 RPM 패키지가 생성되며, 이는 Section 2.5.4, “Installing MySQL on Linux Using RPM Packages from Oracle”에 설명된 대로 설치합니다.

압축된 tar 파일 또는 Zip 아카이브 소스 배포본에서 설치하는 순서는 범용 바이너리 배포본에서 설치하는 과정과 비슷합니다(Section 2.2, “Installing MySQL on Unix/Linux Using Generic Binaries” 참조). 차이점은 모든 플랫폼에서 사용되며 배포본을 구성하고 컴파일하는 단계가 포함된다는 것입니다. 예를 들어 Unix에서 압축된 tar 파일 소스 배포본을 사용하는 경우, 기본적인 설치 명령 시퀀스는 다음과 같습니다:

1# Preconfiguration setup
2$> groupadd mysql
3$> useradd -r -g mysql -s /bin/false mysql
4# Beginning of source-build specific instructions
5$> tar zxvf mysql-VERSION.tar.gz
6$> cd mysql-VERSION
7$> mkdir bld
8$> cd bld
9$> cmake ..
10$> make
11$> make install
12# End of source-build specific instructions
13# Postinstallation setup
14$> cd /usr/local/mysql
15$> mkdir mysql-files
16$> chown mysql:mysql mysql-files
17$> chmod 750 mysql-files
18$> bin/mysqld --initialize --user=mysql
19$> bin/mysqld_safe --user=mysql &
20# Next command is optional
21$> cp support-files/mysql.server /etc/init.d/mysql.server

소스 빌드에 특화된 지침의 좀 더 상세한 버전은 다음에 나옵니다.

참고

여기에 표시된 절차는 MySQL 계정에 대한 패스워드를 설정하지 않습니다. 절차를 따른 후에는 설치 후 설정 및 테스트를 위해 Section 2.9, “Postinstallation Setup and Testing”으로 진행하십시오.

• Perform Preconfiguration Setup

• Obtain and Unpack the Distribution

• Configure the Distribution

• Build the Distribution

• Install the Distribution

• Perform Postinstallation Setup

Perform Preconfiguration Setup

Unix에서 데이터베이스 디렉터리의 소유자이며 MySQL 서버를 실행하고 구동할 때 사용해야 하는 mysql 사용자와, 이 사용자가 속할 그룹을 설정합니다. 자세한 내용은
Create a mysql User and Group를 참조하십시오. 그런 다음, 별도 언급된 경우를 제외하고 mysql 사용자로서 다음 단계를 수행하십시오.

Obtain and Unpack the Distribution

배포본을 압축 해제(unpack)할 디렉터리를 선택하고 그 디렉터리로 이동합니다.

Section 2.1.3, “How to Get MySQL”의 지침에 따라 배포 파일을 구합니다.

배포본을 현재 디렉터리에 압축 해제합니다:

• 압축된 tar 파일을 압축 해제하려면,
  tar가 z 옵션을 지원하는 경우 이를 사용하여 배포본을 압축 해제하고 풀어낼 수 있습니다:

1$> tar zxvf mysql-VERSION.tar.gz

tar에 z 옵션이 없다면,
gunzip으로 배포본을 압축 해제하고
tar로 풀어냅니다:

1$> gunzip < mysql-VERSION.tar.gz | tar xvf -

또는, CMake가 배포본을 압축 해제하고 풀어낼 수 있습니다:

1$> cmake -E tar zxvf mysql-VERSION.tar.gz

• Zip 아카이브를 압축 해제하려면, WinZip 또는 .zip 파일을 읽을 수 있는 다른 도구를 사용합니다.

배포 파일을 압축 해제하면 mysql-VERSION이라는 디렉터리가 생성됩니다.

Configure the Distribution

압축 해제된 배포본의 최상위 디렉터리로 이동합니다:

1$> cd mysql-VERSION

소스 트리를 깨끗하게 유지하기 위해 소스 트리 밖에서 빌드합니다. 최상위 소스 디렉터리가 현재 작업 디렉터리 아래의 mysql-src라면, 동일한 수준에 build라는 디렉터리를 만들어 그곳에서 빌드할 수 있습니다. 디렉터리를 만들고 그곳으로 이동합니다:

1$> mkdir bld
2$> cd bld

빌드 디렉터리를 구성합니다. 최소 구성 명령에는 구성 기본값을 재정의하는 옵션이 포함되지 않습니다:

1$> cmake ../mysql-src

빌드 디렉터리는 반드시 소스 트리 밖에 있을 필요는 없습니다. 예를 들어, 최상위 소스 트리 아래에 build라는 디렉터리를 만들어 그 안에서 빌드할 수 있습니다. 이를 위해 mysql-src를 현재 작업 디렉터리로 두고, build 디렉터리를 만든 후 그곳으로 이동합니다:

1$> mkdir build
2$> cd build

빌드 디렉터리를 구성합니다. 최소 구성 명령에는 구성 기본값을 재정의하는 옵션이 포함되지 않습니다:

1$> cmake ..

동일한 수준에 여러 개의 소스 트리가 있는 경우(예를 들어, 여러 버전의 MySQL을 빌드하려는 경우), 두 번째 전략이 유리할 수 있습니다. 첫 번째 전략은 모든 빌드 디렉터리를 동일한 수준에 두므로 각 디렉터리에 대해 고유한 이름을 선택해야 합니다. 두 번째 전략에서는 각 소스 트리 내에서 빌드 디렉터리에 동일한 이름을 사용할 수 있습니다. 이후의 지침은 두 번째 전략을 가정합니다.

Windows에서는 개발 환경을 지정합니다. 예를 들어, 다음 명령은 각각 32-bit와 64-bit 빌드에 대해 MySQL을 구성합니다:

1$> cmake .. -G "Visual Studio 12 2013"
2
3$> cmake .. -G "Visual Studio 12 2013 Win64"

macOS에서 Xcode IDE를 사용하려면:

1$> cmake .. -G Xcode

Cmake를 실행할 때, 명령줄에 옵션을 추가할 수도 있습니다. 다음은 몇 가지 예입니다:

• -DBUILD_CONFIG=mysql_release:
  Oracle이 공식 MySQL 릴리스용 바이너리 배포본을 생성할 때 사용하는 것과 동일한 빌드 옵션으로 소스를 구성합니다.

• -DCMAKE_INSTALL_PREFIX=dir_name:
  특정 위치에 설치하도록 배포본을 구성합니다.

• -DCPACK_MONOLITHIC_INSTALL=1:
  make package가 여러 개가 아닌 단일 설치 파일을 생성하도록 합니다.

• -DWITH_DEBUG=1: 디버깅 지원을 포함하여 배포본을 빌드합니다.

더 많은 옵션 목록은
Section 2.8.7, “MySQL Source-Configuration Options”를 참조하십시오.

구성 옵션을 나열하려면 다음 명령 중 하나를 사용합니다:

1$> cmake .. -L   # overview
2
3$> cmake .. -LH  # overview with help text
4
5$> cmake .. -LAH # all params with help text
6
7$> ccmake ..     # interactive display

CMake가 실패하는 경우, 다른 옵션으로 다시 실행하여 재구성(reconfigure)해야 할 수도 있습니다. 재구성하는 경우 다음 사항에 유의하십시오:

• CMake는 이전에 실행된 적이 있으면, 이전 호출 중에 수집된 정보를 사용할 수 있습니다. 이 정보는 CMakeCache.txt에 저장됩니다. CMake는 시작 시 이 파일이 존재하면 그 내용을 읽으며, 이 정보가 여전히 유효하다고 가정합니다. 재구성할 때는 이 가정이 유효하지 않습니다.

• CMake를 실행할 때마다 다시 컴파일하기 위해 make를 다시 실행해야 합니다. 그러나 이전 빌드에서 생성된 오래된 오브젝트 파일이 다른 구성 옵션으로 컴파일되었으므로, 먼저 이를 제거하고 싶을 수 있습니다.

오래된 오브젝트 파일이나 구성 정보가 사용되지 않도록 하려면, CMake를 다시 실행하기 전에 Unix에서 빌드 디렉터리에서 다음 명령을 실행합니다:

1$> make clean
2$> rm CMakeCache.txt

또는 Windows에서는:

1$> devenv MySQL.sln /clean
2$> del CMakeCache.txt

MySQL Community Slack에 질문하기 전에, 실패에 대한 유용한 정보가 있는지 CMakeFiles 디렉터리의 파일을 확인하십시오. 버그 리포트를 작성하려면
Section 1.6, “How to Report Bugs or Problems”의 지침을 사용하십시오.

Build the Distribution

Unix에서:

1$> make
2$> make VERBOSE=1

두 번째 명령은 각 소스가 컴파일될 때의 명령을 보여주기 위해 VERBOSE를 설정합니다.

GNU make를 사용하고 그것이 gmake로 설치된 시스템에서는 대신 gmake를 사용하십시오.

Windows에서:

1$> devenv MySQL.sln /build RelWithDebInfo

컴파일 단계까지 진행했지만 배포본이 빌드되지 않는 경우, 도움말은
Section 2.8.8, “Dealing with Problems Compiling MySQL”을 참조하십시오. 그것으로 문제가 해결되지 않으면, Section 1.6, “How to Report Bugs or Problems”에 제시된 지침을 사용하여 버그 데이터베이스에 문제를 등록하십시오.
필요한 도구의 최신 버전을 설치했고, 그 도구가 우리의 구성 파일을 처리하는 동안 크래시하는 경우도 보고해 주십시오. 그러나 필요한 도구에 대해 command not found 오류 또는 이와 유사한 문제가 발생하는 경우는 보고하지 마십시오. 대신, 필요한 모든 도구가 설치되어 있는지, 그리고 셸이 이를 찾을 수 있도록 PATH 변수가 올바르게 설정되어 있는지 확인하십시오.

Install the Distribution

Unix에서:

1$> make install

이 명령은 설정된 설치 디렉터리(기본값은 /usr/local/mysql) 아래에 파일을 설치합니다. root로 명령을 실행해야 할 수도 있습니다.

특정 디렉터리에 설치하려면, 명령줄에 DESTDIR 매개변수를 추가합니다:

1$> make install DESTDIR="/opt/mysql"

또는, 원하는 위치에 설치할 수 있는 설치 패키지 파일을 생성합니다:

1$> make package

이 작업은 범용 바이너리 배포 패키지처럼 설치할 수 있는 하나 이상의 .tar.gz 파일을 생성합니다.
Section 2.2, “Installing MySQL on Unix/Linux Using Generic Binaries”를 참조하십시오. CMake를 -DCPACK_MONOLITHIC_INSTALL=1 옵션과 함께 실행하면 이 작업은 단일 파일을 생성합니다. 그렇지 않으면 여러 파일을 생성합니다.

Windows에서는 데이터 디렉터리를 생성한 다음, .zip 아카이브 설치 패키지를 만듭니다:

1$> devenv MySQL.sln /build RelWithDebInfo /project initial_database
2$> devenv MySQL.sln /build RelWithDebInfo /project package

생성된 .zip 아카이브는 원하는 곳에 설치할 수 있습니다.
Section 2.3.3, “Configuration: Manually”를 참조하십시오.

Perform Postinstallation Setup

설치 과정의 나머지 부분은 구성 파일을 설정하고, 코어 데이터베이스를 생성하며, MySQL 서버를 시작하는 단계로 이루어집니다. 지침은
Section 2.9, “Postinstallation Setup and Testing”를 참조하십시오.

참고

MySQL 권한(grant) 테이블에 나열된 계정은 처음에는 패스워드가 설정되어 있지 않습니다. 서버를 시작한 후에는
Section 2.9, “Postinstallation Setup and Testing”의 지침을 사용하여 이 계정들에 대한 패스워드를 설정해야 합니다.