Skip to content

Commit 271d08f

Browse files
todorarabadzhievtodorarabadzhiev
authored
Todorarabadzhiev patch 1 (#208)
* Update docker-installation.md * Update docker-installation.md * Update docker-installation.md * Create dotnet-installation-on-docker-container-2024-q2.md * Update docker-installation.md
1 parent 6c88a14 commit 271d08f

File tree

2 files changed

+151
-91
lines changed

2 files changed

+151
-91
lines changed

‎dotnet-docs/docker-installation.md‎

Lines changed: 15 additions & 91 deletions
Original file line numberDiff line numberDiff line change
@@ -19,97 +19,23 @@ This article is a step-by-step tutorial on deploying Telerik Report Server for .
1919
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).
2020
1. Unzip the archive. The content gets deployed in two folders `ReportServer` and `ReportServiceAgent`.
2121
1. Open the `Powershell` and navigate to the subfolder `ReportServer`.
22-
1. Run the command `docker build -t telerik-report-server:local .` in _Powershell_ to build the Report Server Manager image.
22+
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.
2323
1. Navigate to the subfolder `ReportServiceAgent`.
24-
1. Run the command `docker build -t telerik-report-server-agent:local .` in _Powershell_ to build the Report Server ServiceAgent image.
24+
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.
2525
1. Navigate to the subfolder `ReportServer\docker-configs`.
26-
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:
27-
28-
````yaml
29-
30-
ports:
31-
- "1433:1433"
32-
````
33-
34-
The tabulation is essential and should be preserved. Here is the final content of the `docker-compose.yml` file:
35-
36-
````yaml
37-
services:
38-
39-
storage:
40-
image: "mcr.microsoft.com/mssql/server:2019-latest"
41-
restart: always
42-
ports:
43-
- "1433:1433"
44-
environment:
45-
- SA_PASSWORD=place_your_sa_password_here
46-
- ACCEPT_EULA=Y
47-
volumes:
48-
- mssql-storage:/var/opt/mssql
49-
50-
volumes:
51-
mssql-storage:
52-
````
53-
54-
55-
Save the modified file.
56-
57-
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.
58-
1. Open `MSSQL Management Studio` and _Login_ with the following parameters:
59-
60-
* _Server_ : `localhost`
61-
* _User_ : `sa`
62-
* _Password_: `place_your_sa_password_here` (this is the argument _SA_PASSWORD_ from the above script file. You may change it as required.)
63-
64-
1. Add the database named `reportserver`. After successfully creating the database, you may close the management studio.
65-
1. Stop the current process in _Powershell_, for example, with the key combination `Ctrl+C`.
66-
1. Go back to the text editor with the opened file `docker-compose.yml` and restore its original content:
67-
68-
````yaml
69-
services:
70-
71-
# template configuration of Report Server.
72-
# Includes sample config for /app/Data File Storage.
73-
telerik-report-server:
74-
env_file:
75-
- mssql_storage.env
76-
image: telerik-report-server:local
77-
restart: always
78-
ports:
79-
- "82:80"
80-
depends_on:
81-
- storage
82-
83-
# template configuration of Report Server Agent.
84-
# Includes sample config for /app/Data File Storage.
85-
telerik-report-server-agent:
86-
environment:
87-
- Agent__Name=FirstAgent,
88-
- Agent__Address=http://telerik-report-server-agent:80
89-
env_file:
90-
- mssql_storage.env
91-
image: telerik-report-server-agent:local
92-
restart: always
93-
depends_on:
94-
- storage
95-
96-
storage:
97-
image: "mcr.microsoft.com/mssql/server:2019-latest"
98-
restart: always
99-
environment:
100-
- SA_PASSWORD=place_your_sa_password_here
101-
- ACCEPT_EULA=Y
102-
volumes:
103-
- mssql-storage:/var/opt/mssql
104-
105-
volumes:
106-
mssql-storage:
107-
````
108-
109-
110-
Save the file.
111-
112-
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.
26+
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`:
27+
28+
* 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:
29+
30+
` - SA_PASSWORD=P1@ceStr0ngP@ssw0rdH3r3`
31+
32+
* Open the file `mssql_storage.env` in a text editor like Notepad++ and change the password with your own password you used above:
33+
34+
`reportServer__storage__parameters__0__value=Data Source=storage;Initial Catalog=reportserver;Password=P1@ceStr0ngP@ssw0rdH3r3;User Id=sa;Encrypt=false`
35+
36+
1. Run the command `docker image pull mcr.microsoft.com/mssql/server:2019-latest`.
37+
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`.
38+
1. Run the command `docker stack deploy -c docker-compose.yml report-server`.
11339
1. Navigate to `localhost:82` in the browser to open the Report Server Manager for .NET.
11440

