sharivan / jcheckers Goto Github PK

1.1 - Na máquina servidora:

	- Sistema operacional Windows ou Linux. Outros sistemas operacionais para desktops como o Mac OS também podem serem utilizados, mas não há garantias de que o servidor do JCheckers irá funcionar corretamente já que não foram realizados testes em outros sistemas operacioais além dos recomendados aqui.

	- MySQL Server 5.6.4 ou posterior. Qualquer versão do MySQL inferior a 5.6.4 não será compatível.
	
	- JDK 8 ou superior.
	
	- Apache Tomcat 8 ou superior.
	
1.2 - Na máquina cliente:

	- JRE 8 ou superior.

2.1 - Na máquina servidora:

	- Na pasta de instalação do Apache Tomcat, copie o arquivo mysql-connector-java-5.1.39-bin.jar dentro da pasta lib. Este arquivo é conector MySQL JDBC, necessário para a conexão da aplicação servidora com o servidor MySQL. Se preferir, pode usar a versão do conector JDBC de sua preferência, porém é recomendável sempre utilizar esta versão ou outra mais atualizada.

	- No servidor MySQL, rode o script jcheckers.sql. Ele irá criar a base de dados necessária para o servidor JCheckers.

	- Para sistemas Windows, crie o diretório C:\jcheckers enquanto em sistemas Linux crie o diretório /home/jcheckers. Esse será o diretório onde estará localizada a configuração do servidor JCheckers e onde serão gravados os logs. Caso deseje que este diretório esteja em um local alternativo, crie uma variável de ambiente com o nome JCHECKERS_HOME e configure seu valor para o caminho para o diretório desejado.
	
	- Copie o arquivo config.xml para o diretório de configuração anteriormente criado.
	
	- Edite o arquivo config.xml anteriormente copiado, alterando os seguintes campos:
	
		username='<seu usuário no mysql>'
		password='<sua senha no mysql>'
		
		É necessário que o usuário escolhido possua privilégios para ao menos realizar todas as operações sobre o schema jcheckers, logo recomenda-se que seja criado um usuário somente para esse fim específico.
	
	- No Tomcat, faça o deploy do arquivo JCheckersServer.war.

3.1 - Na máquina servidora:

	- No arquivo config.xml, pode-se definir a origem da base de dados alterando os campos host e port.

	- Para que o sistema JCheckers seja acessível de outras máquinas na sua rede local ou mesmo na internet, é necessário alterar alguns campos na tabela games da base de dados jcheckers. Para isso altere todas as entradas correspondentes a coluna host (por padrão estará como localhost) com o ip de sua máquina.
	
	- Opcionalmente podem serem configurada a porta do servidor alterando-se todas as entradas correspondentes a coluna port na tabela games.

3.2 - Na máquina cliente:

	- Pode-se escolher a url do servidor alterando-se o campo url no arquivo config.xml que está no mesmo diretório onde se localiza o arquivo JCheckersClient.jar. Esta url aponta para qual endereço o aplicativo cliente irá realizar a conexão e efetuar o login ou o registro.
	
	- Alternativamente, pode-se executar o arquivo JCheckersClient.jar por linha de comando passando-lhe um único argumento indicando a url do servidor. Este argumento é opcional onde caso seja emitido, o aplicativo irá buscar a url dentro do arquivo config.xml.