Guides
Deploy On Linux
Fast Deployment
System Requirements
- Number of processors: 4 cores+
- Memory: 8 GB+
- Hard Disk: 200 GB+
Please refer to Appendix in the end of the page to see the resource useage for each scenario when creating GIS application.
Prepare Install Package
Get the following packages from SuperMap:
supermap-imanager-*-*-*-linux64-docker.tar.gz
(iManager package, * indicates version, any version is ok)supermap-docker-image-iserver-*.tar.gz
(iserver docker image, * indicates version, any version is ok)supermap-docker-image-iportal-*.tar.gz
(iportal docker image, * indicates version, any version is ok)offline-docker-*.tar.gz
(docker offline install package, * indicates operating system and version, select your operating system)
Install Docker
Notes:
Please install docker on clean machine.
Place the offline-docker-*.tar.gz
package in any directory on the machine.
Extract:
tar -zxf offline-docker-*.tar.gz
Go find the readme.txt file in the extracted folder, follow the step to install Docker.
Verify:check docker version,if you see the output like Docker version 17.06.0-ce, build 02c1d87,Docker install successfully
docker -v
Import Required Docker Mirror
-
Import iServer mirror
Place the
supermap-docker-image-iserver-*.tar.gz
packge in any directory on the machine, and execute:tar -zxf supermap-docker-image-iserver-*.tar.gz
Enter the extracted root directory:
cd supermap-docker-image-iserver
Execute the command under the ‘supermap-docker-image-iserver’ folder to import:
chmod +x ./images/pkg-out.sh && ./images/pkg-out.sh
Notes:
If you need to create GIS server, please associate the GIS server temple to the imported image in the iManager environment type page, namely: supermap/iserver-iaas-docker:latest.
-
Import iPortal mirror
Place the
supermap-docker-image-iportal-*.tar.gz
package in any directory on the machineExecute the unzip command (modify the package name to the real package name):
tar -zxf supermap-docker-image-iportal-*.tar.gz
Enter the extracted root directory:
cd supermap-docker-image-iportal
Execute the command under the ‘supermap-docker-image-iportal’ folder to import:
chmod +x ./images/pkg-out.sh && ./images/pkg-out.sh
Note:
If you need to create GIS portal, please associate the GIS portal temple to the imported image in the iManager environment type page, namely: supermap/iportal-iaas-docker:latest.
Install iManager
-
Install iManager
Place the
supermap-imanager-*-*-*-linux64-docker.tar.gz
package in any directory on the machine, and unzip it with the following command (modify the package name to the actual package name)tar -zxf supermap-imanager-*-*-*-linux64-docker.tar.gz
Enter the extracted root directory:
cd supermap-imanager-docker
Perform the following command in the current directory to install iManager
chmod +x install.sh && ./install.sh
-
Tuning Parameters
Under the current directory, execute the following command to edit the. env file for iManager configuration
vi .env
Modify the following parameter values:
# Reuqired, the IP that can be externally accessible for the machine where iManager is. It is used to configure iManager, ElasticSearch, Zabbix, Kibana. IMANAGER_HOST_IP= # Optional, iManager mirroring and the private storage address of the mirror that the iManager must depend on. Pay attention to the end with /. The mirroring contained in the current Docker assemble package does not contain a repository address, and is empty by default. If you need to update the iManager and the iManager-dependent image from your own repository or public network repository, modify this value to replace it. IMANAGER_REGISTRY_URL= # Optional, IAAS platform type. It is empty by default and take the value range: [VSPHERE,DOCKER,OPENSTACK,FUSIONCOMPUTE,FUSIONCOMPUTE_R5]. IAAS_TYPE= # Optional, Docker which is used to create GIS environment ,The value will be used only when the IaaS platform type is DOCKER,the default value is the Docker where iManager is installed. IAAS_DOCKER_IP= # Optional, Docker used by the compose application. Here is the IP of the local machine (note: 127.0.0.1/localhost is not allowed). COMPOSE_DOCKER_IP= # Optional, License Server address (leave blank for trial license). LICENSE_SERVER= # Optional, set KIBANA Port, the default is 5601. KIBANA_PORT=5601 # Optional, enable/disable intelligent alarm, the default is enable. AIOPS_ENABLED=true # Optional, the password of iManager admin account for intelligent alarm. AIOPS_IMANAGER_SERVER_PASSWORD= # Optional, the address of iManager documentation, the default is https://help.supermap.com/iManager. IMANAGER_HELP_URL= # Optional, enable/disable HUAWEI login, the default is false. IAM_LOGIN_ENABLE=false # Optional, the address of HUAWEI login, for example, https://qa-iam-bam.besclouds.com:8081. IAM_LOGIN_URL= # Optional, the value of client_id of HUAWEI account. IAM_CLIENT_ID= # Optional, the value of client_secret of HUAWEI account. IAM_CLIENT_SECRET= # Optional, whether to back to login UI after HUAWEI account logout, the default is false. IAM_REDIRECT_TO_LOGIN=false
-
Start/Stop iManager
Start iManager
./startup.sh
Notes:
If the elastic container reports an error when starting iManager, please refer to Tutorial > Appendix > FAQ Question 15 to solve the problem. Or you can install iManager with root permission(add ‘sudo’ when executing commands) to avoid the problem.
Stop iManager:
./shutdown.sh
-
Access imanager services
http://{IP}:8390/imanager
Where {IP} is IP of the local machine
The login account is admin/admin
Production Environment Deployment
Environment description
- We need to prepare two machines: machine A and machine B.
- Deploy the Docker environment on Machine A, which is used to support iManager Compose applications as well as big data functions.
- Deploy iManager on Machine B.
Deploy machine A
-
System Requirements
- Number of processors: 8 cores+
- Memory: 16 GB+
- Hard Disk: 500 GB+
-
Prepare Install Package
Get the following packages from SuperMap:
supermap-docker-image-iportal-*.tar.gz
(* indicates application type and version, it depends on the requirement of user)offline-docker-*.tar.gz
(docker offline install package, * indicates operating system and version, select your operating system)
-
Install Docker
Notes:
Please install docker on clean Linux machine.
Place the
offline-docker-*.tar.gz
package in any directory on the machine.Extract (modify the package name to the actual package name):
tar -zxf offline-docker-*.tar.gz
Go find the readme.txt file in the extracted folder, follow the step to install Docker.
Verify:check docker version,if you see the output like ”*_Docker version *.*.*”, it means install successfully
docker -v
-
Import Required Docker Mirror
Place the
supermap-docker-image-*.tar.gz
package in any directory on the machine, and extract (modify the package name to the actual package name):tar -zxf supermap-docker-image-*.tar.gz
Enter the unzipped root directory (modify to actual path):
cd supermap-docker-image-*
Execute the command under the folder to import:
chmod +x ./images/pkg-out.sh && ./images/pkg-out.sh
Notes:
If you need to create GIS server/Portal, please associate the GIS server/portal temple to the imported image in the iManager environment type page, namely: supermap/iserver-iaas-docker:latest (supermap/iportal-iaas-docker:latest).
Deploy machine B
-
System Requirements
- Number of processors: 4 cores+
- Memory: 4GB+
- Hard Disk: 80GB+
-
Prepare Install Package
Get the following packages from SuperMap:
supermap-imanager-*-*-*-linux64-docker.tar.gz
(* indicates version, any version is ok).offline-docker-*.tar.gz
(docker offline install package, * indicates operating system and version, select your operating system)
-
Install Docker
Notes: Please install docker on clean Linux machine.
Place
offline-docker-*.tar.gz
package in any directory on the machine.Unzip (modify the package name to the actual package name):
tar -zxf offline-docker-*.tar.gz
Go find the readme.txt file in the extracted folder, follow the step to install Docker.
Verify:check docker version,if you see the output like ”*_Docker version *.*.*”, it means install successfully
docker -v
-
Install iManager
-
Install iManager
Place the
supermap-imanager-*-*-*-linux64-docker.tar.gz
package in any directory on the machine.Unzip (modify the package name to the real package name):
tar -zxf supermap-imanager-*-*-*-linux64-docker.tar.gz
Enter the unzipped root directory (modify to actual path):
cd supermap-imanager-docker
Perform the following command in the current directory to install iManager
chmod +x install.sh && ./install.sh
-
Tuning Parameters
Under the current directory, execute the following command to edit the. env file for iManager configuration
vi .env
Modify the following parameter values:
# IP that can be externally accessible for the machine where iManager is(required). It is used to configure iManager, ElasticSearch, Zabbix, Kibana IMANAGER_HOST_IP= # Docker used by the compose application. Here is the IP of the machine A (note: 127.0.0.1/localhost is not allowed) # IAAS platform type. Here we input Docker, indicating using the Docker environment of machine A. If you want to use other IaaS platforms, modify them (if IaaS not employed, leave it blank) and take the value range: [VSPHERE,DOCKER,OPENSTACK,FUSIONCOMPUTE,FUSIONCOMPUTE_R5] IAAS_TYPE=DOCKE # Docker which is used to create GIS environment ,The value will be used only when the IaaS platform type is DOCKER,the default value is the Docker where iManager is installed. IAAS_DOCKER_IP= # The IP is used for compose application,The IP is the ip of machine A COMPOSE_DOCKER_IP= # License Server address (leave blank for trial license) LICENSE_SERVER= # Set KIBANA Port KIBANA_PORT=5601
-
Start/Stop iManager
Start iManager
./startup.sh
Notes:
If the elastic container reports an error when starting iManager, please refer to Tutorial > Appendix > FAQ Question 15 to solve the problem. Or you can install iManager with root permission(add ‘sudo’ when executing commands) to avoid the problem.Stop iManager:
./shutdown.sh
-
Access iManager services
http://{IP}:8390/imanager
Where
{IP}
is IP of machine BThe login account is admin/admin
-
Appendix
Compose application the resource useage for each scenario(To create an environment, for example, CPU needs to deploy the environmental system requirement)
Compose Application | Memory |
---|---|
GIS Site | 2G |
MySQL Application Set | 500M |
SGS | 4G |
SGS(Multi-machine) | 4G |
SGS(Elastic) | 4G |
SGS(Elastic)(multi-machine) | 4G |
GIS Big Data Site | 4G |
GIS Big Data Site(Multi-machine) | 4G |