Escolar Documentos
Profissional Documentos
Cultura Documentos
5
6
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
30
32
33
34
36
37
38
39
40
41
44
45
46
47
51
53
54
55
56
59
60
61
62
63
64
65
67
68
70
71
72
73
77
80
82
83
84
86
87
89
91
92
93
94
95
96
97
99
100
102
103
104
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
134
138
139
140
141
142
143
145
146
148
149
151
152
152
153
154
155
157
158
159
160
162
163
164
165
166
167
168
169
170
171
172
174
175
176
177
178
179
180
181
182
183
183
184
185
186
187
187
189
190
191
192
194
195
196
197
198
200
201
202
204
205
206
207
208
209
210
211
212
213
214
217
219
220
221
222
222
223
223
224
225
227
228
229
231
232
233
234
235
236
237
238
239
240
241
242
243
245
248
249
250
252
253
255
256
257
Este%captulo%ensina%a%base%de%uso%do%painel%no%servio%de%hospedagem%da%Integrator.
Antes de Comear
Antes%de%iniciar%a%jornada%em%conhecer%os%pontos%chaves%de%seu%servio,%atravs%deste%
manual,%queremos%que%entenda%alguns%pontos%tcnicos,%simples%que%no%esto%sobre%seu%
controle%por%no%serem%exclusivamente%seus.
1.
A% porta% 80% do% servidor% da% Integrator% % compartilhada% entre% todos% os% usurios.%
Nossos%servidores%Java%executam%em%portas%exclusivamente%lanadas%pelo%nosso%sistema%
e%roteadas%pelo%painel.
2.
No%altere%a%porta%do%seu%servidor%Java,%por%exemplo%para%8080,%ou%qualquer%outra%
que%considere%importante.%Se%o%Jizer,%seu%servidor%ser%paralisado%sem%aviso%prvio.
3.
O%Banco%de%dados,%at%o%plano%Java%EE/PHP,%incluindo%promocionais%de%similares%
caractersticas,%no%so%servidores%exclusivos,%ou%seja,%voc%no%%o%administrador%geral%
do%servio%de%banco%de%dados%como%um%todo.%Isso%signiJica%que%NO%%possvel%alterar%a%
porta,%mudar%o%encoding%default%do%PostgreSQL,%acessar%remotamente%o%PostgreSQL,%dar%
permisses%administrativas%para%o%seu%usurio%de%forma%que%ele%crie%banco%de%dados%por%
script,% alm% de% entre% outras% modiJicaes% que% exigem% serem% feitas% diretamente% pelo%
administrador%geral.%Se%esta%for%a%sua%necessidade,%considere%mudar%de%plano%para%um%
que%permita%tais%condies%ou%adicionar%um%servidor%de%banco%de%dados%dedicado.
4.
Voc%tem%o%direito%de%alterar%o%que%precisar%em%seu%servidor%Java.%Mas%nunca%altere%
a%memria%\%alm%do%j%considerado%no%item%2.%Isso%far%seu%servidor%cair%ou%at%mesmo%
ser%suspensa%sua%conta.
5.% Jamais%realize%envios%massivos,%ou%SPAM.
6.
ConJiguraes%tcnicas%que%no%fazemos%cujo,%em%princpio,%precisa%saber:%
Uso%de%keep\alive%connection,%
Timeout%acima%de%5%minutos,%
Execuo%de%conexes%persistentes%inJinitas,%
SVN%via%protocolo%http,%
Mais%de%um%repositrio%SVN%por%domnio,%
Mltiplos%usurios%GIT%em%um%mesmo%terminal%SSH%para%a%mesma%conta,%
Acesso%SHELL%para%usurios%de%plano%#1,%
PostgreSQL%em%muitos%planos%no%possuem%acesso%externo%pelo%pgAdmin,%
Uso%de%CPU%intenso%acima%de%5%,%
Memria%alm%do%plano%contratado%sem%custo,%
Alteraes% personalizadas% no% seu% servidor% Java% para% suas% necessidades% e% que%
Implicam%em%falhas%de%segurana%em%nossos%servios,%
Adicionar%outros%servios%Java%alm%do%servidor%Java
Subir%outro%servidor%Java%em%paralelo
Subir%outro%domain%do%GlassFish
Privilgios%em%banco%de%dados%ou%outros%que%exigem%super%usurio
Os% pontos% acima% so% dvidas% comuns% respondidas% sobre% a% hospedagem% que% escolheu.%
Caso% necessite% de% um% ou% mais% itens% expostos% nos% tpicos% como% sendo% indisponvel% no%
plano% que% escolheu,% nos% comunique% seu% desejo% enviando% um% email% para%
suporte@integrator.com.br,%que%lhe%direcionamos%para%um%plano%adequado.%%
Chamamos%de%suporte%especializado%os%seguintes%proJissionais%que%atendem%aos%
chamados%de%hospedagem:
Administradores%de%Painis%\%Administram%painis%e%analisam%erros%pertencentes%
a%eles
Administradores%Linux%\%Administram%os%servios%do%sistema%operacional
Administradores%de%servidor%Java%\%Administram%servios%de%servidores%Java
Cada%administrador%tem%um%papel%e%faz%parte%de%uma%equipe.%Estes%administradores%so%
acionados%dependendo%o%chamado%para%analisar:
1.%Erros%apresentados%nos%painis%de%controle
2.%Erros%apresentados%em%servios%executando%no%Linux
3.%Erros%apresentados%ao%subir%um%servidor%Java
O%suporte%especializado%da%Integrator%ajuda%parcialmente%em%%resolver%casos%como:
1.%Erro%de%envio%de%email%pelos%nossos%servios
2.%Acesso%por%porta%de%servidor%Tomcat
3.%Problema%ocasionado%de%permisso%em%banco%de%dados
4.%Anlise%de%falhas%de%segurana%de%aplicativo%para%resoluo%mais%rpida
10
O%suporte%especializado%da%Integrator%negar%ajuda%em%%resolver%casos%como:
1.%Erro%apresentado%pelo%aplicativo%PHP
2.%Erro%apresentado%pelo%aplicativo%Java
3.%Falha%parcial%de%aplicativo
4.%Correo%de%cdigo%para%funcionamento%em%servios
5.%Dicas%para%contornar%problemas%programticos
6.%Ensino%de%servidores%Java
7.%Ensino/ajuda%em%uso%de%programas%externos%para%qualquer%servio
8.%Leitura%de%Logs%de%servidores%Java%para%ajuda%com%erros%de%aplicativo%de%usurio
9.%Ensino%de%banco%de%dados%
10.%Ajuda%com%questes%cujo%o%plano%que%atua%no%fornece%permisses
11
Os%programadores%especialistas%no%so%acessveis%no%suporte%de%primeiro%nvel%padro%
em%todos%os%servios%de%hospedagem,%onde%consideramos%apenas%administradores.
O% suporte% de% programadores% % contratado% separadamente% ou% adicionado% em% plano%
especJico%contratado.%
Para% informaes% se% o% seu% plano% possui% tal% suporte% sem% custo,% consulte% o%
suporte@integrator.com.br.
12
Assim% que% liberada% sua% conta,% pginas% PHP% 5.x% e% HTML% funcionam.% O% acesso% ao% seu%
servidor% para% levar% arquivos% est% basicamente% restrito% ao% usurio% do% FTP% do% seu%
domnio.%
O%servidor%da%Integrator%no%opera%com%caches,%ou%seja,%no%temos%em%nossas%mquinas%
Varnish,%%Memcached%e%nem%outro%cacheador%de%servidor.
Nada%do%que%existe%padronizado%pode%ser%alterado,%isso%inclui%adicionar%novas%extenses%
PHP%que%estejam%fora%do%j%existente%servio%fornecido.
Situaes*que*no*prestamos*suporte:
Problemas%referentes%a%formatao%de%pginas%HTML%e%CSS
Correo%de%verses%antigas%de%pginas%feitas%em%cdigo%PHP%defasado
Falhas%de%segurana%advindas%de%sites%antigos%e%sem%manuteno
Ensino%de%linguagem%PHP%ou%de%formatao%HTML/CSS
O%Apache%no%%somente%seu,%portanto%no%poder%personaliz\lo
Site%e%conJiguraes%de%domnio%sempre%pelo%painel%cPanel/WHM
Personalizaes% de% .htaccess% para% resolver% questes% de% sites% desenvolvidos% por%
terceiros.
13
A%Integrator%Host%sempre%opera%com%o%PHP%na%ltima%verso%mais%estvel%e%compatvel%
com%99%%dos%aplicativos%opensource%existentes%no%mercado.
No%h%como%personalizarmos%verses%para%usurios%de%hospedagem%compartilhada.
14
A%Integrator%Host%utiliza%em%sua%hospedagem%compartilhada%as%seguintes%conJiguraes%
de%memria%e%upload%de%arquivos%para%o%uso%de%PHP:
Mximo*de*Memria*RAM*disponvel*por*processo:%128MB%de%RAM
Tamanho*Mximo*para*Upload*de*arquivos:%25MB%de%tamanho%mximo
15
Existe%um%padro%inicial%do%local%onde%Jicam%os%arquivos%PHP%ou%HTML:
1)%Diretrio%public_html
2)%Atalho(Link%Simblico)%em%www%(o%mesmo%que%public_html)
16
Existe%um%padro%para%pgina%inicial%no%local%onde%Jicam%os%arquivos%PHP%ou%HTML:
PHP:%index.php
HTML:%index.htm%ou%index.html
17
Seguindo%o%padro,%suba%suas%pginas%PHP/HTML,%dentro%do%diretrio%public_html,%
contendo%um%index.php,%ndex.html%ou%ndex.htm.%Evidentemente,%s%haver%um%
index,%sendo%os%demais%nomes%suas%pginas%como%criadas.
Uma%estrutura%simples,%ao%ser%colocada%em%public_html,%de%pginas%HTML%seria:
public_html/
*
****index.html
****pagina1.html
****pagina2.html
18
A%Integrator%Host%permite%o%uso%mximo%de%5%%de%CPU%em%20%minutos%de%tempo%
mximo.%
Caso%o%usurio%comece%a%ter%problemas%de%processamento%enviaremos%um%alerta.%Na%
insistncia%do%processamento,%o%usurio%ter%um%informativo%explicando%sobre%o%melhor%
plano%para%o%caso.
A%Integrator%no%abre%excees%quanto%ao%uso%de%processamento%em%qualquer%plano%de%
hospedagem%compartilhada%que%houver.
Caso%a%sua%necessidade%seja%de%processar%arquivos%com%alto%ndice%de%processamento%
por%severos%minutos,%entre%em%contato%com%suporte@integrator.com.br%para%lhe%
oferecermos%um%plano%mais%adequado%ao%seu%caso.
19
Para%%visualizar%o%site%em%PHP%ou%HTML%ainda%sem%o%domnio,%utilize%o%IP%com%o%nome%de%
usurio,%do%servidor,%assim:
http://IP_DO_EMAIL_CONFIGURACOES/~usuarioTftp
Por%exemplo,%digamos%que%o%IP%do%servidor%onde%est%hospedado,%informado%no%e\mail%
de% ConViguraes* e* Instrues* de* Uso% seja% 174.142.48.58% e% seu% usurio% FTP% seja%
integrator.%Voc%acessa%seu%site%PHP%ou%HTML%da%seguinte%forma:
http://174.142.48.58/~integrator/
IMPORTANTE:% O% IP% informado% no% e\mail% de% ConViguraes* e* Instrues* de* Uso% no%
lhe% pertence.% Se% contratar% um% IP% dedicado% (veja% o% valor% de% um% IP% dedicado% mandando%
um%e\mail%ao%suporte@integrator.com.br),%ai%sim,%o%IP%acessado%ser%seu.
20
Na%hospedagem%temos%trs%painis%de%controle:%WHM,%cPanel%e%NGasi.
O% WHM% % o% painel% de% controle% geral,% de% revenda.% Ele% permite% a% voc% adicionar,%
remover,% acrescentar% ou% retirar% recursos% de% domnios.% % neste% painel% que% voc%
controla%espao,%banda%de%uso,%paralisa%um%cliente.
O%cPanel%%o%painel%que%o%cliente%acessa.%Ele%%onde%esto%os%recursos%do%domnio%
como:%email,%bancos%de%dados,%DNSs%se%voc%permitir,%usurios%e%senhas%do%FTP%
entre%outros.
O%NGasi%%o%painel%Java,%onde%o%cliente%pode%escolher%o%servidor%que%vai%instalar,%
iniciar,%parar%e%ler%os%logs%de%sada%do%terminal.
IMPORTANTE:* Nem% toda% hospedagem% possui% os% trs% painis% de% controle.% Caso% tenha%
dvidas% sobre% o% plano% que% escolheu,% ou% deseja% mudar% de% plano,% envie% sua% questo% ao%
email%suporte@integrator.com.br%para%maiores%detalhes%ou%ajuda.%
21
Cada%painel%de%controle%possui%uma%porta%especJica.%Estas%portas%precisam%ser%liberadas%
em%seu%Firewall%Caso%precise%acessar.
WHM%\%Utiliza%a%porta%padro%2087
CPanel%\%Utiliza%a%porta%padro%2083
NGasi%\%Utiliza%a%porta%padro%8663*ou*8666
22
Os%painis%WHM/cPanel%e%NGasi%so%todos%direcionados%a%usar%um%SSL%autoassinado.%
Um%certiJicado%SSL%precisa%ser%atribudo%a%um%domnio,%sempre.%O%painel%%acessado%por%
IP%e,%como%no%tem%um%domnio%vinculado%e%nem%SSL%reconhecido%por%ele%atribudo,%ver%
uma%mensagem%de%alerta,%como%este%que%aparece%no%browser%Google%Chrome:
No*se*preocupe.*Basta%prosseguir%e%adicionar%excees%no%browser,%quando%houver.%O%
SSL% est% ativo,% mesmo% no% estando% em% um% domnio,% para% criptografar% os% dados%
transmitidos%de%usurio%e%senha%do%seu%browser,%colocados%para%entrar%no%painel,%para%
serem% recebidos% pelo% servidor.% Mesmo% no% sendo% reconhecido% pelo% painel,% os% dados,%
ainda%assim,%so%criptografados.
IMPORTANTE:*Se%alterar%sua%senha,%no%temos%como%saber.%O%que%poderemos%fazer,%caso%
isto% ocorra,% % alterar% a% senha% para% aquela% que% lhe% enviamos% com% seu% e\mail% de*
ConViguraes*e*Instrues*de*Uso.
Portas*de*cada*painel*de*controle
Portas*de*cada*painel*de*controle
23
O%WHM%%o%painel%de%controle%geral,%de%revenda.%Ele%permite%a%voc%adicionar,%remover,%
acrescentar% ou% retirar% recursos% de% domnios.% % neste% painel% que% voc% controla% espao,%
banda%de%uso,%paralisa%um%cliente.
24
Para%acessar%o%painel%de%controle%WHM,%inicialmente,%utilize%o%endereo%apresentado%em%
seu%e\mail%de%ConViguraes*e*Instrues*de*Uso,%que%sempre%ter%o%seguinte%formato:
O%padro%mais%simples:
http://IP/whm%
Pela%porta%diretamente:
%http://IP:2087/
Pelo domnio que utiliza na Integrator (precisa apontar para a Integrator):
%http://seusite.com.br:2087/
IMPORTANTE:*Temos%o%IP%que%deve%ser%substitudo%pelo%informado%no%email%supra%
citado%ou%o%seusite.com.br,%caso%aponte%para%a%Integrator,%como%seu%domnio.
25
Caso% o% seu% plano% suporte% revenda% de% sites,% % a% criao% de% domnios% de% revenda% exigem%
dois%passos%simples:%
1)%Criar%um%pacote%ou%utilizar%um%pacote%criado%existente
2)%Adicionar%o%acesso%cPanel%criando%o%cadastro%do%domnio%no%painel
26
1)%V%em%Packages* *Add*a*Package/Pacotes*Adicionar*um*pacote.
2)%D%um%nome%para%o%seu%pacote%(Nome%do%estilo)%:
3)%Selecione%os%recursos%do%pacote.%Os%recursos%principais%so:
Cota*(MB)%%tamanho%em%MB%do%espao%usado%em%disco;
Largura*de*banda*(MB)%%este%local%pode%ser%colocado%um%nmero%grande,%pois%
a%banda%no%tem%limites;
Max*Contas*FTP%%Quantidade%de%contas%FTP%que%o%domnio%ter%permisso%para%
criar.
Max* Contas* de* eTmail% % Quantidade% de% e\mails% que% o% cliente% poder% criar% no%
painel%cPanel.
Max*Bancos*de*Dados%%Quantidade%de%bancos%de%dados%que%ser%permitido%ao%
cliente%criar%no%painel%cPanel.
Max*Subdomnios%%Nmero%mximo%de%subdomnios%permitidos%ao%cliente%
criar%no%painel%cPanel;
Max*Domnios*Estacionados%%Nmero%mximo%de%domnios%estacionados%que%
o%cliente%ser%permitido%criar;
Max*Domnios*Suplementares%%Nmero%mximo%de%domnios%adicionais%que%o%
cliente%ser%permitido%criar%no%cPanel%(isto%dividir%o%espao%dele%com%todos%os%
domnios%que%ele%criar).
ETmail*horria*mxima*pelo*domnio*de*Retransmisso%%Nmero%mximo%de%
e\mails%que%podem%ser%enviados%por%hora.%Este%valor%no%pode%superar%250%
emails%por%domnio,%uma%vez%que%a%nossa%restrio%global%impede%acima%disto.%%
Coloque%valores%baixos%se%desconJiar%que%seu%usurio%realizar%spam.
Percentual*mximo*de*mensagens*que*falharam*ou*diferida*um*domnio*
pode*enviar*por*hora%%Porcentagem%dos%emails%enviados%que%retornam%com%
erro.%Ao%dar%uma%porcentagem,%o%usurio%poder%ser%bloqueado%aps%tantos%%%do%
enviado%ser%retornado%por%falha%no%envio.%Esta%falha%vai%desde%email%inexistente,%
at%recusa%por%empresas%cujo%o%email%que%foi%enviado%no%%solicitado%ou%est%
sendo%considerado%spam.%Deixe%sempre%uma%porcentagem%de%falhas%para%que%o%
27
usurio%seja%bloqueado%caso%ele%falhe%muito,%evitando%problemas%de%spam%e%
nosso%bloqueio%da%conta%que%possui%por%ter%usurio%realizando%spam.
4)% Voc% poder% permitir% que% o% cliente% tenha% acesso% ao% SHELL*,% podendo% executar%
comandos%via%SSH,%assim%como%determinar%a%lngua%do%painel%cPanel.
5)%Para%conJirmar%a%criao%do%pacote,%clique%em%Adicionar.
28
IMPORTANTE:*O%acesso%Shell,%mesmo%ativo%por%voc,%no%%liberado%automaticamente.%
Lembre\se%que%o%SSH%%um%recurso%de%segurana%extrema%e%a%grande%maioria%dos%
usurios%no%necessitam%deste%recurso.%Liber\lo%poder%causar%problemas%a%sua%
revenda%caso%este%cliente%que%liberou%cause%transtornos%ao%servidor%da%Integrator.%
Pedimos%cautela%no%pedido%de%liberao%de%acesso%shell.%Ns%precisamos%dar%a%ltima%
autorizao.%Envie%o%pedido%para%suporte@integrator.com.br.%
29
1)%Ainda%no%WHM,%v%em%Account*Functions* *Create*New*Account/Funes*Conta*
Criar*uma*nova*conta.
2)%Preencha%o%formulrio%com%os%dados%do%domnio%que%vai%liberar%(Informaes%de%
Domnio):
30
6)%Selecione%o%primeiro%item%para%as%conJiguraes%de%email%(Correio%conJiguraes%de%
roteamento):
7)%ConJirme%a%criao%do%domnio%no%boto%Create/Criar.
31
Para%listar%e%acessar%o%cPanel,%atravs%de%sua%revenda,%no%WHM,%v%em%Account*
Information* *List*Accounts/Informaes*da*Conta*Contas*Lista:
32
33
3) No campo "Nameserver 1" alterar os nomes dos NS1 e NS2 para o desejado (o correto
34
IMPORTANTE:*Seu%domnio%deve%conter%seus%DNS%prprios%criados%no%registro.br,%por%
exemplo,%antes%de%usar%em%outros%domnios%de%sua%revenda.%Os%DNS%prprio%exigem%
respectivamente%os%IPs.%Caso%no%saiba%quais%so%seus%IPs%de%revenda,%pea%ao%
suporte@integrator.com.br.
35
O%cPanel%%o%painel%que%o%cliente%acessa.%Ele%%onde%esto%os%recursos%do%domnio%como:%
email,%bancos%de%dados,%DNSs%se%voc%permitir,%usurios%e%senhas%do%FTP%entre%outros.
36
Para%acessar%o%painel%de%controle%cPanel%use%o%endereo%apresentado%em%seu%e\mail%de%
ConJiguraes%e%Instrues%de%Uso,%ao%qual%possui%duas%formas%principais:
Pelo IP e nome do painel:
http://IP/cpanel%%
Pelo%IP%e%Porta:
https://IP:2083/
Pelo domnio que utiliza na Integrator (precisa apontar para a Integrator):
%http://seusite.com.br:2083/
IMPORTANTE:*Temos%o%IP%que%deve%ser%substitudo%pelo%informado%no%email%supra%
citado%ou%o%seusite.com.br,%caso%aponte%para%a%Integrator,%como%seu%domnio.
37
Para%diretrios%e%arquivos,%seja%para%uso%ou%envio%de%upload,%precisam%estar%com%estas%
regras%sempre:
Diretrios%\%755
Arquivos%\%644
Executveis%\%777%(procure%evit\los)
IMPORTANTE:*Os%executveis%so%para%arquivos%shell%em%geral.
38
Existem%alguns%aplicativos%PHP%muito%populares,%como%o%WordPress,%Joomla,%%Drupal,%
Moodle,%Magento%e%outros,%cujo%automatizamos%sua%instalao%dentro%do%cPanel.%
A% viso% que% teremos% agora% % de% como% usar% o% Softaculous% para% instalar% aplicativos% pr\
deJinidos.%
Como% exemplo,% iremos% usar% o% WordPress.% Mas% a% sequncia% serve% para% qualquer% outro%
aplicativo%disponvel%no%painel.
39
%fundamental%o%usurio%compreender%que%hospedamos%aplicativos%e%no%os%ensinamos.%
Os%softwares,%uma%vez%instalados%pelo%Softaculous,%no%tem%nossa%assistncia%de%ensino%
de%utilizao.%
IMPORTANTE:%O%suporte%para%erros%que%seu%aplicativo%apresentar%durante%a%utilizao%
devem%ser%buscadas%no%site%de%seus%idealizadores.% %O%Softaculous%apenas%automatiza%a%
instalao.% A% utilizao% e% manuteno% do% Site% so% exigncias% que% o% usurio% deve% ter%
sobre%seus%aplicativos,%Jicando%a%Integrator%isenta%de%quaisquer%problemas%decorrentes%
do%uso.%
40
1)%Em%Softaculous*Apps*Installer%clique%em%WordPress%no%item%Script:
2)%Assim%que%apresentar%a%janela%do%Softaculous,%clique%em%Instalar:
3)%Na%instalao,%voc%preenche%o%formulrio%primeiro.%Perceba%que%o%painel%lhe%orienta%
como% funciona% a% instalao% em% cada% passo,% inclusive% como% ser% visvel% o% software%
instalado%em%seu%site/domnio:
4) Voc pode alterar o prefixo das tabelas que sero geradas em Database Settings. O padro
o que o painel mantm em seu formulrio j preenchido cujo, se no for de sua necessidade,
mantenha como est.
41
5)%Conclua%a%instalao%assim%que%preencher%o%formulrio%clicando%em%Instalar*%ao%Jinal%
do%formulrio.
6)%O%Softaculous%apresentar%onde%est%o%seu%blog%conJigurado%e%tambm%o%caminho%do%
administrador%na%concluso%da%instalao.
42
43
1)%Retorne%ao%Softaculous%e%clique%em%Todas&as&Instalaes.%
2)%Clique%em%Remover%(o%X)%caso%tenha%um%instalado.
3)% Uma% mensagem% surgir% informando% o% que% ser% removido.% Mantenha% todos% os% itens%
checados% na% parte% superior% para% uma% remoo% completa.% ConJirme% em% Remover*
Instalao.
44
1)%Caso%queira%instalar%em%um%subdomnio,*selecione\o%na%instalao%do%WordPress%em%
Selecione*Dominio.
2)% Deixe% vazio,% o% campo% Directrio.* % Os% demais% campos% voc% preenche% normalmente%
como%ensinado%em%Instalando%o%WordPress%em%sua%conta%.
45
Existem%alguns%aplicativos%PHP%muito%populares,%como%o%WordPress,%Joomla%e%outros,%
cujo%automatizamos%sua%instalao%dentro%do%cPanel.%
A%viso%que%teremos%agora%%de%como%usar%o%Fantastico%De%Luxe%para%instalar%aplicativos%
pr\deJinidos.%
Como% exemplo,% iremos% usar% o% WordPress.% Mas% a% sequncia% serve% para% qualquer%
aplicativo%como:%Joomla,%Drupal,%phpBB%e%outros.
46
1)%Em%Software/Servios%clique%em%Fantastico*De*Luxe:
2)%Assim%que%apresentar%a%janela%do%Fantstico,%clique%em%WordPress%e%depois%em%Nova*
instalao:
47
3)% Na% instalao,% voc% preenche% o% formulrio% e% conJirma% por% Jim% em% Instalar*
WordPress:
4)%No%segundo%passo%ser%informado%o%nome%do%banco%de%dados%que%ser%criado%em%sua%
conta% e% onde% voc% determinou% a% criao% do% seu% WordPress.% ConJirme% em% Terminar*
instalao:
48
5)% Ao% Jinalizar% a% instalao,% voc% ver% as% instrues% de% acesso.% Poder% tambm% enviar%
estas%informaes%ao%seu%e\mail:
49
50
1)%Retorne%ao%Fantastico*De*Luxe%e%clique%em%Wordpress.%Clique%em%Remova%caso%tenha%
um%instalado.
2)%Aparecer%a%conJirmao.%ConJirme%no%boto%Remova*WordPress.
3)%Uma%terceira%mensagem%surgir%informando%que%foram%removidos%as%conJiguraes.
51
52
1)% Caso% queira% instalar% em% um% subdomnio,% crie\o% primeiro% em% Domnios* *
Subdomnios.
1.1)%Por%exemplo,%vamos%criar%um%subdomnio%chamado%blog:
2)%Ao%iniciar%a%instalao%do%WordPress,%no%Fantstico,%selecione%o%subdomnio:
2.2)% No% preencha% nada% em% Instalar* na* directoria.% Os% demais% campos% voc% preenche%
normalmente%como%ensinado%em%Instalando%o%WordPress%em%sua%conta%.
53
Caso% ao% tentar% instalar% um% aplicativo% no% Fantastico% De% Luxe,% ocorrer% o% seguinte% erro% \%
onde%USUARIO%%o%seu%usurio:
Access denied for user USUARIO@localhost' (using password: YES)
V% em% Preferncias% % Alterar% Senha,% recoloque% a% senha% do% cPanel,% antiga% e% nova% e%
marque%a%opo%Synchronize MySQL password.%%
ConJirmando% no% Altere% sua% senha% agora!,% volte% ao% Fantastico% De% Luxe% e% tente% instalar%
novamente.
54
Caso% o% cliente% no% possua% nenhuma% experincia% em% um% programa% de% FTP,%
recomendamos%baixar%o%cliente%FTP%FileZilla%no%seguinte%endereo:
http://Jilezilla\project.org/download.php?type=client
Baixe%a%verso%correspondente%ao%seu%sistema%operacional%instalado%em%sua%mquina.
55
Usando o FileZilla
Assim%que%instalar%o%FileZilla,%v%no%menu%Arquivo* *Gerenciador*de*Sites.
Ao%aparecer%a%caixa%de%dilogo%Gerenciador*de*Sites,%clique%no%boto%Novo*Site.
Na%aba%Geral,%preencha:
Host%%coloque%o%seu%domnio;
Protocolo%%coloque%o%protocolo%FTP;
Tipo*de*logon%%selecione%Normal;
Usurio% % digite% o% usurio% do% seu% FTP% indicado% no% email% de% ConJiguraes% e%
Instrues%de%Uso;
Senha%%digite%a%senha%do%usurio%de%FTP%indicado%no%email%de%ConJiguraes%e%
Instrues%de%Uso;
Aps%conJigurar%o%Gerenciador*de*Sites,%preenchendo%os%dados%do%seu%domnio,%clique%
no%boto%Conectar.
56
O% programa% de% FTP% abrir% os% diretrios% locais% e% do% seu% site% remoto,% onde% hospeda%
conosco,%para%que%possa%subir%seus%arquivos.
Arraste% os% arquivos/diretrios% do% lado% da% sua% mquina% para% o% diretrio% que% deseja% no%
lado%do%seu%site%(servidor).
57
58
Se%voc%no%%revenda,%no%tem%o%WHM,%mas%quer%adicionar%domnios%e%no%se%importa%
de%compartilhar%o%mesmo%painel%de%controle,%%possvel%com%o%cPanel.%Mas%atento%aos%
detalhes:
1)%No%h%um%usurio%diferente%para%o%novo%domnio
2)%O%domnio%novo%tem%usurio%FTP%com%nome%por%extenso%como:%usuario@site.com.br
3)%No%h%como%liberar%parcialmente%uma%rea%do%cPanel%para%um%usurio,%isso%inclui%e\
mails
4)%O%Webmail%no%tem%o%nome%personalizado%do%domnio:%webmail.siteadicional.com.br
59
60
61
Subdomnios%so%partes%de%um%domnio%com%incio%prprio%e%localizao,%contedo,%
independente.%Um%subdomnio%%algo%como:
app.seusite.com.br
62
Adicionando um Subdomnio
subdomnio
63
Ver%tpico%Criando%novos%domnios%como%revenda%de%sites%%do%manual.
64
1)%No%cPanel,%v%em%Correio* *Contas*de*ETmail:
2)%No%assistente,%crie%a%conta%de%e\mail:
3)% As% contas% de% e\mail% criadas% aparecem% abaixo,% onde% voc% pode% alterar% a% senha% ou%
excluir:
65
66
As%contas%de%e\mail%criadas%aparecem%abaixo,%onde%voc%pode%alterar%a%senha%ou%excluir:
67
3) Em "Adicionar um Novo Remetente", digite o endereo do email que voc possui em sua
conta no cPanel, no campo "Endereo para Encaminhamento".
Em "Destino * Encaminhar para o endereo de e-mail", voc define para onde o email
ser encaminhado, quando o endereo para encaminhamento receber.
4) Confirme tudo em "Adicionar Remetente".
68
69
Acesso ao E-mail
Na%Integrator%voc%pode%acessar%suas%contas%de%email%de%duas%formas:
1)%Pelo%Webmail
2)%Por%seu%programa%favorito%em%seu%PC/Mac
70
Existem%trs%formas%de%acessar%o%Webmail:
1)%Na%conta%criada,%via%cPanel,%voc%pode%ir%em%Aes* **More** Acessar*Webmail:
2)%No%cPanel,%em%Correio* *Webmail:
3)%Para%acessar%diretamente%pelo%seu%navegador,%entre%pelo%endereo%apresentado%em%
seu%e\mail%de%ConViguraes*e*Instrues*de*Uso,%ao%qual%possui%o%seguinte%formato:
Pelo%IP:
http://IP/webmail
Pelo%seu%domnio%(site):
http://seusite.com.br/webmail
Onde seusite.com.br o nome do seu site.
IMPORTANTE:*Para%logar%no%Webmail,%digite%o%e\mail%completo%e%a%senha.%O%email%deve%
ter%sido%criado%antes%no%cPanel.
71
Para%acessar%sua%conta%de%email%pelo%seu%programa%de%PC%ou%Mac,%seja%os%clientes%Mail,%
Outlook,%Thunderbird,%temos%as%seguintes%conJiguraes%padro:
Host:%mail.SEUDOMINIO.com.br
Usurio:*seuemail@SEUDOMINIO.com.br
Senha:%do%seu%Email
SMTP:
Porta: 587
POP3:
Porta: 110
72
73
74
75
76
3.
4.
5.
77
78
79
2) Cadastre a conta:
80
81
A%Integrator%%contra%o%envio%de%e\mails%em%massa.%Por%padro,%qualquer%%domnio%pode%
enviar%de%100%emails%%at%250%emails%por%hora.%Caso%haja%a%necessidade%de%enviar%mais%e\
mails,%de%forma%legtima,%sem%ser%envios%em%massa,%entre%em%contato%com%o%
suporte@integrator.com.br,%pedindo%o%aumento%de%envios%de%e\mail%por%hora,%com%a%
justiJicativa%para%tal.
IMPORTANTE:%O%uso%imprudente%de%envios%de%email,%caracterizando%envios%em%massa,%
causar%a%suspenso%automtica%do%servio%de%hospedagem%do%domnio%sem%devoluo%
do%valor%pago,%onde%consideraremos%o%ato%como%quebra%de%contrato.
82
Atualmente%o%nmero%de%spams%que%recebemos%%muito%grande.%Podemos%fazer%um%
bloqueio%dos%e\mails%considerados%Spam%de%diversas%formas.%O%padro%da%Integrator%%
apresentado%de%duas%formas:
1.%Temos%conJigurado%no%servidor%geral%para%rejeitar%emails%em%blacklists%conhecidas
2.%No%cPanel%contamos%com%o%SpamAssassin%e%o%BoxTrapper%para%barrar%os%e\mails%
massivos
83
Indo%em%Correio**Autenticao*de*ETmail:%
Neste%local%encontramos%o%DomainKeys.%A%explicao%de%como%funciona%est%no%prprio%
painel:
Temos%tambm%o%SPF:
IMPORTANTE:%O%SPF%pode%ter%excees%que%podem%ser%adicionadas%neste%mesmo%local,%
84
dependendo%muito%de%como%a%empresa%que%lhe%envia%e\mails%trabalha.%Entretanto,%no%
s% o% seu% conhecimento% a% respeito% % necessrio,% como% tambm% saber% como% est%
conJigurado%o%servidor%no%qual%deseja%adicionar%as%conJiguraes%de%SPF.%Seja%como%for,%
so% instrues% a% respeito,% sempre,% da% empresa/domnio% no% qual% est% lhe% enviando% e\
mails% e,% por% questes% de% conJiguraes% diferentes% do% padro% no% SPF,% voc% no% est%
recebendo.%A%empresa%no%qual%lhe%envia%e\mails%precisa%se%informar%onde%hospeda%das%
regras% de% SPF% que% esto% usando% para% que% possa% adicionar% nas% ConViguraes*
Avanadas.%
85
O Spam Assassin
O% Spam* Assassin% % um% sistema% de% Jiltragem% automatizado% de% e\mails,% cujo% sua%
caracterstica% % identiJicar% mensagens% consideradas% spam% baseados% no% contedo% dos%
cabealhos%e%no%corpo/texto%do%e\mail.%Mais%detalhes%so%explicados%no%prprio%painel,%
no%local%onde%acessamos%o%Spam%Assassin%para%ativ\lo.
Para%ativar,%v%em%Correio***Spam*Assassin:
86
O BoxTrapper
O%servio%BoxTrapper**(Correio* *BoxTrapper)%protege%sua%caixa%de%entrada%de%
spams,%exigindo%que%todos%os%remetentes%de%e\mail%de%sua%lista%respondam%a%uma%
mensagem%de%veriJicao,%antes%que%voc%receba%seus%e\mails.
Manage.
87
2) Clique em Ativar
IMPORTANTE:%Os%usurios%precisam%Jicar%sempre%analisando%a%lista%que%existe%no%
BoxTrapper,%de%forma%a%certiJicar\se%de%que%os%e\mails,%legtimos,%que%desejam%receber,%
no%Jiquem%parados%indevidamente.
*Explicaes-extradas-do-prprio-cPanel
88
89
90
Para%visualizar%logs%de%estatsticas,%atualizados%diariamente,%v%em%Logs** *Webalizer.
Voc%ver%os%sites%e%subdomnios%existentes%no%seu%cPanel.%Clique%na%lupa%do%domnio/
subdomnio%que%deseja%para%visualizar%as%estatsticas:
91
Caso%algo%do%seu%site%no%exista%ou%ocorra%um%erro%gerado%por%um%determinado%servio,%
um%nmero%e%mensagem%aparecer%no%navegador,%contendo%a%informao%mostrada%em%
pginas%padronizadas%pelo%painel,%%que%podem%ser%conJiguradas%em%Avanada** *
Pginas*com*erro,%para%o%usurio.%
As%pginas%j%conJiguradas%esto%em%Editar*Cdigos*de*Erros*Comuns.%Depois%clique%
no%erro%e%edite%a%mensagem.
Caso%necessite%de%personalizar%um%erro,%em%especJico,%clique%em%Mostrar*Todos*os*
Cdigos*de*Status*de*Erro*HTTP.%Depois%clique%no%erro%e%edite%a%mensagem.
92
O%acesso%ao%seu%servidor%java%est%restrito%ao%usurio%do%FTP%do%seu%domnio.%Portanto%
uma%alterao%far%perder%o%acesso%ao%servidor%Java%ou%ter%de%reinstalar%e%reconJigurar%
tudo%que%j%o%fez.%
Regras%bsicas%de%uso%do%servio%Java:
1)% Jamais% altere% a% memria% de% seu% plano% sem% nossa% expressa% autorizao% \% custos% de%
mudana%so%informados%caso%nos%pea%para%alterar
2)%Jamais%altere%as%portas%do%servidor%Java%sem%nossa%expressa%autorizao
3)% Jamais% tente% subir% outro% servio% Java% fora% do% servidor% Java% sem% nossa% expressa%
autorizao
IMPORTANTE:*As%regras%bsicas%citadas,%no%plano%que%escolheu,%devem%ser%seguidas%a%
risca.%Qualquer%alterao%destas%regras%por%sua%conta%colocar%seu%servio%em%risco%de%
ser%paralisado%sem%aviso%prvio.
93
A%Integrator%Host%respeita%totalmente%seu%plano%de%hospedagem%e,%como%tal,%a%memria%
contratada%no%plano%escolhido.%A%memria%RAM%%dedicada%a%mquina%virtual%Java%que%
vai%executar%o%servidor%Java.%Ela%no%est%destinada%a%execuo%de%aplicativos%Java%fora%
do%servidor%Java.
Qualquer%tentativa%do%cliente%de%executar%algo%fora%do%padro%da%memria,%assim%como%
tentar% adulterar% a% memria% contratada% do% plano,% para% mais,% seu% plano% poder% ser%
cancelado%imediatamente,%%sem%devoluo%do%valor%pago.
A%Integrator%Host%tambm%ir%paralisar%qualquer%servio%Java%fora%do%servidor%Java%sem%
aviso%prvio,%alm%de%no%se%responsabilizar%por%eventuais%prejuzos%causados%por%conta%
desta%situao.
Caso% o% usurio% tenha% dvidas% sobre% nossas% polticas% no% plano% contratado,% consulte% o%
nosso%contrato%informado%em%endereo%no%email%de%ConJiguraes%e%Instrues%de%Uso%
recebido%ao%liberar%seu%cadastro%ou,%nosso%suporte%pelo%email:
suporte@integrator.com.br.%
94
A%Integrator%Host%permite%o%uso%mximo%de%5%%de%CPU%em%20%minutos%de%tempo%
mximo.%
Caso%o%usurio%comece%a%ter%problemas%de%processamento%enviaremos%um%alerta.%Na%
insistncia%do%processamento,%o%usurio%ter%um%informativo%explicando%sobre%o%melhor%
plano%para%o%caso.
A%Integrator%no%abre%excees%quanto%ao%uso%de%processamento%em%qualquer%plano%de%
hospedagem%compartilhada%que%houver.
Caso%a%sua%necessidade%seja%de%processar%arquivos%com%alto%ndice%de%processamento%
por%severos%minutos,%entre%em%contato%com%suporte@integrator.com.br%para%lhe%
oferecermos%um%plano%mais%adequado%ao%seu%caso.
95
O%NGasi%%o%painel%Java,%onde%o%cliente%pode%escolher%o%servidor%que%vai%instalar,%iniciar,%
parar%e%ler%os%logs%de%sada%do%terminal.
96
O%Painel%Java,%que%permite%instalar%e%conJigurar%o%servidor%Java%em%seu%domnio,%executa%
em%duas%portas:
Porta%padro%pelo%acesso%via%cPanel:%8663
Porta%fora%do%acesso%via%cPanel:%8666
IMPORTANTE:*O*acesso*via*porta*8663,*portando*por*dentro*do*cPanel,*transmite*
sua*senha*no*endereo*http.*Se*estiver*em*um*local*de*acesso*pblico,*no*realize*
tal*acesso.
Sempre%que%for%acessar%o%painel%NGasi,%poder%faz\lo%diretamente%pelo%painel%cPanel%do%
domnio%no%qual%demos%a%permisso%do%servio%java.
No%cPanel%Jica%em%Avanada* *NGasi*Application*Automation.
Caso%esteja%usando%outro%tema,%ver%o%Ngasi%no%cPanel%em%Ferramentas*Avanadas**
NGasi*Application*Automation:
97
Ateno:% %Se%o%painel%Java,%pelo%acesso%via%cPanel,%pedir%a%senha%do%seu%usurio%FTP,%%
normal% em% casos% onde% a% senha% possui% caracteres% especiais% no% resolvidos% pelo%
cabealho%HTTP.%Digite\a%para%entrar.
98
Veja%no%tpico%Instalando%o%servidor%Java%.
99
Chamamos%de%mapeamento%a%ao%de%colocar%seu%aplicativo%Java%visvel%no%endereo%do%
seu%site/domnio.
Para%fazer%isso,%seguimos%estes%passos:
1)%V%no%painel%Java
2)% Mapeie% o% domnio% em% Web* Server* ConViguration* (no* novo* NGasi* no* canto*
superior*direito*no*cone*de*3*riscos):%
.%
2.1)%O%mapeamento%segue%a%seguinte%regra%se%for%apenas%o%aplicativo%na%URL:
a.
Digamos%que%voc%tenha%enviado%um%aplicativo%WAR%chamado%Aplicacao.war.%No%
mapeamento,% digite% Aplicacao* no% campo% mostrado% abaixo% e% conJirme% no% boto% Set*
Paths:
Teremos,%assim%que%adicionado,%a%URL%de%onde%o%aplicativo%Java%est%funcionando.%Por%
exemplo:
b.
Se for colocar na raiz do domnio, ou seja, digitou www.seusite.com.br, aparece o
aplicativo Java, mapeie%na%Raiz%do%domnio%clicando%no%boto%Set*Wild*Card.%Neste%caso,%
no% aparecer% nada% escrito% na% rea% de% mapeamento.% Basta% abrir% o% site,% aps% o% painel%
terminar%a%conJigurao,%que%deve%aparecer%a%pgina%default%do%servidor%Java%ou%o%seu%
aplicativo.
Para%cada%servidor%Java%que%oferecemos,%um%bsico%de%uso%com%os%painis%%apresentado%
no%tpico%O%Bsico%de%Uso%dos%Servidores%Java%.
100
101
A%Integrator%%uma%empresa%de%hospedagem.%No%somos%responsveis%pela%forma%como%
seu%aplicativo%foi%desenvolvido%e%nem%por%erros%dele%causados.%O%que%no%fazemos:
Ensinar%a%operar%um%servidor%Java%(ensinamos%a%usar%nossos%painis);
Ensinar%a%conJigurar%um%administrador%de%servidor%Java;
Ensinar%a%conJigurar%um%deployment%descriptor;
Otimizar%o%desempenho%do%aplicativo;
Corrigir%erros%de%programao%do%aplicativo%do%cliente.
Uma%alegao%comum%dos%clientes%%que%funciona%localmente.%No%geral,%este%argumento%
no%tem%validade%se%o%cliente%executa%tudo%por%um%programa%como%Adobe%Flex,%Eclipse,%
NetBeans%ou%outros.%No%deploy,%o%cliente%precisa%esta%ciente%de%que:
Nome% do% banco% de% dados% % diferente% do% de% desenvolvimento,% assim% como%
usurios%e%senhas;
No%Linux,%o%servidor%faz%diferena%entre%maisculas%e%minsculas%em:%nomes%de%
arquivos,%nomes%de%diretrios,%nome%do%banco%de%dados;
Regras%que%impomos%no%podem%ser%burladas,%pois%o%seu%servio%de%hospedagem%
compartilha%recursos%como:%servidor%de%banco%de%dados,%Apache,%PHP%e%outros.%
Embora%o%servidor%Java%seja%dedicado,%a%memria%do%servidor%%limitada%pelo%seu%
plano.% Se% o% aplicativo% necessita% de% mais% memria% que% o% contratado,% erros%
causados%por%esta%questo%no%so%considerados%como%problemas%nosso,%uma%vez%
que%o%cliente%%o%nico%que%sabe%o%quanto%realmente%seu%aplicativo%necessita%de%
memria.
102
O%Cliente%%obrigado%a%usar%pool%de%conexes%se%pretende%no%fechar%suas%conexes,%pois%
todos% os% servidores% de% bancos% de% dados% permitem% apenas% 40% conexes% simultneas%
abertas,%seja%em%uso%ou%inoperante.
O%MySQL%fecha%automaticamente,%conexes%inoperantes,%com%mais%de%8%horas.%Conexo%
inoperante%%aquela%que%no%est%sendo%usada,%mas%est%aberta%pelo%seu%aplicativo.
%
Esta%regra%vale%somente%para%planos%com%servidores%de%banco%de%dados%compartilhados.
Caso%queira%saber%quais%dados%colocar%em%seu%aplicativo%para%se%conectar%ao%banco%de%
dados,%v%at%o%tpico%Formas de acesso ao Banco de Dados para configurar sua conexo.
103
O% servidor% Java% pode% ser% selecionado*% na% lista,% assim% como% a% verso% que%
disponibilizamos%de%cada.
Para%instalar,%seleciona%o%Server%e%a%verso%do%JDK%e%clique%no%boto%Install.
ConJirme%no%Continue%para%prosseguir%com%a%instalao.
Ao%Jinalizar,%voc%ver%na%descrio%do%painel%o%servidor%instalado%e%o%local%onde%ele%est%
instalado.
104
IMPORTANTE:* Cada% plano,% que% permite% servidores% Java,% possui% uma% quantidade% de%
memria.% Os% servidores% que% so% possveis% de% serem% executados% so% informados% na%
pgina% da% Integrator.% Se% o% usurio% tentar% executar% um% servidor% Java% que% necessite% de%
mais% memria,% alm% dele% gerar% erros,% % poder% ter% problemas% em% para\lo% para%
substituio.%Caso%esquea%qual%%o%seu%plano,%veja%no%email%da%cobrana.%Os%servidores%
Java% que% consegue% rodar% em% seu% plano% so% visveis% no% site% da% Integrator,% no% link%
Hospedagem*de*Sites.
105
Qualquer%que%seja%o%servidor%Java,%ele%sempre%ser%instalado%em%seu%respectivo%diretrio,%
que%leva%seu%nome,%dentro%de%appservers.%
%Onde%X%%o%nmero%da%verso%instalada:
1.
2.
3.
4.
Tomcat*6/7/8%\%appservers/apache\tomcat\Xx%
Jetty*8*appservers/jetty\Xx
JBoss*7**appservers/jboss\7x
GlassFish*v3/v4**appservers/glassJish\Xx
IMPORTATE:*O%X%representa%o%nmero.%Por%exemplo%o%Tomcat*8%%padronizado%em%
instalao%no%diretrio%appservers/apacheTtomcatT8x.
106
Todos%os%servidores%Java%so%mantidos%em%sua%estrutura%original,%tal%qual%%exatamente%
como% aquele% que% se% obtm% na% Internet.% Nada% % modiJicado,% para% que% sua% experincia,%
com% o% que% j% desenvolve% antes% de% publicar,% seja% aplicado% 100%% na% produo% em%
hospedagem%da%Integrator.
Nada% do% que% for% exposto% aqui% substitui% o% seu% conhecimento% nos% servidores% Java% e% em%
suas%operaes.%A%forma%como%trabalhar%com%o%servidor%Java,%de%conJigurar%o%servidor%
Java,%continua%sempre%a%mesma%padro.%A%inteno%do%manual%,%e%sempre%ser,%explicar%
como%operar%o%painel%Java%para%que%o%seu%aplicativo%Jique%de%acordo%com%o%seu%desejo%de%
acesso%no%domnio.%
IMPORTANTE:% Tentar% realizar% um% deploy% de% forma% diferente% do% que% expomos,%
acessando% reas% do% painel% Java% que% no% estamos% aqui% divulgando,% pode% lhe% causar%
problemas%na%implantao%do%seu%aplicativo%em%seu%servidor.%Operar%caractersticas%que%
fogem% do% seu% acesso% direto% ao% servidor% Java,% como% deploy,% no% est% dentro% do% nosso%
suporte.%
107
Nada% do% que% est% no% servidor% Java,% que% instalar,% % personalizado% por% ns.% O% motivo:%
compatibilidade%total%com%seu%aplicativo.
Isso% mesmo,% queremos% que% voc% coloque% suas% bibliotecas% JAR,% nas% verses% que% est%
utilizando%em%seu%aplicativo,%sem%conJlitos.%
Resumindo:%empacotou%em%WAR/EAR,%com%as%bibliotecas,%faa%o%deploy.
IMPORTANTE:*Se%quiser%colocar%as%bibliotecas%que%possui%no%diretrio%lib%do%servidor%
Java,% tambm% pode.% Mas% Jique% ciente% de% que,% se% reinstalar% o% servidor% Java,% tudo% ser%
apagado%e%ter%que%subir%as%bibliotecas%novamente.
108
Se%a%sua%inteno%%ter%o%mesmo%servidor%Java%em%outros%domnios,%saiba%que:
1) No%%possvel%colocar%dois%ROOTs%independentes%para%cada%domnio;
2) O%domnio%ou%subdomnio%no%poder%ser%cadastrado%no%WHM,%ou%seja,%precisar%
cadastrar%no%cPanel%conforme%os%tpicos%Adicionando*subdomnios%ou%
Adicionando*Domnios*Suplementares.
3) No%%possvel%separar%sua%memria,%desmembrando%a%quantidade%para%mais%de%
uma%JVM,%de%modo%a%distribuir%entre%mais%de%um%domnio/subdomnio%(ex:%
512MB%RAM%dividir%em%duas%JVMs%de%256MB%RAM).
109
Primeiro,%crie%o%domnio%ou%subdomnio%no%cPanel%conforme%os%tpicos%Adicionando*
subdomnios%ou%Adicionando*Domnios*Suplementares.
Depois,%v%no%painel%Java,%%Web*Server*ConViguration.%Selecione%o%subdomnio%ou%
domnio%suplementar%na%caixa%de%combinao%como%destacado%na%Figura%abaixo:
Se%o%primeiro%domnio%estiver%com%o%servidor%Java%na%raiz,%no%ser%possvel%colocar%o%
segundo% na% raiz% de% um% aplicativo% independente.% Por% servidor% Java,% s% existe% a%
possibilidade%de%ter%apenas%um%aplicativo%na%raiz%do%domnio.
IMPORTANTE:%Se%a%sua%inteno%%ter%mais%de%um%domnio%com%servidor%na%raiz,%entre%
em%contato%com%o%suporte@integrator.com.br%para%saber%de%nossos%preos%por%memria%
dedicada.%%
110
Na%Integrator,%temos%as%seguintes%verses%de%servidores%Java:%
1%\%Tomcat:%6.0.x%,%7.0.x%e%8.x.
2%\%Jetty:%8.x
3%\%JBoss:%7.x%e%8%(WildJly)
4%\%GlassJish:%3.x%e%4.x
Este%Captulo%tem%a%inteno%de%mostrar%o%bsico%em%termos%de%localizao%e%realizao%
de% deploy.% Este% manual% no% substitui% o% conhecimento% tcnico% do% desenvolvedor% no%
servidor%Java%que%escolher%operar.
111
Duas%situaes%so%possveis%em%uso%de%aplicaes%Java%no%seu%domnio:
Aplicativo%com%PHP/HTML%em%conjunto,%ou%seja,%aparecer%assim:
http://seusite.com.br/AplicativoJava
Aplicativo%na%raiz%do%domnio%sendo%apenas%Java:
http://seusite.com.br
IMPORTANTE: Chamamos%de%raiz%do%domnio%a%situao%em%que%o%servidor%Java%ir%
apresentar%o%seu%aplicativo%diretamente%quando%os%seus%usurios%digitarem%o%domnio%
no%navegador%(seja%com%ou%sem%WWW).
112
Na% Integrator,% temos% as% seguintes% verses% de% Tomcat:% 6.0.x% ,% 7.0.x% e% 8.x.% Um% aplicativo%
criado% no% Tomcat% 6.x,% executa% em% qualquer% servidor% Tomcat% de% verso% superior.% O%
contrrio% j% no% % verdadeiro,% pois% bibliotecas% podem% ser% necessrias% na% verso%
disponvel% do% Servlet% ou% JSP% que% podem% no% ser% compatveis% com% uma% verso%
retrgrada.
O% Tomcat% no% % ensinado% pelo% nosso% suporte% de% hospedagem.% Esta% parte% do% manual%
apenas%ir%orient\lo%sobre%como%ele%funciona%na%Integrator,%com%um%exemplo%simples.%
Caso% necessite% de% mais% orientaes% sobre% o% Tomcat,% seu% modo% de% operao,%
recomendamos%a%documentao.
113
Caso%o%aplicativo%seja%grande,%o%mais%correto%em%subir%um%aplicativo%no%Tomcat%%usando%
o%FTP.
Para%fazer%deploy%no%Tomcat,%execute%estes%passos:
1)
2)
a.
Pare%o%Tomcat%no%painel%Java%em%
;
Suba%seu%arquivo%WAR,%com%todas%as%bibliotecas,%por%FTP,%no%seguinte%diretrio:%
appservers/apacheTtomcatTXx/webapps%%onde%X%%a%verso%do%seu%Tomcat;
3)
4)
Inicie%o%Tomcat%no%painel%Java%em%
%;
Ainda%no%painel%Java,%mapeie%o%domnio%em%Web*Server*ConViguration.%
4.1)%O%mapeamento%segue%a%seguinte%regra:
a.
Digamos%que%voc%tenha%enviado%um%aplicativo%WAR%chamado%Aplicacao.war.%No%
mapeamento,% digite% Aplicacao* no% campo% mostrado% abaixo% e% conJirme% no% boto% Set*
Paths:
5) Teremos,%assim%que%adicionado,%a%URL%de%onde%o%aplicativo%Java%est%funcionando.%
Por%exemplo:
114
Digamos,% assim% que% adicionado,% a% URL% de% onde% o% aplicativo% Java% est% funcionando,%
mapeado,%em%/Aplicacao.%
Para%remover,%os%passos:
1)%Clique%no%X%do%mapeamento%realizado
2)% Aps% desaparecer% o% endereo% do% mapeamento,% clique% em% Set* Paths% e% aguarde%
processar%a%mudana.
115
A% raiz% de% um% domnio% % quando% digitamos% o% endereo% do% site% (integrator.com.br% \% por%
exemplo)%e%ele%abre%o%aplicativo%Java.
No% Tomcat,% existe% um% padro% para% o% ROOT% do% domnio,% onde% o% seu% aplicativo% deve% se%
chamar%ROOT.war%ou%ele%deve%estar%em%ROOT.%
Faa%os%seguintes%passos%para%realizar%tal%conJigurao:
1) Pare%o%Tomcat%no%painel%Java%em%
;
2)% Remova%%o%diretrio%ROOT%do%Tomcat%padro.
3) Suba% seu% arquivo% ROOT.war,% com% todas% as% bibliotecas,% por% FTP,% no% seguinte%
diretrio:%
a.
appservers/apacheTtomcatTXx/webapps%%onde%X%%a%verso%do%seu%Tomcat;
4) Inicie%o%Tomcat%no%painel%Java%em%
%;
5) Ainda%no%painel%Java,%mapeie%o%domnio%em%Web*Server*ConViguration.%
5.1)%O%mapeamento%segue%a%seguinte%regra:
6)% Mapeie%na%Raiz%do%domnio%clicando%no%boto%Set*Wild*Card.
No%aparecer%nada%aps%o%processamento,%mas%ao%abrir%o%domnio,%deve%aparecer%seu%
aplicativo.
IMPORTANTE:* Caso% aparea% em% Branco,% veja% o% procedimento% de% como% analisar% o%
problema,%lendo%os%logs%do%seu%servidor%Java,%baixando\os%pelo%FTP.%Para%ver%onde%Jicam%
seus%logs,%v%no%tpico%Logs%de%Acesso%do%Servidor%Java%.
IMPORTANTE:* Pools% de% conexo% exigem% a% biblioteca% do% banco% de% dados% no% diretrio%
appservers/apacheTtomcatTXx/lib.
116
Clique%em%Desabe*Mappings%e%aguarde%o%processamento%que%remover%o%mapeamento%
da%raz%do%domnio.
117
Qualquer% verso% do% servidor% Tomcat% instalada% no% painel% no% possui% o% Manager%
conJigurado%por%padro%com%um%usurio%e%senha%idnticos%ao%do%seu%painel.%Isto%%voc%
quem%deve%olhar%o%arquivo%e%alter\lo%como%quiser.
As configuraes de acesso ao Manager so feitas no arquivo tomcat-users.xml.
O tomcat-users.xml fica em appservers/apache-tomcat-Xx/conf/tomcat-users.xml, onde o
"X" a verso do seu Tomcat.
Se o seu Tomcat estiver iniciado, reinicie para ter efeito as mudanas.
118
Onde USER o usurio que deseja e PASS a senha que deseja ter. Mas lembre-se, somente
no Tomcat 7/8 deve ser assim.
119
Antes de comear, esses passos no devem ser realizados por usurios que colocaram o
Tomcat na raiz do domnio. Caso no esteja usando o servidor Java na raiz do domnio,
mapeie o Manager do Tomcat da seguinte forma:
1) V% em% em% Web* Server* ConViguration% e,% no% mapeamento,% digite% manager/html* no%
campo%ilustrado%na%Jigura%abaixo.%ConJirme%no%boto%Set*Paths:
120
Para%fazer%deploy%no%Jetty,%execute%estes%passos:
1)
2)
a.
Pare%o%Tomcat%no%painel%Java%em%
;
Suba%seu%arquivo%WAR,%com%todas%as%bibliotecas,%por%FTP,%no%seguinte%diretrio:%
appservers/jettyTXx/webapps%%onde%X%%a%verso%do%seu%Jetty;
3) Inicie%o%Jetty%no%painel%Java%em%
%;
4) Ainda%no%painel%Java,%mapeie%o%domnio%em%Web*Server*ConViguration.%
4.1)%O%mapeamento%segue%a%seguinte%regra:
a.
Digamos%que%voc%tenha%enviado%um%aplicativo%WAR%chamado%Aplicacao.war.%No%
mapeamento,% digite% Aplicacao* no% campo% mostrado% abaixo% e% conJirme% no% boto% Set*
Paths:
5) Teremos,%assim%que%adicionado,%a%URL%de%onde%o%aplicativo%Java%est%funcionando.%
Por%exemplo:
121
A% raiz% de% um% domnio% % quando% digitamos% o% endereo% do% site% (integrator.com.br% \% por%
exemplo)%e%ele%abre%o%aplicativo%Java.
Faa%os%seguintes%passos%para%realizar%tal%conJigurao:
1)
2)
a.
Pare%o%Jetty%no%painel%Java%em%
;
Suba%seu%arquivo%.war,%com%todas%as%bibliotecas,%por%FTP,%no%seguinte%diretrio:%
appservers/jettyTXx/webapps%%onde%X%%a%verso%do%seu%Jetty;
Inicie%o%Jetty%no%painel%Java%em%
%;
Ainda%no%painel%Java,%mapeie%o%domnio%em%Web*Server*ConViguration.%%
Mapeie%na%Raiz%do%domnio%clicando%no%boto%Set*Wild*Card.
No%aparecer%nada%aps%o%processamento,%mas%ao%abrir%o%domnio,%deve%aparecer%seu%
aplicativo.
IMPORTANTE:* Caso% aparea% em% Branco,% veja% o% procedimento% de% como% analisar% o%
problema,%lendo%os%logs%do%seu%servidor%Java,%baixando\os%pelo%FTP.%Para%ver%onde%Jicam%
seus%logs,%v%no%tpico%Logs%de%Acesso%do%Servidor%Java%.
IMPORTANTE:* Pools% de% conexo% exigem% a% biblioteca% do% banco% de% dados% no% diretrio%
appservers/jettyTXx/lib.
122
Antes%de%comear,%usurios%que%operam%com%WAR/EAR%e%desconhecem%o%JBoss/WildJly,%
apenas%realizando%deploy%por%ferramentas,%consulte%o%manual%do%servidor%JBoss/WildJly%
antes%para%compreend\lo.%
O% suporte% da% Integrator% no% tem% como% foco% ensinar% a% usar% o% JBoss/WildJly,% mas% sim%
fornecer%a%estrutura%necessria%para%que%execute%seus%aplicativos%no%mesmo.
123
O JBoss 7 instalado sempre usando a opo "standalone, que a qual devemos trabalhar:
~/appservers/jboss-7x/standalone
Para%fazer%deploy%no%JBoss%7,%execute%estes%passos:
1) Pare%o%servidor%no%painel%Java%em%
;
2) Suba% seu% arquivo% WAR% ou% EAR,% com% todas% as% bibliotecas,% por% FTP,% no% seguinte%
diretrio:%
~/appservers/jboss-7x/standalone/deployments
2.1) Para as Bibliotecas JAR:
~/appservers/jboss-7x/standalone/lib/
3) Inicie%o%servidor%no%painel%Java%em%
%;
4) Ainda%no%painel%Java,%mapeie%o%domnio%em%Web*Server*ConViguration.%
4.1)%O%mapeamento%segue%a%seguinte%regra:
a.
Digamos%que%voc%tenha%enviado%um%aplicativo%WAR%chamado%Aplicacao.war.%No%
mapeamento,% digite% Aplicacao* no% campo% mostrado% abaixo% e% conJirme% no% boto% Set*
Paths:
5) Teremos,%assim%que%adicionado,%a%URL%de%onde%o%aplicativo%Java%est%funcionando.%
Por%exemplo:
124
No%JBoss%7,%faa%os%seguintes%passos:
1) Pare%o%servidor%no%painel%Java%em%
;
2) Suba% seu% arquivo% WAR% ou% EAR,% com% todas% as% bibliotecas,% por% FTP,% no% seguinte%
diretrio:%
~/appservers/jboss-7x/standalone/deployments
2.1) Para as Bibliotecas JAR:
~/appservers/jboss-7x/standalone/lib/
3)
4)
5)%
Inicie%o%servidor%no%painel%Java%em%
%;
Ainda%no%painel%Java,%mapeie%o%domnio%em%Web*Server*ConViguration.%
Mapeie%na%Raiz%do%domnio%clicando%no%boto%Set*Wild*Card.
No%aparecer%nada%aps%o%processamento,%mas%ao%abrir%o%domnio,%deve%aparecer%seu%
aplicativo.
IMPORTANTE:* Caso% aparea% em% Branco,% veja% o% procedimento% de% como% analisar% o%
problema,%lendo%os%logs%do%seu%servidor%Java,%baixando\os%pelo%FTP.%Para%ver%onde%Jicam%
seus%logs,%v%no%tpico%Logs%de%Acesso%do%Servidor%Java%.
125
Se% voc% sobe% o% aplicativo,% descompactado% (sem% estar% no% formato% WAR),% dentro% de%
"deployments",% chamado% "site1.war",% voc% deve% criar% um% arquivo% chamado%
"site1.war.deployed",%sem%aspas,%com%o%contedo%abaixo:
Isto%far%o%Deploy%ao%iniciar%o%JBoss%7.
Para% que% Jique% na% raiz,% voc% deve% ter% o% arquivo% "site1.war/WEBTINF/jbossTweb.xml"%
com%este%contedo:
<?xml version="1.0" encoding="UTF-8"?>
<jboss-web>
<context-root>/</context-root>
</jboss-web>
E%deve%desativar%o%"enable\welcome\root"%do%JBoss%7%no%seguinte%arquivo:
~/appservers/jbossT7x/standalone/conViguration/standalone.xml
Deixe%a%opo%como%false:
<virtualTserver*name="defaultThost"*enableTwelcomeTroot="false">
IMPORTANTE:* Saiba% que% % conhecimento% do% JBoss% o% que% estamos% fornecendo% neste%
pequeno% exemplo.% Logo,% entenda% que% % um% exemplo% e% no% um% ensino% do% JBoss.% No%
ensinamos% e% nem% resolvemos% caractersticas% pertencentes% ao% JBoss,% uma% vez% que% isso%
foge%da%hospedagem%de%servios%Java.
126
Para%fazer%deploy%no%JBoss%7,%execute%estes%passos:
1) Pare%o%servidor%no%painel%Java%em%
;
2) Suba% seu% arquivo% WAR% ou% EAR,% com% todas% as% bibliotecas,% por% FTP,% no% seguinte%
diretrio:%
~/appservers/wildfly-8x/standalone/deployments
2.1) Para as Bibliotecas JAR:
~/appservers/wildfly-8x/standalone/lib/
3)
Inicie%o%servidor%no%painel%Java%em%
%;
4) Ainda%no%painel%Java,%mapeie%o%domnio%em%
.%O%mapeamento%
segue%a%seguinte%regra:
a.
Digamos%que%voc%tenha%enviado%um%aplicativo%WAR%chamado%Aplicacao.war.%No%
mapeamento,% digite% Aplicacao* no% campo% mostrado% abaixo% e% conJirme% no% boto% Set*
Paths:
5) Teremos,%assim%que%adicionado,%a%URL%de%onde%o%aplicativo%Java%est%funcionando.%
Por%exemplo:
127
No%WildJly,%faa%os%seguintes%passos:
1) Pare%o%servidor%no%painel%Java%em%
;
2) Suba% seu% arquivo% WAR% ou% EAR,% com% todas% as% bibliotecas,% por% FTP,% no% seguinte%
diretrio:%
~/appservers/wildfly-8x/standalone/deployments
2.1) Para as Bibliotecas JAR:
~/appservers/wildfly-8x/standalone/lib/
3)
4)
5)%
Inicie%o%servidor%no%painel%Java%em%
%;
Ainda%no%painel%Java,%mapeie%o%domnio%em%Web*Server*ConViguration.%
Mapeie%na%Raiz%do%domnio%clicando%no%boto%Set*Wild*Card.
No%aparecer%nada%aps%o%processamento,%mas%ao%abrir%o%domnio,%deve%aparecer%seu%
aplicativo.
IMPORTANTE:* Caso% aparea% em% Branco,% veja% o% procedimento% de% como% analisar% o%
problema,%lendo%os%logs%do%seu%servidor%Java,%baixando\os%pelo%FTP.%Para%ver%onde%Jicam%
seus%logs,%v%no%tpico%Logs%de%Acesso%do%Servidor%Java%.
128
Se% voc% sobe% o% aplicativo,% descompactado% (sem% estar% no% formato% WAR),% dentro% de%
"deployments",% chamado% "site1.war",% voc% deve% criar% um% arquivo% chamado%
"site1.war.dodeploy",% sem% aspas,% sem% contedo% algum. Isto% far% o% Deploy% ao% iniciar% o%
WildJly.
Para% que% seu% aplicativo% Jique% na% raiz% do% domnio/servidor% WildJly,% voc% deve% ter% o%
arquivo%"site1.war/WEBTINF/jbossTweb.xml"%com%este%contedo:
<?xml version="1.0" encoding="UTF-8"?>
<jboss-web>
<context-root>/</context-root>
</jboss-web>
IMPORTANTE:* Saiba% que% % conhecimento% do% WildJly% o% que% estamos% fornecendo% neste%
pequeno% exemplo.% Logo,% entenda% que% % um% exemplo% e% no% um% ensino% do% WildJly.% No%
ensinamos%e%nem%resolvemos%caractersticas%pertencentes%ao%WildJly,%uma%vez%que%isso%
foge%da%hospedagem%de%servios%Java.%Para%saber%mais%sobre%nossas%regras%de%suporte,%
clique%aqui.
129
Aps%instalar%o%GlassFish,%voc%pode%acessar%o%Admin.%
1)
2)
Inicie%o%GlassFish%no%painel%Java%em%
Para%acessar%o%Admin,%assim%que%instalado%o%GlassFish,%faa:
http://seudominio:4848
Onde%seudominio%%o%seu%site.%Caso%no%aparea%o%Admin,%assim%que%iniciar%o%servidor%
Java%GlassFish,%entre%em%contato%com%o%suporte@integrator.com.br,%relatando%a%situao.
3)
O%usurio%e%senha%padro%do%GlassFish:
a.
Usurio:%admin
b.
Senha:%adminadmin
4)
Faa%o%deploy%do%seu%aplicativo%indo%em%Applications%no%GlassFish.
5)
Clique%em%Deploy:
6)
Selecione%o%arquivo%de%sua%mquina%se%sua%internet%for%acima%de%2MB%e%for%possvel%
130
usar%um%upload%de%arquivos%rpido:
7) Caso% sua% internet% tenha% um% upload% de% arquivos% baixo,% recomendamos% subir% seu%
aplicativo%por%FTP.%Suba%em%um%diretrio%qualquer,%podendo%ser%na%raiz%do%seu%usurio%
mesmo:
8) Selecione%no%Admin%o%item%Local*Packaged*File*or*Directory*That*Is*Accessible*
from*GlassFish*Server,%clicando%no%boto%para%selecionar%o%arquivo:
9) Ao%abrir%a%janela%popup,%%vaem%Look*In*at%onde%est%seu%aplicativo,%sabendo%que%
ele% comea% com% /home/USUARIO_FTP.% Por% exemplo,% temos% o% usurio% chamado%
clouds10,% acessamos% /home/clouds10.% O% ideal% % digitar% este% caminho% inicial% e%
pressionar% Enter.% Mais% abaixo%voc%ver%os%arquivos%listados.%Selecione%o%arquivo%WAR%
ou%EAR%e%conJirme%no%boto%Choose*File.
131
10) Assim%que%selecionado,%sero%puxadas%as%conJiguraes%iniciais%para%o%deploy:
132
11) %ConJirme%por%Jim%no%boto%
.
12) Ainda%no%painel%Java,%mapeie%o%domnio%em%Web*Server*ConViguration.%
12.1)%O%mapeamento%segue%a%seguinte%regra:
a.
Digamos%que%voc%tenha%enviado%um%aplicativo%WAR%chamado%Aplicacao.war.%No%
mapeamento,% digite% Aplicacao* no% campo% mostrado% abaixo% e% conJirme% no% boto% Set*
Paths:
13) Teremos,%assim%que%adicionado,%a%URL%de%onde%o%aplicativo%Java%est%funcionando.%
Por%exemplo:
133
Aps%instalar%o%GlassFish,%voc%pode%acessar%o%Admin.%
1)
2)
Inicie%o%GlassFish%no%painel%Java%em%
Para%acessar%o%Admin,%assim%que%instalado%o%GlassFish,%faa:
http://seudominio:4848
Onde%seudominio%%o%seu%site%sem%www.%Caso%no%aparea%o%Admin,%assim%que%iniciar%
o% servidor% Java% GlassFish,% entre% em% contato% com% o% suporte@integrator.com.br,%
relatando%a%situao.
3)
O%usurio%e%senha%padro%do%GlassFish:
a.
Usurio:%admin
b.
Senha:%adminadmin
4)
Faa%o%deploy%do%seu%aplicativo%indo%em%Applications%no%GlassFish.
5)
Clique%em%Deploy:
134
6) Selecione%o%arquivo%de%sua%mquina%se%sua%internet%for%acima%de%2MB%e%for%possvel%
usar%um%upload%de%arquivos%rpido:
7) Caso% sua% internet% tenha% um% upload% de% arquivos% baixo,% recomendamos% subir% seu%
aplicativo%por%FTP.%Suba%em%um%diretrio%qualquer,%podendo%ser%na%raiz%do%seu%usurio%
mesmo:
8) Selecione%no%Admin%o%item%Local*Packaged*File*or*Directory*That*Is*Accessible*
from*GlassFish*Server,%clicando%no%boto%para%selecionar%o%arquivo:
9) Ao%abrir%a%janela%popup,%%vaem%Look*In*at%onde%est%seu%aplicativo,%sabendo%que%
ele% comea% com% /home/USUARIO_FTP.% Por% exemplo,% temos% o% usurio% chamado%
clouds10,% acessamos% /home/clouds10.% O% ideal% % digitar% este% caminho% inicial% e%
pressionar% Enter.% Mais% abaixo%voc%ver%os%arquivos%listados.%Selecione%o%arquivo%WAR%
ou%EAR%e%conJirme%no%boto%Choose*File.
135
10) Assim%que%selecionado,%sero%puxadas%as%conJiguraes%iniciais%para%o%deploy:
11) %ConJirme%por%Jim%no%boto%
.
4) Ainda%no%painel%Java,%mapeie%o%domnio%em%Web*Server*ConViguration.%
136
5)%
Mapeie%na%Raiz%do%domnio%clicando%no%boto%Set*Wild*Card.
No%aparecer%nada%aps%o%processamento,%mas%ao%abrir%o%domnio,%deve%aparecer%seu%
aplicativo.
IMPORTANTE:* Caso% aparea% em% Branco,% veja% o% procedimento% de% como% analisar% o%
problema,%lendo%os%logs%do%seu%servidor%Java,%baixando\os%pelo%FTP.%Para%ver%onde%Jicam%
seus%logs,%v%no%tpico%Logs%de%Acesso%do%Servidor%Java%.
137
O GlassFish pode ser configurado de diversas formas. O que precisa a configurao do seu
Enterprise Application informando que o seu aplicativo WAR na raiz. Digamos que o
aplicativo se chame AplicacaoEAR.ear, onde teramos o arquivo application.xml em METAINF.
Veja o exemplo do application.xml em detalhes:
<?xml version="1.0" encoding="UTF-8"?>
<application version="6"
xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/
XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://
java.sun.com/xml/ns/javaee/application_6.xsd">
<display-name>Aplicacao</display-name>
<module>
<web>
<web-uri>Aplicacao-war.war</web-uri>
<context-root>/</context-root>
</web>
</module>
<module>
<ejb>Aplicacao-ejb.jar</ejb>
</module>
</application>
1)
2)%
Ainda%no%painel%Java,%mapeie%o%domnio%em%Web*Server*ConViguration.%
Mapeie%na%Raiz%do%domnio%clicando%no%boto%Set*Wild*Card.
IMPORTANTE:%ConJiguraes%adicionais%do%aplicativo,%gerado%no%EAR%ou%WAR%Jile%no%
fazem% parte% do% conhecimento% que% a% Integrator% fornece.% Se% voc% automatiza% tudo% pelo%
NetBeans,% por% exemplo,% procure% entender% o% que% % feito% na% gerao% do% WAR/EAR% em%
termos% de% conJiguraes.% A% Integrator% no% ensina% estes% detalhes% por% se% tratarem%
exclusivamente%de%conhecimento%voltado%ao%desenvolvimento.
138
Cada%servidor%Java%possui%um%caminho%padro%para%acesso%aos%seus%logs.%Abaixo%a%
relao%de%cada%servidor%Java%para%que%possa%baixar%os%logs%via%FTP.
Substitua%o%X,%em%maisculo,%pela%verso%instalada.
Tomcat 6 at 8
~/appservers/apache-tomcat-Xx/logs/stdout.log
JETTY 8
~/appservers/jetty-8x/logs/stdout.log
JBOSS 7
~/appservers/jboss-7x/standalone/log/server.log
WILDFLY
~/appservers/wildfly-8x/standalone/log/server.log
GlassFish 3 e 4
~/appservers/glassfish-Xx/domains/domain1/logs/server.log
IMPORTANTE:* * O% suporte% da% Integrator% no% analisa% logs% e% nem% resolve% problemas% de%
aplicativo.% Tais% situaes% so% consideradas% de% desenvolvimento% ou% ensino% e% fogem% ao%
quesito%hospedar%um%site.
139
O%servidor%Java%pode%ser%personalizado%nas%informaes%de%locale:%data,%hora,%nmeros%e%
moedas%podem%ser%conJiguradas.%
Cada%servidor%Java%possui%uma%forma%de%alterar%o%Locale.%
140
As%instrues%que%deve%passar,%se%for%conJigurar%no%servidor%Java,%so%feitas%no%shell%que%
inicializa% o% servio.% Por% exemplo,% se% formos% usar% a% regio% de% So% Paulo,% passamos% as%
informaes%mostradas%abaixo.%Mas%ateno,%substitua%o%X,%em%maisculo,%pela%verso%
instalada.
Duser.timezone=America/Sao_Paulo -Duser.language=pt -Duser.region=BR
No% Apache% Tomcat,% para% ilustrar% melhor% como% seria,% conJiguramos% no% arquivo%
appservers/apacheTtomcatTXx/bin/catalina.sh:
export CATALINA_OPTS="-Duser.timezone=America/Sao_Paulo -Duser.language=pt Duser.region=BR"
Em%alguns%servidores,%as%instrues%mostradas%so%passadas%na%varivel%JAVA_OPTS%no%
shell%que%inicializa%o%servidor%Java.
Entretanto,%saiba%das%seguintes%regras:
1) Altere%somente%o%que%informamos,%nada%alm;
2) Existem%timezones%diferentes%para%algumas%regies;
3) Reinicie%o%servidor%Java;
Estas% mudanas% so% feitas% pelo% cliente% e% de% sua% total% responsabilidade.% O% suporte% da%
Integrator% no% tem% obrigao% de% orientar% o% desenvolvedor% a% respeito% de% suas%
conJiguraes%regionais%para%uso%no%timezone.
IMPORTANTE:* * O% suporte% da% Integrator% no% analisa% logs% e% nem% resolve% problemas% de%
aplicativo.% Tais% situaes% so% consideradas% de% desenvolvimento% ou% ensino% e% fogem% ao%
quesito%hospedar%um%site.
141
Para locale, adicione a linha abaixo, no Locale do Timezone do Brasil, Amrica, So Paulo:
-Duser.timezone=America/Sao_Paulo -Duser.language=pt -Duser.region=BR
A alterao deve ser feita no seguinte local do Admin do GlassFish:
Configurations server-config JVM Settings JVM Options. Clique em Add JVM
Option, adicione a linha ensinada acima. Confirme em Save.
IMPORTANTE: Jamais altere a memria do servidor Java, pois nossos sistemas derrubam
mquinas alteradas.
142
O cPanel trata todo domnio suplementar como subdomnio do principal. Logo teste.com.br
para o cPanel (no para seus usurios) teste.clouds13integrator.com. Seus usurios sempre
acessaro como teste.com.br de forma transparente e sempre aparecer desta forma na URL.
1) Depois de adicionado o domnio suplementar, ou subdomnio, v no painel NGasi, em
;
2) V%em%Web*Server*ConViguration%e selecione o domnio suplementar/subdomnio que
aparecer com o nome do usurio, assim:
3) Vamos dizer que voc fez o deploy, de um aplicativo novo, chamado "Aplicativo.war" e
vai mape-lo no novo domnio.
3.1) Digite o nome do "Aplicativo", Digamos%que%voc%tenha%enviado%um%aplicativo%WAR%
chamado%Aplicacao.war.%No%mapeamento,%digite%Aplicacao*no%campo%mostrado%abaixo%
e%conJirme%no%boto%Set*Paths:
143
13) Teremos,%assim%que%adicionado,%a%URL%de%onde%o%aplicativo%Java%est%funcionando.%
144
Na% Integrator,% % o% usurio% pode% trabalhar% com% dois% tipos% de% banco% de% dados% que%
prestamos%suporte:
1.%MySQL
2.%PostgreSQL
Cada% banco% de% dados% possui% sua% particularidade.% O% suporte% no% ensina% as%
particularidades%do%%banco%de%dados%que%escolher%usar%de%forma%administrativa.%Apenas%
orientamos% no% uso% pelos% painis% em% termos% de% acesso,% assim% como% em% seu% aplicativo%
online%e%erros%que%possuir,%desde%que%no%sejam%ocasionados%pela%falta%de%conhecimento%
tcnico%no%que%deseja%realizar,%como%por%exemplo,%criao%de%functions/procedures.
145
Para%trabalhar%com%o%PostgreSQL,%da%forma%mais%simples,%v%em%Bancos*de*Dados*
Banco*de*Dados*PostgreSQL.
1. Dentro do painel, voc cria o banco de dados, dando seu nome no campo "Nome do Banco
de Dados" e confirmando em "Criar Banco de Dados". Mais abaixo aparecer o banco de
dados, assim que criado, ao entrar neste mesmo painel.
IMPORTANTE: O PostgreSQL no precisa criar usurio, pois ele usa o mesmo usurio do
146
FTP. Para se conectar ao seu banco de dados PostgreSQL pelo seu aplicativo, aps definir o
banco de dados, use:
host: localhost
147
Para%trabalhar%com%o%PostgreSQL,%no%%preciso%criar%usurio,%como%no%MySQL%para%
acesso%a%ele, principalmente se estiver usando Frameworks para criar tabelas, como
Hibernate/JPA em Java.
Para se conectar ao seu banco de dados PostgreSQL pelo seu aplicativo, aps definir o banco
de dados, use:
host: localhost
Usurio: mesmo do FTP
Senha: a mesma do usurio FTP
Banco de dados: O nome completo, que inclui o prefixo, criado no painel de controle
cPanel
148
No cPanel, voc exporta o banco de dados pelo phpPgAdmin usando os seguintes passos:
1) V em "Bancos de Dados", clique em "phpPgAdmin".
149
150
151
Para Importar bancos de dados grandes, use o acesso SSH e comandos de importao do
PostgreSQL via psql.
Para importar via SSH, os passos:
1) Leve o arquivo por FTP para a conta do seu usurio.
2) Crie apenas o banco de dados no cPanel
2) No terminal SSH, execute aps subir seu arquivo via FTP, o seu DUMP em SQL:
psql -U USUARIO_FTP BANCO_CRIADO < ARQUIVO.SQL
Onde:
ARQUIVO.SQL - Seu arquivo de dump SQL gerado local e levado via FTP para sua
conta
Veja-o-tpico-Usurio-PADRO-do-PostgreSQL-no-Painel--caso-estejausando-Hibernate/JPA.-Usurios-PHP-que-trabalhem-com-Frameworks,-aorientao--a-mesma.
152
A forma mais simples de criar um banco de dados MySQL no cPanel ensinado abaixo:
1. Crie o banco de dados MySQL indo em Banco de Dados, Banco de dados MySQL.
153
154
155
3) Por fim, voc dever ver o nome do banco de dados e seu respectivo usurio.
156
Na%Integrator,% %o%usurio%pode%trabalhar%com%o%acesso%ao%banco%de%dados%das%seguintes%
formas%aps%criar%o%banco%de%dados%no%cPanel:
No*MySQL*
1.%Pelo%cPanel%atravs%do%phpMyAdmin
2.%Pelo%SSH%atravs%de%comandos%diretamente%executados%no%banco%de%dados
3.%Remotamente%desde%que%liberado%acesso%via%cPanel
No*PostgreSQL
1.%Pelo%cPanel%atravs%do%phpPgAdmin
2.%Pelo%SSH%atravs%de%comandos%diretamente%executados%no%banco%de%dados
O%Item%2%de%cada%banco%de%dados%exige%conhecimento%de%SQL%e%tambm%o%conhecimento%
tcnico%do%terminal%de%cada%banco%de%dados.%
IMPORTANTE:%Se%%iniciante,%recomendamos%fortemente%o%MySQL%por%ser%mais%simples%
e%seguir%as%normas%SQL%padro.
157
1.%Aps%criar%o%banco%de%dados%no%MySQL,%v%em%Banco*de*Dados**phpMyAdmin
2.%Ao%abrir%o%phpMyAdmin,%clique%no%seu%banco%de%dados:
%
No% phpMyAdmin% voc% pode% importar% seu% SQL,% clicando% em% Importar,% selecionando% o%
arquivo.
158
No%Java%ou%PHP,%use%sempre%as%seguintes%conJiguraes:
Host:%localhost
Banco%de%dados,%Usurio%e%senha:%Criados%no%cPanel
159
1.%Aps%criar%o%banco%de%dados%no%PostgreSQL,%v%em%Banco*de*Dados**phpPgAdmin:
2.%Ao%abrir%a%janela%do%phpPgAdmin,%clique%no%banco%de%dados%para%que%possa%executar%
suas%queries%SQL%ou%Importar%um%banco%de%dados:
3.%Para%importar%as%tabelas%e%dados,%exporte%em%formato%SQL,%depois%no%phpPgAdmin,%
v%em%SQL* selecione*o*arquivo*local* Execute*a*importao:
160
161
No%Java,%use%sempre%as%seguintes%conJiguraes:
Host:%localhost
Banco%de%dados:%Criado%no%cPanel
Usurio*:%O%mesmo%do%usurio%cPanel
Senha:%Senha%do%Usurio%cPanel
No%PHP,%use%sempre%as%seguintes%conJiguraes:
Host:%127.0.0.1
Banco%de%dados,%usurio%e%senha:%Criado%no%cPanel
* Use o mesmo Usurio do cPanel sempre que for criar tabelas no PostgreSQL.
IMPORTANTE: No PHP no gere tabelas pelo aplicativo e jamais use o mesmo usurio e
senha do cPanel.
162
Na% Integrator,% % o% usurio% pode% trabalhar% com% o% acesso% acesso% remoto% padronizado% no%
banco%de%dados%MySQL,%desde%que%liberados%antes%no%cPanel.
163
Os%passos%para%liberao%de%acesso%remoto:
1. V em "Bancos de Dados MySQL Remoto", no seu cPanel.
164
O host do seu programa local, executado em sua mquina, pode ser seu domnio, sem "http://
www." ou o IP que aparece no FTP do seu email de Configuraes e Instrues de Uso.
Resumindo:
Host: seusite.com.br
Porta: 3306
Banco de Dados, Usurio e Senha: Criados no cPanel
165
Se estiver vendo este erro aparecendo para a conexo do seu aplicativo online, seja Java ou
PHP, veja o tpico Formas de acesso ao Banco de Dados para corrigir sua conexo, cujo
online, deve ser no host apenas localhost, sem as aspas.
Remotamente*, se muitos erros de conexo ocorrerem em um perodo pequeno, haver uma
mensagem de erro ao tentar se conectar remotamente ao seu banco de dados no MySQL. A
mensagem similar a mostrada abaixo:
Host 199.182.11.0 is blocked because of many connection errors; unblock with
'mysqladmin flush-hosts'
A mensagem acompanha um comando 'mysqladmin flush-hosts. Infelizmente, somente um
administrador geral pode realizar este comando. Planos abaixo do Java EE/PHP Plus devem
solicitar o nosso desbloqueio administrativo.
Para pedir ajuda, se estiver vendo este erro por conta de seu acesso remoto, com o comando
administrativo, envie email para suporte@integrator.com.br, informando o site e mostrando o
referido problema no corpo da mensagem.
*Por remotamente dizemos da sua mquina local de desenvolvimento ou acesso externo
a Integrator. No considere remotamente por seu aplicativo, que executa no servidor da
Integrator.
166
Exceo no PostgreSQL
Se% o% seu% plano% permitir% banco% de% dados% dedicado,% poder% acessar% o% PostgreSQL%
remotamente.%Veja%detalhes%de%acesso%no%email%de%assunto%ConJiguraes%de%Acesso%ao%
Banco%de%Dados%que%receber%caso%seja%seu%plano%com%tal%servio.
167
O%erro%mais%comum%de%OutOfMemoryError:%Java%heap%space%%falta%de%memria%no%
servidor%Java%para%executar%o%aplicativo.
Para%resolver:
1)%VeriJique%a%necessidade%real%de%seu%aplicativo%perante%o%plano%que%escolheu
2)%Se%houver%mais%de%um%aplicativo,%remova%todos,%deixe%apenas%1%e%v%acrescendo%cada%
aplicativo%at%que%o%erro%ocorra
IMPORTANTE:*O%suporte%da%Integrator%no%resolver%de%outra%forma,%que%no%seja%
oferecendo%um%plano%com%mais%memria.%
168
Uso do HTTPS
Uma%dvida%comum%que%ocorre%na%Integrator%%o%uso%do%HTTPS.
Temos%duas%situaes%de%uso%de%HTTPS:
Painis%e%E\mail
Domnio
169
HTTPS em Painis
O%SSL%nos%painis%e%no%e\mail%so%autoassinados,%ou%seja,%pertencem%ao%painel%de%
controle%e%no%so%reconhecidos%pelo%browser.
Para%saber%mais%veja%o%tpico%%O%https%do%WHM/cPanel%ou%NGasi%.
170
HTTPS em Domnio
O%SSL%em%seu%domnio%depende%de%duas%situaes:
1.%IP%dedicado%\%contratado%separadamente%com%valor%mensal%mnimo
2.%SSL%Homologado%\%emitido%por%uma%certiJicadora%reconhecida
171
128bits ou 256bits
O certificado digital SSL gerado com uma chave de 2048 bits. Essa informao pode ser
conferida nos detalhes do certificado. Por exemplo, no navegador Google Chrome, possvel
identificar com um clique no cadeado Conexo Informaes do certificado Detalhes
Campos do certificado Informaes de Chave Pblica Tamanho da Chave.
A informao de 128 bits ou 256 bits designada pelo navegador no momento em que acessa
o site, e sua conexo com um site obtido em HTTPS por um alto nvel, da seguinte forma:
O servidor responde enviando seu certificado ao cliente, ou seja, para o navegador que
est usando, contendo sua chave pblica.
O navegador verifica o certificado informado, reconhecido por ele, para saber se ele
vlido e extrai a chave pblica corretamente.
172
O navegador ento gera uma chave aleatria para ser usada na conexo com o
servidor. Essa chave aleatria criptografada usando a chave pblica recebida
anteriormente, e o resultado enviado para o servidor novamente.
O servidor recebe a chave criptografada e a descriptografa usando sua chave privada esse modo de operao chamado de "troca de chave" - key exchange.
A chave aleatria criada pelo navegador pode ser gerada de formas diferentes,
dependendo das bibliotecas de criptografia instaladas no computador do usurio e seu
processo automatico ocorre no navegador de forma transparente a voc. As duas
possibilidades mais comuns so:
173
Se o seu site apresentar junto ao cadeado da imagem, uma exclamao no SSL, no significa
que o SSL est mal configurado.
O erro apresentado porque certas partes de seu site no foram criptografados pelo SSL.
Se pedir para ver os detalhes da Conexo, haver um informativo do porque no foi possvel
criptografar tudo.
Infelizmente, uma situao que somente o desenvolvedor do site pode resolver. Este erro,
caso no seja voc o desenvolvedor, dever ser apresentado a ele.
A questo somente ser resolvida se analisar o aplicativo que envolvido no site, buscando
endereos que no esto dentro do seu servio ou com acesso de outros domnios, cujo o SSL
no alcana.
174
Existem%vrios%erros,%comuns,%encontrados%na%Hospedagem%da%Integrator.%Eles%so%
divididos%em%duas%classes:
1.%PHP%\%Erros%de%servidor%Apache
2.%Java%\%Erros%de%servidores%Java
175
Erros Gerais
Existem%dezenas%de%erros%em%uma%hospedagem.%Neste%tpico%listamos%os%mais%comuns:
Permisso
Bloqueio
Aplicativo
E\mail
176
Erro 500
O%erro%mais%comum%de%permisso%%o%erro%500.%Este%erro%ocorre%porque:
1.%Possui%um%.htaccess%com%sintaxe%errada
2.%Mudou%a%permisso%do%diretrio%public_html%fora%a%755
3.%Recriou%o%diretrio%public_html%%(Mudou%a%permisso%do%Grupo%nobody)
3.%Criou%um%php.ini%personalizado%com%erros
4.%Arquivos%principais%como%index.php%com%permisso%diferente%da%644
177
Para%resolver%o%Erro%500%alguns%passos:
1.%Renomear%o%.htaccess%com%o%FTP%para%.htaccess.old
2.%Recolocar%a%permisso%no%public_html%para%755
3.%Recolocar%a%permisso%em%qualquer%diretrio%para%755
4.%Se%apagou%o%public_html,%informar%ao%suporte@integrator.com.br%sobre%o%incidente
3.%Renomear%o%php.ini%para%php.ini.old
4.%Recolocar%a%permisso%do%index.php,%como%de%outros%arquivos,%para%644
178
Erro 503
Este%erro%signiJica%que%seu%servidor%Java%est%parado.%%Entre%no%painel%Java%e%o%inicie.
179
A%possvel%situao%%que%alterou%o%arquivo%de%conJiguraes%do%servidor%Java%alterando%
sua%porta.%Isso%causou%falha.
Para%resolver,%devolva%as%conJiguraes%originais.%Caso%no%saiba,%ter%que,%infelizmente,%
reinstalar%o%arquivo%de%conJiguraes.
Abaixo%os%arquivos%que,%se%alterar%portas,%ter%problemas:
Tomcat%\%server.xml
JBoss%7/WildJly%\%standalone.xml
GlassFish%\%domain.xml
IMPORTANTE:* * Caso% seja% a% primeira% vez% que% ocorre,% ou% seja,% assim% que% mapeou% o%
servio% e% o% iniciou,% este% erro% apareceu,% chame% o% suporte@integrator.com.br% para%
investigar,%pois%pode%ter%ocorrido%algum%problema%na%conJigurao%do%servidor%Java%em%
relao%ao%seu%domnio.
180
O Erro 404
O%erro%404%%no%encontrado.%Cada%servio%tem%uma%forma%de%resolver:
PHP%\%veriJique%se%est%acessando%corretamente.%
Java%\%veriJique%se%fez%o%mapeamento%no%seu%domnio%corretamente
181
O%erro%404%no%PHP%pode%ter%como%causa%comum%a%conJigurao%que%fez%em%seu%
aplicativo.
Problemas%comuns%relatados%para%ajudar:
Mod_Rewrite%\%Mapeamento%no%.htaccess%incorreto%para%URL%Amigveis%
Falta%de%arquivo%\%Falta%do%arquivo%index.php%ou%conJigurao%incorreta%de%
mapeamento%do%index%personalizado%no%.htaccess
IMPORTANTE:* * O% suporte% da% Integrator% no% resolve% problemas% de% aplicativo% e% nem%
ensina% a% corrigir% .htaccess% com% mod_rewrite% personalizado.% Tais% situaes% so%
consideradas%de%desenvolvimento%ou%ensino%e%fogem%ao%quesito%hospedar%um%site.
182
O% erro% 404% no% Java% pode% ter% como% causa% comum% a% conJigurao% que% fez% em% seu%
aplicativo.
Problemas%comuns%relatados%para%ajudar:
Mapeamento%no%NGasi%\%ConJira%o%nome%que%deu%no%seu%WAR%Jile%para%o%que%fez%
de%mapeamento%no%NGasi.
Acesso%Incorreto%\%Iniciantes%costumam%executar%aplicativos%Java%por%programas%
como%Eclipse,%sem%se%dar%conta%da%falta%de%um%index.%Casos%como%index.jsf%em%vez%
de% um% index.jsp% reconhecido% pelo% servidor% Java% automaticamente,% causam% erro%
404%sem%que%o%usurio%perceba.
A%forma%correta%de%resolver%%baixando%os%logs%do%servidor%Java%pelo%FTP%e%analisando%
sempre.
IMPORTANTE:* * O% suporte% da% Integrator% no% resolve% problemas% de% aplicativo.% Tais%
situaes%so%consideradas%de%desenvolvimento%ou%ensino%e%fogem%ao%quesito%hospedar%
um%site.
O%erro%de%criao%de%tabelas%no%PostgreSQL%com%o%usurio%incorreto%%um%problema%
comum.%O%correto%%realizar%a%criao%das%tabelas%como%ensinamos%no%tpico%Usurio%
PADRO%do%PostgreSQL%no%Painel%.%
Para%resolver,%veja%o%tpico%Erro%de%Permisso%no%PostgreSQL%%em%diante.
183
Existem%muitos%erros%em%um%servidor%java.%Neste%tpico%listamos%apenas%os%mais%
comuns:
PermGen
OutOfMemoryError:%Java%heap%space
Proxy%Error
184
A% JVM% separa% uma% rea% Jixa% de% memria% no% momento% da% inicializao,% chamada% de%
Permanent% Generation% (PermGen)\% % Gerao% Permanente% \% onde% so% armazenados% os%
objetos%estticos,%objetos%de%reJlexo%(Class,%Method%e%Field),%objetos%de%ClassLoader%e%
Pool% de% Strings.% Como% esta% rea% de% memria% no% costuma% ter% muitas% atualizaes,% os%
objetos% costumam% demorar% para% serem% desalocados% da% memria.% % Vrios% deploys%
consecutivos%costumam%gerar%muita%sujeira%e%esta%vai%sendo%acumulada%na%PermGen.
Esse%espao%%independente%do%Java%Heap%Space,%a%memria%oJicial,%conJigurada%por%ns,%
tendo%alocaes%distintas.%%Por%padro,%a%rea%utilizada%para%o%PermGen%%64mb.%Quando%
essa%rea%de%memria%atinge%um%limite,%o%seguinte%erro%%gerado:
java.lang.OutOfMemoryError:%PermGen%space
Como% este% % o% erro% mais% comum,% voc% precisa% da% ajuda% do% suport@integrator.com.br%
para%podermos%conJigurar%seu%servidor%Java%de%forma%a%adequar%seu%plano%na%memria%
PermGen%fornecida%e%permitida%a%ele.
O% Tomcat% % o% servidor% Java% mais% comum% neste% erro,% uma% vez% que% JBoss% e% GlassFish% j%
esto%com%as%conJiguraes%mximas%estabelecidas%pr\conJiguradas.
185
O%erro%mais%comum%de%OutOfMemoryError:%Java%heap%space%%falta%de%memria%no%
servidor%Java%para%executar%o%aplicativo.
Para%resolver:
1)%VeriJique%a%necessidade%real%de%seu%aplicativo%perante%o%plano%que%escolheu
2)%Se%houver%mais%de%um%aplicativo,%remova%todos,%deixe%apenas%1%e%v%acrescendo%cada%
aplicativo%at%que%o%erro%ocorra
IMPORTANTE:*O%suporte%da%Integrator%no%resolver%de%outra%forma,%que%no%seja%
oferecendo%um%plano%com%mais%memria.%
186
No se trata de uma mensagem que parte diretamente do servidor Java, mas que a causa
feita por ele.
Ao navegar em seu aplicativo, digamos que se depare com o seguinte erro:
Proxy*Error
The%proxy%server%received%an%invalid%response%from%an%upstream%server.
The%proxy%server%could%not%handle%the%request%GET&/.
Reason:%Error*reading*from*remote*server
Additionally,%a%502%Bad%Gateway%error%was%encountered%while%trying%to%use%an%
ErrorDocument%to%handle%the%request.
O erro de Proxy apresentado dado pelo servidor Apache. Para entender como funciona a
hospedagem, resumimos em trs pontos:
1) Apache responde a todas as requisies de sites na porta 80
2) Cada servidor Java possui uma porta definida em suas configuraes
3) O Apache faz o roteamento da 80 para a porta do servidor Java que opera pelo seu mdulo
chamado "mod_proxy"
O Proxy Error ocorre quando o mod_proxy continua chamando o servidor Java, mas a
resposta deste servio no ocorre. O Apache no sabendo o que responder gera o erro.
O que deve analisar:
1) Analisar os logs - Severos erros geram problemas na performance e no servidor Java
2) Tempo de resposta a uma requisio demasiadamente grande - O Apache configurado
para 5 minutos no mximo
3) Memria do servidor Java estourou - Erros de PermGen ou OutOfMemory podem ocorrer,
assim como especficos do aplicativo
Como resolver:
1) Modificar o aplicativo para ser mais responsivo
2) Na falta de memria, adicionar mais memria ao servidor Java contratando o servio, caso
opere em uma memria contratada padro de um plano de hospedagem
3) Aumentar o tempo de resposta que o Apache exige, desde que esteja em uma hospedagem
de mquina virtual dedicada
187
188
Existem%alguns%erros%comuns%de%operao%com%o%banco%de%dados%MySQL%ou%PostgreSQL%
que%vamos%list\los%aqui.
1.%Erro%de%Permisso%no%MySQL%ou%PostgreSQL
2.%Banco%de%dados%existente%aps%excluir%no%MySQL%ou%PostgreSQL
3.%Erro%de%Broken%Pipe%ou%Communications%link%failure
189
190
1.1. Se aparecer vazio como da imagem acima, adicione mais abaixo o usurio ao banco de
dados:
2. Outra possibilidade seria a sua chamada estar procurando o banco de dados com nome
diferente do que existe a tabela.
3. A terceira e ltima possibilidade, seria sua query buscar por uma tabela escrita em
MAISCULAS, mas elas terem sido criadas em minsculas no nome, ou vice-versa.
191
Todo objeto criado localmente, pelo phpMyAdmin, por exemplo - View, Functions e
Procedures - que no estiverem com o DEFINER informado, sero gerados com o usurio em
condio de acesso local somente.
O Exemplo mostrado abaixo para entender como se faz a permisso para acesso local de
determinado usurio - que deve ser considerado ao realizar o seu teste, colocando o seu do
cPanel.
1. A Tabela de exemplo:
create table teste (id int not null primary key auto_increment, data date);
2. A procedure de exemplo, onde o USUARIO o seu usurio do cPanel:
DELIMITER $$
CREATE DEFINER=USUARIO@localhost' PROCEDURE `inserir`(data date)
BEGIN
INSERT INTO teste VALUES (NULL,data);
END $$
DELIMITER ;
3. Testando a procedure na hospedagem, seria assim:
call inserir('2012-12-12');
192
tcnico que deve ser obrigao do desenvolvedor conforme reza nosso contrato.
193
Remova onde o criou e recrie da forma correta, ou seja, se criou remotamente, remova
remotamente e o recrie com o DEFINER como citamos em Erro de Permisso ou Privilgio
em Functions, Views e Procedures .
Se no entender bem do MySQL, e quer criar um objeto com permisso local, simplesmente
remova o remoto e recrie no phpMyAdmin, que mesmo sem o DEFINER, ele criar
localmente como permisso do usurio.
194
Quem opera criando tabelas atravs do aplicativo Java, usando JPA, Hibernate ou JDBC
diretamente, deve:
1. No criar usurio no cPanel e nem atribuir ele ao Banco de Dados
2. Usar o usurio do cPanel/FTP para se conectar ao Banco de Dados
195
Se voc criou tabelas, ou outros objetos, atravs do aplicativo Java, usando JPA, Hibernate ou
JDBC diretamente, e no usou o usurio do cPanel/FTP, deve realizar os passos abaixo para
resolver:
1. Faa um backup via SSH usando o mesmo owner que criou as tabelas, mas retirando-o do
backup. O comando que deve ser realizado:
pg_dump -i BANCO_DE_DADOS>ARQUIVO_BKP.sql -U USUARIO --no-owner
Onde temos:
BANCO_DE_DADOS - nome do seu banco de dados
ARQUIVO_BKP.sql - nome do arquivo de backup do banco de dados completo
USUARIO - o usurio que utilizou para gerar as tabelas/objetos pelo seu aplicativo
2. Suba o backup em um segundo banco de dados criado no cPanel usando o owner do
cPanel. O comando que deve ser realizado:
psql BANCO_DE_DADOS_NOVO<ARQUIVO_BKP.sql -U USUARIO_CPANEL
USUARIO_CPANEL - use o usurio do cPanel neste caso
3. Confira tudo, veja se est ok com o owner e se consegue manipular pelo phpPgAdmin
4. Pare o servio Java caso ele esteja conectando ao banco de dados que est com problemas
5. Remova o banco de dados com problema atravs do cPanel.
6. Recrie novamente o mesmo banco de dados removido pelo cPanel,
7. Suba via SSH o backup no banco de dados que foi removido e recriado
psql BANCO_DE_DADOS<ARQUIVO_BKP.sql -U USUARIO_CPANEL
8. Mude a sua conexo de internet, se usar o Hibernate/JPA para criar objetos, usando o
usurio do cPanel
9. Suba o aplicativo Java com a conexo alterada e refaa o deploy do seu aplicativo para
obter a conexo correta da prxima vez que operar, iniciando o servidor Java novamente.
196
Excluir um banco de dados com conexo persistente, ativa, usual em aplicativos Java, causa
este erro. O cPanel apresenta como excludo mas, no servidor de banco de dados, a operao
no foi realizada.
Como resolver:
1. No MySQL ou PostgreSQL, tente parar o servidor Java e verificar se, aps isso, o banco
foi excludo tambm no servidor de banco de dados.
2. Se o passo 1 no resolver, entre em contato com o suporte@integrator.com.br relatando:
Domnio que est seu servio ou Domnio principal que o identifica na Integrator
197
198
Validao da Conexo
testOnBorrow = true - valida antes de ser usado no pool. Se no validar,
ele ser retirado do pool, sendo pego outro.
validationInterval = 34000 - usado para evitar o excesso de validao ,
apenas executar a validao no mximo nesta frequncia - tempo em
milissegundos . Se uma conexo est prevista para a validao , mas j foi
validado anteriormente neste intervalo, no ser validado novamente .
Quanto maior o valor, melhor o desempenho, mas voc aumenta a chance de
uma conexo antiga estar sendo requisitada.
validationQuery = SELECT 1 - consulta o MySQL usando esta simples
query para validar conexes do pool antes de apresenta-las ao aplicativo.
Vazamentos de Conexo
Existem vrias definies de configurao para ajudar a detectar vazamentos
de conexes, ajudando a resolver possveis leaks:
removeAbandoned = true remove conexes abandonadas se excederem
o removeAbandonedTimeout . A conexo considerada abandonada e
elegveis para retirada do pool. Conexes em banco de dados, desta forma,
podem ser recuperadas a partir de aplicaes que no conseguem fechar
uma conexo.
removeAbandonedTimeout = 54 - tempo limite em segundos antes que
uma conexo seja considerada abandonada e elegvel para ser removida.
validationQuery - Vide explicao anterior.
199
Entre%no%terminal%SSH%e%execute%o%comando%abaixo:
ps*cu*TU*USUARIO_FTP*|*awk*'{*print*$2*"*"*$11*}'*|*grep*java
Onde%USUARIO_FTP%%o%usurio%do%FTP%que%est%executando%o%servidor%Java.
Pegue%o%nmero%que%%apresentado%do%servidor%Java%e%mate%o%processo%assim.%
kill*T9*NUMERO
Digite%o%nmero%do%PID%que%apareceu%no%comando%acima%e%pressione%ENTER.
%%e%aguarde%iniciar.
200
Veja%o%tpico%Problema%ao%instalar%um%aplicativo%no%Fantastico%De%Luxe%%deste%manual.
201
Os passos abaixo so para o GlassFish 3.x, instalado em diretrio default pelo NGasi.
Antes de comear, exigido um pequeno conhecimento em shell. necessrio acessa o SSH
com seu usurio para executar os passos. Caso no saiba como operar, a recomendao
reinstalar o servidor GlassFish e reconfigurar seu aplicativo.
1) Deixe o GlassFish parado
~/appservers/glassfish-3x/bin/./asadmin.sh stop-domain domain1
2) Retire o antigo autenticador cujo a senha se perdeu:
mv ~/.asadminpass ~/.asadminpass.bk
3) No SSH, faa um backup do seu atual domain1:
~/appservers/glassfish-3x/bin/./asadmin.sh backup-domain
domain1
4) Verifique a porta do GlassFIsh admin, anotando o nmero que aparecer, entre aspas, com o
comando abaixo:
cat ~/appservers/glassfish-3x/domains/domain1/config/
domain.xml | grep 'network-listener port' | grep adminlistener | grep admin-thread-pool| awk -Fport= '{print $2}'
4.1) Digamos que o resultado foi:
"8395" protocol="admin-listener" trans
4.2) O nmero 8395
5) Crie um segundo domain com a porta encontrada:
~/appservers/glassfish-3x/bin/./asadmin.sh create-domain -adminport 8395 domain2
6) Atribua a senha para o admin aps a pergunta no SSH. As perguntas comeando ao admin
(coloque admin)
- Digite o nome de usurio admin [Pressione a tecla Enter para
aceitar o default "admin" / sem senha]> admin
- Digite a senha admin [Pressione a tecla Enter para aceitar o
default de nenhuma senha]>
- Digite a senha admin novamente>
7) Copie os arquivos de autenticao do domain2, que possui a nova senha, para o domain1,
cujo perdeu:
cp ~/appservers/glassfish-3x/domains/domain2/config/
202
cacerts.jks \
~/appservers/glassfish-3x/domains/domain2/config/admin-keyfile
\
~/appservers/glassfish-3x/domains/domain2/config/keyfile \
~/appservers/glassfish-3x/domains/domain2/config/keystore.jks
\
~/appservers/glassfish-3x/domains/domain1/config/
IMPORTANTE:*O%suporte%da%Integrator%no%resolver%estes%passos%para%o%usurio.%%de%
total%responsabilidade,%assim%que%alterada%a%senha,%guardar%em%local%seguro%para%no%
esquecer%um%lembrete.%
203
Existe um tipo de problema que para muitos desenvolvedores incomum: Thread Leaks. A
caracterstica mais comum, de threads abertas ao mximo, sem ter como o servio Java de
abrir novas, uma pgina em branco ou, aps alguns minutos aparecer um erro no browser
de tempo esgotado - Timeout.
Alguns servidores como o Jetty pode se comportar simplesmente no servindo o contedo e
sim indexando as pginas e arquivos dentro do diretrio de aplicativos.
Muitos%usurios%percebem%sempre%que%volta%a%funcionar%aps%reiniciar%o%servidor%Java,%
sem%entender%a%causa.
Estes problemas no tem uma soluo nica e cada aplicativo apresenta em seus logs erros
que formam a situao. Cabe ao desenvolvedor, ao se deparar com o problema, baixar os logs
e analisar todos os erros, antes mesmo de reiniciar o servio Java.
IMPORTANTE:*O%suporte%da%Integrator%no%analisar%os%logs%para%os%usurios,%muito%
menos%dar%dicas%para%solucionar%a%causa.%%Aplicativo%desenvolvido%por%empresa/pessoa%
que%no%opera%mais%em%manuteno%do%mesmo,%deve%ser%ainda%assim%acionada%para%
resoluo%da%causa,%j%que%se%trata%de%uma%correo%para%um%problema%no%visto%no%
desenvolvimento.
204
IMPORTANTE:*O%suporte%da%Integrator%no%analisar%os%logs%para%os%usurios,%muito%
menos%dar%dicas%para%solucionar%a%causa.%%Aplicativo%desenvolvido%por%empresa/pessoa%
que%no%opera%mais%em%manuteno%do%mesmo,%deve%ser%ainda%assim%acionada%para%
resoluo%da%causa,%j%que%se%trata%de%uma%correo%para%um%problema%no%visto%no%
desenvolvimento.
205
Veja detalhes sobre este erro em Erro comum: Host is blocked because of many connection
errors .
206
Existem alguns erros comuns no envio de email que fornecemos as solues mais prticas
neste captulo.
importante ressaltar que alguns erros so de natureza puramente do programa que est
usando para submeter emails e nem sempre nosso suporte consegue alcanar a resposta certa
para o problema de imediato.
207
Existem erros ao enviar emails usando o Outlook. Provavelmente, quando voc copia e cola
os endereos de e-mail no campo Para, ou os chama, estes incluem aspas ao seu redor que o
servidor no sabe como lidar, por exemplo: 'nome@site.com.br' em vez de apenas
nome@site.com.br.
Remova as aspas e tente enviar o email novamente.
208
Tente os passos a seguir caso seu Outlook seja 2010 - pode funcionar em verses superiores
ou 2007:
1. Boto direito do mouse sobre "Itens Enviados"
2. Propriedades
3. Marcar "mostrar nmero total de Itens"
4. Desmarcar Gerar modos de exibio Microsoft Exchange
O endereo abaixo pode ser consultado para dvidas e solues sobre esta questo:
http://support.microsoft.com/kb/184059/pt-br
IMPORTANTE: Caso o endereo que a Microsoft fornece for alterado, nos informe no
suporte@integrator.com.br para atualizarmos o manual.
209
210
O erro "Retry timeout exceeded" retornado pelo servidor de email, Exim, indica que o
servidor tentou enviar o email ao destinatrio, mas falhou.
Depois de uma certa quantidade de tentativas falhas para entregar um determinado e-mail, o
servidor envia a mensagem que ir adicionar o ID da mensagem para um banco de dados
especfico do servio. As mensagens neste banco de dados no esto inclusas no prximo
ciclo de tentativas em transmitir mensagens de e-mail. Depois de um perodo de tempo, as
mensagens no banco de dados so re-enviadas, em uma nova rodada de tentativas de
transmisso. Este processo continua at que se atinge um ponto de falha, onde o servidor no
tentar enviar a mensagem. Aps as tentativas de entregar a mensagem esgotadas, voc
poder ento ver a mensagem de devoluo com um retorno de erro: Retry timeout
exceeded.
211
Vrios motivos causam esta falha. Todos so referentes ao local para onde envia, sendo os
principais:
Caixa de email lotada - usurio no tem espao adicional para receber sua mensagem
Porta do SMTP bloqueada - a porta de comunicao SMTP no funciona
Filtro antispam - seus emails so bloqueados pelo servidor para o qual envia
Roteamento da rede com falhas (problemas de DNS) - erro de DNS do domnio para o
qual envia
Problemas de caixa lotada ou antispam, a empresa para o qual envia conseguir resolver
facilmente se conseguir se comunicar com eles a respeito do assunto. Porm, problemas com
porta do SMTP ou falhas de DNS, podem demorar mais tempo, pois a empresa ao qual est
submetendo emails pode estar passando por instabilidades ou mudanas de configuraes no
qual esto propagando ou precisam ser resolvidos pela equipe tcnica deles.
Para nossa ajuda, envie sempre o email de falha para suporte@integrator.com.br para que
nossa equipe tcnica especilizada seja escalada para anlise e ajuda com o problema.
212
O SVN
Para% usar% o% SVN% no% servidor,% ser% necessrio% mudar% de% tema.% Infelizmente,% o% tema%
padro%do%painel%de%controle%no%possui%suporte%direto%ao%assistente%do%SVN.
IMPORTANTE:%O%SVN%usa%o%protocolo%svn://%e%tem%o%repositrio%completamente%
criado%dentro%do%usurio.%
%
213
Inicialmente,%precisamos%mudar%o%tema%do%painel%para%ter%acesso%ao%cone%do%SVN.%Veja%
abaixo%os%passos:
1)%Para%mudar%de%tema,%v%em%Preferncias* *RVSkin*Theme*Changer:
2)%Selecione%o%tema%rvneo%e%conJirme%no%boto%Change:
Assim% que% trocar% de% tema,% desa% a% rolagem% e% encontrar% em% Programa* * Subversion*
and*Trac*Manager%o%SVN:
214
Ao%entrar%no%painel%do%Subversion,%execute%estes%passos:
1)%Habilite%o%SVN%clicando%em%Activate*Now:
2)%Assim%que%ativar,%desa%a%rolagem%at%o%Jim%e%clique%em%Go*to*Management*
Subversion*and*Trac*NOW:
3)%Para%conJigurar%uma%conta%%no%SVN,%crie%um%Grupo:
4)%Assim%que%criar%o%grupo,%mais%abaixo,%adicione%um%usurio:
215
6)% Ainda% em% Subversion* Management,% voc% pode% gerir% os% privilgios% do% grupo,%
clicando%em%Subversion*Privileges*Management:
6.1)%Em%
%Add*Privileges,%%voc%pode%adicionar%o%privilgio%ao%repositrio:
Se%desejar%remover%um%repositrio,%clique%em%
%
%
216
Antes% de% mais% nada,% s% teste% se% o% seu% domnio% estiver% apontando% para% o% servidor% da%
Integrator.
Depois% de% adicionado% seu% repositrio,% usurio% e% senha,% teste% seu% acesso% usando% um%
programa%como%o%Eclipse,%por%exemplo.
1)%No%Eclipse,%podemos%testar%indo%em%File* *Import.%%Na%janela%Import,%selecione%SVN%
%Checkout*Projects*from*SVN%e%conJirme%no%boto%Next.
2)%Na%prxima%etapa%selecione%Create*a*new*repository*location.
217
3)% Na% etapa% seguinte,% em% URL,% coloque% o% endereo% apresentado% em% Subversion*
Management.%Por%exemplo:
4)% Ao% solicitar% o% usurio% e% a% senha,% coloque% aquele% que% cadastrou% neste% repositrio.%
Prossiga%at%que%seja%concludo.
IMPORTANTE:%A%Integrator%no%ensina%a%operar%o%SVN.%A%demonstrao%ilustrada%neste%
tutorial%%apenas%um%teste%e%no%responderemos%sobre%problemas%de%sua%operao%local,%
uma%vez%que%foge%a%hospedagem%e%entra%no%quesito%ensino.%
218
Para%realizar%um%backup/dump%do%repositrio%SVN:
1)%Entre%no%SSH%com%seu%usurio%e%senha%do%cPanel.
2) Realize o dump com a linha de comando no SSH:
svnadmin dump ~/rvsubversion/repository/ > ~/svn.dump
O comando do passo 2) criar um arquivo chamado svn.dump dentro do usurio de sua conta.
Se precisar baixar via FTP, ao logar o encontrar junto a arquivos e diretrios. Ele gerado
no mesmo "nvel" de arquivos dos diretrios: public_html, mail e etc.
IMPORTANTE:%A%Integrator%no%ensina%a%operar%o%SVN.%A%demonstrao%neste%tutorial%%
apenas%um%exemplo%e%no%responderemos%sobre%problemas%de%sua%operao%local,%uma%
vez%que%foge%a%hospedagem%e%entra%no%quesito%ensino.%
219
Para%realizar%a%recuperao%do%backup/dump%do%repositrio%SVN:
1)%Suba%para%o%seu%usurio%o%dump%do%seu%SVN.%Para%exemplo,%subimos%o%nosso%backup%
com%um%arquivo%chamado%de%"svn.dump".
2)%Entre%no%SSH%com%seu%usurio%e%senha%do%cPanel.
3) Realize a recuperao do dump com a linha de comando no SSH:
svnadmin load ~/rvsubversion/repository/ < ~/svn.dump
IMPORTANTE:%A%Integrator%no%ensina%a%operar%o%SVN.%A%demonstrao%neste%tutorial%%
apenas%um%exemplo%e%no%responderemos%sobre%problemas%de%sua%operao%local,%uma%
vez%que%foge%a%hospedagem%e%entra%no%quesito%ensino.%
220
O%SVN%%um%servio%particular,%de%servidor%SVNServe%que%sobe%no%usurio%de%sua%conta.%
Como% existem% alguns% erros% que% so% de% natureza% impossvel% de% serem% solucionadas,%
nossa%recomendao%%de%backup%do%svn%caso%tenha%erro%e%recriao%do%repositrio.
IMPORTANTE:%A%Integrator%no%ensina%a%operar%o%SVN.%A%demonstrao%neste%tutorial%%
apenas%um%exemplo%e%no%responderemos%sobre%problemas%de%sua%operao%local,%uma%
vez%que%foge%a%hospedagem%e%entra%no%quesito%ensino.%
221
O GIT
O%GIT%trabalha%via%SSH,%j%ativo,%por%padro,%nos%servidores%da%Integrator.%O%que%
apresentaremos%a%seguir%%um%exemplo%de%como%us\lo.
Para%criar%um%%repositrio%GIT,%de%dentro%da%sua%conta,%no%servidor,%em%seu%domnio,%%
atravs%do%SSH,%faa%os%seguintes%passos:
1) Crie%o%diretrio%do%repositrio,%por%exemplo:
a. mkdir%\p%repo/nome_projeto.git
b. cd%repo/nome_projeto.git
c. git%\\bare%init
2) Saia%do%SSH%que%est%logado%no%servidor.
3) Em%sua%mquina%local,%no%seu%computador,%crie%um%repositrio%GIT,%escolhendo%o%
projeto%que%deseja%trabalhar%com%esta%ferramenta%.
Nota:%O%GIT%pode%trabalhar%com%o%Eclipse%IDE,%usando%o%plug\in%EGit:
http://wiki.eclipse.org/EGit/User_Guide
IMPORTANTE:%A%Integrator%no%ensina%a%operar%o%GIT.%A%demonstrao%passada%neste%
tutorial%%apenas%um%exemplo%de%seu%uso.%
%
Para Desenvolvedores
Este% tpico% foge% ao% padro% de% um% servio% de% suporte% de% hospedagem% pois% envolve%
questes%tcnicas%de%habilidade%e%conhecimento%do%desenvolvedor.
As% informaes% que% encontrar% no% possuem% nosso% suporte% para% anlise% ou% veriJicao%
de%erros,%seja%de%qual%natureza%for.
O% responsvel% pelo% conhecimento% de% adoo% das% informaes% aqui% contidas,% junto% a%
documentao%do%servio%que%deseja%operar,%%do%desenvolvedor.
IMPORTANTE:% O% tpico% envolve% ensino,% mas% com% base% de% endereos% de% sites% de%
terceiros%em%alguns%casos.%No%nos%responsabilizamos%por%ensinar%desenvolvedores%que%
operam%em%suas%mquinas%apenas%por%plugins%de%softwares%como%Eclipse%ou%NetBeans.%
Se%a%sua%necessidade%for%de%aprendizado,%recomendamos%um%bom%frum%ou%uma%escola%
222
adequada%de%ensino%de%desenvolvimento.
1)%Baixe%o%Axis2%em:
http://axis.apache.org/axis2/java/core/download.cgi
Os%passos%seguintes%seguem%as%regras%abordadas%no%tpico%Subindo%o%aplicativo%no%
Tomcat%.
2)%Pare%o%Tomcat
3)%Coloque%o%axis2.war%dentro%do%diretrio%appservers/apache\tomcat\Xx/webapps.
4)%Inicie%o%Tomcat
Os%passos%seguintes%so%ensinados%no%manual,%visto%no%ltimo%passo%informado%abaixo.
5)%Acesse%o%axis2%pela%URL%do%seu%domnio,%algo%como:
http://seusite.com.br/axis2
6)%Use%o%link%Validate%para%veriJicar%se%est%executando%corretamente.
7)%Veja%mais%instrues%de%uso%do%Axis2%no%endereo:
http://axis.apache.org/axis2/java/core/docs/installationguide.html#servlet_container
IMPORTANTE:*Caso%o%Tomcat%no%esteja%na%raiz%do%domnio,%faa%o%mapeamento%do%
aplicativo%axis2%no%Ngasi.
Enviando E-mails
Uma% dvida% comum% de% desenvolvedores% na% Integrator% % o% envio% de% emails.% Operamos%
com% Java% e% PHP% oJicialmente,% logo,% os% exemplos% contidos% aqui% so% nestas% duas%
223
linguagens.
Envios%que%fujam%as%regras%bsicas,%como%as%citadas%logo%abaixo,%no%possuem%garantia%
alguma% de% seu% funcionamento.% Pedidos% de% suporte% desta% natureza,% com% alegaes% de%
funcionamento% anterior% diferindo% das% conJiguraes% alertadas,% so% negados% como%
resposta.
Resumo%das%conJiguraes%para%envio%de%email%online%em%aplicativos%Web%hospedados%
na%Integrator:
Host:%localhost
Porta:%25
Usurio%e%senha:%email%criado%e%sua%respectiva%senha%no%painel%de%controle
SSL%e%TLS:%No%deixe%nada%conJigurado%a%respeito%ou%coloque%No
Requer%autenticao:%Sim
Para%enviar%email%em%Java,%temos%um%exemplo%simples,%compactado%com%a%fonte%.java,%no%
arquivo%.war%chamado%EnviaEmail.war.
Baixe%o%exemplo%no%endereo%(arquivo%precisa%de%duas%descompactaes,%pois%est%
como%.zip%tambm):
http://wiki.integrator.com.br/index.php?title=Enviando_E\mail_em_Java
Descompacte%o%.war%com%um%programa%de%Zip%ou%Rar%que%estiver%instalado%em%sua%
mquina.%Na%descompactao,%abra%o%%arquivo%WEB-INF/classes/br/com/integrator/
Envia Email.Java%.%
Nele,%temos%as%seguintes%linhas:
props%=%System.getProperties();
props.put("mail.smtp.host",%"localhost");
props.put("mail.smtp.port",%"25");
224
props.put("mail.smtp.auth",%"true");
session%=%Session.getInstance(props,
new*Autenticar("seu_email_aqui","sua_senha_aqui")
);
Coloque%seu%email%completo,%criado%no%cPanel%e%a%respectiva%senha%dada%a%ele,%na%linha%
de%%new%Autenticar.
Resumo%das%conJiguraes%para%envio%de%email%online%informado%no%EnviaEmail.java:
Host:%localhost
Porta:%25
Usurio%e%senha:%email%criado%e%sua%respectiva%senha%no%painel%de%controle
SSL%e%TLS:%No%deixe%nada%conJigurado%a%respeito%ou%coloque%No
Requer%autenticao:%Sim
O ideal para sua segurana enviar emails autenticados, com uma boa biblioteca de PHP que
permita isso de forma fcil. Para isso, temos o PHPMailer.
Para%enviar%email%em%PHP,%temos%um%exemplo%simples,%compactado,%no%arquivo%.zip%
chamado%phpmailer.zip.
Baixe%o%exemplo%no%endereo:
http://wiki.integrator.com.br/index.php?title=Enviando_E\mail_com_PHP
Descompacte%o%.zip%com%um%programa%de%Zip%ou%Rar%que%estiver%instalado%em%sua%
mquina.%Na%descompactao,%abra%o%%arquivo%confirm.php%.%
Nele,%temos%as%seguintes%linhas%que%devem%ser%alteradas%respectivamente%para%seu%site/
domnio,%seu%email%e%senha.
$dominio = 'seudominio.com.br';
$mailfrom = "contato@$dominio";
225
$passwd = "SUA_SENHA_AQUI";
Para utilizar o exemplo:
1.%Crie%o%email%no%cPanel.
2. Se quiser baixar a ltima verso do PHPMailer, este endereo o mais indicado:
https://github.com/PHPMailer/PHPMailer
Resumo%das%conJiguraes%para%envio%de%email%online%com%PHPMailer%informado%no%
exemplo:
Host:%localhost
Porta:%25
Usurio%e%senha:%email%criado%e%sua%respectiva%senha%no%painel%de%controle
SSL%e%TLS:%No%deixe%nada%conJigurado%a%respeito%ou%coloque%No
Requer%autenticao:%Sim
226
O%Apache%permite%mudar%seu%comportamento%atravs%de%diretrizes%que%permitem%ser%
adicionadas%em%arquivos%.htaccess.
Essas%diretrizes%so%instrues%que%podem%ir%de%comportamentos%bsicos%e%simples%de%
compreender%at%mesmo%envolver%lgica%de%programao.
A%documentao%para%aprender%sobre%as%diretrizes%do%.htaccess%Jica%em:
http://httpd.apache.org/docs/2.2/pt\br/howto/htaccess.html
IMPORTANTE:%O%suporte%da%Integrator%Host%no%analisa%seu%.htaccess%personalizado%em%
casos%que%envolvam%o%comportamento%de%seu%site,%seja%pela%performance%ou%anlise%de%
URL%amigvel.%
227
O%.htaccess%(%arquivos%de%conJigurao%distribuda%\%distributed%conJiguration%Jiles)%%um%
arquivo%que%permite%realizar%mudanas%comportamentais%de%acesso%aos%arquivos%
existentes%em%um%site%servido%pelo%servidor%Apache.
O%.htaccess%%complexo%e%possui%caractersticas%que%nas%conJiguraes,%podem%exigir%
conhecimentos%de%lgica%de%programao.
Existem%alguns%motivos%para%no%usar%.htaccess:
1.%Ele%%complexo%e%exige%lgica%em%certas%diretrizes
2.%Exige%conhecimento%em%regex%pelo%usurio%para%obter%muitas%vezes%o%comportamento%
desejado
3.%Pode%inJluir%profundamente%na%performance%do%site
Para%saber%mais:
http://httpd.apache.org/docs/2.2/pt\br/howto/htaccess.html
IMPORTANTE:%O%suporte%da%Integrator%Host%no%analisa%seu%.htaccess%personalizado%em%
casos%que%envolvam%o%comportamento%de%seu%site,%seja%pela%performance%ou%anlise%de%
URL%amigvel.%
228
URL%amigvel%ou,%URLs%Amigveis,%so%a%forma%que%os%desenvolvedores%usam%para%
rescrever%um%endereo%de%site%dinmico,%geralmente%em%PHP,%da%forma%original%para%
uma%mais%amigvel%a%leitura,%tanto%para%o%endereo%no%navegador,%como%para%os%
buscadores%como%o%Google.
Por%exemplo,%digamos%que%seu%site%tenha%um%link%chamado%hospedagem,%que%%dinmico,%
onde%seu%usurio%acessaria%ele%da%forma%abaixo:
http://integrator.com.br/?p=2
Mas%os%usurios%podem%ter%diJiculdade%em%lembrar%o%endereo%todo%de%uma%vez,%ou%at%
mesmo%memorizar%na%barra%de%endereo%qual%nmero%%a%pgina%que%desejam%ver.%Com%
o%intuito%de%facilitar,%voc%modiJica%o%comportamento%%para%que%seja%visvel%assim:
http://integrator.com.br/hospedagem
Internamente,%o%?p=2%permanece%existindo.%Mas%para%seu%usurio,%o%navegador/
browser%e%os%buscadores,%%na%realidade%hospedagem.
A%rescrita%foi%feita%pelo%servidor,%usando%recursos%de%diretrizes%existentes%no%Apache%
atravs%do%.htaccess.%Digamos%que%seja%um%truque%que%envolve:
1.%Lgica%de%programao
2.%Conhecimento%de%regex.
Exemplo:
Um%site%contendo%o%seguinte%contedo:
http://integrator.com.br/hospedagem.php?plano=1
E%deseja%deixar%ao%seu%usurio%visvel:
http://integrator.com.br/hospedagem/plano\php\basico
Teria%um%.htaccess%assim:
RewriteEngine%On
RewriteBase%/
ErrorDocument%404%/404.php
RewriteRule%^hospedagem\/plano\php\basico$%%/hospedagem.php?plano=1%[NC,L]
J%existem%casos%mais%complexos,%que%precisam%operar%em%Regex,%por%exemplo,%digamos%
que%a%URL%seja:
http://integrator.com.br/edit/host/1
Temos%que%usar%uma%expresso%regular%assim:
([a\z]+)\/([a\z]+)\/([0\9]+)
O%arquivo%em%por%trs%desta%URL,%serial%algo%como:
229
http://integrator.com.br/sistema.php?act=$1&model=$2&id=$3
Onde%cada%$nmero%%o%nmero%do%grupo%em%sequncia%ao%que%foi%analisado%pela%
expresso%regular.
Para%entender%melhor%o%trecho%do%.htaccess:
RewriteRule%^([a\z]+)\/([a\z]+)\/([0\9]+)$%%sistema.php?act=$1&model=$2&id=$3%
[NC,L]
IMPORTANTE:% Sem% experincia,% procure% estudar% para% entender% o% que% pretende% fazer%
ou% ,% sempre% que% possvel,% buscar% ajuda% de% proJissional% qualiJicado% experiente% para%
instru\lo%em%como%resolver%a%questo%do%seu%programa.%O%suporte%da%Integrator%por%ser%
hospedagem,% em% momento% algum% ser% responsvel% por% tal% ajuda% de% desenvolvimento%
comportamental% particular% e% nem% resoluo% das% conseqncias% de% conJiguraes%
erradas%que%obtiver.
230
Tanto%o%MySQL,%como%o%PostgreSQL,%permitem%criar%programao%procedural%em%
formato%de%funes%dentro%de%seus%bancos%de%dados.
IMPORTANTE:% O% suporte% da% Integrator% Host% no% ensina,% no% analisa% e% nem% se%
responsabiliza%pela%falta%de%conhecimento%na%criao%de%procedures,%functions%ou%views%
em%seu%banco%de%dados,%muito%menos%na%qualidade%da%exportao%de%seu%banco%de%dados%
local,%em%arquivo,%para%upload%no%servidor%online.%
231
Para%exempliJicar,%temos%uma%pequena%tabela:
create%table%teste%(id%int%not%null%primary%key%auto_increment,%data%date);
Assim%que%criada%a%tabela,%temos%a%procedure:
DELIMITER%$$
CREATE%PROCEDURE%`inserir`(data%date)
%%%BEGIN
%%%%%%%%INSERT%INTO%teste%VALUES%(NULL,data);
%%%END%$$
DELIMITER%;
Testando%a%procedure:
call%inserir('2012\12\12');
232
Veja%na%documentao%oJicial%do%MySQL%pelo%endereo%abaixo%um%exemplo%que%funciona:
http://dev.mysql.com/doc/refman/5.5/en/create\function.html
Trecho%extrado%do%endereo%da%documentao:
mysql> CREATE FUNCTION hello (s CHAR(20))
mysql> RETURNS CHAR(50) DETERMINISTIC
-> RETURN CONCAT('Hello, ',s,'!');
Query OK, 0 rows affected (0.00 sec)
mysql> SELECT hello('world');
233
Veja%na%documentao%oJicial%do%MySQL%pelo%endereo%abaixo%um%exemplo%que%funciona:
http://dev.mysql.com/doc/refman/5.5/en/trigger\syntax.html
Trecho%extrado%do%endereo%da%documentao:
234
Veja%a%documentao%oJicial%do%MySQL%em:
http://dev.mysql.com/doc/refman/5.5/en/stored\programs\security.html
235
O%usurio%mais%experiente%pode%precisar%realizar%certas%operaes%no%painel%cPanel,%ou%
acessar%sua%conta,%de%algumas%formas%diferentes%dos%usurios%comuns.%Temos%neste%
tpico%resumido:
1)%Criao%de%novas%contas%FTP
2)%Acesso%SSH%atravs%de%terminal
3)%Criao%de%Chaves%de%Acesso%SSH%%
4)%Personalizao%dos%DNS
5)%Erros%em%PHP
6)%Compactando%contedo%com%GZip%pelo%painel%cPanel
7)%Crontab
236
Para%criar%uma%nova%conta%de%usurio%FTP,%v%em%Arquivos* *Contas*FTP.
No%formulrio,%basta%preencher%o%usurio%do%FTP,%a%senha%e%o%local%onde%ser%adicionado%
o%acesso%a%este%usurio.
237
Para%remover%a%conta%de%FTP%extra%criada,%mais%abaixo,%depois%de%criada,%existem%as%
contas%existentes.%Clique%em%Excluir.
Havero%duas%opes%para%excluso.%PreJira%Excluir*Conta,%removendo%assim,%somente%o%
acesso%ao%usurio%do%FTP%que%existia%antes.
238
Caso%tenha%apontando%a%conta%extra%de%FTP%em%um%diretrio%do%seu%servidor%Java,%por%
exemplo,%tenha%muito%cuidado%ao%excluir.%O%boto%Excluir*Conta*e*Arquivos%remover%
tudo,% sem% excees,% causando% transtornos% inclusive% para% reinstalar% o% servidor% pelo%
painel%Java,%portanto%CUIDADO.
239
Se%o%seu%plano%permitir%acesso%SSH,%existe%a%possibilidade%de%manipular%arquivos%e%seu%
banco%de%dados%particular%diretamente%por%linhas%de%comando.
Antes%de%iniciar,%precisamos%esclarecer%dois%pontos%do%acesso%SSH:
1.% O% suporte% da% Integrator% no% ensina% a% operar% em% linhas% de% comando% para% manipular%
arquivos,%o%que%exige%conhecimentos%de%Linux.
2.%No%caso%de%banco%de%dados,%o%suporte%da%Integrator%no%ensina%a%manipular%seu%banco%
de% dados,% via% linha% de% comando,% o% que% exige% conhecimento% SQL,% alm% da% interface% de%
terminal%do%Banco%de%Dados%que%est%pretendendo%operar:%MySQL%ou%PostgreSQL.
IMPORTANTE:%No%tente%operar%via%linhas%de%comando%em%nenhuma%das%duas%situaes%
citadas% neste% tpico% se% houver% pouca% experincia% de% uso.% Problemas% em% mudana% de%
permisses,%at%mesmo%excluses%indevidas,%podem%lhe%custar%horas%para%resoluo,%ou%
at%mesmo%a%cobrana%de%recuperao%de%backup.%
SSH
240
Temos% dois% tipos% padro% de% Sistema% Operacional% em% formato% de% acesso:% Unix% e%
Windows.%O%Linux%usa%o%padro%Unix.
241
1.%No%padro%Unix,%abra%o%terminal%e%execute%o%seguinte%comando:
ssh%USUARIO_FTP@SEUDOMINIO
Exemplo:
ssh%suporte@integrator.com.br
Se% o% domnio% no% estiver% ainda% apontando% para% o% servidor% da% Integrator,% use% o% IP% da%
mquina%informada%no%email%ConJiguraes%e%Instrues%de%Uso:
ssh%USUARIO_FTP@IP
Exemplo%abaixo%com%um%IP%Jictcio:
ssh%suporte@191.160.0.1
242
Windows XP/Vista/7/8
No% Windows% no% existe% um% programa% padro% do% sistema% operacional.% Neste% caso,%
recomendamos%o%Putty.%
Para usar o SSH, baixe o programa Putty no seguinte endereo:
http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html.
O Putty um executvel simples que, aps baixado, basta dar um duplo clique sobre ele.
Ao aparecer a janela de PuTTY Configuration:
Clique em Session e preencha o formulrio como mostrado na Imagem abaixo:
1. Host Name (or IP address): Digite seu domnio ou o IP do email de Configuraes
2. Deixe marcada a opo SSH
3. D um nome em Saved Sessions
4. Confirme tudo no boto Open
5. Ao clicar em Open, a tela de Prompt aparecer pedindo o usurio, que deve ser o mesmo
do seu FTP. Pressione <ENTER> no teclado para confirmar aps digitar.
6. A senha oculta, ou seja, no aparecer nem mesmo asteriscos (***). Ele pedir a senha do
seu usurio FTP. Digite-a e pressione <ENTER> no teclado.
243
serem resolvidos.
244
Para%gerar%chaves%SSH,%evitando%que%tenha%que%digitar%sua%senha%todas%as%vezes%que%
precisar%logar,%siga%estes%passos:
1)%No%cPanel,%v%em%Segurana* *Acesso*SSH/Shell.
2)%Clique%no%boto%Gerenciar*Chaves*SSH.%
3)%Na%etapa%seguinte,%clique%em%Gerar*nova*chave:
4)%Crie%a%chave:
245
5)%Depois%de%criada,%clique%em%Gerenciar*Autorizao%para%gerar%a%autorizao%para%o%
uso%da%chave%gerada.
6)%ConJirme%a%autorizao%clicando%no%boto%Authorize.
Veja%que%haver%uma%conJirmao%que%foi%autorizada:
*
7)%Baixe%as%chaves%em%sua%mquina:
246
247
Antes% de% comear,% saiba% que% est% sendo% mostrado% neste% tpico% no% tem% suporte% em%
termos% de% uso% via% sistema% operacional.% Usar% um% sistema% operacional% de% usurio,% via%
terminal,% no% % de% responsabilidade% do% suporte% da% Integrator% e% nem% mesmo% deve% ser%
cobrado%como%parte%do%mesmo.%%
Voc%estar%de%posse%de%duas%chaves/arquivos%para%utilizar%em%seu%sistema%operacional%
Linux/Mac%OS%X:
chave
chave.pub
Da%primeira%vez%ser%solicitada%a%senha%da%key.%Depois,%no%ocorrer%mais.
Coloque\os%no%diretrio%~/.ssh,%sem%aspas,%de%seu%usurio.
IMPORTANTE:*Se%voc%no%usar%os%nomes%de%chave%padro,%que%no%caso%seria%id_rsa,%ou%
deseja%armazenar%suas%chaves%em%um%caminho%diferente,%ser%necessrio%adicionar%o%
caminho%em%/usr/bin/sshTadd*para%que%o%comando%ssh%saiba%onde%encontrar%sua%
chave%(no%MacOs%X%%ssh\add%\K%~/.ssh/chave,%sem%as%aspas).%
248
Para%usar%no%sistema%operacional%Windows,%faa%os%seguintes%passos:
1)%V%em%Visualizar/Download.
2)%Digite%a%senha%da%chave%que%criou%e%clique%em%Converter:
3)%Clique%em%Fazer*Download*da*Chave:
4)%No%Putty,%expanda%em%Category:%Connection>SSH>Auth.*%Clique%em%Browse%e%
selecione%a%key%que%baixou.*
5)%ConJirme%clicando%no%boto*Open.
249
Antes% de% comear,% saiba% que% no% nos% responsabilizamos% por% suas% personalizaes.%
Corrigir%ou%apontar%nossos%DNS%conJigurados%corretamente%na%liberao%do%seu%servio%
poder%ser%cobrado.
Para%os%DNSs%comuns,%v%em%%Domnios** Editor*de*Zona*DNS*Simples*ou%Editor*de*
Zona*DNS*Avanado:
Se%for%adicionar%um%registro%DNS,%v%em%Editor*de*Zona*DNS*Avanado,%em%Adicionar*
um* Registro% e% selecione% o% Tipo,% preenchendo% os% demais% campos.% ConJirme% em%
Adicionar*Registro.
Neste%local,%so%permitidos%os%tipos:%A,%CName%e%TXT.
Para%editar%entradas%de%DNS%do%tipo%MX,%v%em%Correios** Entrada*MX:
250
251
Saiba que ter de criar os domnios e subdomnios no mesmo painel de controle cPanel, como
Domnio Suplementar. Em caso de domnios, eles devem ser criados obrigatoriamente como
suplementares. Caso no saiba realizar a criao, veja o tpico Adicionando um Subdomnio
ou Adicionando Domnios Suplementares .
O domnio suplementar, uma vez criado no cPanel, deve ser mapeado no NGasi, como Raiz,
conforme ensinamos no tpico Colocando seu aplicativo na raiz do domnio com o servidor
GlassFish .
IMPORTANTE:* Usar% muitos% aplicativos% em% um% mesmo% servidor% GlassFish% exige%
memria.%No%nos%responsabilizamos%se%ocorrer%erros%de%memria%Java%Heap%Space.
252
Configurando no GlassFish
253
254
Crie um arquivo php.ini, dentro do diretrio onde esto os arquivos PHP com este
contedo:
display_errors = Off
error_reporting = 0
Caso seja por causa da date(), timezone, exemplo para a regio de So Paulo:
date.timezone = "America/Sao_Paulo"
255
Antes de comear, saiba que esta forma de configurao no funciona para Java.
1) Ative o GZip no cPanel indo em "Software/Servios * Otimizar Site".
256
Antes de comear, saiba que no pode automatizar tarefas com servios Java independentes,
ou seja, em .JAR executando via SHELL fora do servidor Java. Se o fizer, sua conta poder
ser suspensa sem aviso prvio.
1) Entre no cPanel, v em "Avanada * Tarefas Cron".
257
258