guide to install and configure mago3d on windows 10

Guide

install softwares

• mago3d: v1.0.0 from

  wget https://codeload.github.com/Gaia3D/mago3d/zip/v1.0.0

  Unzip to C:\git\repository\mago3d

• java: java jdk-8u161

  wget http://download.oracle.com/otn-pub/java/jdk/8u161-b12/2f38c3b165be4555a1fa6e98c45e0808/jdk-8u161-windows-x64.exe

  java -version
  1.8.0_161
  

• eclipse: eclipse Oxygen (NOT USE FOR NOW)

  wget http://ftp.jaist.ac.jp/pub/eclipse/oomph/epp/oxygen/R/eclipse-inst-win64.exe

  Install lombok plugin and import Gradle Project

• Intellij IDEA: 2018.1 (USE THIS)

  Install lombok plugin by File->Settings->Plugins->Browse repositories... and search for lombok online and install.
  And then import Gradle Project

• PostgreSQL: PostgreSQL10.3 64bit

  Installation path C:\Program Files\PostgreSQL\10\bin

  postgres,postgres
  port:5432

• PostGIS: PostGIS bundle 2.4.3

  wget http://download.osgeo.org/postgis/windows/pg10/postgis-bundle-pg10x64-setup-2.4.3-1.exe

• gradle: gradle 4.6

  wget https://downloads.gradle.org/distributions/gradle-4.6-bin.zip

  add C:\Gradle\gradle-4.6\bin to System Path.

  gradle -v 
  4.6
  

• lombok: jar 1.16.20

  wget https://projectlombok.org/downloads/lombok.jar

DB creation & initial data registration

1. add variable PGPASSWORD with value postgres to System Path to avoid input password with psql.

2. start pgAdmin and create database mago3d with following options.

   Name:mago3d, 
   Encoding:UTF-8, 
   Template:template0, 
   Collation:C, 
   Character type:C, 
   Connection Limit:-1
   

   or with sql

   CREATE DATABASE mago3d
    WITH 
    OWNER = postgres
    TEMPLATE = template0
    ENCODING = 'UTF8'
    LC_COLLATE = 'C'
    LC_CTYPE = 'C'
    TABLESPACE = pg_default
    CONNECTION LIMIT = -1;
   

   tips: how to change postgres password?

      psql -h 192.168.1.100 -p 5432 -U postgres -d mydb
      psql> alter user postgres with password 'new password';
      psql> \h \q
   

3. create extension for mago3d.

   

4. load data into mago3d
   edit mago3d-core/src/doc/en/database/dbinit.bat

   :: cd C:\PostgreSQL\9.6\bin\
   cd C:\Program Files\PostgreSQL\10\bin
   

   and run dbinit.bat from command.

    C:\git\repository\mago3d\mago3d-core\src\doc\en\database> .\dbinit.bat
   

5. db symbolic link

   Execute Command Line Prompt (cmd.exe) with administrative privileges

   C:\git\repository\mago3d\mago3d-user\src\main\webapp > mklink /d "C:\git\repository\mago3d\mago3d-user\src\main\webapp\f4d" "C:\f4d"
   

lombok plugin with eclipse

wget http://projectlombok.googlecode.com/files/lombok.jar 
java -jar  ./lombok.jar 

select path to eclipse and click install/update

check the result:
(1) -javaagent:C:\Users\zunli\eclipse\jee-oxygen\eclipse\lombok.jar in C:\Users\zunli\eclipse\jee-oxygen\eclipse\eclipse.ini
(2) lombok.jar has been copied to eclipse plugins folder C:\Users\zunli\eclipse\jee-oxygen\eclipse\plugins.

restart eclipse and import settings.gradle.

install lombok plugin for IDEA

Install lombok plugin by File->Settings->Plugins->Browse repositories... and search for lombok online and install.

enable anonation processing

File->Settings->Compiler->Anonation Processers->Enable Anonation Processing (Check ON)

import lombok libraries

File->Project Structure->Libraries->...

run adminApplication

config

By default, program use postgres as username,and postgres as password for magoed database.

spring.datasource.username=nvdm6E6o5Fr3x2a877fl/w==
spring.datasource.password=nvdm6E6o5Fr3x2a877fl/w==

run admin

start /mago3D-admin/src/main/java/com/gaia3d/mago3DAdminApplication.java

and access http://localhost:9090/login/login.do
login with admin as username and admin as password.

Reference

• mago3d github
• gradle

History

• 20180331: created.