Changes

Trutzbox Manual

44,929 bytes added, 6 years ago

→‎Comidio Customer Area (-> for users)

[[#top|-> Table of Contents (of this manual)]]

== Application example ==

=== Limiting TV tracking ===

The number of companies interested in data is increasing rapidly. Even with a television, you can no longer be sure that no personal data is transmitted to TV stations or even manufacturers. Even in its terms of use, the TV manufacturer Samsung recommends not to say anything private in the presence of a smart TV, because speech recognition could transmit this anywhere (https://netzpolitik.org/2015/samsung-warnt-bitte-achten-sie-darauf-nichts-privates-vor-unseren-smarttvs-zu-erzaehlen/).

But not only the microphone or even the camera on the TV could spy on the user. Current generations of television are getting closer and closer to the technology of smart phones by extending the functionality of the television by downloading apps. And there is interactive TV (HbbTV). This enables app providers, TV set manufacturers, HbbTV providers, providers of electronic program guides (Electronic Program Giude - EPG) and TV stations to track user behavior (https://netzpolitik.org/2015/studie-anonyme-nutzung-von-smart-tvs-kaum-moeglich/ und https://www.lda.bayern.de/lda/datenschutzaufsicht/lda_daten/150227%20PM%20Datenschutz%20und%20Smart-TV.pdf).

So the question arises: how can you limit the tracking of the TV with the TrutzBox?

Here a short manual ...

First you have to make sure that the TV set only communicates to the Internet via the TrutzBox. The easiest way to do this is to connect the TV set to the TrutzBox via LAN cable or WLAN. After that, all standard TrutzBox filters for HTTP and HTTPS (i.e. ports 80 and 443) will automatically take effect.

Here at the example of a television of the type "Sony Bravia"

After switching on the TV set, TrutzBrowse shows that the TV is loading some data from sony.net and encrypted JS programs, pictures and other data from playstation.net.

[[File:Fernseher einschränken-PastedGraphic-3.png|756x756px]]

In the further process, when one clicks through the menus of the television the Internet video offers, further profile data are transferred to playstation.net:

[[File:Fernseher einschränken-PastedGraphic-4.png]]

If you then call up the news on the TV via the Internet, it not only downloads data from Tagesschau.de, but also images from secure.footprint.net. Thus the American service provider Markmonitor (https://www.markmonitor.com) also gets the information that someone here retrieves data:

[[File:Fernseher einschränken-PastedGraphic-5.png]]

All this information exchanged via http/https (port 80/443) is already controlled by the TrutzBox. The TrutzBox function TrutzBrowse used the default profile to manipulate the http header data. With the menu item TrutzContent you can now also block individual URLs (domains) to which you do not want to supply data. E.g. "secure.footprint.net".

However, the TV can also exchange data via protocols and ports other than http. These ports/protocols can be controlled and blocked with TrutzBase.

What to do if... ? ==

=== ... WLAN is not working? ===

If the TrutzBox WLAN is not visible, i.e. does not show an SSID (WLAN ID defined by the administrator during setup) and the WLAN button in the TrutzBox user interface in the "TrutzBox Übersicht" is gray instead of green, proceed as follows:

*In the TrutzBox user interface go to "Netzwerk" -> "WLAN", scroll down completely and click on the "Apply" button at the bottom.

Wait a moment and check whether the SSID is visible.

If not visible, restart the TrutzBox:

*In the TrutzBox user interface, click on "System" -> "Ein-/Ausschalten" and wait until the TrutzBox has shut down and started up again automatically.

Rebooting takes about 15 minutes.

Then check whether the SSID is visible.

If not visible, a factory reset may have to be performed.

*In this case, please contact Comidio Support so that they can accompany the factory reset by telephone if necessary.

=== ... a SmartPhone/Tablet app does not work? ===

Sometimes it is difficult to find out which servers an app wants to access. These must be identified in order to be able to assign SecurityLevel 9 or even 10 to their addresses, if necessary.

#Start and stop the app concerned because some SSL connections are enabled for the app the first time the app is started on the TrutzBox.

#In the TrutzBox user interface under "TrutzBox Filter" -> "Status" in the tab of the relevant device, delete the status: "Delete history". This prevents other accesses from covering the searched accesses.

#Then restart the app on the smartphone/tablet.

If the app does not yet work, under Status press "Neu laden" again to see which accesses are not on L10. If necessary, set this to L10.

Sometimes an app wants to access several sub-domains of xyz.com. In this case it may help if all sub-domains are activated by entering "*.xyz.com.

=== ... the browser and/or mail program reports a problem with the certificate? ===

That's normal. Import the TrutzBox® certificate into the browser and the mail program. Download the TrutzBox® certificate from the TrutzBox user interface (https://trutzbox/#mail/status).

=== ... the TrutzBurg (symbol of the TrutzBox in the upper right corner of the browser window) is not displayed ===

'''Browser Update?'''

Please check first if your browser is up to date; if not, update it.

'''NoScript" off?'''

The TrutzBurg (top right) is "injected" into the website by software. This only works if Java-Script is activated in the browser.

Therefore, the Java script should NOT be deactivated in the browser: the button should be set at: "Skripte allgemein erlauben", or the extension (add-on) "NoScript" should not be loaded or not activated.

Pop-ups allowed?'''

Please make sure that pop-ups are allowed.

If the TrutzBurg is still not displayed, please proceed according to the following flowchart or table:

[[File:20170130 Wenn TrutzBox Symbol nicht gezeigt wird Diagramm V02.png|700px|link=]]

[[#top|-> Table of Contents (of this manual)]]

<tr>

<td width="230">1. Check if TrutzBrowse works correctly </td>

<td width="230"> Opening in TrutzBox User Interface: TrutzBox Filter -> Status

If the call '''xyz.de''' is displayed for the device used?

</td>

<td width="230"> No, so call did not go via TrutzBrowse; continue with 2.

Yes, with level 1-9; continue with 4.

Yes, with level 10; continue with 5. </td>

</tr>

<tr>

<td>2. Does the current device access in "Transparentmodus" or in "Proxymodus"?</td>

<td>Determination of operating mode

*„transparent mode“:

Device is directly connected to TrutzBox via (W)LAN

*„proxy mode“:

The device is connected to the Internet Router and the TrutzBox is entered in the browser as a proxy (= quasi detour).

</td>

In transparent mode the TrutzBox is switched on quasi automatically and should work, then with 6.

If the device is or should be connected to the Internet Router (proxy mode), continue with 3.

</td>

</tr>

<tr>

<td>3. is TrutzBox activated as a proxy in the browser?</td>

dd>Proxy Activation Detection

*Is the TrutzBox "pac file" entered and activated in the browser?

(see manual 6.2.1)

*Is the corresponding software switch set up and switched on?

</td>

<td>If TrutzBox is activated as a proxy in the browser, continue with 6.

If TrutzBox is not activated as a proxy in the browser, this is recommended (see manual 6.2.1), and then page '''xyz.de''' should be called again.

</td>

</tr>

<tr>

<td>4. Displayed in "Status" with level 1-9

Intention:

Show tracker

</td>

<td>In Status:

Click on link call ('''xyz.de''') right of security level

(Same effect as usual click on the TrutzBox icon and after displaying the security slider: click on "Details".)

</td>

<td>In a few exceptions the display of the TrutzBox symbol with sign and number of trackers cannot be shown on the respective website.

Nevertheless, protection exists and the results (calls and tracker display and blocking) are correct.

When calling from another website the expected display of the TrutzBox symbol should appear again in the upper right corner.

</td>

</tr>

<tr>

<td>5. Displayed in "Status" with level 10

Intention a:

none <

Intention b:

Set level to level 1-9

</td>

<td>Case b: in Status:

Click on blue icon left of security level of ''xyz.de'''

Click on "Change slider settings"

Set the desired level in "Slider Position" using the pull-down menu (right).

</td>

In SecuritySlider level 10 the TrutzBox is bypassed and therefore the TrutzBox symbol is not displayed.

This may be necessary for certain applications (e.g. smartphone apps), so that the app works as desired (but unprotected).

Level 10 can be set:

*by user: Call the SecuritySlider of the corresponding page and click on the green button "TrutzBrowse".

*by administrator: set the level to 10 in "Status" or in "Slider Einstellungen”

*automatic: if under "TrutzBox Filter" -> "Geräte" the check mark " Falls SSL-Fehler auftreten, Filtering für angesteuerte Domain automatisch ausschalten " is set

If level 10 is no longer set, but 1-9, the TrutzBurg should reappear when ''xyz.de''' is called up.

</td>

</tr>

<tr>

<td>6. xyz.de''' is not displayed in "Status"

Restarting the TrutzBox

</td>

<td>restart via:

"System" ->"Ein-/Ausschalten"

*Click on "Neu starten".

Only if user interface is not accessible:

*Cold start by disconnecting the power supply unit

*Wait 10 seconds and

*Reconnecting the power supply unit

</td>

<td> The "proxy part" of the TrutzBox does not seem to work or does not work properly.

First restart or, in an emergency, perform a cold start.

Continue with 7.

</td>

</tr>

<tr>

<td>7. xyz.de''' is not displayed in "Status"

Comidio asks you to send us the files "logs.zip".

</td>

<td>"System" ->"Debug":

Click on "Alle Logdateien herunterladen".

Save the file "logs.zip" (if necessary, the individual files).

Mail the file "logs.zip" (if necessary the individual files) to support@comidio.de

</td>

<td>Comidio is interested in analyzing the error using the log files and therefore asks for the log files to be sent.

Continue with 8.

</td>

</tr>

<tr>

<td>8. xyz.de''' is not displayed in "Status"

Restart possible or contact Comidio Support

</td>

<td>Restart via:

"System" -> "Ein-/Ausschalten"

Click on "Neu starten".

</td>

If neither a new start nor a cold start is successful, please send an e-mail to support@comidio.de.

Joint work reset may be necessary.

</td>

</tr>

</table>

[[#top|-> Table of Contents (of this manual)]]

=== ... the e-mail gets stuck in the TrutzMail outbox? ===

Go to TrutzMail -> Status (https://trutzbox/#mail/status). Check whether TrutzMail, SMTP, IMAP each have a green check mark = are OK. If not, restart and press the round arrows to the right. Attention: this restart may take some time. The mail can therefore remain in the mail queue for some time. If it has not been delivered after some time, make sure that the TrutzBox® of the receiver is active, port 5888 (on the DSL router e.g. FRITZ!Box) is not open or the receiver has received a new certificate due to a factory reset, replacement of the TrutzBox®, etc. In this case go to TrutzBox® Overview -> TrutzMail -> Status and click on "Mail-Schlüssel erneuern" in the upper right corner.

=== ... the user interface (UI) is no longer accessible? ===

Make sure that the TrutzBox® is listed under Devices and Users on the DSL router (e.g. FRITZ!Box) in the home network. Otherwise you can also reboot your Internet-enabled device (e.g. PC), the DSL router (e.g. FRITZ!Box) and the TrutzBox®. If the TrutzBox® cannot be reached via the IP address, try the "traditional" method = remove the plug, wait a few minutes, reconnect the plug and restart the TrutzBox®.

It may take 5 - 10 minutes for it to start up.

[[#top|-> Table of Contents (of this manual)]]

=== ... the right and middle LEDs are off and the left LED is constantly on? ===

Probably you cannot access Webmin https://trutzbox:10000 any more; then try the "traditional" method = remove the plug, wait a few minutes, plug in the plug again and restart the TrutzBox®.

It may take 5 - 10 minutes for it to start up.

Should the startup not bring the desired success, please contact us by e-mail at support@comidio.de.

[[#top|-> Table of Contents (of this manual)]]

=== ... Your TrutzBox is not connected to the router or your terminal device (e.g. PC) cannot reach the TrutzBox? ===

The TrutzBox works exclusively with IPv4 addresses.

If your TrutzBox is not connected to the router or your terminal device (e.g. PC) cannot reach the TrutzBox, one reason for this may be that the router assigns IPv6 addresses. To avoid this, it should be ensured that the router assigns IPv4 addresses.

To disable IPv6 addresses, go to:

https://comidio.de/wiki/index.php?title=TrutzBox_Handbuch#IPv6_deaktivieren

[[#top|-> Table of Contents (of this manual)]]

=== ... Your router has had an "Internet failure" and your TrutzBox is no longer accessible after service has started (e.g. only the left LED is permanently light)? ===

Exceptionally, please try the "brutal" method = remove the plug, wait a few minutes, reconnect the plug and reboot the TrutzBox®.

It may take 5 - 10 minutes for it to start up.

Should the startup not bring the desired success, please contact us by e-mail at support@comidio.de.

[[#top|-> Table of Contents (of this manual)]]

=== ... I want to check that my software packages are up-to-date? ===

'''Caution: All version numbers shown in this chapter were valid at the time the screenshots were taken. If you check versions yourself, you will probably find other, then current version information. The newer version numbers are always larger than the older ones, e.g. 0.0.62 is newer than 0.0.61 and 0.2.119-1 is newer than 0.1.134. '''

# Quick test: Check_the_current_status_of_software_updates using Webmin [https://comidio.de/wiki/index.php/TrutzBox_Handbuch#Schnelltest:_Aktuellen_Stand_der_Software-Updates_mittels_Webmin_pr.C3.BCfen -> Details]

#Do I have the latest software packages? [https://comidio.de/wiki/index.php/TrutzBox_Handbuch#Habe_ich_die_aktuellen_Software-Pakete.3F -> Details]

##What are the current software package versions on the Comidio server? [https://comidio.de/wiki/index.php/TrutzBox_Handbuch#Welches_sind_die_aktuellen_Software-Paket-Versionen_auf_dem_Comidio-Server.3F -> Details]

##Which software package versions do I have on my TrutzBox? [https://comidio.de/wiki/index.php/TrutzBox_Handbuch#Welche_Software-Paket-Versionen_habe_ich_auf_meiner_TrutzBox.3F -> Details]

##Do I have the current packages on my TrutzBox? [https://comidio.de/wiki/index.php/TrutzBox_Handbuch#Habe_ich_die_aktuellen_Pakete_auf_meiner_TrutzBox.3F -> Details]

#When were the latest software packages downloaded to my TrutzBox? [https://comidio.de/wiki/index.php/TrutzBox_Handbuch#Wann_wurden_die_letzten_Software-Pakete_auf_meine_TrutzBox_heruntergeladen.3F -> Details]

#When was the last time my TrutzBox checked for software updates? [https://comidio.de/wiki/index.php/TrutzBox_Handbuch#Wann_hat_meine_TrutzBox_das_letzte_Mal_nach_Software-Updates_geschaut.3F -> Details]

#When the last filter lists were downloaded to my TrutzBox? [https://comidio.de/wiki/index.php/TrutzBox_Handbuch#Wann_wurden_die_letzten_Filterlisten_auf_meine_TrutzBox_heruntergeladen.3F -> Details]

[[#top|-> Table of Contents (of this manual)]]

==== Quick-check: Check current status of software updates via Webmin ====

We use Webmin functions to quickly check the current status of the imported software packages.

[[File:09_10_100.png|700px|link=]]

*Enter "https://trutzbox:10000" (without quotes) (1).

*The Webmin display "Alle installierten Pakete sind aktuell" is already a first indication that all software updates have been imported. A click on it (2) allows a forced new check of the up-to-dateness.

[[#top|-> Table of Contents (of this manual)]]

[[File:09_10_110.png|700px|link=]]

*Click on "Aktualisiere verfügbare Pakete" (1).

[[#top|-> Table of Contents (of this manual)]]

[[File:09_10_120.png|700px|link=]]

*If " 0 mögliche Updates gefunden" (1) is displayed, your TrutzBox is up to date.

*If your TrutzBox is online overnight, all necessary updates should be installed automatically (around 5:00 am).

*If your TrutzBox was offline, any update installations can be initiated manually, or you can leave your TrutzBox online overnight. The manual installation of package updates is described in "5.6.5.8 Webmin: TrutzBox Updates manuell anstoßen".

[[#top|-> Table of Contents (of this manual)]]

==== Do I have the current software packages? =====

We will

*check on the Comidio server which versions of the software packages for the Trutzbox are released,

*determine on your TrutzBox the version status of the TrutzBox software packages currently installed on your TrutzBox, and

*by comparing the version of the Comidio Server (TARGET) with that of your TrutzBox (ACTUAL) to determine whether it is up-to-date.

===== What are the current software package versions on the Comidio server? =====

We check the software packages and their version numbers that Comidio has published on its server for the Trutzbox.

[[File:09_10_210.png|700px|link=]]

*Call "http://comidio.email/repo/dists/TrutzBox/base/binary-i386/Packages" (without quotes) (1).

*Call up full-text search in current page, e.g. by entering Ctrl + F (2) on the keyboard.

*Enter "Package: trutz" (without quotation marks) (3). Note: Only if the entry begins with "Package:" does the search show the first meaningful entry.

*Click on the down arrow (4).

*Details of the next software package found (in the example: "trutzbox-base-routing") are displayed (5).

*The version number (in the example: "0.0.62") is displayed after the keyword "Version" (6).

*Click the down arrow (7) to move to the next package whose name begins with "trutz.

'''Insight''' (with example data) ''':'''

'''Package "trutzbox-base-routing" is currently available on the server in version "0.0.62

"'''

[[#top|-> Table of Contents (of this manual)]]

===== Which software package versions do I have on my TrutzBox? =====

We use Webmin to check the software packages and their version numbers installed on my Trutzbox.

[[File:09_10_250.png|700px|link=]]

*Call "https://trutzbox:10000" (without quotes) (1).

*Click on "System" (2).

*Click on "Softwarepakete" (3).

*Enter "trutz" (without quotation marks) in the search mask (4) to display all packages maintained by Comidio.

*Click on "Suche nach Paketen" (5).

<

[[#top|-> Table of Contents (of this manual)]]

<

[File:09_10_260.png|700px|link=]]

*The software packages on the Trutzbox in whose name "trutz" appears are listed (1).

'''Knowledge''' (with example values)'''':'''

The "trutzbox-base-routing" package is currently available on my TrutzBox in version "0.0.62"'''

[[#top|-> Table of Contents (of this manual)]]

===== Do I have the current packages on my TrutzBox? =====

We compare the version numbers of the software packages on my Trutzbox with those on the Comidio server. <

'''Insight''' (with example data)'''':'''

The "trutzbox-base-routing" package has the same version on the server and on my TrutzBox, so it is current.'''

==== When were the latest software packages downloaded to my TrutzBox? ====

[[File:09_10_300.png|700px|link=]]

*Call "https://trutzbox:10000" (without quotes) (1).

*Click on "System" (2).

*Click on "Systemprotokolle" (3).

*Enter "/var/log/unattended-upgrades/unattended-upgrades-dpkg.log" (without quotes) in filename field (4).

*Click on "Ansehen" (5).

[[#top|-> Table of Contents (of this manual)]]

[[File:09_10_310.png|700px|link=]]

*Log ended" shows when the software packages were last updated on my TrutzBox (1).

'''Insight''' (with example data)''':'''

'''The last update of the software packages on my TrutzBox was on 19th October 2017 at 04h : 03min : 51sec.'''

[[#top|-> Table of Contents (of this manual)]]

==== When did my TrutzBox last check for software updates? ====

We check the logfiles of the Trutzbox to know the date of the last change.

[[File:09_10_400.png|700px|link=]]

*Call "https://trutzbox:10000" (without quotes) (1).

*Click on "System" (2).

*Click on "Systemprotokolle" (3).

*Enter "/var/log/unattended-upgrades/unattended-upgrades.log" (without quotes) in filename field (4).

*Click on "Ansehen" (5).

[[#top|-> Table of Contents (of this manual)]]

[[File:09_10_410.png|700px|link=]]

'''Insight''' (with example data)''':'''

'''The last check of my TrutzBox for software package updates was on 24.10.2017 at 06h : 33min : 46sec and showed that no updates were available. The date shown should not be too long ago to be sure that the software packages of my Trutzbox are up to date.'''

[[#top|-> Table of Contents (of this manual)]]

==== When were the last filter lists downloaded to my TrutzBox? ====

We check the logfiles of the Trutzbox to obtain the date of the last change.

[[File:09_10_500.png|700px|link=]]

*Call "https://trutzbox:10000" (ohne Anführungszeichen) (1).

*Click on "System" (2).

* Click on "Systemprotokolle" (3).

*Enter "/var/log/comidio/updshalla.log" (without quotes) in filename field (4).

* Click on "Ansehen" (5).

[[#top|-> Table of Contents (of this manual)]]

[[File:09_10_510.png|700px|link=]]

'''Insight''' (with example data)''':'''

'''The last filter list update took place on 24.10.2017 at 05h : 00min : 26sec and was successful. The displayed date should not be too long ago to be sure that the filter lists of my Trutzbox are up to date.'''

[[#top|-> Table of Contents (of this manual)]]

=== ... if someone wants to sell his Trutzbox? ===

A TrutzLegitimation (consisting of TrutzKennung and TrutzSchlüssel) is person-oriented and not bound by concept to a specific TrutzBox.

For example, the TrutzMail addresses configured are also linked to the TrutzLegitimation.

Thus the seller should not pass on his TrutzLegitimation and the buyer should order a new TrutzLegitimation including TrutzServices from Comidio.

We recommend the following procedure to the seller

The seller ...

#initiates factory reset on Trutzbox,

#waits until Trutzbox is completely shut down (may take up to 60 minutes) and the LEDs are off, and

#disconnects Trutzbox from the power supply.

Now the Trutzbox is ready to be handed over to a buyer.

[[#top|-> Table of Contents (of this manual)]]

=== ... if someone has bought a used Trutzbox or an appropriate hardware and wants to use the TrutzServices? ===

A TrutzLegitimation (consisting of TrutzKennung and TrutzSchlüssel) is person-oriented and not bound by concept to a specific TrutzBox.

For example, the TrutzMail addresses configured are also linked to the TrutzLegitimation.

Thus the buyer should order a new TrutzLegitimierung including TrutzServices from Comidio ([https://trutzbox.de/produkt/trutzlegitimierung-trutzservices-fuer-fremdhardware-12-monate/ zu Shop]).

We recommend the following procedure to the buyer

The buyer ...

#orders a new TrutzLegitimierung including TrutzServices from Comidio ([https://trutzbox.de/produkt/trutzlegitimierung-trutzservices-fuer-fremdhardware-12-monate/ zu Shop]),

#connects Trutzbox to router,

#connects Trutzbox to power supply,

#runs through setup

#enters NEW Trutz legitimacy,

#can set up TrutzMail addresses (up to 5 in the basic contingent), and

#runs his trutzbox and is protected on the Internet.

[[#top|-> Table of Contents (of this manual)]]

=== ... if TrutzMails arrive on your own Trutzbox but are not displayed in the mail client (e.g. Outlook or Thunderbird) or webmailer? ===

When the IMAP icon appears red in the dashboard of the Trutzbox user interface, either

*Click on "Details zeigen", or

*Click on "Status" under "TrutzMail.

There press the restart arrow belonging to IMAP: then the IMAP server is restarted and the TrutzMails are (again) received correctly.

[[#top|-> Table of Contents (of this manual)]]

== Support in error analysis ==

For error analysis or optimisation of TrutzBox® settings it can be helpful if Comidio Support can get a "picture" of the current situation of TrutzBox® at the customer.

For this purpose, Comidio may ask the customer to record information about states and settings and to transmit it to Comidio.

=== Mail Screenshot of TrutzBox® overview page ===

If Comidio asks you to email a screenshot of the overview page, please proceed as follows.

[[File:Fehleranalyse 010 Übersicht 010.png|700x700px|link=]]

*Open "trutzbox" and the "TrutzBox Overview" page is displayed automatically. Especially the utilization of the fixed memory is interesting (1),

*Take a screenshot of the page "TrutzBox Overview",

*Mail screenshot to support@comidio.de.

=== Mail TrutzMail log files ===

If Comidio asks you to mail the TrutzMail log files ("TrutzMail log" and "Mail log"), please proceed as follows.

[[File:Fehleranalyse 060 TrutzMail Logs 011.png|700x700px|link=]]

*Call"trutzbox" and click on "TrutzMail" (1),

*Click on "Logs" (2) and

*Click on "Herunterladen" (3).

[[File:Fehleranalyse 060 TrutzMail Logs 020.png|700x700px|link=]]

After downloading, a file icon and the name of the "trutzmail.log" file appear at the bottom left.

Double-click on the file name to open an editor window with the log file.

[[File:Fehleranalyse 060 TrutzMail Logs 030.png|700x700px|link=]]

* Click on "Datei" (1),

* Click on "Save as..." (2) and save the log file "trutzmail.log" on the PC.

*Proceed in the same way with the log file "Mail log".

*Finally, please mail log files "trutzmail.log" and "mail.log" to support@comidio.de

=== Find oversized files ===

(This function is currently being revised.)

=== Generate log files (and email) ===

If Comidio asks you to mail TruzBox log files, please proceed as follows:

Generating the file: '''logs.zip'''

Generating the file: '"systeminfo.txt"

==== file creation: logs.zip ====

In the TrutzBox user interface in the navigation menu go to:

System -> Debug

[[File:104 LogDateien mailen 015.png|700px|link=]]

*Delete all log files (1).

*Set the modules requested by Comidio to "Debug", in this example the modules "database", "proxy" and "levels" (2).

*Then please start the application or the device in question (e.g. your TV set)...

*... after "strange behaviour" occurred, download the files using the " Alle Logdateien herunterladen " button (3).

*Then set all modules back to "information" (no longer to "Debug"), so that the TrutzBox does not permanently write log files and unnecessarily occupies storage space.

[[#top|-> Table of Contents (of this manual)]]

[[File:104 LogDateien mailen 020.png|300px|link=]]

Click on "OK".

[[#top|-> Table of Contents (of this manual)]]

[[File:104 LogDateien mailen 030.png|700px|link=]]

Click on "Speichern".

'''Then please mail the file logs.zip to support@comidio.de Thank you very much! ''' >

[[#top|-> Table of Contents (of this manual)]]

==== Creation of the file: systeminfo.txt ====

In the TrutzBox user interface in the navigation menu go to:

System -> Erweiterte Einstellungen

[[File:104 LogDateien mailen 040.png|700px|link=]]

Click on "Erweiterte Einstellungen".

[[#top|-> Table of Contents (of this manual)]]

[[File:104 LogDateien mailen 050.png|700px|link=]]

Enter the user name "admin" and the corresponding password.

Click on "Anmelden".

[[#top|-> Table of Contents (of this manual)]]

[[File:104 LogDateien mailen 060.png|700px|link=]]

Enter in URL line "https://trutzbox:10000/sysinfo.cgi".

Press the Enter key.

[[#top|-> Table of Contents (of this manual)]]

[[File:104 LogDateien mailen 070.png|300px|link=]]

Click on "OK".

[[#top|-> Table of Contents (of this manual)]]

The file is automatically stored in the "Downloads" directory (or in the directory specified by the user).

[[File:104 LogDateien mailen 080.png|700px|link=]]

Click on "Speichern".

[[#top|-> Table of Contents (of this manual)]]

'''Please then mail both files (logs.zip and systeminfo.txt) to support@comidio.de Thank you!'''

=== Screen sharing at TrutzRTC via Comidio Server ===

Comidio-Support has the possibility to invite participants to a TrutzRTC meeting on the Comidio server.

The participant only needs a Chrome or FireFox browser to access the shared room URL and attend the TrutzRTC Meeting. <

If the participant wants to share (= show) his screen, this can be done with the Chrome Browser, in which the "Comidio Conference Screen Sharing" extension was previously activated.

The following screenshots show how to find and activate this extension.

[[File:105 ScreenSharing Chrome Plugin 010.png|700px|link=]]

Call the current Chrome Browser (1).

Enter in the URL field "https://chrome.google.com/webstore/category/extensions?hl=de" (2).

Enter into the search field "comidio" (3).

[[#top|-> Table of Contents (of this manual)]]

[[File:105 ScreenSharing Chrome Plugin 020.png|700px|link=]]

Click on "+ HINZUFÜGEN" (1).

[[#top|-> Table of Contents (of this manual)]]

[[File:105 ScreenSharing Chrome Plugin 030.png|700px|link=]]

Click on "Erweiterung hinzufügen" (1).

[[#top|-> Table of Contents (of this manual)]]

[[File:105 ScreenSharing Chrome Plugin 040.png|700px|link=]]

Click on logo for settings (3 horizontal lines) (1).

[[#top|-> Table of Contents (of this manual)]]

[[File:105 ScreenSharing Chrome Plugin 050.png|800px|link=]]

Click on "Weitere Tools" (1).

Click on "Erweiterungen" (2).

[[#top|-> Table of Contents (of this manual)]]

[[File:105 ScreenSharing Chrome Plugin 060.png|700px|link=]]

The installed extensions are displayed here, including the new screen sharing extension (1).

[[#top|-> Table of Contents (of this manual)]]

<

=== exchange of SD cards ===

In exceptional situations it may be necessary to replace an SD card in the TrutzBox.

The following illustrations show how to replace the SD card.

[[File:106 SD Karte wechseln 010.png|700px|link=]]

Loosen the four screws with a small cross-head screwdriver.

[[#top|-> Table of Contents (of this manual)]]

[[File:106 SD Karte wechseln 020.png|700px|link=]]

Pull the housing off to the front.

[[#top|-> Table of Contents (of this manual)]]

[[File:106 SD Karte wechseln 030.png|700px|link=]]

Carefully pull out the old SD card.

[[#top|-> Table of Contents (of this manual)]]

[[File:106 SD Karte wechseln 040.png|700px|link=]]

New SD card ...

[[#top|-> Table of Contents (of this manual)]]

[[File:106 SD Karte wechseln 050.png|700px|link=]]

... in setting ...

[[#top|-> Table of Contents (of this manual)]]

[[File:106 SD Karte wechseln 060.png|700px|link=]]

... insert as far as it will go.

[[#top|-> Table of Contents (of this manual)]]

[[File:106 SD Karte wechseln 070.png|700px|link=]]

Push the housing back on ...

[[#top|-> Table of Contents (of this manual)]]

[[File:106 SD Karte wechseln 080.png|700px|link=]]

... and re-tighten the four nuts.

[[#top|-> Table of Contents (of this manual)]]

=== Instructions for writing (fuelling) the SSD ===

To reload the SSD disk installed in the Trutzbox, a "tank USB stick" must first be created, with which the built-in SSD disk can then be "fueled" with a new TrutzBox image (previous image overwritten).

The tank USB stick must be 32GB in size.

First download an image for the USB tank stick from https://trutzbox.de/download/Tank_V67_dev_11.zip. Unpack the file (is then approx. 19GB in size) and upload it with a PC and the program "etcher" (https://etcher.io/) to a 32GB USB stick. Use it to create a bootable USB stick. When you boot the TrutzBox with this USB stick (i.e. insert the tank USB stick into the TrutzBox before the TrutzBox boot), a program is started from the USB stick which copies a TrutzBox image from the USB stick to the built-in storage medium in the TrutzBox.

<

The copy program outputs information via the TrutzBox LEDs with which you can check the copy process.

<

'''Description of the LED signals (LEDs on the front of the TrutzBox; LED 1 is left): '''

<tr>

<td width="500">'''Meaning'''</td>

</tr>

<tr>

<td width="500"> Trutzbox booting</td>

</tr>

<tr>

<td>1 on; 2 blinking; 3 off</td>

<td>Search USB stick</td>

</tr>

<tr>

<td>1,2 on; 3 blinking</td>

<td>Search target medium (SD card or mSSD)</td>

</tr>

<tr>

dtd>1,2,3 from left to right</td>

<td>Write image to target medium (takes a long time with old TrutzBox, since USB2 is still..., on new TrutzBox with USB3 stick approx. 5-10min)</td>

</tr>

<tr>

dtd>3.2.1 from right to left</td>

<td>Check written data (with old TrutzBox, since USB2 is still very long..., on new TrutzBox with USB3 stick approx. 5-10min)</td>

</tr>

<tr>

<td>1,2,3 blink synchronously,

3*beeps</td>

dtd>successfully completed, box turns off in 30sec </td>

</tr>

<tr>

</tr>

<tr>

</tr>

<tr>

<td>'''Error'''</td>

</tr>

<tr>

<td>outside inside rhythm:

1 on, 2 off, 3 on

1 off, 2 on, 3 off

</td>

<td> Error display is shown together with beep every 60 seconds. Copy did '''not''' work.</td>

</tr>

</table>

Then remove the TrutzBox from the power supply, remove the USB stick, reconnect the TrutzBox to the power supply and run the TrutzBox setup again.

Please note that the TrutzBox generates new certificates during setup. Therefore, you must delete the previously imported certificates on your mobile devices before setup.

It may happen that the TrutzBox does not want to boot from the USB stick when "refuelling". Then only a serial cable helps to connect to the TrutzBox and adjust the boot order with a terminal in the TrutzBox-BIOS. Or remove the storage medium and send it to us.

[[#top|-> Table of Contents (of this manual)]]

=== Installation and start of PuTTY (terminal program under Windows) ===

As an alternative to Webmin, it may be necessary to execute commands directly on the Trutzbox via SSH (secure shell). A terminal program is required for this. Under MacOS, a terminal application is already available by default and can be searched for and started there in Spotlight with "terminal". Under Windows, the "PuTTY" terminal program must first be installed. <

The installation and use of PuTTY ''under Windows''' is described below.

<

Calling of:

https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html

[[File:10 08 PuTTY 010.png|700px|link=]]

* Click on (1), falls 32-Bit System, oder …

* Click on (2), falls 64-Bit System.

[[#top|-> Table of Contents (of this manual)]]

[[File:10 08 PuTTY 020.png|300px|link=]]

* Click on "Datei speichern" (1).

[[#top|-> Table of Contents (of this manual)]]

[[File:10 08 PuTTY 030.png|700px|link=]]

* PuTTY Installer downloaded to download directory (1).

[[#top|-> Table of Contents (of this manual)]]

[[File:10 08 PuTTY 040.png|700px|link=]]

* Change to the download directory.

Double click on PuTTy Installer (1).

[[#top|-> Table of Contents (of this manual)]]

[[File:10 08 PuTTY 050.png|500px|link=]]

* Click on "Next" (1).

[[#top|-> Table of Contents (of this manual)]]

[[File:10 08 PuTTY 060.png|500px|link=]]

* Change the destination directory (1), and/or ...

* Click on "Next" (2).

[[#top|-> Table of Contents (of this manual)]]

[[File:10 08 PuTTY 070.png|400px|link=]]

* Click on "Install" (1).

[[#top|-> Table of Contents (of this manual)]]

[[File:10 08 PuTTY 080.png|500px|link=]]

* PuTTY is being installed ...

[[#top|-> Table of Contents (of this manual)]]

[[File:10 08 PuTTY 090.png|500px|link=]]

PuTTY is now installed and can be called and started in the program directory ...'''

[[#top|-> Table of Contents (of this manual)]]

'''... to simplify the call, a desktop shortcut can also be set up:'''

[[File:10 08 PuTTY 100.png|700px|link=]]

* Right-click on desktop surface (1).

* Click on "Neu" (2).

* Click on "Verknüpfung" (3).

[[#top|-> Table of Contents (of this manual)]]

[[File:10 08 PuTTY 110.png|700px|link=]]

* Click on "Durchsuchen..." (1).

Click through to the PuTTY directory and there to the PuTTY application:

C: -> Program Files -> PuTTY

[[#top|-> Table of Contents (of this manual)]]

[[File:10 08 PuTTY 121.png|300px|link=]]

* Click on PuTTY-Programm (1).

* Click on "OK" (2).

[[#top|-> Table of Contents (of this manual)]]

[[File:10 08 PuTTY 130.png|700px|link=]]

* Click on "Weiter" (1).

[[#top|-> Table of Contents (of this manual)]]

[[File:10 08 PuTTY 140.png|700px|link=]]

* If desired, enter another name and/or ... (1).

* Click on "Fertig stellen" (2).

Shortcut from desktop to PuTTY program is now set up and PuTTY can be called from desktop by double-clicking the shortcut icon...'''

[[#top|-> Table of Contents (of this manual)]]

'''The call is made as follows:'''

[[File:10 08 PuTTY 150.png|400px|link=]]

* Double-click on desktop on shortcut icon (1).

[[#top|-> Table of Contents (of this manual)]]

[[File:10 08 PuTTY 160.png|400px|link=]]

* Click on "SSH" (1).

* Enter "trutzbox" as host name and port "22“ (2).

* Click on "Open" (3).

[[#top|-> Table of Contents (of this manual)]]

[[File:10 08 PuTTY 180.png|600px|link=]]

* To log in: Enter "admin" (1).

*... and press the Return key (2).

[[#top|-> Table of Contents (of this manual)]]

[[File:10 08 PuTTY 190.png|600px|link=]]

* Enter the Trutzbox admin password as the password and press the Return key (1).

Then enter the command(s) named by Comidio ... (2).

[[#top|-> Table of Contents (of this manual)]]

== Access and passwords ==

The following accesses and passwords are used chronologically to operate and use the TrutzBox®:

'''Registration on website (for purchase TrutzBox®)'''

invocation: comidio.de -> Login / Register (https://comidio.de/mein-konto)

<tr>

<td width="375">'''Password'''</td>

</tr>

<tr>

<td> Existing e-mail address of the prospect / customer</td>

<td> assigns the user by entering </td>

</tr>

</table>

<tr>

Purpose:

*serves to authenticate the user,

*is required after a one-time registration for access ("login") to customer account.

</td>

</tr>

</table>

'''Setting up the TrutzBox ®'''

Call: http://trutzbox

<tr>

<td width="375">'''Password'''</td>

</tr>

<tr>

<td>„ admin"; automatically created by TrutzBox®</td>

<td> user assigns by entering </td>

</tr>

</table>

<tr>

Purpose:

*is used to authenticate the TrutzBox® Administrator,

*required by the administrator for later administration of the TrutzBox.

</td>

</tr>

</table>

<tr>

<td width="375">'''Password'''</td>

</tr>

<tr>

<td>TrutzKennung

(see the document "TrutzLegitimierung")

</td>

<td>TrutzSchlüssel

(see the document "TrutzLegitimierung")

</td>

</tr>

</table>

<tr>

Purpose:

*is used for authentication of TrutzBox® Rights and TrutzMail Services,

*is only required for installation (and if necessary, for factory reset) of the TrutzBox®.

</td>

</tr>

</table>

'''Administration of the TrutzBox® (e.g. create e-mail address)'''

Call: http://trutzbox

<tr>

<td width="375">'''Password'''</td>

</tr>

<tr>

<td>( not required; is automatically "admin")</td>

when setting up the TrutzBox® defined password </td>

</tr>

</table>

<tr>

Purpose:

*is used to authenticate the TrutzBox® Administrator,

*required by the administrator for administration of the TrutzBox®.

</td>

</tr>

</table>

[[#top|-> Table of Contents (of this manual)]]

Administration of the Comidio account

Call: comidio.de -> Login / Register (https://comidio.de/mein-konto)

<tr>

<td width="375">'''Password'''</td>

</tr>

<tr>

<td> E-mail address used for registration (by interested parties)</td>

<td> Password defined at registration (by interested parties) </td>

</tr>

</table>

<tr>

Purpose:

*serves to authenticate the user,

*is required after a one-time registration for access ("login") to customer account.

</td>

</tr>

</table>

Fox

Bureaucrats, Administrators

5,561

edits

Changes

Trutzbox Manual

Navigation menu

Personal tools

Namespaces

Variants

Views

More

Search

Navigation

Tools