You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/linux/sql-server-linux-configure-mssql-conf.md
+36-2Lines changed: 36 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ description: This topic describes how to use the mssql-conf tool to configure S
6
6
author: luisbosquez
7
7
ms.author: lbosq
8
8
manager: jhubbard
9
-
ms.date: 03/17/2017
9
+
ms.date: 03/21/2017
10
10
ms.topic: article
11
11
ms.prod: sql-linux
12
12
ms.technology: database-engine
@@ -32,11 +32,16 @@ ms.custom: H1Hack27Feb2017
32
32
-[Default log directory](#datadir): Changes the directory where the new SQL Server database log (.ldf) files are created.
33
33
-[Default dump directory](#dumpdir): Change the directory where SQL Server will deposit the memory dumps and other troubleshooting files by default.
34
34
-[Default backup directory](#backupdir): Change the directory where SQL Server will send the backup files by default.
35
+
-[Mini and full dump prefernces](#coredump): Specify whether to generate both mini dumps and full dumps.
36
+
-[Core dump type](#coredump): Choose the type of dump memory dump file to collect.
35
37
-[Set traceflags](#traceflags): Set the traceflags that the service is going to use.
36
38
-[Set collation](#collation): Set a new collation for SQL Server on Linux.
37
39
38
40
The following sections show examples of how to use mssql-conf for each of these scenarios.
39
41
42
+
> [!TIP]
43
+
> These examples run mssql-conf by specify the full path: `/opt/mssql/bin/mssql-conf`. If you choose to navigate to that path instead, run mssql-conf in the context of the current directory: `./mssql-conf`.
44
+
40
45
## <aid="tcpport"></a> Change the TCP port
41
46
42
47
This option will let you change the TCP port where SQL Server will listen for connections. By default, this port is set to 1433. To change the port, run the following commands:
@@ -129,7 +134,7 @@ To set up this new location, use the following commands:
129
134
130
135
## <aid="backupdir"></a> Change the default backup directory location
131
136
132
-
This option will let you change the default location where the backup files are generaqted. By default, these files are generated in /var/opt/mssql/data.
137
+
This option will let you change the default location where the backup files are generated. By default, these files are generated in /var/opt/mssql/data.
133
138
134
139
To set up this new location, use the following commands:
135
140
@@ -158,6 +163,35 @@ To set up this new location, use the following commands:
If an exception occurs in one of the SQL Server processes, SQL Server creates a memory dump.
169
+
170
+
There are two options for controlling the type of memory dumps that SQL Server collects: **coredumptype** and **captureminiandfull**. These relate to the two phases of core dump capture.
171
+
172
+
The first phase capture is controlled by the **coredumptype** setting, which determines the type of dump file generated during an exception. The second phase is enabled when the **captureminiandfull** setting. If **captureminiandfull** is set to true, the dump file specified by **coredumptype** is generated and a second mini dump is also generated. Setting **captureminiandfull** to false disables the second capture attempt.
173
+
174
+
1. Decide whether to capture both mini and full dumps with the **captureminiandfull** setting.
175
+
176
+
```bash
177
+
sudo /opt/mssql/bin/mssql-conf set captureminiandfull <true or false>
178
+
```
179
+
180
+
2. Specify the type of dump file with the **coredumptype** setting.
181
+
182
+
```bash
183
+
sudo /opt/mssql/bin/mssql-conf set coredumptype <dump type>
184
+
```
185
+
186
+
The following table lists the possible **coredumptype** values.
187
+
188
+
| Type | Description |
189
+
|-----|-----|
190
+
|**mini**| Mini is the smallest dump file type. It uses the Linux system information to determine threads and modules in the process. The dump contains only the Host Environment thread stacks and modules. It does not contain indirect memory references or globals. |
191
+
|**miniplus**| MiniPlus is similar to mini, but it includes additional memory. It understands the internals of SQLPAL and the host environment, adding the following memory regions to the dump:</br></br> - Various globals</br> - All memory above 64TB</br> - All named regions found in**/proc/$pid/maps**</br> - Indirect memory from threads and stacks</br> - Thread information</br> - Associated Teb’s and Peb’s</br> - Module Information</br> - VMM and VAD tree |
192
+
|**filtered**| Filtered uses a subtraction-based design where all memory in the process is included unless specifically excluded. The design understands the internals of SQLPAL and the host environment, excluding certain regions from the dump.
193
+
|**full**| Full is a complete process dump that includes all regions located in**/proc/$pid/maps**. This is not controlled by **captureminiandfull** setting. |
This option will let you enable or disable traceflags for the startup of the SQL Server service. To enable/disable a traceflag use the following commands:
0 commit comments