Jboss Enterprise Application Server(EAP)6.0에서 Java EE 6 Full Profile and Context Dependency Injection (CDI) 구동되어 집니다.

본서비스의 Jboss EAP 6.0 Cartridge는 Java EE6 Full Profile에서 실행 되며, Paas환경에서 개발자가 활용할 수 있는 기술의 주요 특징은 다음과 같습니다.

• 웹 어플리케이션 프로그래밍 기술을 위한 Java Servlets, Java Server Page (JSP), Java Server Faces (JSF)를 포함한 웹 및 모바일 콘텐츠를 제공
• MySQL 같은 데이터베이스에 데이터 지속성과 같은 Java Persistence (JPA)
• Web Service 및 Mobile HTML5 Site 와 외부 시스템과의 통신을 위한 REST-ful Services(JAX-RS)와 Java API
• Enterprise JavaBeans (EJB 3.1), Java Message Service (JMS), Java 트랜잭션 API (JTA)
• 클러스터링 및 고 가용성

PaaS서비스에 접속하여 사용하는 방법은 몇 가지가 있습니다.

1. 1) WEB UI : 사이트 내 로그인 통하여 제공되는 많은 기능을 웹 콘솔 UI에서 사용할 수 있습니다.
2. 2) RHC client tools : 서비스를 이용하기 위해서는 몇 가지 Tool를 다운로드 하여야 합니다.이에 대한 방법은 사이트 내에 메뉴얼과 시작하기 화면에 설명되어 있습니다.
3. 3) Eclipse Plugin : Jboss Tools Site에 설치 관련 Plugin하는 방법이 설명되어 있습니다.
4. 4) Java Client API : GitHub에서 Java Client을 찾을 수 있습니다.
5. 5) REST API : REST API 문서 본 사이트의 자료실에서 찾을 수 있습니다.

사이트에 로그인 한 후에 My Account(나의 계정)을 클릭하면 설정된 namespace가 표시 될 것 입니다. 아래의 변경 아이콘을 눌려 namespace을 변경 할 수도 있습니다. 또한, 서버로의 접근을 위해서 client(개발PC)을 등록하기 위한 SSH Key을 추가/변경/갱신 할 수 있습니다.

• namespace을 변경하려면
  > rhc domain update {oldNameSpace} {newNameSpace} 을 실행 합니다.
• SSH Key 을 추가 하려면
  > rhc sshkey add {name} {path to SSH key file} 을 실행 합니다.여기서, {name}은 사용자가 지정한 영숫자 식별자 입니다.합니다.

PaaS서비스에서는 개발언어, 프레임워크, DMBS , 개발Tool 등을 아래와 같이 제공 됩니다.

또한, 개발자가 직접 본 사이트 내에서 개발환경을 설정할 수 있으며, 본 사이트에서 지원하지 않는 개발언어나 프레임워크, 개발 Tool, DBMS 등을 개발자가 직접 DIY(Do It Yourself) 기능을 활용하여 구현 및 적용 할 수 있습니다.

Application program 은 제공된 5개의 Gear 내에서 자유롭게 구성 배포 할 수 있으며, 추가적인 Gear의 제한, Memory 또는 Disk 자원의 할당이 필요 할 경우에는 클라우드지원센타와의 협의가 필요 합니다.
SSH을 사용하여 Gear에 로그인 하여 현재 사용하고 있는 자원의 할당량 & Disk 공간 등을 확인 할 수 있습니다.

• > quota -s
• > du -sh ~

기타 monitor 한계와 자원을 확인 할 수 있는 명령어

• > lsof -n -P
• > top -b -n 1
• > free
• > ss
• vmstat
• Optionally: iostat && mpstat
• ulimit -a

응용 프로그램은 local SQLite 데이터베이스에 연결하거나 포트 $ OPENPAAS_MYSQL_DB_PORT에서 MySQL에 TCP / IP로 연결 할 수 있습니다. 또한 제공 되어지는 Local SQLite 데이터베이스에 응용 프로그램을 연결하는 방법에 대한 자세한 내용은 기술지원사의 사이트인 https://www.openshift.com/kb/kb-e1002/deploying-openshift-express-applications-using-sqlite를 참조하십시오.

또한, 제공되는 DBMS는 MySQL은 5.1, PostgreSQL을 8.4과 MongoDB를 2.2을 지원합니다.

• 제공되는 DBMS 등의 cartridge을 확인 하려면,
• > rhc cartridge list 을 실행하십시오.
• Application program 내에 cartridge을 추가 하려면,
• > > rhc cartridge add {Cartridge_ID} -a {App_Name} 을 실행하여 추가 할 수 있습니다.

DBMS 연결 매개 변수를 환경 변수로 하여 Application program Gear에 저장됩니다. Gear에 로그온 하여 접근 할 수 있습니다

• > env | grep OPENSHIFT_MYSQL   #for MySQL
• OPENSHIFT_MYSQL_DB_HOST=
• OPENSHIFT_MYSQL_DB_PASSWORD=
• OPENSHIFT_MYSQL_DB_USERNAME=
• OPENSHIFT_MYSQL_DB_URL=
• OPENSHIFT_MYSQL_DB_PORT=

