Maker Planet www.makerplanet.com Manual do Usuário Atenção: Este é o rascunho inicial deste documento, visite o Maker Planet.COM (HTTP://www.makerplanet.com/) para obter as atualizações deste documento. Arquivo gerado na terça-feira, 16 de março de 2009 Autor: Lourival Oliveira da Silva e-mail: lourival@makerplanet.com Versão: Rascunho
Conteúdo Guia Rápido... 3 Publicando uma aplicação feita em Maker 2 na Web... 4 Dados de acesso... 4 Acessando o Painel de Controle... 4 Introdução ao Painel de Controle... 4 Fazendo Upload de sua aplicação... 5 Opções avançadas... 6 Webrun version... 6 Clean work and temporary files... 6 HTTP, HTTPS e Client Authentication... 6 Autenticação da máquina do cliente... 6 URL alternativa... 6 Protegendo o código fonte... 8 Como remover o código fonte do JAR... 8 Administração do Banco de dados... 9 Criando um novo banco de dados... 9 Fazendo o backup... 9 Enviando um backup para o servidor... 10 Upload do backup via FTP... 10 Copiando o backup do servidor... 11 Restaurando um backup... 12 Excluindo um banco de dados... 12 Mais ferramentas administrativas... 12 Anexo I - Configurando o servidor DNS no Parallels Plesk Control Panel... 14 2
Guia Rápido Veja como publicar uma aplicação rapidamente no Maker Planet. 1. Gere o código fonte da aplicação que será publicada no formato JAR; 2. Mude o nome do JAR para que tenha o mesmo nome do WFRE do projeto (ex: Sistema de Exemplo.jar e Sistema de Exemplo.wfre ); 3. Acesse o Maker Planet e faça login no Painel de Controle; 4. Faça upload do JAR e do WFRE na seção Maker Applications (primeira aba); Crie o banco de dados remotamente usando um dos métodos abaixo: a. Usando um backup do banco de dados: i. Faça um backup do banco de dados da aplicação; ii. Faça o upload do Backup do backup do banco de dados; iii. Restaure o backup remotamente; b. Usando o script para criação das tabelas: i. Crie uma nova base de dados usando o Painel de Controle; ii. Acesse o banco usando uma das ferramentas administrativas disponíveis no site; iii. Execute o script de criação do banco de dados; 5. Inicie o seu servidor de aplicação; 6. Acesse o sistema e faça as configurações necessárias no WFRE a. Defina o login e senha do banco; b. Defina o nome do host e a porta do servidor; 3
Publicando uma aplicação feita em Maker 2 na Web Este tópico descreve como utilizar o Maker Planet para publicar suas aplicações feitas em Maker 2 na Web. Dados de acesso Após a confirmação do seu cadastro no Maker Planet você receberá um e-mail com os dados de sua conta de usuário e senha. Serão entregues duas senhas, uma para sua conta pessoal e outra para as atividades do sistema como FTP e banco de dados. Acessando o Painel de Controle No site do Maker Planet você deve clicar sobre o link do Painel de Controle, será exibida a tela de login, use os dados recebidos para acessar sua conta. Introdução ao Painel de Controle O Painel de Controle é uma aplicação Maker que permite que você administre as aplicações publicadas na Maker Planet. Além de controlar detalhes técnicos do seu sistema, você também pode acompanhar as faturas. Relação de contratos de hospedagem ativos, administração do tomcat e atualização das aplicações Faturas emitidas e pagamento de faturas 4
Fazendo Upload de sua aplicação O primeiro passo é gerar o JAR com a aplicação compilada em seu ambiente de desenvolvimento. Veja como gerar o JAR nos seguintes tópicos do Manual do Maker 2: 1. http://suporte.softwell.com.br/maker/manual/maker2.htm 2. http://suporte.softwell.com.br/maker/manual/recursos_avancados/geracao_codigo_fonte/ exportar_codigo_jar.htm Agora basta clicar no botão Upload, o arquivo será adicionado à pasta systems do Webrun. Somente arquivos JAR e WFRE podem ser adicionados aqui. Após adicionar um JAR você deve reiniciar o Tomcat para que a aplicação seja atualizada. 5
Opções avançadas Webrun version Aqui você pode especificar qual versão do Webrun será utilizada em sua aplicação, você pode alterar a versão utilizada a qualquer momento. Clean work and temporary files Use este comando para limpar o context do Webrun, a pasta work será apagada, e o WAR do Webrun será republicado apagando qualquer alteração na pasta do Webrun restaurando-o para o estado original. HTTP, HTTPS e Client Authentication Permite configurar o acesso via HTTPS, HTTP e autenticação da máquina cliente. Autenticação da máquina do cliente Este recurso restringe o acesso ao sistema somente através de computadores com um certificado SSL instalado, ou seja, somente os computadores em que você adicionar o certificado terão acesso ao sistema, esta opção desabilita o acesso via HTTP. URL alternativa Permite especificar uma URL alternativa para acesso a sua aplicação, aqui você informará a URL que o cliente irá utilizar sem o HTTP, por exemplo: apps.meusite.com.br. Depois você deve configurar o seu servidor DNS para redirecionar as requisições para a conta nos servidores do MakerPlanet através de um registro CNAME. Para tal adicione um registro CNAME ao seu servidor DNS que irá redirecionar um subdomínio (neste exemplo apps) do seu site para os servidores do MakerPlanet, por exemplo para que seus clientes acessem os seus sistemas através da URL HTTP://apps.meusite.com.br/ e sejam redirecionados para HTTP://minhaconta.makerplanet.com/ basta adicionar o seguinte registro no seu DNS: 6
Tipo: CNAME Origem: apps Destino: minhaconta.makerplanet.com Há um período para atualização do DNS, após algum tempo (< 4h) o redirecionamento do seu site começará a funcionar e você será redirecionado para o MakerPlanet, que também tem um período para atualização das URL s alternativas (24h-72h), enquanto esta atualização não for efetuada você verá o site do MakerPlanet. 7
Protegendo o código fonte Não é necessário fazer UPLOAD das tabelas FR que contém os códigos fontes do seu sistema, no Maker Planet você pode trabalhar com o JAR, que é a versão compilada de sua aplicação. Um aspecto que devemos observar quando trabalhamos com o JAR é que ele contém tanto o sistema compilado (bytecode), quanto o código fonte em Java (*.java), ou seja, é possível editar seu sistema, ou observar detalhes do funcionamento através dos códigos das classes em Java. Para evitar tal situação basta remover os códigos fonte do arquivo JAR. Como remover o código fonte do JAR Abra o arquivo JAR com uma ferramenta compatível com ZIP (WINRAR www.rarlab.com, ou WINZIP - www.winzip.com, por exemplo), localize a pasta `src na raiz do zip e delete-a. Isso removerá todos os fontes em JAVA contido no JAR gerado pelo Webrun. 8
Administração do Banco de dados Este tópico cobre a administração dos seus bancos de dados nos servidores. A interface web fornece as funcionalidade principais para publicação e manutenção de uma aplicação Maker. Criando um novo banco de dados A interface administrativa permite criar novos bancos de dados remotamente. Fazendo o backup Para iniciar um backup selecione um banco de dados e clique sobre o botão Make a backup now, o backup será listado na aba Backups onde poderá ser baixado, restaurado ou excluído. 9
Enviando um backup para o servidor Cada backup deve ser enviado usando o botão correspondente ao DBMS. Upload do backup via FTP Quando o backup for muito grande você pode fazer o upload via FTP, para tal acesse o ftp.makerplanet.com usando um cliente FTP como WINSCP (http://winscp.net/), ou o próprio FTP disponível no prompt de comando do Windows. Após conectar-se via FTP você deve acessar a pasta de backups de banco de dados \backups\databases agora basta fazer o upload do arquivo. Ao fazer upload certifique-se de que os backups tenham a extensão padrão correspondente ao banco, no MakerPlanet convencionamos o seguinte: PostgreSQL - *.backup MS SQL Server - *.bak MySQL - *.sql 10
Após fazer o upload do arquivo use o botão Refresh para que os novos arquivos sejam reconhecidos pela interface administrativa e então você poderá utilizá-los para um restore. Exemplo de upload de backup usando o FTP do Windows C:\>ftp ftp.makerplanet.com Connected to ftp.makerplanet.com. 220 Wellcome to MakerPlanet FTP User (ftp.makerplanet.com:(none)): login 331 Password required for Password: ***** 230 User login logged in. ftp>cd backups\databases 250 CWD command successful. "/backups/databases" is current directory. ftp>lcd c:\meusbackups\ Local directory now c:\meusbackups\ ftp>binary 200 Type set to I. ftp>put meusistema.backup OBS: O comando bynary especifica que o arquivo sendo transmitido não é um texto, se for omitido pode causar erros na transmissão. Copiando o backup do servidor Você pode fazer o download do backup através da interface administrativa usando sua conta FTP. 11
Restaurando um backup Maker Planet - Manual do usuário Ao selecionar um backup para ser restaurado você pode definir se ele será efetuado sobre um banco de dados existente ou um novo banco de dados. Se for um novo banco de dados informe o nome e o Charset/Collation do banco de dados que será criado. Excluindo um banco de dados Basta selecionar um banco de dados e clicar sobre o botão Drop Database, pare o tomcat antes de tentar remover um banco de dados para certificar-se de que não haja nenhuma conexão ativa com o BD que está sendo excluído. Mais ferramentas administrativas Além da interface do Painel de Controle o Maker Planet oferece três outras ferramentas administrativas especificas para cada banco de dados suportado, são elas: 12 phppgadmin PostgreSQL - HTTP://www.makerplanet.com/tools/pgAdmin/
phpmyadmin MySQL HTTP://www.makerplanet.com/tools/myAdmin/ Web Data Administrator MS-SQL Server HTTP://www.makerplanet.com/tools/msAdmin/ 13
Anexo I - Configurando o servidor DNS no Parallels Plesk Control Panel Alguns provedores de hospedagem usam o Plesk como interface administrativa, esta interface permite a configuração do DNS diretamente pelo cliente, se esta opção estiver liberada pelo seu provedor, caso não esteja entre em contato com o seu provedor para obter alternativas. Caso esteja selecione o domínio que deseja integrar, neste exemplo vamos usar como exemplo a URL lourival.eti.br, localize o e clique sobre o ícone DNS Settings. Será exibida a lista de entradas existentes no DNS e um botão para adicionar novos registros Add Record. Clique sobre este botão para que seja exibida a interface de cadastro de novos registros. Selecione o tipo de registro, que deve ser CNAME, no próximo campo você deve informar o nome do subdomínio que será redirecionado, neste exemplo apps, e por fim a URL da conta no MakerPlanet sem o HTTP, algo do tipo minhaconta.makerplanet.com. Basta clicar em OK e aplicar as alterações. 14