Update using-microsoft.entra-id-linux.md (#209)

telerik · Oct 16, 2024 · e321b0a · e321b0a
1 parent 271d08f
commit e321b0a
Showing 1 changed file with 15 additions and 135 deletions.
diff --git a/dotnet-docs/using-microsoft.entra-id-linux.md b/dotnet-docs/using-microsoft.entra-id-linux.md
@@ -86,143 +86,23 @@ In this article, we will explain how to set up and enable the Microsoft Entra ID
 1. Download the archive `Telerik_ReportServer_Net_NonWindows_{Report Server version}.zip` from [your Telerik account](https://www.telerik.com/account/downloads/product-download?product=REPSERVER).
 1. Unzip the archive. The content gets deployed in two folders `ReportServer` and `ReportServiceAgent`.
 1. Open the `Powershell` and navigate to the subfolder `ReportServer`.
-1. Run the command `docker build -t telerik-report-server:local .` in _Powershell_ to build the Report Server Manager image.
+1. Run the command `docker build -t telerik-report-server:local .` in _Powershell_ to build the Report Server Manager image. Mind the dot `.` at the end of the command.
 1. Navigate to the subfolder `ReportServiceAgent`.
-1. Run the command `docker build -t telerik-report-server-agent:local .` in _Powershell_ to build the Report Server ServiceAgent image.
+1. Run the command `docker build -t telerik-report-server-agent:local .` in _Powershell_ to build the Report Server ServiceAgent image. Mind the dot `.` at the end of the command.
 1. Navigate to the subfolder `ReportServer\docker-configs`.
-1. Open the file `docker-compose.yml` in a text editor like _Notepad++_ and edit its content. Delete everything between the lines `services:` and `  storage:`. Before the line `    environments` include the next lines:
-
-	````yaml
-
-	  ports:
-	    - "1433:1433"
-````
-
-	The tabulation is essential and should be preserved. Here is the final content of the `docker-compose.yml` file:
-
-	````yaml
-services:
-
-	storage:
-	  image: "mcr.microsoft.com/mssql/server:2019-latest"
-	  restart: always
-	  ports:
-	    - "1433:1433"
-	  environment:
-	    - SA_PASSWORD=place_your_sa_password_here
-	    - ACCEPT_EULA=Y
-	  volumes: 
-	    - mssql-storage:/var/opt/mssql
-
-	volumes:
-	mssql-storage:
-````
-
-
-	Save the modified file.
-
-1. Run the command `docker-compose up` in _Powershell_ to execute the above script to create and run the MsSqlServer Docker container we are going to use as Report Server Storage.
-1. Open `MSSQL Management Studio` and _Login_ with the following parameters:
-
-	* _Server_  : `localhost`
-	* _User_    : `sa`
-	* _Password_: `place_your_sa_password_here` (this is the argument _SA_PASSWORD_ from the above script file. You may change it as required.)
-
-1. Add the database named `reportserver`. After successfully creating the database, you may close the management studio.
-1. Stop the current process in _Powershell_, for example, with the key combination `Ctrl+C`.
-1. Go back to the text editor with the opened file `docker-compose.yml` and restore its original content:
-
-	````yaml
-services:
-
-	# template configuration of Report Server.
-	# Includes sample config for /app/Data File Storage.
-	telerik-report-server:
-	  env_file:
-	    - mssql_storage.env
-	  image: telerik-report-server:local
-	  restart: always
-	  ports:
-	    - "82:80"
-	  depends_on: 
-	    - storage
-
-	# template configuration of Report Server Agent.
-	# Includes sample config for /app/Data File Storage.
-	telerik-report-server-agent:
-	  environment:
-	    - Agent__Name=FirstAgent,
-	    - Agent__Address=http://telerik-report-server-agent:80
-	  env_file:
-	    - mssql_storage.env
-	  image: telerik-report-server-agent:local
-	  restart: always
-	  depends_on:
-	    - storage
-
-	storage:
-	  image: "mcr.microsoft.com/mssql/server:2019-latest"
-	  restart: always
-	  environment:
-	    - SA_PASSWORD=place_your_sa_password_here
-	    - ACCEPT_EULA=Y
-	  volumes: 
-	    - mssql-storage:/var/opt/mssql
-
-	volumes:
-	mssql-storage:
-````
-
-
-1. Update the `telerik-report-server` information in the same file by adding the `ExternalLogin__EntraId__ClientSecret` environment attribute as shown below:
-
-	````yaml
-services:
-
-	# template configuration of Report Server.
-	# Includes sample config for /app/Data File Storage.
-	telerik-report-server:
-	  env_file:
-	    - mssql_storage.env
-	  image: telerik-report-server:local
-	  restart: always
-	  ports:
-	    - "82:80"
-	  depends_on: 
-	    - storage
-
-	# template configuration of Report Server Agent.
-	# Includes sample config for /app/Data File Storage.
-	telerik-report-server-agent:
-	  environment:
-	    - Agent__Name=FirstAgent,
-	    - Agent__Address=http://telerik-report-server-agent:80
-	    - ExternalLogin__EntraId__ClientSecret=HZq8Q~j9iO0Mr.WDn1U9IMHZClsacsWz3DTdlmgYjaOH
-	  env_file:
-	    - mssql_storage.env
-	  image: telerik-report-server-agent:local
-	  restart: always
-	  depends_on:
-	    - storage
-
-	storage:
-	  image: "mcr.microsoft.com/mssql/server:2019-latest"
-	  restart: always
-	  environment:
-	    - SA_PASSWORD=place_your_sa_password_here
-	    - ACCEPT_EULA=Y
-	  volumes: 
-	    - mssql-storage:/var/opt/mssql
-
-	volumes:
-	mssql-storage:
-````
-
-	Change the client secret with the one from the Entra ID setup in the Azure portal.
-
-	Save the file.
-
-1. Go back to the _Powershell_ environment and execute the above _yaml_ file with the same command `docker-compose up`. This should run the Report Server Manager and ReportServer.ServiceAgent for .NET.
+1. (_optional, recommended_) Change the password `P1@ceStr0ngP@ssw0rdH3r3` for the SA database user with your own strong password in the files `docker-compose.yml` and `mssql_storage.env`:
+
+	* Open the file `docker-compose.yml` in a text editor like Notepad++ and change the password on line 31. The tabulation is essential and should be preserved:
+
+	`      - SA_PASSWORD=P1@ceStr0ngP@ssw0rdH3r3`
+
+	* Open the file `mssql_storage.env` in a text editor like Notepad++ and change the password with your own password you used above:
+
+	`reportServer__storage__parameters__0__value=Data Source=storage;Initial Catalog=reportserver;Password=P1@ceStr0ngP@ssw0rdH3r3;User Id=sa;Encrypt=false`
+
+1. Run the command `docker image pull mcr.microsoft.com/mssql/server:2019-latest`.
+1. (_optional, use it only if it was not used before_) Initialize a swarm to make the Docker Engine hosting the RS.NET a manager in the newly created single-node swarm by running the command `docker swarm init`.
+1. Run the command `docker stack deploy -c docker-compose.yml report-server`.
 1. Navigate to `localhost:82` in the browser to open the Report Server Manager for .NET.
 
 ### 4. Enabling Microsoft Entra ID Authentication in the Telerik Report Server for .NET