Skip to content

Commit 45f57e0

Browse files
committed
Some acrolinx
1 parent fb7eaf7 commit 45f57e0

2 files changed

Lines changed: 24 additions & 14 deletions

File tree

docs/database-engine/configure-windows/configure-pmem.md

Lines changed: 17 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -25,11 +25,11 @@ This article describes how to configure the persistent memory (PMEM) for [!INCLU
2525

2626
### Create namespaces for PMEM devices
2727

28-
In Windows, use the `ipmctl` utility to configure the PMEM disks (referred to as namespaces in Linux). You can find Intel® Optane™ specific instructions [here](https://www.intel.com/content/www/us/en/developer/articles/guide/qsg-part3-windows-provisioning-with-optane-pmem.html). Details on supported PMEM hardware on different Windows versions is provided [here](/azure-stack/hci/concepts/deploy-persistent-memory#supported-hardware). PMEM disks should be interleaved across PMEM NVDIMMs and can provide different types of user-space access to memory regions on the device. For more on interleaved sets in Windows see [here](/azure-stack/hci/concepts/deploy-persistent-memory#understand-interleaved-sets).
28+
In Windows, use the `ipmctl` utility to configure the PMEM disks (referred to as namespaces in Linux). You can find Intel® Optane™ specific instructions [here](https://www.intel.com/content/www/us/en/developer/articles/guide/qsg-part3-windows-provisioning-with-optane-pmem.html). Details on supported PMEM hardware on different Windows versions are at [Understand and deploy persistent memory](/azure-stack/hci/concepts/deploy-persistent-memory#supported-hardware). PMEM disks should be interleaved across PMEM NVDIMMs and can provide different types of user-space access to memory regions on the device. For more on interleaved sets in Windows see [here](/azure-stack/hci/concepts/deploy-persistent-memory#understand-interleaved-sets).
2929

3030
## PMEM disks
3131

32-
### Using powershell to examine PMEM disks
32+
### Use PowerShell to examine PMEM disks
3333

3434
```powershell
3535
#Get information about all physical disks
@@ -44,16 +44,19 @@ Get-PmemPhysicalDevice
4444
#Get information about unused PMEM regions
4545
Get-PmemUnusedRegion
4646
```
47+
4748
### BTT and DAX
4849

4950
By default, `New-PmemDisk` will use the desired `FSDax` mode. Atomicity is set to the default of `None` rather than `BlockTranslationTable`. From a support perspective, BTT must be enabled for the transaction log, to mimic required sector mode semantics. Although use of [BTT](/azure-stack/hci/concepts/deploy-persistent-memory#block-translation-table) with NTFS is generally recommended, BTT is not recommended when using large pages, such as required for [DAX](/windows-server/storage/storage-spaces/persistent-memory-direct-access#dax-and-block-translation-table-btt).
5051

5152
```powershell
5253
Get-PmemUnusedRegion | New-PmemDisk -Atomicity None
5354
```
55+
5456
### Formatting the NTFS volume(s)
5557

5658
```powershell
59+
5760
#Initialize PMEM Disk(s)
5861
Get-PmemDisk | Initialize-Disk -PartitionStyle GPT
5962
@@ -72,20 +75,24 @@ Format-Volume `
7275
## File alignment and offset
7376

7477
### Check partition offset(s)
78+
7579
```powershell
7680
Get-Partition | Select-Object DiskNumber, DriveLetter, IsDAX, Offset, Size, PartitionNumber | fl
7781
```
78-
We can check the file alignment of a particular file using `fsutil`. Note that our file size must be a modulo of 2MB.
82+
83+
Check the file alignment of a particular file using `fsutil`. Note that our file size must be a modulo of 2 MB.
84+
7985
```bash
8086
fsutil dax queryFileAlignment A:\AdventureWorks2019_A.mdf
8187
```
88+
8289
## Replacing PMEM
8390

8491
### Reprovision PMEM disks
8592

86-
Whenever a PMEM module is replaced it needs to be reprovisioned.
93+
Whenever a PMEM module is replaced, it needs to be re-provisioned.
8794

88-
> [!Note]
95+
> [!NOTE]
8996
> Removing a PMEM disk will result in the loss of data on that disk.
9097
9198
```powershell
@@ -94,10 +101,13 @@ Get-PmemDisk | Remove-PmemDisk -Confirm:$false
94101
```
95102
### Erase PMEM modules
96103

97-
To permanently erase data from PMEM modules use the `Initialize-PmemPhysicalDevice` powershell cmdlet.
104+
To permanently erase data from PMEM modules use the `Initialize-PmemPhysicalDevice` PowerShell cmdlet.
98105

99106
```powershell
100107
# Reinitialize all PMEM disks
101108
Get-PmemPhysicalDevice | Initialize-PmemPhysicalDevice -Confirm:$false
102109
```
103-
Other powershell cmdlets for manipulating PMEM are listed [here](/powershell/module/persistentmemory/).
110+
111+
## See also
112+
113+
For other cmdlets for manipulating PMEM see [PersistentMemory](/powershell/module/persistentmemory/) in the PowerShell reference documentation.

docs/relational-databases/databases/add-persisted-log-buffer.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
description: "Add persisted log buffer to a database"
2+
description: "Explains how to add a persisted log buffer to a database in SQL Server 2019 and later. Provides Transact SQL examples."
33
title: "Add persisted log buffer to a database"
44
ms.custom: ""
55
ms.date: "10/30/2019"
@@ -18,7 +18,7 @@ helpviewer_keywords:
1818
ms.assetid: 8ead516a-1334-4f40-84b2-509d0a8ffa45
1919
author: "briancarrig"
2020
ms.author: "brcarrig"
21-
manager: amitban
21+
ms.reviewer: mikeray
2222
---
2323

2424
# Add persisted log buffer to a database
@@ -40,7 +40,7 @@ To configure a persistent memory device in [Windows](../../database-engine/confi
4040

4141
## Add a persisted log buffer to a database
4242

43-
The following examples adds a persisted log buffer.
43+
The following example adds a persisted log buffer.
4444

4545
```sql
4646
ALTER DATABASE <MyDB>
@@ -64,15 +64,15 @@ ALTER DATABASE WideWorldImporters
6464
);
6565
```
6666

67-
Note that the log file on the DAX volume will be sized at 20MB regardless of the size specified wih the ADD FILE command.
67+
The log file on the DAX volume will be sized at 20 MB regardless of the size specified with the ADD FILE command.
6868

6969
The volume or mount the new log file is placed must be formatted with DAX enabled (NTFS) or mounted with the DAX option (XFS/EXT4).
7070

7171
## Remove a persisted log buffer
7272

7373
To safely remove a persisted log buffer, the database must be placed in single user mode in order to drain the persisted log buffer.
7474

75-
The following example places removes a persisted log buffer.
75+
The following example removes a persisted log buffer.
7676

7777
```sql
7878
ALTER DATABASE <MyDB> SET SINGLE_USER;
@@ -93,13 +93,13 @@ ALTER DATABASE WideWorldImporters SET MULTI_USER;
9393

9494
[Availability Groups](../../t-sql/statements/create-availability-group-transact-sql.md) can only use this feature on secondary replicas due to the requirement by the log reader agent for standard log writing semantics on the primary. However, the small log file must be created on all nodes (ideally on DAX volumes or mounts). In the event of a failover, the persisted log buffer path must exist, in order for the failover to be successful.
9595

96-
In cases where the path or file are not present during an Availability Group failover event, or database startup, the database will enter a `RECOVERY PENDING` state until the issue is resolved.
96+
In cases where the path or file isn't present during an Availability Group failover event, or database startup, the database enters a `RECOVERY PENDING` state until the issue is resolved.
9797

9898
## Interoperability with other PMEM features
9999

100100
When both Persisted log buffer and [Hybrid Buffer Pool](../../database-engine/configure-windows/hybrid-buffer-pool.md) are jointly enabled, along with start-up [trace flag 809](../../t-sql/database-console-commands/dbcc-traceon-trace-flags-transact-sql.md), Hybrid buffer pool will operate in what is known as _Direct Write_ mode.
101101

102-
## Backup and restore operations
102+
## Back up and restore operations
103103

104104
Normal restore conditions apply. If persisted log buffer is restored to a DAX volume or mount, it will continue to function, otherwise it can be safely removed.
105105

0 commit comments

Comments
 (0)