gillilo IT Skill Book

Step 0: Requirements
####################

  * JDK 11
  * root (linux/unix) or Administrator (Windows)
  * libc6 (linux)
  * 512MB RAM (launches with -Xmx512M - can use less, can need more, depending on load)

Step 1: Download
#################

  * Download apache-james-3.3.0-app.zip from http://james.apache.org/download.cgi#Apache_James_Server

Step 2: Deploy
##############

  * Unzip apache-james-3.3.0-app.zip.
  * You should have a folder with sub-folders bin, conf, lib, log, var and four text files.

$ unzip apache-james-3.3.0-app.zip
$ cd apache-james-3.3.0-app
$ ls (linux) / dir (windows)
bin
BUILD.txt
conf
lib
LICENSE.txt
log
NOTICE.txt
README.txt
var

Step 3: Understand James Features
#################################

Persistence
- Mailbox is for users' Inbox, Sent Items, Trash... folders - Mailbox persistence is configured in spring-beans.xml (by default jpa, you set the database connection properties in database.properties). We think to move this config out-of spring-beans.xml.
- Mailrepositorystore is for spam, error,... mails, so nothing to do with users visible mails. Available mailstore persistence are defined in mailstore.xml. Each has an URL prefix (file, db, dbfile,...) that can be used in mailetcontainer.xml to define where to store spam,... mails (exemple: file://var/mail/error/).
- Domain persistence is configured in domainlist.xml
- Users persistence is configured in usersrepository.xml
- All database connection use the database.properties in case of database access.

Mailet Container - http://james.apache.org/server/feature-mailetcontainer.html

SMTP Hooks - http://james.apache.org/server/feature-smtp-hooks.html

Step 4: Configure
#################

  * All configuration files are embedded in jars.
  * We ship in the conf folder the configuration files.
  * You can override the default configuration by editing these files

database.properties
META-INF/persistence.xml
dnsservice.xml
domainlist.xml
fetchmail.xml
imapserver.xml
james-listmanager.xml
jmx.properties
lmtpserver.xml
log4j.properties
mailetcontainer.xml
mailbox.xml
mailserver.xml
mailrepositorystore.xml
pop3server.xml
recipientrewritetable.xml
smtpserver.xml
sqlResources.xml
usersrepository.xml
wrapper.xml
lib folder (for your additional jar, e.g. JDBC drviers,...)

James is packaged with virtual hosting enabled, JPA (Derby database) storage for the mails, users, and domains.
On SMTP (see smtpserver.xml config)
  * authRequired is true by default, so you can safely deploy James on the Internet (it won't be an open relay).
  * verifyIdentity is true by default (you can only send mails with a FROM being the authenticated user).

To use another database:
  * Edit the database.properties and change the values according to your database.
  * Add the needed JDBC driver jar in the ./conf/lib folder according to your database.

Step 5: Start
#############

$ cd bin
$ ./james start 
  * !! you need libc6 installed on Linux !! - sudo apt-get install libc6-i386 libc6-dev-i386 on ubuntu
  * You can see log result in the log/wrapper.log file.

Step 6: Create Domains and Users
################################

Time to add domains and users.
We will show how to via the james-cli (client interface).
You also can achieve this via JMX (launch jconsole). JMX has more operations than james-cli.

  * cd bin
  * james-cli -h localhost -p 9999 adddomain mydomain.tld
  * james-cli -h localhost -p 9999 adduser myuser@mydomain.tld mypassword

  * The username to use in your mail client will be myuser@mydomain.tld

Step 7: Test
############

$ telnet 127.0.0.1 25
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
220 172.16.1.131 SMTP Server (JAMES SMTP Server 3.0.0) ready Wed, 20 Jul 2017 17:31:33 +0100 (CET)
ehlo test
250-172.16.1.131 Hello test (aoscommunity.com [127.0.0.1])
250-PIPELINING
250-ENHANCEDSTATUSCODES
250 8BITMIME
mail from:<YOUR_NAME@YOUR_DOMAIN>
250 2.1.0 Sender <YOUR_NAME@YOUR_DOMAIN> OK
rcpt to:<YOUR_NAME@YOUR_DOMAIN>
250 2.1.5 Recipient <YOUR_NAME@YOUR_DOMAIN> OK
data
354 Ok Send data ending with <CRLF>.<CRLF>
subject: test

this is a test
.
250 2.6.0 Message received
quit
Connection closed by foreign host.

Step 8: Manage
##############

8.1. Manage via james-cli

  usage: java org.apache.james.cli.ServerCmd --host <arg> <command>
    -h,--host </arg>   node hostname or ip address
    -p,--port </arg>   remote jmx agent port number
  Available commands:
    adduser </username> </password>
    removeuser </username>
    listusers
    adddomain </domainname>
    removedomain </domainname>
    listdomains

8.2. Manage via JMX

  * Launch jconsole (or any other JMX client) and connect on URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi
  * Select the MBeans tab and open the org.apache.james node to view attributes and execute operations.

Step 9: Monitor
###############

  * Monitor the ./log/wrapper.log log file.

  * Monitor via JMX (launch any JMX client and connect to URL=service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi)

  * Check ./var folder usage
  
    mail
    +-error
    +-address-error
    +-relay-denied
    +-spam

    store
    +-derby
    +-jackrabbit
    +-activemq
      +-brokers
        +-james
      +-blob-transfer
        +-outgoing
        +-spool

  * Check /tmp folder usage

$ docker search httpd

웹에서 찾기

https://hub.docker.com/search?type=image 

$ docker pull httpd

httpd 이미지 풀 (다운로드)

$ docker images

pull한 이미지들 확인

$ docker run httpd

httpd 이미지 container생성 후 실행

$ docker run -name asdf httpd

httpd 이미지 asdf 이름으로 생성 후 실행

6. $ docker stop asdf

asdf 이름 container 정지

$ docker start asdf

asdf 이름 container 실행

$ docker ps

실행 중 container들 확인

$ docker logs -f asdf

asdf 이름 container log출력 (-f : 로그 계속해서 출력하는 옵션)

$ docker rm --force asdf

asdf 이름 container 제거 (--force : 컨테이너가 실행중일때 강제로 삭제하는 옵션)

$ docker rmi httpd

httpd 이미지 제거

$ docker run -name asdf -p 9999:80 httpd

-p : [docker 포트 포워딩]호스트(서버) 포트(9999)를 이미지 컨테이너의 포트(80)에 연결(할당)

$ docker exec asdf pwd

asdf container의 pwd명령어 실행(pwd)

$ docker exec -it asdf /bin/sh (/bin/bash)

asdf container의 쉘 프롬프트 실행, 연결 유지 (연결 해제 시 exit 입력)

$ docker run -name asdf -p 9999:80 -v ~/htmls:/usr/local/apaches/htdocs httpd

-v : 호스트의 디렉토리와 컨테이너의 디렉토리 동기화

$ docker run -it -name asdf ubuntu bash

-it ~ bash : asdf container를 생성하고 실행 직후 명령 프롬프트까지 실행

$ docker commit asdf asdf-repo:asdf-v1

asdf container를 asdf-v1 테그로 asdf-repo 저장소에 이미지를 생성 [이것을 Layer 라고 함]

$ docker run -it -name asdf-v2 asdf-repo:asdf-v1 bash

asdf-repo 저장소의 asdf-v1 이미지로 asdf-v2 container를 생성 후 실행, 프롬프트 실행

$ docker commit asdf-v2 asdf-repo:asdf-v2

asdf-v2 container를 asdf-v2 테그로 asdf-repo 저장소에 이미지를 생성 [확장 Layer 를 계속 생성 할 수 있다.]

From ubuntu (Image)
Run apt update && upt install -y git

$ docker build -t asdf-repo:asdf-v3 /Dockerfile경로

$ docker login

Docker hub에 로그인

$ docker push docker/mobytheewhale/my-first-repo:tagname

로그인 한 계정의 저장소에 이미지를 업로드

1. 이전 버전 제거 

$ sudo apt-get remove docker docker-engine docker.io containerd runc

2. apt 패키지 인덱스를 업데이트하고 apt가 HTTPS를 통해 리포지토리를 사용할 수 있도록 패키지를 설치합니다.

$ sudo apt-get update

$ sudo apt-get install \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

3. Docker의 공식 GPG 키 추가:

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

4. 다음 명령어를 사용하여 안정적인 저장소를 설정합니다. 

nightly 또는 테스트 리포지토리를 추가하려면 아래 명령에서 단어 뒤에 nightlyor test(또는 둘 다)를 추가합니다.

$ 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" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

5. apt패키지 인덱스를 업데이트하고 최신 버전 의 Docker Engine을 설치합니다.

$ sudo apt-get update

$ sudo apt-get install docker-ce docker-ce-cli containerd.io

6. hello-world 이미지 를 실행하여 Docker 엔진이 올바르게 설치되었는지 확인하십시오 .

$ sudo docker run hello-world

이 명령은 테스트 이미지를 다운로드하고 컨테이너에서 실행합니다. 컨테이너가 실행되면 메시지를 인쇄하고 종료합니다.

1. Docker 엔진, CLI 및 Containerd 패키지를 제거합니다.

$ sudo apt-get purge docker-ce docker-ce-cli containerd.io

2. 호스트의 이미지, 컨테이너, 볼륨 또는 사용자 지정 구성 파일은 자동으로 제거되지 않습니다. 모든 이미지, 컨테이너 및 볼륨을 삭제하려면:

$ sudo rm -rf /var/lib/docker
$ sudo rm -rf /var/lib/containerd

1. 루트가 아닌 사용자로 Docker 관리

docker 그룹을 추가하고 현재 유저를 그룹에 포함시킵니다. 그 후 docker 그룹의 구성원을 확인합니다.

$ sudo groupadd docker

$ sudo usermod -aG docker $USER

$ sudo cat /etc/group | grep docker

로그아웃했다가 다시 로그인하여 그룹 구성원 자격을 재평가하십시오.

$ docker run hello-world

가상 머신에서 테스트하는 경우 변경 사항을 적용하려면 가상 머신을 다시 시작해야 할 수 있습니다. X Windows와 같은 데스크톱 Linux 환경에서는 세션에서 완전히 로그아웃한 다음 다시 로그인합니다. Linux에서는 다음 명령을 실행하여 그룹에 대한 변경 사항을 활성화할 수도 있습니다.

$ newgrp docker

2. 부팅 시 시작하도록 Docker 구성

대부분의 최신 Linux 배포판(RHEL, CentOS, Fedora, Debian, Ubuntu 16.04 이상) systemd은 시스템 부팅 시 시작되는 서비스를 관리하는 데 사용합니다. Debian 및 Ubuntu에서 Docker 서비스는 기본적으로 부팅 시 시작되도록 구성됩니다. 다른 배포판의 부팅 시 Docker 및 Containerd를 자동으로 시작하려면 아래 명령을 사용하십시오.

$ sudo systemctl enable docker.service
$ sudo systemctl enable containerd.service

이 동작을 비활성화하려면 disable을 사용하십시오.

$ sudo systemctl disable docker.service
$ sudo systemctl disable containerd.service

We no longer support global installation of Create React App.

Please remove any global installs with one of the following commands:
- yarn global remove create-react-app

The latest instructions for creating a new app can be found here:
https://create-react-app.dev/docs/getting-started/