Projekt

Obecné

Profil

Server Installation and Service » Historie » Revize 10

Revize 9 (Eliška Mourycová, 2021-05-28 07:50) → Revize 10/36 (Eliška Mourycová, 2021-05-28 07:57)

h1. Server Installation (WIP) 

 The server runs on Debian 10 VM at https://nuada.zcu.cz/ 
 The ip of the machine is 147.228.173.54 

 h2. Hardware requirements 

 TBD, however the default settings for creating the VM seem to suffice 

 h2. Software requirements 


 h2. "Deploying" the Server Application 

 h3. Uploading the project to the remote machine 

 Upload the whole folder built with the commands below: 

 <pre> 
 $ scp -r /pathToFolder/publish root@{machine_ip}:/<path>/ 
 </pre> 

 You can also upload the default configuration file: 

 <pre> 
 $ scp /path/server_config root@{machine_ip}:/<path>/ 
 </pre> 

 h3. Building the project 

 At the moment, the easiest way to build the project is to build it locally in Windows with the following commands: 
 open windows command line (cmd.exe) in the directory where the solution file is located. Please make sure you can run `dotnet` command from the cmd. Make sure you have the right SDK on your system: 
 <pre><code class="text"> 
 $ dotnet --list-sdks 
 </code></pre> 
 Version 5.0 is needed to build the project. If you have this version, you can build the project: 
 <pre><code class="text"> 
 $ dotnet publish --runtime=linux-x64 ServerApp.sln 
 </code></pre> 
 The built project files are in folder: 
 .\ServerApp\bin\Debug\net5.0\linux-x64\publish 


 h3. Generating and using a certificate for a specific port (DEPRECATED?) 

 h3. Note 

 The project could probably be built on-site as well, but that would require .NET SDK to be installed and require larger disc space. 

 h3. Running the server 

 * A folder named *data* must exist in the directory where the app is launched 
 * A .p12 file named *cert.p12* must exist in the directory where the app is launched 
 ** We used this one: attachment:cert.p12 $$cert.12$$ 

 Firstly you most grant permission to run the executable: 

 <pre> 
 $ chmod +x <path>/ServerApp 
 </pre> 

 Then you can run the server: 

 <pre> 
 $ <path>/ServerApp <args> 
 </pre>