Você está na página 1de 258

Sumrio

O Bsico do Uso no Painel


Antes de Comear
Sobre o Suporte Especializado
Servios de Atuao do Suporte
Atuao Parcial de Suporte
O que o Suporte No Ajuda
Sobre o Suporte de Programadores
Como funciona o servio PHP e HTML
O Uso do PHP Em Servidores Compartilhados
Memria e Upload de Arquivos do PHP
Local dos Arquivos PHP ou HTML
Pgina Inicial em PHP ou HTML
Resumo do Local e Pgina Inicial de Sites PHP/HTML
Uso de Processamento em PHP
Como visualizar um site PHP ou HTML sem o domnio
Cada Painel de Controle
Portas de cada painel de controle
O https do WHM/cPanel ou NGasi
O Painel de Controle WHM - Revenda
O acesso ao painel de controle WHM
Criando novos domnios como revenda de sites
Criando um Pacote de Revenda
Adicionando o cPanel para um novo Domnio
Listando Domnios da Revenda
Alterando a senha do acesso ao painel cPanel do domnio revendido
DNS Prprio em Revenda
O Painel de Controle cPanel
O acesso ao painel de controle cPanel
Permisses de Arquivos e Diretrios
Softaculous para Aplicativos OpenSource PHP
Antes de Utilizar o Softaculous
Instalando o WordPress em sua conta
Removendo um aplicativo como o WordPress
Instalando o WordPress em um subdomnio
Fantastico De Luxe para Aplicativos OpenSource PHP
Instalando o WordPress em sua conta
Removendo um aplicativo como o WordPress
Instalando o WordPress em um subdomnio
Problema ao instalar um aplicativo no Fantastico De Luxe
Usando um Programa de FTP
Usando o FileZilla
Adicionando novos Domnios no cPanel
Adicionando Domnios Suplementares
Adicionando Domnios Estacionados
Adicionando subdomnios no cPanel
Adicionando um Subdomnio
Adicionando novos Domnios no WHM
Adicionando novas contas de e-mail
Alterando a Senha ou Excluindo Contas de Email
Redirecionando Contas de Email
Acesso ao E-mail
Acesso ao E-mail pelo Webmail
Acesso ao E-mail pelo PC ou MAC

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

Acesso ao E-mail pelo Outlook 2010 - Windows


Acesso ao E-mail pelo Mail do Mac OS
Acesso ao E-mail pelo Thunderbird (Linux/Windows/Mac OS)
Sobre as regras de envio de emails
Evitando Spams com os recursos do painel
Verificando a legitimidade de um e-mails enviado
O Spam Assassin
O BoxTrapper
Traduo das Mensagens do BoxTrapper
Visualizando as estatsticas de acesso ao seu site
Personalizando as paginas de erro do Apache
Como funciona o servio Java
A memria do servidor Java
Uso de Processamento em Java
O Painel de Usurio Java
O acesso o painel NGasi
Instalando o servidor Java
Colocando o Aplicativo Java no Endereo do seu Site
Erros do cliente e direito de suporte
Acesso Java em conexo ao banco de dados
Instalando o servidor Java
Local onde o servidor Java instalado
A estrutura do servidor Java
Suas bibliotecas JAR
Compartilhando seu servidor Java em outros domnios ou subdomnios
Como mapear outro domnio ou subdomnio no painel Java
O Bsico de Uso dos Servidores Java
Sobre a exibio no domnio
Usando o servidor Java Tomcat
Subindo o aplicativo no Tomcat
Removendo o mapeamento do aplicativo no Domnio
Subindo um aplicativo na Raiz do domnio com o Tomcat
Removendo o mapeamento da Raiz no Domnio
Configurando o acesso ao Manager do Tomcat
Configurando o manager do Tomcat 7/8
Mapeando o Manager no Tomcat
Usando o servidor Java Jetty
Subindo um aplicativo na Raiz do domnio com o Jetty
Usando o servidor Java JBoss
Usando o servidor Java JBoss 7
Usando o servidor Java JBoss 7 com aplicativo na raiz do domnio
Pequeno exemplo do deploy na raiz com JBoss 7
Usando o servidor Java Wildfly
Usando o servidor Java Wildfly com aplicativo na raiz do domnio
Pequeno exemplo do deploy na raiz com Wildfly
Usando o servidor Java GlassFish
Colocando seu aplicativo na raiz do domnio com o servidor GlassFish
Aplicativo EAR na raiz com o GlassFish
Logs de Acesso do Servidor Java
Alterando o Locale: Data, hora, nmeros e moedas
Alterando o Locale do Tomcat
Alterando o Locale do GlassFish
Um mesmo servidor Java em vrios domnios
Trabalhando com o Banco de Dados
Criando Banco de Dados PostgreSQL no Painel
Usurio PADRO do PostgreSQL no Painel
Exportando no PostgreSQL do cPanel
Importando no PostgreSQL do cPanel

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

Importando no PostgreSQL Bancos Grandes


Criando Tabelas no PostgreSQL com Aplicativos
Criando Banco de Dados MySQL no Painel
Criando o usurio ao Banco de Dados MySQL no Painel
Definindo o usurio ao Banco de Dados MySQL no Painel
Formas de acesso ao Banco de Dados
Usando o phpMyAdmin para o MySQL
Usando o MySQL pelo Aplicativo Hospedado
Usando o phpPgAdmin para o PostgreSQL
Usando o PostgreSQL pelo Aplicativo Hospedado
Acesso Remoto ao Banco de Dados
Liberando o acesso remoto ao MySQL
Acessando remotamente o MySQL
Erro comum: Host is blocked because of many connection errors
Exceo no PostgreSQL
Dvidas Comuns Encontradas na Hospedagem
Uso do HTTPS
HTTPS em Painis
HTTPS em Domnio
128bits ou 256bits
Erro no certificado SSL: Elementos no criptografados
Erros Comuns Encontrados na Hospedagem
Erros Gerais
Erro 500
Resolvendo o Erro 500
Erro 503
Erro 503 com servidor Java iniciado
O Erro 404
Resolvendo o Erro 404 no PHP
Resolvendo o Erro 404 no Java
Permisso de Tabelas no PostgreSQL
Erros de Uso do Servidor Java
Resolvendo o erro PermGen
Resolvendo o erro Java heap space
Proxy Error no Acesso ao Aplicativo Java
Resolvendo erro java.lang.OutOfMemoryError: unable to create new native thread
Erros Comuns de Operao no Banco de Dados
Erro de Permisso ou Privilgio no MySQL
Erro de Permisso ou Privilgio no Usurio
Erro de Permisso ou Privilgio em Functions, Views e Procedures
Resolvendo erro de Privilgio
Erro de Permisso no PostgreSQL
Resolvendo o Erro de Permisso no PostgreSQL
Banco de Dados existente aps excluso
O Erro Broken Pipe ou Communications link failure
Servidor Java no quer parar ou reiniciar
Fantastico De Luxe - Access denied for user
Troca de Senha do Admin Do GlassFish
Servio Java no responde com erro de Timeout
Erro The web application [] registered the JDBC driver
Erro do MySQL: Host is blocked because of many connection errors
Erros Comuns de E-mail
Erro 501 Too many syntax or protocol errors
Alguns emails no vo para a caixa de enviados no Outlook
Outlook no salva emails em itens enviados
Erro de E-mail: Retry timeout exceeded copy
Causas da falha: Retry timeout exceeded
O SVN

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

