Skip to content

Commit 3d66c67

Browse files
seesharprunseesharprun
committed
Updated release notes
1 parent d3c0bdd commit 3d66c67

File tree

1 file changed

+59
-52
lines changed

1 file changed

+59
-52
lines changed

‎articles/cosmos-db/local-emulator-release-notes.md

Lines changed: 59 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -5,105 +5,112 @@ ms.service: cosmos-db
55
ms.topic: conceptual
66
author: milismsft
77
ms.author: adrianmi
8-
ms.date: 09/21/2020
8+
ms.date: 08/10/2022
9+
ms.reviewer: esarroyo
910
---
1011

1112
# Azure Cosmos DB Emulator - Release notes and download information
13+
1214
[!INCLUDE[appliesto-all-apis](includes/appliesto-all-apis.md)]
1315

1416
This article shows the Azure Cosmos DB Emulator released versions and it details the updates that were made. Only the latest version is made available to download and use and previous versions aren't actively supported by the Azure Cosmos DB Emulator developers.
1517

1618
## Download
1719

1820
| | Link |
19-
|---------|---------|
20-
|**MSI download**|[Microsoft Download Center](https://aka.ms/cosmosdb-emulator)|
21-
|**Get started**|[Develop locally with Azure Cosmos DB Emulator](local-emulator.md)|
21+
| --- | --- |
22+
| **MSI download** | [Microsoft Download Center](https://aka.ms/cosmosdb-emulator) |
23+
| **Get started** | [Develop locally with Azure Cosmos DB Emulator](local-emulator.md) |
2224

2325
## Release notes
2426

25-
### 2.14.7 (May 9, 2022)
27+
### `2.14.9` (July 7, 2022)
2628

27-
- This release updates the Azure Cosmos DB Emulator background services to match the latest online functionality of the Azure Cosmos DB. In addition to this update there are couple issues that were addressed in this release:
28-
* Update Data Explorer to the latest content and fix a broken link for the quick start sample documentation.
29-
* Add option to enable the Mongo API version for the Linux Cosmos DB emulator by setting the environment variable: "AZURE_COSMOS_EMULATOR_ENABLE_MONGODB_ENDPOINT" in the Docker container setting. Valid setting are: "3.2", "3.6", "4.0" and "4.2"
29+
- This release updates the Azure Cosmos DB Emulator background services to match the latest online functionality of the Azure Cosmos DB.
3030

31-
### 2.14.6 (March 7, 2022)
31+
### `2.14.8`
3232

33-
- This release updates the Azure Cosmos DB Emulator background services to match the latest online functionality of the Azure Cosmos DB. In addition to this update there are couple issues that were addressed in this release:
34-
* Fix for an issue related to high CPU usage when the emulator is running.
35-
* Add PowerShell option to set the Mongo API version: "-MongoApiVersion". Valid setting are: "3.2", "3.6" and "4.0"
33+
- This release updates the Azure Cosmos DB Emulator background services to match the latest online functionality of the Azure Cosmos DB.
3634

37-
### 2.14.5 (January 18, 2022)
35+
### `2.14.7` (May 9, 2022)
3836

39-
- This release updates the Azure Cosmos DB Emulator background services to match the latest online functionality of the Azure Cosmos DB. One other important update with this release is to reduce the number of services executed in the background and start them as needed.
37+
- This release updates the Azure Cosmos DB Emulator background services to match the latest online functionality of the Azure Cosmos DB. In addition to this update, there are couple issues that were addressed in this release:
38+
- Update Data Explorer to the latest content and fix a broken link for the quick start sample documentation.
39+
- Add option to enable the Mongo API version for the Linux Cosmos DB emulator by setting the environment variable: `AZURE_COSMOS_EMULATOR_ENABLE_MONGODB_ENDPOINT` in the Docker container. Valid settings are: `3.2`, `3.6`, `4.0` and `4.2`
4040

41-
### 2.14.4 (October 25, 2021)
41+
### `2.14.6` (March 7, 2022)
4242

43-
- This release updates the Azure Cosmos DB Emulator background services to match the latest online functionality of the Azure Cosmos DB.
43+
- This release updates the Azure Cosmos DB Emulator background services to match the latest online functionality of the Azure Cosmos DB. In addition to this update, there are couple issues that were addressed in this release:
44+
- Fix for an issue related to high CPU usage when the emulator is running.
45+
- Add PowerShell option to set the Mongo API version: `-MongoApiVersion`. Valid settings are: `3.2`, `3.6` and `4.0`
4446

45-
### 2.14.3 (September 8, 2021)
47+
### `2.14.5` (January 18, 2022)
4648

47-
- This release updates the Azure Cosmos DB Emulator background services to match the latest online functionality of the Azure Cosmos DB. It also addresses couple issues with telemetry data that is collected and resets the base image for the Linux Cosmos emulator Docker image.
49+
- This release updates the Azure Cosmos DB Emulator background services to match the latest online functionality of the Azure Cosmos DB. One other important update with this release is to reduce the number of services executed in the background and start them as needed.
4850

49-
### 2.14.2 (August 12, 2021)
51+
### `2.14.4` (October 25, 2021)
5052

51-
- This release updates the local Data Explorer content to latest Microsoft Azure version and resets the base for the Linux Cosmos emulator Docker image.
53+
- This release updates the Azure Cosmos DB Emulator background services to match the latest online functionality of the Azure Cosmos DB.
5254

53-
### 2.14.1 (June 18, 2021)
55+
### `2.14.3` (September 8, 2021)
5456

55-
- This release improves the start-up time for the emulator while reducing the footprint of its data on the disk. This new optimization is activated by "/EnablePreview" argument.
57+
- This release updates the Azure Cosmos DB Emulator background services to match the latest online functionality of the Azure Cosmos DB. It also addresses issues with performance data that is collected and resets the base image for the Linux Cosmos emulator Docker image.
5658

57-
### 2.14.0 (June 15, 2021)
59+
### `2.14.2` (August 12, 2021)
5860

59-
- This release updates the local Data Explorer content to latest Microsoft Azure version. It also fixes an issue when importing multiple document items by using the JSON file upload feature.
61+
- This release updates the local Data Explorer content to latest Microsoft Azure version and resets the base for the Linux Cosmos emulator Docker image.
6062

61-
### 2.11.13 (April 21, 2021)
63+
### `2.14.1` (June 18, 2021)
6264

63-
- This release updates the local Data Explorer content to latest Microsoft Azure version and adds a new MongoDB endpoint configuration, "4.0".
65+
- This release improves the start-up time for the emulator while reducing the footprint of its data on the disk. This new optimization is activated by `/EnablePreview` argument.
6466

65-
### 2.11.11 (February 22, 2021)
67+
### `2.14.0` (June 15, 2021)
6668

67-
- This release updates the local Data Explorer content to latest Microsoft Azure version.
69+
- This release updates the local Data Explorer content to latest Microsoft Azure version. It also fixes an issue when importing multiple document items by using the JSON file upload feature.
6870

71+
### `2.11.13` (April 21, 2021)
6972

70-
### 2.11.10 (January 5, 2021)
73+
- This release updates the local Data Explorer content to latest Microsoft Azure version and adds a new MongoDB endpoint configuration, "4.0".
7174

72-
- This release updates the local Data Explorer content to latest Microsoft Azure version. It also adds a new public option, "/ExportPemCert", which allows the emulator user to directly export the public emulator's certificate as a .PEM file.
75+
### `2.11.11` (February 22, 2021)
7376

74-
### 2.11.9 (December 3, 2020)
77+
- This release updates the local Data Explorer content to latest Microsoft Azure version.
7578

76-
- This release updates the Azure Cosmos DB Emulator background services to match the latest online functionality of the Azure Cosmos DB. It also addresses couple issues with the Azure Cosmos DB Emulator functionality:
77-
* Fix for an issue where large document payload requests fail when using Direct mode and Java client applications.
78-
* Fix for a connectivity issue with MongoDB endpoint version 3.6 when targeted by .NET based applications.
79+
### `2.11.10` (January 5, 2021)
7980

80-
### 2.11.8 (November 6, 2020)
81+
- This release updates the local Data Explorer content to latest Microsoft Azure version. It also adds a new public option, `/ExportPemCert`, which allows the emulator user to directly export the public emulator's certificate as a .PEM file.
8182

82-
- This release includes an update for the Azure Cosmos DB Emulator Data Explorer and fixes an issue where "TLS 1.3" clients try to open the Data Explorer.
83+
### `2.11.9` (December 3, 2020)
8384

84-
### 2.11.6 (October 6, 2020)
85+
- This release updates the Azure Cosmos DB Emulator background services to match the latest online functionality of the Azure Cosmos DB. It also addresses couple issues with the Azure Cosmos DB Emulator functionality:
86+
- Fix for an issue where large document payload requests fail when using Direct mode and Java client applications.
87+
- Fix for a connectivity issue with MongoDB endpoint version 3.6 when targeted by .NET based applications.
8588

86-
- This release addresses a concurrency-related issue when multiple containers might be created at the same time. This can leave the emulator in a corrupted state and future API requests to the emulator's endpoint will fail with "service unavailable" errors. The work-around is to stop the emulator, reset of the emulator's local data and restart.
89+
### `2.11.8` (November 6, 2020)
8790

88-
### 2.11.5 (August 23, 2020)
91+
- This release includes an update for the Azure Cosmos DB Emulator Data Explorer and fixes an issue where "TLS 1.3" clients try to open the Data Explorer.
8992

90-
This release adds two new Azure Cosmos DB Emulator startup options:
93+
### `2.11.6` (October 6, 2020)
9194

92-
* "/EnablePreview" - it enables preview features for the Azure Cosmos DB Emulator. The preview features that are still under development and they can be accessed via CI and sample writing.
93-
* "/EnableAadAuthentication" - it enables the emulator to accept custom Azure Active Directory tokens as an alternative to the Azure Cosmos primary keys. This feature is still under development; specific role assignments and other permission-related settings aren't currently supported.
95+
- This release addresses a concurrency-related issue when multiple containers might be created at the same time. The issue can leave the emulator in a corrupted state and future API requests to the emulator's endpoint will fail with "service unavailable" errors. The work-around is to stop the emulator, reset of the emulator's local data and restart.
9496

95-
### 2.11.2 (July 7, 2020)
97+
### `2.11.5` (August 23, 2020)
9698

97-
- This release changes how ETL traces required when troubleshooting the Azure Cosmos DB Emulator are collected. WPR (Windows Performance Runtime tools) is now the default tools for capturing ETL-based traces while old LOGMAN based capturing has been deprecated. With the latest Windows security update, LOGMAN stopped working as expected when executed through the Azure Cosmos DB Emulator.
99+
- This release adds two new Azure Cosmos DB Emulator startup options:
100+
- `/EnablePreview` - Enables preview features for the Azure Cosmos DB Emulator. The preview features that are still under development and they can be accessed via CI and sample writing.
101+
- `/EnableAadAuthentication` - Enables the emulator to accept custom Azure Active Directory tokens as an alternative to the Azure Cosmos primary keys. This feature is still under development; specific role assignments and other permission-related settings aren't currently supported.
98102

99-
### 2.11.1 (June 10, 2020)
103+
### `2.11.2` (July 7, 2020)
104+
105+
- This release changes how ETL traces required when troubleshooting the Azure Cosmos DB Emulator are collected. WPR (Windows Performance Runtime tools) is now the default tools for capturing ETL-based traces while old LOGMAN based capturing has been deprecated. With the latest Windows security update, LOGMAN stopped working as expected when executed through the Azure Cosmos DB Emulator.
100106

101-
This release fixes couple bugs related to Azure Cosmos DB Emulator Data Explorer:
107+
### `2.11.1` (June 10, 2020)
102108

103-
* Data Explorer fails to connect to the Azure Cosmos DB Emulator endpoint when hosted in some Web browser versions. Emulator users might not be able to create a database or a container through the Web page.
104-
* Address an issue that prevented emulator users from creating an item from a JSON file using Data Explorer upload action.
109+
- This release fixes couple bugs related to Azure Cosmos DB Emulator Data Explorer:
110+
- Data Explorer fails to connect to the Azure Cosmos DB Emulator endpoint when hosted in some Web browser versions. Emulator users might not be able to create a database or a container through the Web page.
111+
- Address an issue that prevented emulator users from creating an item from a JSON file using Data Explorer upload action.
105112

106-
### 2.11.0
113+
### `2.11.0`
107114

108115
- This release introduces support for autoscale provisioned throughput. The added features include the option to set a custom maximum provisioned throughput level in request units (RU/s), enable autoscale on existing databases and containers, and API support through Azure Cosmos DB SDK.
109116
- Fix an issue while querying through large number of documents (over 1 GB) were the emulator will fail with internal error status code 500.
@@ -122,7 +129,7 @@ This release fixes couple bugs related to Azure Cosmos DB Emulator Data Explorer
122129

123130
### 2.7.2
124131

125-
- This release adds MongoDB version 3.6 server support to the Azure Cosmos DB Emulator. To start a MongoDB endpoint that target version 3.6 of the service, start the emulator from an Administrator command line with "/EnableMongoDBEndpoint=3.6" option.
132+
- This release adds MongoDB version 3.6 server support to the Azure Cosmos DB Emulator. To start a MongoDB endpoint that target version 3.6 of the service, start the emulator from an Administrator command line with `/EnableMongoDBEndpoint=3.6` option.
126133

127134
### 2.7.0
128135

@@ -134,8 +141,8 @@ This release fixes couple bugs related to Azure Cosmos DB Emulator Data Explorer
134141

135142
### 2.4.3
136143

137-
- Disabled starting the MongoDB service by default. Only the SQL endpoint is enabled as default. The user must start the endpoint manually using the emulator's "/EnableMongoDbEndpoint" command-line option. Now, it's like all the other service endpoints, such as Gremlin, Cassandra, and Table.
138-
- Fixed a bug in the emulator when starting with “/AllowNetworkAccess” where the Gremlin, Cassandra, and Table endpoints weren't properly handling requests from external clients.
144+
- Disabled starting the MongoDB service by default. Only the SQL endpoint is enabled as default. The user must start the endpoint manually using the emulator's `/EnableMongoDbEndpoint` command-line option. Now, it's like all the other service endpoints, such as Gremlin, Cassandra, and Table.
145+
- Fixes a bug in the emulator when starting with “/AllowNetworkAccess” where the Gremlin, Cassandra, and Table endpoints weren't properly handling requests from external clients.
139146
- Add direct connection ports to the Firewall Rules settings.
140147

141148
### 2.4.0

0 commit comments

Comments
 (0)