Running an ICE DFSI or ISSI Gateway
Use the following instructions to construct the run command and launch an ICE DFSI or ISSI Gateway.
Prerequisites
1. Ensure you have completed all steps in Running an ICE Gateway in a Docker Container.
2. Airgap: If you are using Airgap to deploy, complete the Supporting Air-Gapped IGateway Deployments instructions.
3. After constructing the command, ensure you are in the working directory specified in the Organizing Directories section before pasting and running the command.
Process
To deploy and run an ICE Telephony Gateway, use the command below after the replacing the fields containing <> with values determined in the Required ICE Gateway Data.
Note: Ensure you replace the angle brackets <> as well as the text.
External Server Coasting is off (false) by default and may be omitted. If you wish to use Coasting, then set the <coast> value to true, otherwise set the value to false or delete the line.
Fixed Station TX Mode is digital by default. This parameter only applies to DFSIG, and accepts digital or analog settings.
To run the Gateway
1. For DFSI Copy and paste the following code into a text editor:
docker run --detach --restart always \
--net=host \
--name <gateway_type> \
-e ICE_GATEWAY_COAST='<coast>' \
-e ICE_GATEWAY_FIXED_STATION_TX_MODE='<tx_mode>' \
-e ICE_GATEWAY_HOME='/home/gateway/ice' \
-e ICE_GATEWAY_PREFERRED_INTERFACE='<nic>' \
-e ICE_AGENT_CLIENT_BRIDGE='<server address>' \
-e ICE_GATEWAY_GROUP_CODE='<group_code>' \
-e ICE_AGENT_API_KEY='<api_key>' \
-e ICE_GATEWAY='<gateway_type>' \
--device=<license_dongle> \
--volume $(pwd):/home/gateway/ice/logs \
--volume $(pwd):/home/gateway/ice/agent/log \
instantconnect/gateway-3.6.6:9096
Refer to the SAMPLE CODE section at the end of this procedure for a working example.
2. For ISSI copy and paste the following code into a text editor:
docker run --detach --restart always \
--net=host \
--name <gateway_type> \
-e ICE_GATEWAY_COAST='<coast>' \
-e ICE_GATEWAY_HOME='/home/gateway/ice' \
-e ICE_GATEWAY_PREFERRED_INTERFACE='<nic>' \
-e ICE_AGENT_CLIENT_BRIDGE='<server address>' \
-e ICE_GATEWAY_GROUP_CODE='<group_code>' \
-e ICE_AGENT_API_KEY='<api_key>' \
-e ICE_GATEWAY='<gateway_type>' \
-e ICE_GATEWAY_CONSOLE_ID='<console-id>' \
-e ICE_GATEWAY_RADIO_SYSTEM_ID='<radio-system-id>' \
--device=<license_dongle> \
--volume $(pwd):/home/gateway/ice/logs \
--volume $(pwd):/home/gateway/ice/agent/log \
instantconnect/gateway-3.6.6:9096
3. Replace the highlighted sections with the data from the Required Gateway Deployment Data list.
4. Paste and run the command.
5. Save the commands for future use.
The ICE Gateway should now appear in ICE Desktop when logged-in to your ICE Server. Navigate to Settings > Radio Interoperability and click DFSI or ISSI depending on the <gateway_type> you specified. For additional instructions refer to the following sections:
EXAMPLE CODE:
The following code example shows the syntax for a functioning DFSI Gateway command.
docker run --detach --restart always \
--net=host \
--name dfsig \
-e ICE_GATEWAY_COAST='false' \
-e ICE_GATEWAY_FIXED_STATION_TX_MODE='digital' \
-e ICE_GATEWAY_HOME='/home/gateway/ice' \
-e ICE_GATEWAY_PREFERRED_INTERFACE='eno1' \
-e ICE_AGENT_CLIENT_BRIDGE='https://yourserver.com' \
-e ICE_GATEWAY_GROUP_CODE='DGC' \
-e ICE_AGENT_API_KEY='eyJhJKLbLIOJiJ9.eyJpYXQiOjE3NDcyMzk1NDksInBpZCI6ImYxYmM3ZDBhLWVlNmYtNGVkZC1iMDFjLWZhN2M4ZjQ3YWEyZCJ9.e5OSXNoTp-fVCAw0DOP34bWIts89U0m9fJAGOoRKtrs' \
-e ICE_GATEWAY='dfsig' \
--device=/dev/bus/usb/001/002:/dev/bus/usb/001/002 \
--volume $(pwd):/home/gateway/ice/logs \
--volume $(pwd):/home/gateway/ice/agent/log \
instantconnect/gateway-3.6.6:9096