Criando seu Repositrio SVN


Testando o acesso remoto
Realizando Dump do Repositrio
Recuperando o Dump do Repositrio
Erro no repositrio do SVN
O GIT
Para Desenvolvedores
Instalando o WebServices Axis2 no Tomcat
Enviando E-mails
Enviando E-mail com Java
Enviando E-mail com PHP
Alterando o Comportamento com as Diretrizes Apache
Desenvolvendo seu .htaccess
URL Amigvel ou Mod_Rewrite
Procedimentos em seu Banco de Dados
Criando uma Stored Procedures no MySQL
Criando Functions no MySQL
Criando Triggers no MySQL
Privilgios em Procedimentos no MySQL
Uso Avanado do Painel e Servios
Novas contas de FTP
Removendo contas de FTP
Cuidados ao excluir uma conta extra de FTP
Acesso SSH atravs do sistema operacional
Acesso SSH atravs do Linux/Unix e Windows
Linux/Mac OS X/FreeBSD/ Unix em Geral
Windows XP/Vista/7/8
Gerando chaves de acesso SSH no cPanel
Usando as chaves caso esteja usando o Linux/MacOS X
Usando as chaves caso esteja usando o Windows
Personalizando os DNS do seu Servio
Vrios Domnios ou Subdomnios na Raiz de um GlassFish
Configurando no GlassFish
Desativando erros do PHP
Ativando o GZip para Contedo Web
Criando Tarefas Automatizadas - Cron

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

O Bsico do Uso no Painel

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.%%

Sobre o Suporte Especializado

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

Servios de Atuao do Suporte

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

Atuao Parcial de Suporte

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 que o Suporte No Ajuda

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

Sobre o Suporte de Programadores

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

Como funciona o servio PHP e HTML

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

O Uso do PHP Em Servidores Compartilhados

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

Memria e Upload de Arquivos do PHP

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

Local dos Arquivos PHP ou HTML

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

Pgina Inicial em PHP ou HTML

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

Resumo do Local e Pgina Inicial de Sites PHP/HTML

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

Uso de Processamento em PHP

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

Como visualizar um site PHP ou HTML sem o domnio

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

Cada Painel de Controle

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

Portas de cada painel de controle

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

O https do WHM/cPanel ou NGasi

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 Painel de Controle WHM - Revenda

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

O acesso ao painel de controle WHM

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

Criando novos domnios como revenda de sites

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

Criando um Pacote de Revenda

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

Adicionando o cPanel para um novo Domnio

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):

3) Determine o Pacote/Package que criou para a revenda.


4)%Determine%a%lngua%do%painel%cPanel:

5) Em DNS Configurations/Configuraes de DNS, deixe marcada apenas as opes

30

Enable DKIM on this account e Enable SPF on this account ().

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

Listando Domnios da Revenda

Para%listar%e%acessar%o%cPanel,%atravs%de%sua%revenda,%no%WHM,%v%em%Account*
Information* *List*Accounts/Informaes*da*Conta*Contas*Lista:

32

Alterando a senha do acesso ao painel cPanel do domnio revendido

V% em% Account* InformationList* Accounts/Informaes* da* Conta* Contas* Lista.%%


Clique% no% sinal% de% .% Altere% a% senha% do% painel% em% Change* Password/Alterar* senha.
Confirme no Change/Mudar.

33

DNS Prprio em Revenda

1) Entre no painel WHM com o seu usurio e senha de revenda;

2) Em Server ConfigurationBasic cPanel & WHM Setup/Configurao do Servidor


Bsico cPanel & WHM Setup;

3) No campo "Nameserver 1" alterar os nomes dos NS1 e NS2 para o desejado (o correto

34

do seu domnio principal, sempre) e clicar em "Save Changes";

4) Ao criar novos domnios com os DNS, v em Account Functions Create a New


Account/Funes Conta Criar uma nova conta" e selecione as opes de DNS:

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 Painel de Controle cPanel

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

O acesso ao painel de controle cPanel

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

Permisses de Arquivos e Diretrios


Permisses de Arquivos e Diretrios

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

Softaculous para Aplicativos OpenSource PHP

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.

IMPORTANTE:% O% Softaculous% possui% aplicativos% PHP% conhecidos% e% so% atualizados%


automaticamente%pelo%painel%em%verses..

39

Antes de Utilizar o Softaculous

%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

Instalando o WordPress em sua conta

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) Em Site Settings voc define o assunto do seu blog e a descrio inicial.

6) Uma das reas do formulrio mais importantes, se no a mais importante, a segurana do


administrador. Voc define em Admin Account os dados do administrador do blog, como
Usurio e sua senha. Observe que existe uma barra Strong que demonstra se a senha inserida
forte.

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

IMPORTANTE:% A% Integrator% no% ensina% a% operar,% apenas% hospeda,% qualquer% aplicativo%


PHP%existente%no%Softaculous.%O%Softaculous%apenas%automatiza%a%instalao,%mas%operar%
o%WordPress,%Joomla%ou%outros,%dependem%exclusivamente%do%conhecimento%do%cliente.%

43

Removendo um aplicativo como o WordPress

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

