User Support
First steps
Get a real head start on the topic of Industry 4.0 with C-Gate. You can retrofit C-Gate for existing systems and welding machines as well as include it in your next new order. This page gives you an overview of how C-Gate is integrated and what you need to use C-Gate.
![](../static/img/smartphone-dashboard-oee.6c7b86b89f3bc141e8e9b9416b7d82a2.png)
Questions & Answers
-
How do I access the graphical user interface and operate C-Gate?
How do I access the graphical user interface and operate C-Gate?
- Why does no process data (e.g. voltage or current) appear on the dashboard?
- Why are my components not being recorded correctly?
-
How is overall equipment effectiveness (OEE) or QINEO productivity calculated?
How is overall equipment effectiveness (OEE) or QINEO productivity calculated?
-
Why is the overall equipment effectiveness (OEE) or QINEO productivity low?
Why is the overall equipment effectiveness (OEE) or QINEO productivity low?
The metric availability depends on the capacity planning, which corresponds to the planned working time. For example, as soon as the plant or equipment is switched off, the plant is assessed as unavailable. For the performance metric, it is important that your component programmes are equipped with the documented Carola instructions and that the target times have been entered appropriately in the component templates. The quality metric is determined either automatically, via the process data, or manually, via an entry by the worker at the machine. QS2.8 or newer, QTI and SD monitoring and the module C-Gate.QM are required for automatic determination.
- Why does incorrect time information appear on the dashboard or in the component log?
- Why are functions not licensed?
-
Why can't the robot exchange programmes with C-Gate?
Why can't the robot exchange programmes with C-Gate?
The C-Gate programme management can only be used if the C-Gate.PG module is licensed for the corresponding robot and the robot has the 'Programme management with C-Gate' option set. In addition, either the C-Gate IoT Connector address (if available) or the C-Gate IoT Hub address must be stored in the robot. Furthermore, the robot's device-specific token must be stored in the robot settings. The robot must have at least software version QS2.12. From time to time it helps if the address of the C-Gate IoT Connector in the robot is set as the default gateway in the network configuration.
- Where is my C-Gate data stored?
-
How can I create a backup of my C-Gate data?
How can I create a backup of my C-Gate data?
You can create a backup of your data with the following command. The backup is stored in the folder where the command is executed.
Linux (Docker):
# Create backup
sudo docker run --rm --volumes-from cgate -v $(pwd):/backup ubuntu tar cvzf /backup/cgate-backup.tar.gz /data
# Restore backup
sudo docker run --rm --volumes-from cgate -v $(pwd):/backup ubuntu bash -c "cd /data && tar xvzf /backup/cgate-backup.tar.gz --strip 1"Windows (WSL Ubuntu Shell):
# Create backup
podman run --rm --volumes-from cgate -v $(pwd):/backup ubuntu tar cvzf /backup/cgate-backup.tar.gz /data
# Restore backup
podman run --rm --volumes-from cgate -v $(pwd):/backup ubuntu bash -c "cd /data && tar xvzf /backup/cgate-backup.tar.gz --strip 1"For a daily backup, for example, a cron job (Linux) or a scheduled task (Windows) can be used.
For a consistent backup, it is recommended to stop the application briefly (
docker stop cgate
) and start it again after the backup (docker start cgate
). -
C-Gate asks me for access data when I start it. What do I have to enter there?
C-Gate asks me for access data when I start it. What do I have to enter there?
By default, a user with the name admin is created when C-Gate is installed. The password for this user is generated the first time the Docker Container is started and output on the command line. You can display the output of the Docker Container with the command
docker logs cgate
. The following command provides you with the output of the password generation:Linux (Docker):
sudo docker logs cgate | grep UserInitializer
Windows (WSL Ubuntu Shell):
podman logs cgate | grep UserInitializer
With the Windows installation, the access data is also displayed once at the end of the installation.
-
How can I reset my password?
How can I reset my password?
You can force a new admin password by setting the environment variable
APP_ADMIN_PASSWORD='NewPassword'
for your C-Gate container. For a Docker installation with Docker Compose, for example, you can set this variable in the docker-compose.yml file below theenvironment
line.Example:
...
environment:
- APP_ADMIN_PASSWORD="MySecretPassword"
...If you have installed C-Gate with our Windows instructions, you can set the password in the file
~/.config/cgate/cgate.conf
within the WSL by entering the following line:APP_ADMIN_PASSWORD="MySecretPassword"
-
How do I connect my devices to C-Gate?
How do I connect my devices to C-Gate?
- First of all, a physical connection should be available. For CLOOS robot systems, this is usually a network cable connected to the robot controller and your company network. QINEO welding units can alternatively be connected via Wifi.
- Then your devices need an IP address and corresponding network settings so that they can be reached from the server or PC on which C-Gate IoT Hub is installed. Please refer to the respective device manual for information on how to adjust the network settings. The network settings should be assigned according to your IT policy. You can check the connection by running a
ping
on the device IP from the server or PC using C-Gate. - Follow the C-Gate instructions on the C-Gate web interface to activate your licence. You can then configure your devices in the device view on C-Gate. Enter the corresponding IP addresses of the devices there.
If everything is set up correctly, the devices appear as online in the C-Gate device view.
If you are still unable to connect, please refer to our notes on firewall rules.
-
Which firewall rules and ports must be observed?
Which firewall rules and ports must be observed?
The following ports are relevant for accessing the C-Gate IoT Hub :
Inbound 80 TCP Web interface and API Inbound 4840 TCP OPC UA server for the connection of your MES and ERP systems Inbound 5679 TCP RPC interface for the C-Gate IoT Connector Without IoT Connector, the C-Gate IoT Hub additionally establishes connections to the following ports:
Outgoing 48010 TCP Robot systems Outgoing 52341 TCP Welding equipment Outgoing 4840 TCP PLCs With QIROX Legacy Hardware (hardware older than V7) the following additional ports are used:
Inbound 5000 TCP Inbound 5000 UDP Inbound 5005 TCP Inbound 5010 TCP -
How can I update C-Gate IoT Hub ?
How can I update C-Gate IoT Hub ?
C-Gate can be brought up to date with a new container image.
Linux (Docker):
cd /opt/cloos/cgate/
docker compose pull
docker compose up -dLinux (Docker-Compose):
cd /opt/cloos/cgate/
docker-compose pull
docker-compose up -dWindows:
In the Start menu under the folder C-Gate there is an update script which performs an update to the current stable version.
Existing data is automatically migrated by the application when it is updated. Depending on the amount of data, the migration process may delay the start of the new application version by a few minutes. The application is not available during this time.
-
What is inside the C-Gate container?
What is inside the C-Gate container?
The C-Gate IoT Hub container is based on a current official Ubuntu base image and contains the following services. Only services with a corresponding port specification can be accessed from outside the container. Services without port specifications can only be accessed within the container and are therefore protected from external access.
-
Why does Windows block the execution of the C-Gate installation?
Why does Windows block the execution of the C-Gate installation?
Downloaded .exe files are easily classified as a threat by Windows. The following Powershell command can be used to correct this classification for the file:
cd Downloads
Unblock-File -Confirm:$false '.\C-Gate IoT Hub Setup.exe'If the installation or execution of included script files is still blocked, please install our Cloos certificate in your system and try again. Please make sure to select "Trusted Root Certification Authorities" as the location for the certificate during installation.
-
I have manually installed C-Gate on Windows using Docker Desktop. How do I migrate my data to the new version with the C-Gate installer?
I have manually installed C-Gate on Windows using Docker Desktop. How do I migrate my data to the new version with the C-Gate installer?
The new C-Gate installer for Windows automatically detects a previous installation with Docker Desktop and imports the data during the installation. After the installation, please make sure that your C-Gate installation works as usual. Afterwards, please delete the C-Gate container from Docker Desktop so that it does not start again automatically after a reboot.
-
The update of my C-Gate installation under Windows reports an error with access data. How can I fix this?
The update of my C-Gate installation under Windows reports an error with access data. How can I fix this?
With an older C-Gate installation under Windows, the access data to the CLOOS Docker Repository was partly not permanently stored. To fix the problem, please execute the following command in your WSL installation (Ubuntu) and enter the access data you received with your C-Gate licence:
podman login --authfile=${HOME}/.docker/config.json docker.cloos.de
Documentation
-
Data points
Description of all data points and their statuses -
OPC UA interface
Description of the OPC UA interface of C-Gate -
Carola-requirements
Requirements for the robot programme for component recording and system efficiency -
Overall Equipment Effectiveness (OEE) and Productivity
Explanations for calculating the overall system effectiveness for C-Gate -
Programme management with C-Gate
Requirements and connection of the robot's programme management
Ralf Pfeifer, Head of IT and Organisation, Carl Cloos Schweißtechnik GmbH The user recognises any weak points in the production process at an early stage and can significantly reduce system downtimes or waiting times due to set-up and adjustment as well as other idle phases. With extensive evaluation options and statistics on key performance indicators, we support our customers on their way to networked production. Through continuous dialogue with our customers, we can optimally develop C-Gate.