11541
The first time you open the Report Server you need to configure it as explained in the article [Application Startup]({%slug application-startup%}).
@@ -122,12 +48,10 @@ You may download and watch the whole process from our `reporting-samples` GitHub
12248

12349
The above approach for starting the RS.NET from the container will stop it *each* time you restart the machine. To avoid this, execute the following commands in _Powershell_ from the folder _.\ReportServer\docker-configs\_ to start/stop the Report Server instead of using the commands `docker-compose up` and `docker-compose down`:
12450

125-
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:`docker swarm init`
12651
1. Start the RS.NET with `.\start-docker-server.bat`
12752
1. (_optional_) Stop the RS.NET with `.\stop-docker-server.bat`
12853

12954
## See Also
13055

13156
* [Telerik Report Server Introduction]({%slug introduction%})
13257
* [Report Server for .NET Introduction]({%slug coming-soon%})
133-
* [SetupRS.NET-Docker.mp4](https://github.com/telerik/reporting-samples/blob/master/VideosRS/SetupRS.NET-Docker.mp4)

‎knowledge-base/dotnet-installation-on-docker-container-2024-q2.md‎

Lines changed: 136 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,136 @@
1+
---
2+
title: Installing ReportServer.NET version 2024 Q2 on Docker Container
3+
description: "Learn how to install the Telerik Report Server for .NET version 2024 Q2 on Docker Container."
4+
type: how-to
5+
page_title: Install RS.NET 2024 Q2 on Docker Container
6+
slug: dotnet-installation-on-docker-container-2024-q2
7+
tags: installation,dotnet,docker,linux,container
8+
res_type: kb
9+
---
10+
11+
> The steps in this tutorial are for RS.NET `2024 Q2`. For newer Report Server versions use the Documentation article [Report Server for .NET: Installation on Docker Container]({%slug dotnet-installation-on-docker-container%}).
12+
13+
## Description
14+
15+
The Report Server for .NET (`RS.NET`) is ready for deployment on Docker Containers. The assets for non-Windows platforms are available as separate resources downloadable from [your Telerik account](https://www.telerik.com/account/downloads/product-download?product=REPSERVER).
16+
17+
This article is a step-by-step tutorial on deploying Telerik Report Server for .NET on a Linux Docker Container with a [Microsoft SQL Server (MsSqlServer) Storage]({%slug storage-settings%}#microsoft-sql-server-mssqlserver) deployed on its own Docker Container based on the image `mcr.microsoft.com/mssql/server:2019-latest` exposed publicly on port `1433`.
18+
19+
## Installation Process
20+
21+
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).
22+
1. Unzip the archive. The content gets deployed in two folders `ReportServer` and `ReportServiceAgent`.
23+
1. Open the `Powershell` and navigate to the subfolder `ReportServer`.
24+
1. Run the command `docker build -t telerik-report-server:local .` in _Powershell_ to build the Report Server Manager image.
25+
1. Navigate to the subfolder `ReportServiceAgent`.
26+
1. Run the command `docker build -t telerik-report-server-agent:local .` in _Powershell_ to build the Report Server ServiceAgent image.
27+
1. Navigate to the subfolder `ReportServer\docker-configs`.
28+
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:
29+
30+
````yaml
31+
32+
ports:
33+
- "1433:1433"
34+
````
35+
36+
The tabulation is essential and should be preserved. Here is the final content of the `docker-compose.yml` file:
37+
38+
````yaml
39+
services:
40+
41+
storage:
42+
image: "mcr.microsoft.com/mssql/server:2019-latest"
43+
restart: always
44+
ports:
45+
- "1433:1433"
46+
environment:
47+
- SA_PASSWORD=place_your_sa_password_here
48+
- ACCEPT_EULA=Y
49+
volumes:
50+
- mssql-storage:/var/opt/mssql
51+
52+
volumes:
53+
mssql-storage:
54+
````
55+
56+
57+
Save the modified file.
58+
59+
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.
60+
1. Open `MSSQL Management Studio` and _Login_ with the following parameters:
61+
62+
* _Server_ : `localhost`
63+
* _User_ : `sa`
64+
* _Password_: `place_your_sa_password_here` (this is the argument _SA_PASSWORD_ from the above script file. You may change it as required.)
65+
66+
1. Add the database named `reportserver`. After successfully creating the database, you may close the management studio.
67+
1. Stop the current process in _Powershell_, for example, with the key combination `Ctrl+C`.
68+
1. Go back to the text editor with the opened file `docker-compose.yml` and restore its original content:
69+
70+
````yaml
71+
services:
72+
73+
# template configuration of Report Server.
74+
# Includes sample config for /app/Data File Storage.
75+
telerik-report-server:
76+
env_file:
77+
- mssql_storage.env
78+
image: telerik-report-server:local
79+
restart: always
80+
ports:
81+
- "82:80"
82+
depends_on:
83+
- storage
84+
85+
# template configuration of Report Server Agent.
86+
# Includes sample config for /app/Data File Storage.
87+
telerik-report-server-agent:
88+
environment:
89+
- Agent__Name=FirstAgent,
90+
- Agent__Address=http://telerik-report-server-agent:80
91+
env_file:
92+
- mssql_storage.env
93+
image: telerik-report-server-agent:local
94+
restart: always
95+
depends_on:
96+
- storage
97+
98+
storage:
99+
image: "mcr.microsoft.com/mssql/server:2019-latest"
100+
restart: always
101+
environment:
102+
- SA_PASSWORD=place_your_sa_password_here
103+
- ACCEPT_EULA=Y
104+
volumes:
105+
- mssql-storage:/var/opt/mssql
106+
107+
volumes:
108+
mssql-storage:
109+
````
110+
111+
112+
Save the file.
113+
114+
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.
115+
1. Navigate to `localhost:82` in the browser to open the Report Server Manager for .NET.
116+
117+
The first time you open the Report Server you need to configure it as explained in the article [Application Startup]({%slug application-startup%}).
118+
119+
## Additional Resources
120+
121+
You may download and watch the whole process from our `reporting-samples` GitHub repository: [SetupRS.NET-Docker.zip](https://github.com/telerik/reporting-samples/blob/master/VideosRS/SetupRS.NET-Docker.zip).
122+
123+
## Notes
124+
125+
The above approach for starting the RS.NET from the container will stop it *each* time you restart the machine. To avoid this, execute the following commands in _Powershell_ from the folder _.\ReportServer\docker-configs\_ to start/stop the Report Server instead of using the commands `docker-compose up` and `docker-compose down`:
126+
127+
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:`docker swarm init`
128+
1. Start the RS.NET with `.\start-docker-server.bat`
129+
1. (_optional_) Stop the RS.NET with `.\stop-docker-server.bat`
130+
131+
## See Also
132+
133+
* [Telerik Report Server Introduction]({%slug introduction%})
134+
* [Report Server for .NET Introduction]({%slug coming-soon%})
135+
* [Report Server for .NET: Installation on Docker Container]({%slug dotnet-installation-on-docker-container%})
136+
* [SetupRS.NET-Docker.mp4](https://github.com/telerik/reporting-samples/blob/master/VideosRS/SetupRS.NET-Docker.mp4)

0 commit comments

Comments
 (0)