Skip to content

Commit 88763d6

Browse files
authored
Merge pull request SkylineCommunications#14 from MariekeTest/main
Review of Skyline DataMiner folder section
2 parents 1515806 + f1fd855 commit 88763d6

10 files changed

+425
-342
lines changed

user-guide/part_3/failover/Failover_configuration_in_Cube.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -80,6 +80,6 @@ To enable Failover using DataMiner version **10.1.7 or lower**:
8080
> [!NOTE]
8181
> - Both DMAs store the full Failover configuration in their *DMS.xml* file. Each time the Failover configuration is changed, a copy of the old *DMS.xml* file will be moved to the folder *C:\\Skyline DataMiner\\Recycle Bin*.
8282
> - If the configuration is changed on only one of the DMAs because the other was unreachable, the newest configuration will be synchronized as soon as the DMAs can make contact again.
83-
> - To avoid possible issues in case a NIC is unplugged, you can specify the order of the network adapters used by a DMA (the first being used for the corporate network, the second for the acquisition network). To do so, configure the *NetworkAdapters* tag in the file *DataMiner.xml* (see [Alphabetical overview of settings](xref:DataMiner_xml#alphabetical-overview-of-settings)). However, note that to do so, you will need to stop both Failover Agents and then restart them once the file has been modified. If you do this for an existing Failover setup, you will also need to make sure that the changes you make match the IP configuration in DMS.xml.
83+
> - To avoid possible issues in case a NIC is unplugged, you can specify the order of the network adapters used by a DMA (the first being used for the corporate network, the second for the acquisition network). To do so, configure the *NetworkAdapters* tag in the file *DataMiner.xml* (see [DataMiner.NetworkAdapters](xref:DataMiner_xml#dataminernetworkadapters)). However, note that to do so, you will need to stop both Failover Agents and then restart them once the file has been modified. If you do this for an existing Failover setup, you will also need to make sure that the changes you make match the IP configuration in DMS.xml.
8484
> - For Failover logging information, refer to the files *SLNet.txt* and *SLFailover.txt*.
8585
>

user-guide/part_3/failover/Preferred_configuration_using_virtual_IP_addresses__best_practice.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Make sure to respect the order of the connections in the *Network Connections* l
2121
- The second connection represents the acquisition network, which is mainly used for communication with data sources managed by DataMiner.
2222

2323
> [!NOTE]
24-
> To avoid possible issues in case a NIC is unplugged, you can specify the order of the network adapters used by a DMA (the first being used for the corporate network, the second for the acquisition network). To do so, configure the *NetworkAdapters* tag in the file *DataMiner.xml* (see [Alphabetical overview of settings](xref:DataMiner_xml#alphabetical-overview-of-settings)). However, note that to do so, you will need to stop both Failover Agents and then restart them once the file has been modified. If you do this for an existing Failover setup, you will also need to make sure that the changes you make match the IP configuration in DMS.xml.
24+
> To avoid possible issues in case a NIC is unplugged, you can specify the order of the network adapters used by a DMA (the first being used for the corporate network, the second for the acquisition network). To do so, configure the *NetworkAdapters* tag in the file *DataMiner.xml* (see [DataMiner.NetworkAdapters](xref:DataMiner_xml#dataminernetworkadapters)). However, note that to do so, you will need to stop both Failover Agents and then restart them once the file has been modified. If you do this for an existing Failover setup, you will also need to make sure that the changes you make match the IP configuration in DMS.xml.
2525
2626
### Four heartbeats
2727

user-guide/part_7/SkylineDataminerFolder/ConnectionSettings_txt.md

+25-24
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,7 @@ This file contains default connection settings to be used by DataMiner client ap
1010
> - An update of this file does not require a restart of the DataMiner software.
1111
> - This file is not synchronized throughout the DataMiner System.
1212
13-
- This file is located in the following folder:
14-
15-
*C:\\Skyline DataMiner\\Webpages\\*
13+
- This file is located in the folder *C:\\Skyline DataMiner\\Webpages\\*.
1614

1715
- ConnectionSettings.txt format:
1816

@@ -32,56 +30,59 @@ This file contains default connection settings to be used by DataMiner client ap
3230
3331
- **type=**
3432
35-
The type of connection. Possible values:
33+
The type of connection. Possible values:
3634
37-
- RemotingConnection (.NET Remoting)
35+
- RemotingConnection (.NET Remoting)
3836
39-
- WSConnection (Web Services - deprecated from DataMiner 10.0.11 onwards)
37+
- WSConnection (Web Services - deprecated from DataMiner 10.0.11 onwards)
4038
4139
- **polling=**
4240
43-
Polling interval Possible values:
41+
Polling interval Possible values:
4442
45-
- Number of milliseconds (minimum: 100)
43+
- Number of milliseconds (minimum: 100)
4644
47-
- 0 (no polling)
45+
- 0 (no polling)
4846
4947
- **serverport=**
5048
51-
Server port onto which the client has to connect. Possible values:
49+
Server port onto which the client has to connect. Possible values:
5250
53-
- Port number
51+
- Port number
5452
55-
- 0 (no override - connect to default port)
53+
- 0 (no override - connect to default port)
5654
5755
- **zip=**
5856
59-
Whether or not the communication has to be zipped. Possible values:
57+
Whether or not the communication has to be zipped. Possible values:
6058
61-
- true
59+
- true
6260
63-
- false
61+
- false
6462
6563
- **cache=**
6664
67-
The type of data that has to be cached on the client machine.
68-
When this option is set to its default value (“objects”), a number of objects (e.g. DataMiner Protocols) are cached on the client machine. Once these objects are present on the client, data traffic between DMA and client drops substantially. Possible values:
65+
The type of data that has to be cached on the client machine.
66+
67+
When this option is set to its default value (“objects”), a number of objects (e.g. DataMiner Protocols) are cached on the client machine. Once these objects are present on the client, data traffic between DMA and client drops substantially. Possible values:
6968
70-
- all
69+
- all
7170
72-
- none
71+
- none
7372
74-
- objects (default)
73+
- objects (default)
7574
76-
- events
75+
- events
7776
7877
- **resolve=**
7978
80-
Whether or not hostnames have to be resolved to IP addresses before the connection is set up. Possible values:
79+
Whether or not hostnames have to be resolved to IP addresses before the connection is set up.
80+
81+
Possible values:
8182
82-
- true (default)
83+
- true (default)
8384
84-
- false
85+
- false
8586
8687
> [!NOTE]
8788
> - If a client connects to a DataMiner Agent via a load balancing URL (i.e. a hostname redirecting to different IP addresses when resolved), by default the hostname will be explicitly resolved before the connection is set up. If, for some IP addresses, you want to prevent this from happening, in ConnectionSettings.txt specify “resolve=false” next to those IP addresses.

user-guide/part_7/SkylineDataminerFolder/DBMaintenance_xml_and_DBMaintenanceDMS_xml.md

+10-10
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ Examples:
9696
- To specify a period of 1 hour, you can use “1h”, “3600s” or “3600”.
9797

9898
> [!NOTE]
99-
> - Strings without unit will be interpreted as a number of seconds.<br>For example, “3600” will be interpreted as 3600 seconds.
99+
> - Strings without unit will be interpreted as a number of seconds. For example, “3600” will be interpreted as 3600 seconds.
100100
> - For a logger table, the TTL value can be set to “-1” to indicate that the TTL value is specified in the protocol.
101101
> - From DataMiner 9.5.13 onwards, if the TTL value is set to “0” for a particular type of data, no data of that type will be stored in the database.
102102
> - For an indexing database, it is possible to specify “infinite”, in which case the data will be kept indefinitely.
@@ -157,7 +157,7 @@ Example of a *DBMaintenanceDMS.xml* file with protocol override:
157157

158158
From DataMiner 9.5.14 onwards, timetrace data for a service in the Cassandra database by default only contains the service properties that match with the service key. In earlier versions of DataMiner, the rows contained the service properties of all affected services.
159159

160-
It is possible to revert to the earlier behavior by adding the following tag in the *\<MaintenanceConfig>* tag of the *DBMaintenance.xml* or *DBMaintenanceDMS.xml* file: <br>*\<TimeTrace duplicateAllServiceProperties="True" />*.
160+
It is possible to revert to the earlier behavior by adding the following tag in the *\<MaintenanceConfig>* tag of the *DBMaintenance.xml* or *DBMaintenanceDMS.xml* file: *\<TimeTrace duplicateAllServiceProperties="True" />*.
161161

162162
However, note that this can cause a significant increase in disk space usage, especially in systems with many services and service properties.
163163

@@ -168,13 +168,13 @@ However, note that this can cause a significant increase in disk space usage, es
168168

169169
When you upgrade a DataMiner Agent without the two new configuration files to a version with these files, *DBMaintenance.exe* will copy a number of settings from the *DB.xml* and *MaintenanceSettings.xml* files to the new configuration files. See the following table:
170170

171-
| Existing setting | New setting |
172-
|-----------------------------------------------------------------|----------------------|
173-
| DB.xml<br> \> Maintenance \> MonthsToKeep | Alarm TTL |
174-
| DB.xml<br> \> Historyslider \> TimeToKeep | TimeTrace TTL |
175-
| MaintenanceSettings.xml<br> \> Trending \> TimeSpan | RealTimeTrending TTL |
176-
| MaintenanceSettings.xml<br> \> Trending \> TimeSpan5MinRecords | FiveMinTrending TTL |
177-
| MaintenanceSettings.xml<br> \> Trending \> TimeSpan1HourRecords | OneHourTrending TTL |
178-
| MaintenanceSettings.xml<br> \> Trending \> TimeSpan1DayRecords | OneDayTrending TTL |
171+
| Existing setting | New setting |
172+
|-------------------------------------------------------------|----------------------|
173+
| DB.xml \> Maintenance \> MonthsToKeep | Alarm TTL |
174+
| DB.xml \> Historyslider \> TimeToKeep | TimeTrace TTL |
175+
| MaintenanceSettings.xml \> Trending \> TimeSpan | RealTimeTrending TTL |
176+
| MaintenanceSettings.xml \> Trending \> TimeSpan5MinRecords | FiveMinTrending TTL |
177+
| MaintenanceSettings.xml \> Trending \> TimeSpan1HourRecords | OneHourTrending TTL |
178+
| MaintenanceSettings.xml \> Trending \> TimeSpan1DayRecords | OneDayTrending TTL |
179179

180180
When you downgrade to a DataMiner Agent without the two new configuration files, *DBMaintenance.exe* will revert the above-mentioned copy actions and update the settings in question in both the *DB.xml* and *MaintenanceSettings.xml* files.

0 commit comments

Comments
 (0)