Instalando o WordPress em um subdomnio

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%.

IMPORTANTE:% A% Integrator% no% ensina% a% operar,% apenas% hospeda,% qualquer% aplicativo%


PHP%existente%no%Softaculous.%O%Softaculous%apenas%automatiza%a%instalao,%mas%operar%
o%WordPress,%Joomla%ou%outros,%dependem%exclusivamente%do%conhecimento%do%cliente.%

45

Fantastico De Luxe para Aplicativos OpenSource PHP

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.

IMPORTANTE:% O% Fantastico% De% Luxe% possui% aplicativos% PHP% conhecidos% e% so%


atualizados% automaticamente% pelo% painel.% As% verses% mais% novas% que% no% estiverem%
ainda% aparecendo% neste% local,% podem% ser% instaladas% manualmente% pelo% usurio,% no%
diretrio%que%este%desejar,%desde%que%dentro%de%public_html.

46

Instalando o WordPress em sua conta

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

Removendo um aplicativo como o WordPress

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

Instalando o WordPress em um subdomnio

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%.

IMPORTANTE:% A% Integrator% no% ensina% a% operar,% apenas% hospeda,% qualquer% aplicativo%


PHP%existente%no%Fantastico.%O%Fantastico%apenas%automatiza%a%instalao,%mas%operar%o%
WordPress,%Joomla%ou%outros,%dependem%exclusivamente%do%conhecimento%do%cliente.%

53

Problema ao instalar um aplicativo no Fantastico De Luxe

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.

IMPORTANTE:% O% Fantastico% apenas% automatiza% a% instalao% e% algumas% de% suas%


caractersticas% no% so% controladas% por% ns,% como% da% obrigao% de% sincronizao% de%
senhas%com%o%MySQL.%

54

Usando um Programa de FTP

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

Adicionando novos Domnios no cPanel

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

Adicionando Domnios Suplementares

V% em% Domnios* * * Domnio* de* complementos.% O% domnio% suplementar% permite%


compartilhar%o%mesmo%espao,%mas%com%outro%usurio%e%senha%do%domnio%principal%do%
cliente%no%cPanel.

IMPORTANTE: O exemplo abaixo produzir o domnio novo dentro de public_html, onde


o usurio FTP especfico seria usuario@novodominio.com.br. No h como ser apenas
usuario.

60

Adicionando Domnios Estacionados

Entre no cPanel, clique em "Domnios * Domnios Estacionados".


Adicione o outro domnio em "Criar um Novo Domnio Estacionado" e confirme no boto
"Adicionar Domnio":

Depois de adicionado, clique em "Gerenciar Redirecionamento".

Informe o domnio para onde ser redirecionado, em "Redirecionamento de Domnio


Estacionado" e confirme no boto "Salvar".

61

Adicionando subdomnios no cPanel

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

Crie o subdomnio no cPanel, em "Domnios * Subdomnios".


Na criao de um subdomnio, o nome do diretrio dado para ele, somente servir para
aplicativos PHP e HTML.

subdomnio

63

Adicionando novos Domnios no WHM

Ver%tpico%Criando%novos%domnios%como%revenda%de%sites%%do%manual.

64

Adicionando novas contas de e-mail

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

Alterando a Senha ou Excluindo Contas de Email

As%contas%de%e\mail%criadas%aparecem%abaixo,%onde%voc%pode%alterar%a%senha%ou%excluir:

67

Redirecionando Contas de Email

Para redirecionar um email para outro, siga os passos:


1) V no cPanel, em "Correio * Remetentes".

2) Clique no boto "Adicionar Remetente":

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

Acesso ao E-mail pelo Webmail

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

Acesso ao E-mail pelo PC ou MAC

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

Acesso ao E-mail pelo Outlook 2010 - Windows

O exemplo abaixo ser de configuraes no Outlook 2010. Caso sua verso


seja diferente e precise de ajuda, envie um email para
suporte@integrator.com.br.
Os passos aps iniciar o Outlook 2010
1. Clique no menu Arquivo e logo aps em Configuraes de Conta e
depois na opo que surgir logo abaixo chamada Adicione e remova
contas ou altere as configuraes... conforme mostra a imagem abaixo.

2. Na tela Configuraes de Conta clique em Novo.

73

3) Na tela Adicionar Nova Conta


3.1 - Marque a opo Definir manualmente as configuraes do servidor
ou tipo de servidores adicionais.
3.2 - Clique em Avanar.

4) Marque a opo Email da Internet e depois clique em Avanar.

5) Configuraes de Email na Internet, insira suas informaes pessoais,


informaes da conta de Email e servidores.

74

1 - Informe o Nome da Pessoa ou Responsvel pela Conta de Email.


2 - Informe o Endereo de Email completo: suaconta@seudomnio.
3 - Selecione o tipo de Servidor de entrada de Emails que poder ser POP ou
IMAP.
4 - Informe o servidor de entrada de Emails que mail.seudomnio.
5 - Informe o servidor de sada de Emails que mail.seudomnio.
6 - Informe o Nome de Usurio que o seu endereo de e-mail completo
suaconta@seudomnio.
7 - Informe a sua senha.
8 - Marque a opo Lembrar senha.
9 - Desmarque a opo Teste as configuraes da Conta clicando no
boto Avanar.
10 - Clique em Mais Configuraes e siga o exemplo na imagem abaixo.

75

Clique na guia Servidor de Sada e Marque as opes: Meu servidor de


sada (SMTP) requer autenticao e a opo: Usar as mesmas config. do
servidor de entrada de e-mails
Cique em OK.
Ir aparecer a tela de Configuraes de Email na Internet novamente, clique
em Avanar.

76

Acesso ao E-mail pelo Mail do Mac OS

Abra o Mail e execute um dos seguintes procedimentos:


1.
2.

3.

4.
5.

Caso voc nunca tenha configurado contas de email usando o Mail, a


