Skip to content

Commit e321b0a

Browse files
Update using-microsoft.entra-id-linux.md (#209)
1 parent 271d08f commit e321b0a

File tree

1 file changed

+15
-135
lines changed

1 file changed

+15
-135
lines changed

dotnet-docs/using-microsoft.entra-id-linux.md

Lines changed: 15 additions & 135 deletions
Original file line numberDiff line numberDiff line change
@@ -86,143 +86,23 @@ In this article, we will explain how to set up and enable the Microsoft Entra ID
8686
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).
8787
1. Unzip the archive. The content gets deployed in two folders `ReportServer` and `ReportServiceAgent`.
8888
1. Open the `Powershell` and navigate to the subfolder `ReportServer`.
89-
1. Run the command `docker build -t telerik-report-server:local .` in _Powershell_ to build the Report Server Manager image.
89+
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.
9090
1. Navigate to the subfolder `ReportServiceAgent`.
91-
1. Run the command `docker build -t telerik-report-server-agent:local .` in _Powershell_ to build the Report Server ServiceAgent image.
91+
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.
9292
1. Navigate to the subfolder `ReportServer\docker-configs`.
93-
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:
94-
95-
````yaml
96-
97-
ports:
98-
- "1433:1433"
99-
````
100-
101-
The tabulation is essential and should be preserved. Here is the final content of the `docker-compose.yml` file:
102-
103-
````yaml
104-
services:
105-
106-
storage:
107-
image: "mcr.microsoft.com/mssql/server:2019-latest"
108-
restart: always
109-
ports:
110-
- "1433:1433"
111-
environment:
112-
- SA_PASSWORD=place_your_sa_password_here
113-
- ACCEPT_EULA=Y
114-
volumes:
115-
- mssql-storage:/var/opt/mssql
116-
117-
volumes:
118-
mssql-storage:
119-
````
120-
121-
122-
Save the modified file.
123-
124-
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.
125-
1. Open `MSSQL Management Studio` and _Login_ with the following parameters:
126-
127-
* _Server_ : `localhost`
128-
* _User_ : `sa`
129-
* _Password_: `place_your_sa_password_here` (this is the argument _SA_PASSWORD_ from the above script file. You may change it as required.)
130-
131-
1. Add the database named `reportserver`. After successfully creating the database, you may close the management studio.
132-
1. Stop the current process in _Powershell_, for example, with the key combination `Ctrl+C`.
133-
1. Go back to the text editor with the opened file `docker-compose.yml` and restore its original content:
134-
135-
````yaml
136-
services:
137-
138-
# template configuration of Report Server.
139-
# Includes sample config for /app/Data File Storage.
140-
telerik-report-server:
141-
env_file:
142-
- mssql_storage.env
143-
image: telerik-report-server:local
144-
restart: always
145-
ports:
146-
- "82:80"
147-
depends_on:
148-
- storage
149-
150-
# template configuration of Report Server Agent.
151-
# Includes sample config for /app/Data File Storage.
152-
telerik-report-server-agent:
153-
environment:
154-
- Agent__Name=FirstAgent,
155-
- Agent__Address=http://telerik-report-server-agent:80
156-
env_file:
157-
- mssql_storage.env
158-
image: telerik-report-server-agent:local
159-
restart: always
160-
depends_on:
161-
- storage
162-
163-
storage:
164-
image: "mcr.microsoft.com/mssql/server:2019-latest"
165-
restart: always
166-
environment:
167-
- SA_PASSWORD=place_your_sa_password_here
168-
- ACCEPT_EULA=Y
169-
volumes:
170-
- mssql-storage:/var/opt/mssql
171-
172-
volumes:
173-
mssql-storage:
174-
````
175-
176-
177-
1. Update the `telerik-report-server` information in the same file by adding the `ExternalLogin__EntraId__ClientSecret` environment attribute as shown below:
178-
179-
````yaml
180-
services:
181-
182-
# template configuration of Report Server.
183-
# Includes sample config for /app/Data File Storage.
184-
telerik-report-server:
185-
env_file:
186-
- mssql_storage.env
187-
image: telerik-report-server:local
188-
restart: always
189-
ports:
190-
- "82:80"
191-
depends_on:
192-
- storage
193-
194-
# template configuration of Report Server Agent.
195-
# Includes sample config for /app/Data File Storage.
196-
telerik-report-server-agent:
197-
environment:
198-
- Agent__Name=FirstAgent,
199-
- Agent__Address=http://telerik-report-server-agent:80
200-
- ExternalLogin__EntraId__ClientSecret=HZq8Q~j9iO0Mr.WDn1U9IMHZClsacsWz3DTdlmgYjaOH
201-
env_file:
202-
- mssql_storage.env
203-
image: telerik-report-server-agent:local
204-
restart: always
205-
depends_on:
206-
- storage
207-
208-
storage:
209-
image: "mcr.microsoft.com/mssql/server:2019-latest"
210-
restart: always
211-
environment:
212-
- SA_PASSWORD=place_your_sa_password_here
213-
- ACCEPT_EULA=Y
214-
volumes:
215-
- mssql-storage:/var/opt/mssql
216-
217-
volumes:
218-
mssql-storage:
219-
````
220-
221-
Change the client secret with the one from the Entra ID setup in the Azure portal.
222-
223-
Save the file.
224-
225-
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.
93+
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`:
94+
95+
* 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:
96+
97+
` - SA_PASSWORD=P1@ceStr0ngP@ssw0rdH3r3`
98+
99+
* Open the file `mssql_storage.env` in a text editor like Notepad++ and change the password with your own password you used above:
100+
101+
`reportServer__storage__parameters__0__value=Data Source=storage;Initial Catalog=reportserver;Password=P1@ceStr0ngP@ssw0rdH3r3;User Id=sa;Encrypt=false`
102+
103+
1. Run the command `docker image pull mcr.microsoft.com/mssql/server:2019-latest`.
104+
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`.
105+
1. Run the command `docker stack deploy -c docker-compose.yml report-server`.
226106
1. Navigate to `localhost:82` in the browser to open the Report Server Manager for .NET.
227107

228108
### 4. Enabling Microsoft Entra ID Authentication in the Telerik Report Server for .NET

0 commit comments

Comments
 (0)