{"type":"doc","content":[{"type":"heading","attrs":{"level":4},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install ","type":"text"},{"text":"maven v3.2.x","type":"text","marks":[{"type":"link","attrs":{"href":"http://maven.apache.org/download.cgi"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install ","type":"text"},{"text":"PostgreSQL v9.6","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.postgresql.org/download/"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install ","type":"text"},{"text":"Elastic Search v2.4.x","type":"text","marks":[{"type":"link","attrs":{"href":"https://download.elasticsearch.org/elasticsearch/elasticsearch/elasticsearch-2.4.1.zip"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install ","type":"text"},{"text":"Jboss Wildfly v10.x","type":"text","marks":[{"type":"link","attrs":{"href":"https://devops.egovernments.org/Downloads/wildfly/wildfly-14.0.1.Final.zip"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install ","type":"text"},{"text":"Git 2.8.3","type":"text","marks":[{"type":"link","attrs":{"href":"https://git-scm.com/downloads"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install ","type":"text"},{"text":"JDK 8 update 112 or higher","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.oracle.com/technetwork/java/javase/downloads"}}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Database Setup","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a database and user in postgres","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a schema called ","type":"text"},{"text":"generic","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Execute ","type":"text"},{"text":"ALTER ROLE SET search_path TO generic,public;","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Elastic Search Setup","type":"text"}]},{"type":"paragraph","content":[{"text":"Elastic seach server properties needs to be configured in ","type":"text"},{"text":"elasticsearch.yml","type":"text","marks":[{"type":"code"}]},{"text":" under ","type":"text"},{"text":"/config","type":"text","marks":[{"type":"code"}]}]},{"type":"codeBlock","content":[{"text":"## Your local elasticsearch clustername, DO NOT use default clustername\ncluster.name: elasticsearch-\n## This is the default port\ntransport.tcp.port: 9300","type":"text"}]},{"type":"paragraph","content":[{"text":"NB: ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" user name of the loggedin system, enter the below command in terminal to find the username.","type":"text"}]},{"type":"codeBlock","content":[{"text":"$ id -un","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Building Source","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Clone the eGov repository (development is done on the ","type":"text"},{"text":"develop","type":"text","marks":[{"type":"code"}]},{"text":" branch.","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"$ mkdir egovgithub\n$ cd egovgithub\n$ git clone https://github.com/egovernments/egov-smartcity-suite.git\n$ git checkout develop","type":"text"}]},{"type":"paragraph","content":[{"text":"2. Change directory to ","type":"text"},{"text":"/egov/egov-config/src/main/resources/config/","type":"text","marks":[{"type":"code"}]},{"text":" and create a file called ","type":"text"},{"text":"egov-erp-.properties","type":"text","marks":[{"type":"code"}]},{"text":" and enter the following values based on your environment config.","type":"text"}]},{"type":"codeBlock","content":[{"text":"##comma separated list of host names \nelasticsearch.hosts=localhost\nelasticsearch.port=9300\nelasticsearch.cluster.name=elasticsearch-","type":"text"}]},{"type":"paragraph","content":[{"text":"If required, you can override any default settings available in ","type":"text"},{"text":"/egov/egov-egi/src/main/resources/config/application-config.properties","type":"text","marks":[{"type":"code"}]},{"text":" by overriding the value in ","type":"text"},{"text":"egov-erp-.properties","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"3. Change directory back to ","type":"text"},{"text":"/egov","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"4. Run the following commands, this will cleans, compiles, tests, migrates database and generates ear artifact along with jars and wars appropriately","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn clean package -s settings.xml -Ddb.user= -Ddb.password= -Ddb.driver=org.postgresql.Driver -Ddb.url=","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Redis Server Setup","type":"text"}]},{"type":"paragraph","content":[{"text":"By default eGov suit uses embedded redis server (work only in Linux & OSx), to make eGov suit works in Windows OS or if you want to run redis server as standalone then follow the installation steps below.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Installing redis server on Linux","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"sudo apt-get install redis-server","type":"text"}]},{"type":"paragraph","content":[{"text":"2. Installing redis server on Windows :- There is no official installable available for Windows OS. To install redis on Windows OS, follow the instruction given in ","type":"text"},{"text":"https://chocolatey.org/packages/redis-64","type":"text","marks":[{"type":"link","attrs":{"href":"https://chocolatey.org/packages/redis-64"}}]}]},{"type":"paragraph","content":[{"text":"3. Once installed, set the below property in ","type":"text"},{"text":"egov-erp-override.properties","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"egov-erp-.properties","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"codeBlock","content":[{"text":"## true by default\nredis.enable.embedded=false","type":"text"}]},{"type":"paragraph","content":[{"text":"to control the redis server host and port use the following property values (only required if installed with non default).","type":"text"}]},{"type":"codeBlock","content":[{"text":"## Replace with your redis host, localhost by default\nredis.host.name=\n## Replace with your redis port, 6379 by default\nredis.host.port=","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Deploying Application","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Configuring JBoss Wildfly","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download and unzip the customized JBoss Wildfly Server from ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://devops.egovernments.org/Downloads/wildfly/wildfly-11.0.0.Final.zip"}}]},{"text":". This server contains some additional jars that are required for the ERP.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In case properties needs to be overridden, edit the below file (This is only required if ","type":"text"},{"text":"egov-erp-.properties","type":"text","marks":[{"type":"code"}]},{"text":" is not present)","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"/modules/system/layers/base/\n\norg\n└── egov\n └── settings\n └── main\n ├── config\n │ └── egov-erp-override.properties\n └── module.xml","type":"text"}]},{"type":"paragraph","content":[{"text":"3. Update settings in ","type":"text"},{"text":"standalone.xml","type":"text","marks":[{"type":"code"}]},{"text":" under ","type":"text"},{"text":"/standalone/configuration","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check Datasource setting is in sync with your database details.","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"jdbc:postgresql://localhost:5432/\n\n \n ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check HTTP port configuration is correct in","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"4. Change directory back to ","type":"text"},{"text":"/egov/dev-utils/deployment/","type":"text","marks":[{"type":"code"}]},{"text":" and run the below command","type":"text"}]},{"type":"codeBlock","content":[{"text":"$ chmod +x deploy.sh\n$ ./deploy.sh","type":"text"}]},{"type":"paragraph","content":[{"text":"Alternatively this can be done manually by following the below steps.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy the generated exploded ear ","type":"text"},{"text":"/egov/egov-ear/target/egov-ear-.ear","type":"text","marks":[{"type":"code"}]},{"text":" in to your JBoss deployment folder ","type":"text"},{"text":"/standalone/deployments","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create or touch a file named ","type":"text"},{"text":"egov-ear-.ear.dodeploy","type":"text","marks":[{"type":"code"}]},{"text":" to make sure JBoss picks it up for auto deployment","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"5. Start the wildfly server by executing the below command","type":"text"}]},{"type":"codeBlock","content":[{"text":" $ cd /bin/\n $ nohup ./standalone.sh -b 0.0.0.0 &","type":"text"}]},{"type":"paragraph","content":[{"text":"In Mac OSx, it may also required to specify ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Djboss.modules.system.pkgs=org.jboss.byteman","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"b 0.0.0.0","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":" only required if application accessed using IP address or domain name.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Monitor the logs and in case of successful deployment, just hit ","type":"text"},{"text":"http://localhost:/egi","type":"text","marks":[{"type":"code"}]},{"text":" in your favorite browser.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Login using username as ","type":"text"},{"text":"egovernments","type":"text","marks":[{"type":"code"}]},{"text":" and password ","type":"text"},{"text":"demo","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Accessing the application using IP address and domain name","type":"text"}]},{"type":"paragraph","content":[{"text":"This section is to be referred only if you want the application to run using any ip address or domain name.","type":"text"}]},{"type":"heading","attrs":{"level":6},"content":[{"text":"1. To access the application using IP address:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Have an entry in eg_city table in database with an IP address of the machine where application server is running (for ex: domainurl=\"172.16.2.164\") to access application using IP address.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Access the application using an url ","type":"text"},{"text":"http://172.16.2.164:8080/egi/","type":"text","marks":[{"type":"link","attrs":{"href":"http://172.16.2.164:8080/egi/"}}]},{"text":" where 172.16.2.164 is the IP and 8080 is the port of the machine where application server is running.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":6},"content":[{"text":"2. To access the application using domain name:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Have an entry in eg_city table in database with domain name (for ex: domainurl= \"","type":"text"},{"text":"www.egoverpphoenix.org","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.egoverpphoenix.org"}}]},{"text":"\") to access application using domain name.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add the entry in hosts file of your system with details as 172.16.2.164 ","type":"text"},{"text":"www.egoverpphoenix.org","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.egoverpphoenix.org"}}]},{"text":" (This needs to be done both in server machine as well as the machines in which the application needs to be accessed since this is not a public domain).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Access the application using an url ","type":"text"},{"text":"http://www.egoverpphoenix.org:8080/egi/","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.egoverpphoenix.org:8080/egi/"}}]},{"text":" where ","type":"text"},{"text":"www.egoverpphoenix.org","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.egoverpphoenix.org"}}]},{"text":" is the domain name and 8080 is the port of the machine where application server is running.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Always start the wildfly server with the below command to access the application using IP address or domain name.","type":"text"}]},{"type":"codeBlock","content":[{"text":" nohup ./standalone.sh -b 0.0.0.0 &","type":"text"}]},{"type":"paragraph","content":[{"text":"Note","type":"text","marks":[{"type":"strong"}]},{"text":": This system is supported","type":"text"}]},{"type":"paragraph","content":[{"text":"OS:-","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Linux (Recommended)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mac","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Windows (If Redis server standalone installed).","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Browser:-","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Chrome (Recommended)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Firefox","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Internet Explorer","type":"text"}]}]}]}],"version":1}

Browser not supported