pgina Bem-vindo ao Mail ser exibida. V para a etapa 2.
Caso voc j tenha criado contas de email usando o Mail, no menu
Mail, clique em Preferncias. Na guia Contas, clique no sinal de
adio (+) na parte inferior do painel de navegao para abrir a janela
Adicionar Conta.
Na janela Bem-vindo ao Mail ou Adicionar Conta:
1. Na caixa Nome Completo, digite o nome a ser exibido para as
pessoas s quais voc envia email.
2. Na caixa Endereo de Email, digite seu endereo de email
principal.
3. Na caixa Senha, digite a senha da sua conta de email e clique
em Continuar.
Na janela Servidor de Correio de Entrada, digite o seguinte:
Ao lado de Tipo de Conta, selecione POP ou IMAP.
1. Na caixa Descrio, digite um nome como lembrete da
finalidade dessa conta de email.
2. Na caixa Servidor de Correio de Entrada, insira o nome do
servidor de e-mail, informado anteriormente por ns. Ex:
mail.seudominio.com.br.
3. Na caixa Nome de Usurio, digite seu endereo de email
principal criado no painel de controle (ex:
usuario@seudominio.com.br).
4. Na caixa Senha, digite a senha da sua conta de email.
5. Clique em Continuar. O Mail ir testar a sua conexo ao servidor
de entrada usando as configuraes padro.

IMPORTANTE: Caso aparea a opo de certificado, devido ao SSL


autoassinado do cPanel, clique em Mostrar Certificado, depois selecione
Confiar Sempre e mande Conectar. Confirme a senha do seu usurio do Mac
OS e no ter mais esta mensagem em seu Mail.

77

Se o teste no for bem-sucedido, clique novamente em Continuar. Voc


pode verificar suas configuraes aps concluir este procedimento:
1.

Na janela Servidor de Correio de Sada, faa o seguinte:


1. Na caixa Descrio, insira o nome deste servidor de email; por
exemplo, Servidor de envio da Integrator.
2. Na caixa Servidor de Correio de Sada, digite o nome do
servidor SMTP. Ex.: mail.seudominio.com.br.
3. Marque a caixa de seleo Usar somente este servidor.
4. Marque a caixa de seleo Usar Autenticao. O seu nome de
usurio e a senha que voc inseriu para o servidor de entrada
podero ser exibidos nas caixas de texto Nome de Usurio e
Senha. Esses valores so os mesmos para o servidor de
Entrada ensinado anteriormente, caso no aparea. Clique em
Continuar.
5. O Mail testar a sua conexo com o servidor de email de sada
usando as configuraes padro.
Mesma Nota acima para o SSL autoassinado do cPanel.
No final do assistente, ter um sumrio da criao da conta. Mantenha
marcada a opo Conectar conta e clique em Criar.

78

79

Acesso ao E-mail pelo Thunderbird (Linux/Windows/Mac OS)

O Thunderbird um programa cliente gratuito, da Mozilla, OpenSource que


executa nas plataformas Linux/Windows e Mac OS. O Tutorial abaixo permite
configurar suas contas de email em qualquer plataforma que ele executar.
1) Crie a conta indo em Configurar Contas:

2) Cadastre a conta:

3) Espere ele testar.


4) Marque POP3 e clique em Config. Manual:

80

5) Altere os parmetros para cada porta e tipo de acesso, confirmando em


Retestar. Veja o detalhe do campo Nome do usurio. Por fim, assim que
retestar, clique em Concluir.

81

Sobre as regras de envio de emails

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

Evitando Spams com os recursos do painel

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

Verificando a legitimidade de um e-mails enviado

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.

1) Procure a conta de email que deseja habilitar o BoxTrapper e clique em

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

Traduo das Mensagens do BoxTrapper

Abaixo a traduo das mensagens de confirmao geradas pelo BoxTrapper.


Voc pode editar os textos como preferir aps copiar para a caixa de texto
IMPORTANTE: no altere os valores entre os caracteres "%". Esses valores
so interpretados pelo programa e representam dados da mensagem! No
altere tambm os valores To e Subject no incio da mensagem
1) verify - Mensagem automtica enviada a um novo remetente
To:%email%
Subject: Seu e-mail requer verificao (verify#%msgid%)
A mensagem que enviou requer que voc prove que um ser vivo humano
real e no uma fonte de spam.
%if can_verify_web%
Para completar esta verificao, basta responder a esta mensagem e deixar a
linha de assunto intacta.
Os cabealhos da mensagem enviada do seu endereo so mostrados
abaixo:
%headers%
2) verifyreleased - Mensagem enviada quando um remetente adicionado
lista branca
To:%email%
Subject: Voc foi adicionado lista branca de%fromname% e seu e-mail foi
entregue. (original:%subject%)
Esta mensagem para notific-lo de que a sua verificao foi recebida, e seu
endereo de e-mail foi adicionado lista branca.
Todas as mensagens pendentes de seu endereo foram entregues
%fromname%. Nenhuma ao necessria de sua parte.
Os cabealhos da mensagem enviada do seu endereo so mostrados
abaixo:
%headers%

89

3) returnverify - Mensagem de confirmao do BoxTrapper


To:%email%
Subject: Re:%subject%
Esta mensagem uma resposta a uma mensagem de verificao
Boxtrapper. Nenhuma ao necessria de sua parte.
Se voc estava esperando para ser adicionado lista branca do usurio,
certifique-se de que o e-mail de verificao que voc respondeu continha a
seqncia correta de verificao no assunto. Boxtrapper viu a chave de
verificao como "%msgid%"
Os cabealhos da mensagem enviada do seu endereo so mostrados
abaixo:
%headers%

90

Visualizando as estatsticas de acesso ao seu site

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

Personalizando as paginas de erro do Apache

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

Como funciona o servio Java

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 memria do servidor Java

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

Uso de Processamento em Java

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 Painel de Usurio Java

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 acesso o painel NGasi

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

Instalando o servidor Java

Veja%no%tpico%Instalando%o%servidor%Java%.

99

Colocando o Aplicativo Java no Endereo do seu Site

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

Erros do cliente e direito de suporte

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

Acesso Java em conexo ao banco de dados

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

Instalando o servidor Java

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

Local onde o servidor Java instalado

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

A estrutura do servidor Java

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

Suas bibliotecas JAR

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

Compartilhando seu servidor Java em outros domnios ou


subdomnios

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

Como mapear outro domnio ou subdomnio no painel Java

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

O Bsico de Uso dos Servidores Java

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

Sobre a exibio no domnio

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

Usando o servidor Java Tomcat

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

Subindo o aplicativo no Tomcat

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

Removendo o mapeamento do aplicativo no Domnio

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

