Defining extra hosts for Docker deployments

This section provides information on defining extra hosts for Docker deployments.

About this task

It has been reported on CentOS 8 that in some cases hostnames fail to resolve properly. If the DNS is unreliable in resolving host names to IP addresses, these can be defined manually in the configuration. These steps work for all supported Linux versions.

Note: When modifying the yml file, the indentations of these entries are spaces, not tabs (do not use tabs). These entries MUST line up exactly. Use the “networks:” placement as a reference for “extra_hosts:” and the “sametime.test:” placement as a reference for where the “-”.

Procedure

  1. Open the docker-compose.yml in edit mode.
  2. Locate the auth: section of the file. At the bottom of the auth section after:
    networks:  
              
              sametime.test:  
              
              aliases:  
              
              - meeting-auth  
    Add:
     extra_hosts:  
    
                - "<stproxy_host_name>:<stproxy_ip_address>" 

    Where <stproxy_host_name> is the fully qualified hostname of the Sametime Proxy Server, and <stproxy_ip_address> is the IP address of the Sametime Proxy Server.

    Locate the recordings: section of the file. At the bottom of the recordings section after:
    networks: 
    
                sametime.test: 
    Add:
    extra_hosts:  
    
                - "<stproxy_host_name>:<stproxy_ip_address>" 
    Locate the nginx: section of the file. At the bottom of the nginx section after:
    networks:  
    
                sametime.test:  
    
                    aliases:  
    
                        - ${XMPP_DOMAIN} 
    Add:
    extra_hosts:  
    
                - "<stproxy_host_name>:<stproxy_ip_address>" 
    At the bottom of the jvb section after:
    networks:  
    
                sametime.test:  
    Add:
    extra_hosts:  
    
                - "stun.l.google.com:209.85.144.127"  
    
                - "stun1.l.google.com:172.217.192.127"  
    
                - "stun2.l.google.com:66.102.1.127"  
    Note: Resolve the hostnames of the Google STUN servers and use the corresponding IP address for your region. You can also define a separate STUN server host if you are not using the Google STUN servers.

    In the catalog: section. At the bottom of the catalog section after:
    networks:  
    
                sametime.test:  
    Add:
    extra_hosts:  
    
                - "<mongoDB_host>:<mongoDB_IP_Address" 

    Where <mongoDB_host> is the fully qualified hostname of the MongoDB server and <mongoDB_IP_Address> is the IP address of the MongoDB server.

  3. Review formatting and correct any indentations (using spaces).
  4. Save the changes.
  5. Install or reinstall the server using the remaining steps from Installing Sametime Meetings on Docker.