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

  1. 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.

  2. Import iPortal mirror

    Place the supermap-docker-image-iportal-*.tar.gz package in any directory on the machine

    Execute 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

  1. 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
  2. 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
  3. 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
  4. 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

image42

  • 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

  1. System Requirements

    • Number of processors: 8 cores+
    • Memory: 16 GB+
    • Hard Disk: 500 GB+
  2. 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)
  3. 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
  4. 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

  1. System Requirements

    • Number of processors: 4 cores+
    • Memory: 4GB+
    • Hard Disk: 80GB+
  2. 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)
  3. 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
  4. 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 B

      The 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