• > env | grep OPENSHIFT_POSTGRESQL
• OPENSHIFT_POSTGRESQL_DB_HOST=
• OPENSHIFT_POSTGRESQL_DB_PASSWORD=
• OPENSHIFT_POSTGRESQL_DB_USERNAME=
• OPENSHIFT_POSTGRESQL_DB_URL=
• OPENSHIFT_POSTGRESQL_DB_PORT=

• > env | grep OPENSHIFT_NOSQL_DB   #for MongoDB
• OPENSHIFT_MONGO_DB_USERNAME=
• OPENSHIFT_MONGO_DB_URL=
• OPENSHIFT_MONGO_DB_PASSWORD=
• OPENSHIFT_MONGO_DB_PORT=
• OPENSHIFT_MONGO_DB_HOST=

DBMS와 application program의 연결을 하기 위해 환경변수로 구성하여 사용하는 것이 매우 편리합니다.향후 IP 변경 등의 사유로 인하여 application program 과 DBMS의 migration 또는 Update 할 때 이를 통하여 편리하게 구성할 수 있습니다.

임베디드 DBMS는 Application의 Gear에 외부 IP 주소에 바인딩 되지 않습니다. 따라서, 오직 해당 Gear에만 Application이 DBMS에 접속 할 수 있습니다.

1. 1) Gear에 로그인한 후에 "mysql"을 실행 합니다.
      " > env | grep MYSQL" 을 실행하면 MYSQL의 환경변수를 확인할 수 있습니다.
2. 2) mysql DB에 접근하는 모든 tool을 사용하고 rhc port-forward 을 실행 합니다.
3. 3) Application program 에 phpMyAdmin-5.3 cartridge 을 추가 합니다.
4. 4) MongoDB을 위하여 웹관리 콘솔에서 rockmongo-1.1 을 포함 시킬 수 있습니다.
      " > rhc cartridge add rockmongo-1.1 -a {appName}" 을 실행 하십시오.

MySQL로 Application program과 연결하는 방법과 다른 점에 유의하시기 바랍니다

SSL을 통해 Application program에 접근 할 때, application URL을 사용하면 잘 작동합니다.
하지만 사용자가 새롭게 정의한 별도의 Domain을 사용하기 시작하는 순간, Error code "ssl_error_bad _cert_domain" 와 함께 " Untrusted Connection" 경고가 표시됩니다.

그 이유는 기본 SSL 인증서는 *.cloudsc.kr, cloudsc.kr 과 같은 이름에 대해서만 유효하기 때문입니다.
향후에는, 사용자 정의 Domain에 대하여 SNI 기반으로 SSL을 지원합니다.

오류가 있는 application program의 log을 검토하는 가장 좋은 방법은 외부의 client system(RHC client tool이설치된 곳)에서 "rhc tail {APPNAME}" 을 실행하면, 여기에서 현재 application program의 log 항목을 제공합니다.