Subindo um aplicativo na Raiz do domnio com o Tomcat

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

Removendo o mapeamento da Raiz no Domnio

Clique%em%Desabe*Mappings%e%aguarde%o%processamento%que%remover%o%mapeamento%
da%raz%do%domnio.

117

Configurando o acesso ao Manager do Tomcat

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

Configurando o manager do Tomcat 7/8

O que vamos passar abaixo um exemplo de configurao do tomcat-users.xml do Tomcat


na verso 7 ou 8.
Com o Tomcat parado, altere o arquivo tomcat-users.xml assim:
<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
<role rolename="manager-jmx"/>
<role rolename="manager-script"/>
<role rolename="manager-status"/>
<role rolename="manager-gui"/>
<user username="USER" password="PASS"
roles="manager-jmx,manager-script,manager-status,manager-gui"/>
</tomcat-users>

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

Mapeando o Manager no Tomcat

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:

2) Depois acesse o manager assim:


http://seudominio/manager/html
Um usurio e senha sero requisitados e devem ser configurados conforme ensinamos em
Configurando o manager do Tomcat 7/8.

IMPORTANTE: No ensinamos as caractersticas e formas de configuraes do Manager do


Tomcat. Caso o usurio deseje aprender mais sobre o Manager do servidor Tomcat, veja a
documentao da verso que est usando em http://tomcat.apache.org.

120

Usando o servidor Java Jetty

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

Subindo um aplicativo na Raiz do domnio com o Jetty

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;

3) Coloque% o% contexto% do% Jetty% em% appservers/jettyTXx/contexts/% % onde% X% % a%


verso%do%seu%Jetty;
a.
O%detalhe%do%contexto%para%colocar%o%aplicativo%Java%na%raiz%do%domnio%:
<Set*name="contextPath">/</Set>
4)
5)
6)%

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

Usando o servidor Java JBoss

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

Usando o servidor Java JBoss 7

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

Usando o servidor Java JBoss 7 com aplicativo na raiz do domnio

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

Pequeno exemplo do deploy na raiz com JBoss 7

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

Usando o servidor Java Wildfly

O Wildfly 1 instalado usando a opo "standalone":


~/appservers/wildfly-8x/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/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

Usando o servidor Java Wildfly com aplicativo na raiz do domnio

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

Pequeno exemplo do deploy na raiz com Wildfly

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

Usando o servidor Java GlassFish

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

Colocando seu aplicativo na raiz do domnio com o servidor GlassFish

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

Aplicativo EAR na raiz com o GlassFish

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

Logs de Acesso do Servidor Java

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

Alterando o Locale: Data, hora, nmeros e moedas

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

Alterando o Locale do Tomcat

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

Alterando o Locale do GlassFish

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

Um mesmo servidor Java em vrios domnios

Crie o outro domnio como suplementar/ou subdomnio, no cPanel, em Domnios


Suplementares/ Subdomnios.
O exemplo abaixo sobre domnio suplementar. Ns temos o clouds13integrator.com e
adicionamos o usurio teste para o domnio "teste.com.br". Veja como ficou o domnio
suplementar:

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.%

4) Aps mapear, ter o domnio suplementar/subdomnio com o acesso ao servidor java e no


aplicativo que deseja.

IMPORTANTE: Na raiz do domnio/subdomnio - raiz quando digitamos


www.teste.com.br, por exemplo - podemos ter um ROOT apenas no Tomcat, ou seja, no
possvel, como no nosso exemplo, abrir www.clouds13integrator.com um aplicativo
diretamente e ww.teste.com.br, outro aplicativo.

144

Trabalhando com o Banco de Dados

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.

IMPORTANTE: A Integrator uma empresa que visa hospedar aplicativos profissionais.


Qualquer pergunta que caracterize falta de conhecimento tcnico o suporte ser obrigado a
responder apresentando o endereo Web da documentao do servio que est querendo
operar.

145

Criando Banco de Dados PostgreSQL no Painel

Para%trabalhar%com%o%PostgreSQL,%da%forma%mais%simples,%v%em%Bancos*de*Dados*
Banco*de*Dados*PostgreSQL.

ATENO: Antes de criar tabelas, visite o tpico Usurio PADRO do PostgreSQL no


Painel se estiver usando frameworks.

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

Usurio: mesmo do FTP

Senha: a mesma do usurio FTP

Banco de dados: Inclui o prefixo criado no painel de controle cPanel

147

Usurio PADRO do PostgreSQL no Painel

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

Exportando no PostgreSQL do cPanel

No cPanel, voc exporta o banco de dados pelo phpPgAdmin usando os seguintes passos:
1) V em "Bancos de Dados", clique em "phpPgAdmin".

2) No phpPgAdmin, clique em "Exportar".

3) Em Exportar, selecione "Estrutura e dados", o Formato "SQL", marque "Download" e


confirme no boto "Exportar".

149

150

Importando no PostgreSQL do cPanel

Para Importar, no phpPgAdmin do cPanel, clique sobre o banco de dados.


1) Clique em "SQL".
2) Na parte inferior de SQL, selecione o arquivo que deseja importar e confirme no boto
"Executar".

151

Importando no PostgreSQL Bancos Grandes

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:

USUARIO_FTP - Seu usurio do cPanel ou FTP

BANCO_CRIADO - Seu banco de dados criado no cPanel

ARQUIVO.SQL - Seu arquivo de dump SQL gerado local e levado via FTP para sua
conta

Criando Tabelas no PostgreSQL com Aplicativos

Veja-o-tpico-Usurio-PADRO-do-PostgreSQL-no-Painel--caso-estejausando-Hibernate/JPA.-Usurios-PHP-que-trabalhem-com-Frameworks,-aorientao--a-mesma.

152

Criando Banco de Dados MySQL no Painel

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.

2. Em "Criar Novo Banco de Dados", coloque o nome em "Novo Banco de Dados" e


confirme no boto "Criar Banco de Dados":

153

Criando o usurio ao Banco de Dados MySQL no Painel

1. Em Banco de Dados, Banco de dados MySQL.

2. Defina um usurio em "Adicionar Novo Usurio", confirmando depois no boto "Criar


Usurio":

154

Definindo o usurio ao Banco de Dados MySQL no Painel

1) Em Banco de Dados, Banco de dados MySQL.

2) Com o Usurio criado, atribua ao banco de dados em "Adicionar Usurio ao Banco de


Dados":

2.1) Defina seus privilgios e confirme no boto "Fazer Alteraes".

155

3) Por fim, voc dever ver o nome do banco de dados e seu respectivo usurio.

156

Formas de acesso ao Banco de Dados

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

Usando o phpMyAdmin para o MySQL

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

Usando o MySQL pelo Aplicativo Hospedado

No%Java%ou%PHP,%use%sempre%as%seguintes%conJiguraes:
Host:%localhost
Banco%de%dados,%Usurio%e%senha:%Criados%no%cPanel

159

Usando o phpPgAdmin para o PostgreSQL

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

Usando o PostgreSQL pelo Aplicativo Hospedado

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

Acesso Remoto ao Banco de Dados

Na% Integrator,% % o% usurio% pode% trabalhar% com% o% acesso% acesso% remoto% padronizado% no%
banco%de%dados%MySQL,%desde%que%liberados%antes%no%cPanel.

163

Liberando o acesso remoto ao MySQL

Os%passos%para%liberao%de%acesso%remoto:
1. V em "Bancos de Dados MySQL Remoto", no seu cPanel.

2. Digite somente o smbolo da percentagem, "%", sem aspas, em "Adicionar Host de


Acesso Host (% wildcard permitido)".

3. Confirme no boto Adicionar Host .

164

Acessando remotamente o MySQL

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

Erro comum: Host is blocked because of many connection errors

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.

IMPORTANTE:%O%comando%'mysqladmin flush-hosts' s realizado por nossa equipe uma


vez por um severo perodo de horas, desde que o bloqueio seja do seu acesso remoto. Ns
realizamos o comando com um aviso do perodo que poderemos realizar novamente.

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

Dvidas Comuns Encontradas na Hospedagem

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

Ao usar SSL prprio, na barra de endereos do domnio, dependendo do navegador, podemos


ver "https://" e o smbolo de uma cadeado exibido logo ao lado, dando a informao de
segurana na pgina.

Certificado SSL 128 bits ou 256 bits?


Ao olhar os detalhes de um SSL no navegador, voc pode se deparar com 128 bits ou 256
bits. Isso no se refere a quantidade de bits do certificado que foi adquirido. Essa diferena
uma escolha feita pelo navegador que est usando, browser, para permitir a comunicao dos
dados criptografados com o servidor. Resumindo: no est sendo informado o nmero de bits
do certificado propriamente dito.

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 navegador conecta-se ao servidor e envia uma requisio HTTPS para o acesso ao


site que informou.

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.

Neste ponto, o navegador e servidor possuem uma chave compartilhada que s os


dois conhecem, gerando a segurana devida pela criptografia. Isso permite
criptografar o contedo do site em envio de dados que somente voc que preenche
conhece e o servidor que vai receber, saber.

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:

Criptografia de 128 bits usando AES_128_GCM (com TLS 1.2)

Criptografia de 256 bits usando AES_256_CBC (com TLS 1.1)


As siglas GCM e CBC referem-se a modos de operaes criptogrficas, ou seja, so
algoritmos usados para criptografar a chave aleatria gerada pelo navegador. O modo de
operao GCM considerado mais seguro do que o CBC, embora use menos bits
informados, pois h uma verso mais recente do TLS - verso 1.2.

173

Erro no certificado SSL: Elementos no criptografados

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.

IMPORTANTE:*O suporte de hospedagem no tem como ajudar neste caso em hiptese


alguma.

174

Erros Comuns Encontrados na Hospedagem

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

Resolvendo o Erro 500

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

Erro 503 com servidor Java iniciado

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

Resolvendo o Erro 404 no PHP

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

Resolvendo o Erro 404 no Java

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.

Permisso de Tabelas no PostgreSQL

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

Erros de Uso do Servidor Java

Existem%muitos%erros%em%um%servidor%java.%Neste%tpico%listamos%apenas%os%mais%
comuns:

PermGen
OutOfMemoryError:%Java%heap%space
Proxy%Error

184

Resolvendo o erro PermGen

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

Resolvendo o erro Java heap space

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

Proxy Error no Acesso ao Aplicativo Java

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

Resolvendo erro java.lang.OutOfMemoryError: unable to create new


native thread

187

Se houver o erro java.lang.OutOfMemoryError: unable to create new native thread, um


forte indicativo que seu aplicativo est tentando criar mais threads que ns impomos no
servidor como um todo, limitado por usurio.
Este erro comum no uso de pools como C3P0 e deve ser analisado pelo desenvolvedor.
Uma recomendao, no uso do C3P0 tentar inicializar um pool com final static
ComboPooledDataSource pool.
Por outro lado, injetores de dependncia como o Spring so altamente recomendados.

188

Erros Comuns de Operao no Banco de Dados

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

Erro de Permisso ou Privilgio no MySQL

Existem dois tipos de Erros de Permisso no MySQL comuns na hospedagem:


1. Erro na criao de tabelas e outros objetos no banco de dados por um usurio
2. Erro na permisso de functions, views ou procederes por desconhecimento do usurio

190

Erro de Permisso ou Privilgio no Usurio

Existem trs possibilidades comuns de erro de permisso no MySQL.


1. No cPanel, v em Bancos de Dados Bancos de dados MySQL.

Verifique se o banco de dados possui o USURIO que criou.

1.1. Se aparecer vazio como da imagem acima, adicione mais abaixo o usurio ao banco de
dados:

1.2. D a ele os privilgios de acesso 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

Erro de Permisso ou Privilgio em Functions, Views e Procedures

Um erro comum no MySQL para usurios inexperientes a permisso de Views, Functions e


Procedures.
O MySQL diferencia na criao o acesso dando a permisso adequada, cujo o usurio ter
permisso de acesso.
Todo objeto criado remotamente - View, Functions e Procedures - que no estiverem com o
DEFINER informado, sero gerados com o usurio em condio de acesso remoto somente.

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');

IMPORTANTE: Caso precise de mais instrues, recomendamos a documentao do


MySQL. O suporte da Integrator Host no aceita pedidos de ajuda que envolvam ensino

192

tcnico que deve ser obrigao do desenvolvedor conforme reza nosso contrato.

193