전체 Log을 얻으려면 본 FAQ문서의 내용을 확인하여 language framework/cartridge 가 설치되어 있는 Gear에 접근( > rhc app ssh -a {appName} )하여 more ~/{cartridgeID}/logs/*.log 의 실행 합니다.여기서 {cartridgeID}은 nodejs-0.6 같은 framework cartridge 또는 MySQL-5.1 같은 임베디드 cartridge log 처럼 framework cartridge Logs 입니다.

기본적으로 PostgreSQL DB 서버의 매개변수를 비활성화 할 수 있으며 다른 값으로 설정합니다.
예를 들어 max_prepared_transactions는 XA 트랜잭션을 사용하지 않도록 0 으로 설정됩니다.

이러한 매개변수를 설정하는 한가지 방법은 DB가 할당된 Gear 의 /postgresql-8.4/data/postgresql.conf 디렉토리에 있는 postgresql.conf를 SSH을 통하여 파일을 편집하는 것입니다.

postgresql.conf 을 변경 하였다면 PostgreSQL 을 재 시작 하여야 합니다.
아래의 방법으로 재시작 할 수 있습니다

• DB gear 내에서 SSH 로 "pg_ctl restart -D $PWD//postgresql-8.4/data -m fast " 또는 "ctl_all restart" 실행
• RHC command line Tools을 사용하여 "rhc cartridge restart postgresql -a {appName}" 실행

귀하의 application program에 서비스를 요청을 할 때 "Service Temporarily Unavailable. The server is temporarily unable to service your request due to maintenance downtime or capacity problems. Please try again later."" 오류가 나타날 수 있습니다

이 Error는 Gear로 서비스를 요청할 때 global Apache instance 로 부터 보내어 집니다.
이것은 일반적으로 application program이 응답하지 않는 것을 의미합니다. 근본 원인이 무엇인지 로그를 확인할 수 있습니다. 때에 따라서는 단순하게 " rhc app restart -a blog" 을 실행 하여 restart을 함으로 서 도움이 될 수 있습니다.
그러나 근본적인 원인을 찾기 위해서는 Log Data를 확인하는 것을 추천 합니다.
단순하게 restart 하는 것이 도움이 되지 않는다면, "rhc app force-stop -a blog" 와 "rhc app start -a blog" 실행 하십시요.

귀하의 application program에 서비스를 요청을 할 때 Gateway Time-out. The server didn't respond in time." 또는 "Bad Gateway..."오류가 나타날 수 있습니다.

이 Error는 Gear로 서비스를 요청할 때 global Apache instance 로 부터 보내어 집니다.
이것은 일반적으로 실행중인 트랜잭션의 응답 시간이 초과되었다는 것을 의미합니다.
이 time out 설정은 현재 4 분 설정되어 있지만, 서비스 응답시간을 조정/변경 할 수 있습니다.
Paas의 multi-tenant 환경에서는 Apache의 Route을 통하여 많은 Application program 간에 load balance 에 의하여 30분 내에 응답하는 application과 4분 이내에 응답하는 application 간에 균형을 맞출 수 있습니다.

MySQL은 2를 기본 값으로 설정합니다.

• interactive_timeout은 = 2880
• WAIT_TIMEOUT은 = 28800

8시간 이상의 지속적인 DB 연결은 시간 제약을 받게 되며, 이 값은 수정 할 수 없습니다.

하나의 Gear에서 다른 Gear로 Port forwarding 을 하는 방법은 몇 가지가 있습니다.

1. 1) 여러 application 이 같은 DBMS에 접근
2. 2) Gear 간의 통신

gear에 대한 사용자의 SSH접근 권한을 부여 받은 방법은 몇 가지 있습니다.
특정한 경우에는 Client Gear가 사용자의 $UUID 입니다.

1. 1) ssh-keygen을 사용하여 ssh Key Set를 생성 할 수 있습니다.
       > ssh-keygen -f $OPENPAAS_DATA_DIR/mykey
       그러면, 사용자 계정의 mykey.pub에 추가 할 수 있습니다.
2. 2) SCP는 사용자의 Host에 존재하는 Keys 값을 가져올 수 있습니다.
       > scp /path-to-keys/mykey $UUID@sample-sudheendra.cloudsc.kr:~/app-root/data/.

여기에서, -i flag 를 사용하여 SSH port forward 명령을 실행할 수 있습니다.
  > ssh -i $OPENPAAS_DATA_DIR/mykey ...

PaaS서비스는 application gear에 로깅 뿐만 아니라 gear에 Code 을 pushing 하기 위해 SSH key 를 사용합니다.
Key을 설정하지 않았다면 다음과 같이 수행 하십시오
이제는 각각의 SSH 서버가 고유의 호스트 fingerprint을 가지고 있으며, 어떻게 SSH 인증 작업이 구체적으로 이루어지는지 보겠습니다.
SSH client가 SSH server에 연결되면 서버에서 fingerprint을 가져 옵니다.
client는 선택적으로 내부 DB 서버의 fingerprint을 확인하거나 fingerprint 사용자 확인 메시지가 표시 될 수 있습니다.
fingerprint의 presentation은 client가 올바른 server의 통신을 보장합니다.
일반적으로, SSH는 처음 연결할 때 원격 RSA 키 지문을 표시하고 .ssh/known_hosts 파일 및 후속 로그인 시도에 의해 fingerprint을 제시 할 때 저장됩니다.

여기서 node의 fingerprint는 : ex-std-node1.prod.cloudsc.kr

Fingerprint : 2048 cf:ee:77:cb:0e:fc:02:d7:72:7e:ae:80:c0:90:88:a7 ex-std-node1.prod.rhcloud.com (RSA)

Public Key :

ssh-rsa

AAAAB3NzaC1yc2EAAAABIwAAAQEAwUPkUQ84FKIWhOxy5RBBuR9gbrov2epARmFmaxD7NFRayobnDvl8G
aBTbH1kxaZ/tYQeIqVE1assL74KArMQBzz6rj0FEWf0zrXxAY55EGswmWEEdqlYu1LbIxDCG6opqkiq6ocxjea9K3
XYq+2aYoAvI3sshSImTYZP1glFhrh3QUsNJHOfDboTLJFNSdLjzXubRMa4eEx7s9pe9kwBOaLNIiVeGzUWg5+K
aykSg2UMB3aG127t8kX+OhDYceVR42ehQJ0MjQGlGoNtldxGrlX8NjxUqvJAo6pqNqRK8Cps7/x/m0GPXWAgSZ
ymhurXmj1o2LP5nKLtVzMPvwMb0w==

만약 원격 서버에서 잘 알려진 좋은 SSH key fingerprint을 찾으려 하지 않을 경우, "ssh-keyscan"과 "ssh-keygen" 명령어를 사용합니다.

공개 Key 다운노드 "ssh-keyscan myapp-mydomain.cloudsc.kr > /tmp/key"
fingerprint 생성 "ssh-keygen -l -f /tmp/key"