Resolvendo erro de Privilgio

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.

IMPORTANTE: Caso precise de mais instrues, recomendamos a documentao do


MySQL. O suporte da Integrator Host no aceita pedidos de ajuda que envolvam ensino
tcnico que deve ser obrigao do desenvolvedor conforme reza nosso contrato.

194

Erro de Permisso no PostgreSQL

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

Resolvendo o Erro de Permisso no PostgreSQL

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

Banco de Dados existente aps excluso

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

O nome do Banco de Dados que no consegue ser excludo

Tipo do Banco de Dados - PostgreSQL ou MySQL

197

O Erro Broken Pipe ou Communications link failure

Este erro, comum em banco de dados MySQL, ocorre por conta de um


timeout padro, no MySQL e na Integrator, de 8 horas de conexo inativa.
O problema comum quando o desenvolvedor no resolve em seu Pool de
Conexes essa caracterstica, seja por desconhecimento ou por
esquecimento.
Para resolver, existem formas diferentes para cada framework que opera.
Por exemplo, com o Hibernate, em um hibernate.cfg.xml, com o C3p0, temos
o hibernate.c3p0.idle_test_period que resolve o broken pipe. No exemplo,
ele checa a cada 100 segundos se a conexo est invlida:
<property name="hibernate.connection.provider_class">
org.hibernate.connection.C3P0ConnectionProvider
</property>
<property name="hibernate.c3p0.min_size">1</property>
<property name="hibernate.c3p0.max_size">20</property>
<property name="hibernate.c3p0.timeout">30</property>
<property name="hibernate.c3p0.idle_test_period">100</property>

No Pool do Tomcat, comum vermos o erro Communications link failure.


Neste caso, por exemplo, temos o atributo validationQuery, alm de outros
testes que permitem a validao da conexo a cada X tempo, permitindo
assim que o aplicativo possa analisar se a conexo est ainda ativa ou se o
MySQL realizou o famoso timeout.
<Resource auth="Container"
name="jdbc/POOL"
driverClassName="com.mysql.jdbc.Driver"
maxActive="20"
maxIdle="10"
maxWait="-1"
type="javax.sql.DataSource"
url="jdbc:mysql://localhost/banco?autoReconnect=true"
password="senha"
username="usuario"
removeAbandoned = true
validationInterval = 34000
validationQuery="SELECT 1"
testOnBorrow="true" testWhileIdle="true"
timeBetweenEvictionRunsMillis="10000"
minEvictableIdleTimeMillis="60000" />
</Context>

Abaixo uma rpida explicao tcnica:

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.

IMPORTANTE: As questes informadas neste tpico no possuem suporte


na hospedagem em analisar problemas relacionados, uma vez que so
considerados de conhecimento tcnico do desenvolvedor.

199

Servidor Java no quer parar ou reiniciar

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.

Depois,% v% no% painel% Java,% clique% em%


.% Aparecero% diversos%
erros,%conJirme%o%dilogo%de%Erro%que%o%servidor%exibir%no%Jinal.
Aps,%clique%em%

%%e%aguarde%iniciar.

IMPORTANTE: Se o servidor Java no funcionar ainda assim, relate o


problema no suporte@integrator.com.br.

200

Fantastico De Luxe - Access denied for user

Veja%o%tpico%Problema%ao%instalar%um%aplicativo%no%Fantastico%De%Luxe%%deste%manual.

201

Troca de Senha do Admin Do GlassFish

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/

8) Apague o domain2 que no vai mais usar:


~/appservers/glassfish-3x/bin/./asadmin.sh delete-domain
domain2
9) Inicie e entre no admin com a senha que havia dado no passo 6 e pronto, j est operando
novamente no GlassFish Admin:
~/appservers/glassfish-3x/bin/./asadmin.sh start-domain
domain1

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

Servio Java no responde com erro de Timeout

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

Erro The web application [] registered the JDBC driver

Se nos logs encontrar o erro


similar a este SEVERE [localhost-startStop-2]
org.apache.catalina.loader.WebappClassLoader.clearReferencesJdbc
The
web
application [] registered the JDBC driver [...Driver] but failed to unregister it when the
web application was stopped. , significa que sua biblioteca JDBC pode estar conflitando
com o diretrio lib do servidor Java e do seu WAR/EAR file.
Neste caso, retire a biblioteca JDBC duplicada de um dos dois locais. Se usar POOL de
conexes, retire do seu aplicativo WAR/EAR.

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

Erro do MySQL: Host is blocked because of many connection errors

Veja detalhes sobre este erro em Erro comum: Host is blocked because of many connection
errors .

206

Erros Comuns de E-mail

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

Erro 501 Too many syntax or protocol errors

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

Alguns emails no vo para a caixa de enviados no Outlook

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

Outlook no salva emails em itens enviados

Se a caixa de seleoSalvar cpias das mensagens na pasta Itens Enviados no estiver


marcada, a pastaItens Enviadosno manter uma cpia de cada mensagem enviada. A caixa
de seleoSalvar cpias das mensagens na pasta Itens Enviados marcada por padro.
Para selecionar a configurao, siga este procedimento:
1.
2.
3.

No menuFerramentas, clique emOpes.


Na guiaPreferncias, clique emOpes de Email.
EmManipulao de mensagens, marque a caixa de seleoSalvar cpias das
mensagens na pasta Itens Enviados.

IMPORTANTE: H uma pastaItens Enviadoscorrespondente para cada pastaCaixa de


Entrada. Se voc usar mais de uma conta de email e quiser enviar uma mensagem de uma
conta secundria, uma cpia da mesma tambm ser enviada para a pastaItens Enviadosda
conta padro principal.

210

Erro de E-mail: Retry timeout exceeded copy

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

Causas da falha: Retry timeout exceeded

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

Criando seu Repositrio SVN

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:

Acessando o Painel SVN

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

5)% Adicionado% o% usurio% e% o% grupo,% v% em% Subversion* Management% e% visualize% o%


caminho%para%acesso%remoto:

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

Testando o acesso remoto

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

Realizando Dump do Repositrio

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

Recuperando o Dump do Repositrio

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

O comando do passo 3) ir buscar um arquivo chamado svn.dump dentro do usurio de sua


conta. Lembre-se que ele deve ser levado via FTP, onde no exemplo ele colocado 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.%

220

Erro no repositrio do SVN

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.

Instalando o WebServices Axis2 no Tomcat

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

IMPORTANTE:* % fundamental% entender% que% nossos% exemplos% no% possuem% nosso%


suporte% para% anlise% de% erros% que% obtiver,% uma% vez% que% isso% caracteriza% ensino.% Eles%
servem%como%base%para%o%desenvolvedor%que%j,%por%sua%obrigao%tcnica,%deve%resolver%
a%questo%alterando%seu%aplicativo%para%obter%o%envio%correto%no%seu%site/servio.

Enviando E-mail com Java

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

Enviando E-mail com PHP

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

Alterando o Comportamento com as Diretrizes Apache

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

Desenvolvendo seu .htaccess

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 Mod_Rewrite

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

Procedimentos em seu Banco de Dados

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

Criando uma Stored Procedures no MySQL

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');

IMPORTANTE:% % Criar% stored% procedures,% functions% ou% triggers% online% permitem%


automaticamente% seus% usurios,% devidamente% adicionados% ao% banco% de% dados% pelo%
cPanel,%acessar%online%somente.%

232

Criando Functions no MySQL

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');

IMPORTANTE:% % Criar% stored% procedures,% functions% ou% triggers% online% permitem%


automaticamente% seus% usurios,% devidamente% adicionados% ao% banco% de% dados% pelo%
cPanel,%acessar%online%somente.%

233

Criando Triggers no MySQL

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:

mysql> CREATE TABLE account (acct_num INT, amount


DECIMAL(10,2));
Query OK, 0 rows affected (0.03 sec)
mysql> CREATE TRIGGER ins_sum BEFORE INSERT ON account
-> FOR EACH ROW SET @sum = @sum + NEW.amount;
Query OK, 0 rows affected (0.06 sec)

IMPORTANTE:% % Criar% stored% procedures,% functions% ou% triggers% online% permitem%


automaticamente% seus% usurios,% devidamente% adicionados% ao% banco% de% dados% pelo%
cPanel,%acessar%online%somente.%

234

Privilgios em Procedimentos no MySQL

Veja%a%documentao%oJicial%do%MySQL%em:
http://dev.mysql.com/doc/refman/5.5/en/stored\programs\security.html

IMPORTANTE:% % Criar% stored% procedures,% functions% ou% triggers% online% permitem%


automaticamente% seus% usurios,% devidamente% adicionados% ao% banco% de% dados% pelo%
cPanel,%acessar%online%somente.%

235

Uso Avanado do Painel e Servios

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

Novas contas de FTP

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.

Ao criar a conta de FTP, ela ser listada abaixo.

237

Removendo contas de FTP

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.

IMPORTANTE: No possvel excluir as contas padro de FTP criadas ao ser liberado o


acesso ao painel cPanel.

238

Cuidados ao excluir uma conta extra de FTP

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.

IMPORTANTE: A recuperao de backup no imediata. O seu pedido pode levar at 48


horas para ser atendido e, para emergncias, um custo extra ser cobrado para adiantar o
tempo de recuperao.

239

Acesso SSH atravs do sistema operacional

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

Acesso SSH atravs do Linux/Unix e Windows

Temos% dois% tipos% padro% de% Sistema% Operacional% em% formato% de% acesso:% Unix% e%
Windows.%O%Linux%usa%o%padro%Unix.

241

Linux/Mac OS X/FreeBSD/ Unix em Geral

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.

IMPORTANTE: Se voc apenas opera no SO Windows, procure evitar ao mximo o


terminal SSH se no tem experincia com Linux. Erros para serem corrigidos pelo nosso
suporte, ao constatarmos a questo por falta de experincia do usurio, sero cobrados para

243

serem resolvidos.

244

Gerando chaves de acesso SSH no cPanel

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

Usando as chaves caso esteja usando o Linux/MacOS X

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

Usando as chaves caso esteja usando o Windows

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

Personalizando os DNS do seu Servio

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

Vrios Domnios ou Subdomnios na Raiz de um GlassFish

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

1) Entre no Admin do GlassFish.


2) V em "Configuraes * server-config * Servidores Virtuais" e clique no boto
"Novo...".

3) No "Novo Servidor Virtual", determine um "Id", que o identifique, e no campo "Hosts",


coloque o site/domnio ou subdomnio, separado por vrgulas. Isso inclui o "www" no caso de
domnios. Mais abaixo, selecione em "Listeners de Rede" os itens "http-listener-1" e "httplistener-2". Confirme no boto "OK".
3.1) O processo do passo #3 deve ser realizado quantos domnios/subdomnios quiser.

253

4) Uma vez criados os servidores virtuais, v em "Aplicaes" e implante um novo


aplicativo.
4.1) Em "Raiz de Contexto", digite "/", sem aspas, que indica a raiz do documento.
4.2) Em "Servidores Virtuais", selecione o servidor virtual que definiu anteriormente, cujo
responder pelas requisies ao domnio/subdomnio.

254

Desativando erros do PHP

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"

IMPORTANTE: Desativar a exibio de um erro no o resolve. Nem toda mensagem de


erro deve ser resolvida com a dica apresentada neste tpico. Cabe ao desenvolvedor/usurio
compreender que aplicativos PHP antigos podem ter falhas por cdigo ultrapassado que
precisam ser substitudo para ter o erro resolvido definitivamente.

255

Ativando o GZip para Contedo Web

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".

2) Marque a opo "Compactar todo o contedo" e confirme no boto "Atualizar


Definies".

256

Criando Tarefas Automatizadas - Cron

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".

2) Em "Adicionar Novo Trabalho Cron", selecione a forma como vai executar, em


"Definies Comuns".
3) Em "Comando", defina o comando Linux, desde que tenha permisso para tal, assim
como o path onde encontra-se seu aplicativo.
O path fsico sempre comea assim:
/home/USUARIO_FTP
Onde USUARIO_FTP o seu usurio de FTP. Dentro dele, que a rea onde voc visualiza
ao entrar com o FTP, voc coloca seu aplicativo para ser executado.

IMPORTANTE: Jamais execute envio de e-mails em massa, pois proibido praticas de


Spam nos servidores da Integrator. Jamais execute aplicativos Java fora do servidor Java
tambm.

257

258

Você também pode gostar