> For the complete documentation index, see [llms.txt](https://rocketry.gitbook.io/public/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rocketry.gitbook.io/public/tutorials/administrative/azure-server.md). # Azure Server Connecting to the CalSTAR server for maintenance {% hint style="danger" %} Be very careful when making server changes. Changing certain items such as processor count, RAM size, disk size, and backup services will incur additional charges. **Do NOT change our subscriptions, services, plan, or anything relating to billing without discussing with all leads. You will be responsible for any changes in payment.** {% endhint %} ## Our Server CalSTAR pays for a cloud server from Microsoft Azure. It is a very weak virtual machine (VM), meant only for low intensive tasks like licensing, product data management (CAD version tracking), and simple scripts (Discord/Slack bots). ### Details The server is currently on the **Basic A1 (1 vcpus, 1.75 GB memory)** plan with **127GB** of disk space. As of the time of writing, this is CalSTAR's only server (with the exception of a Berkeley OCF web server hosting our website). This means the server is the one you probably have connected to in the past for Solidworks Workgroup PDM and Converge CFD Licensing. ## Getting basic information about the server If you simply want to look at resource status (CPU Usage, RAM, Network Activity, etc), some of this information is available on the [Azure portal](https://portal.azure.com/). {% hint style="info" %} Login information should have been provided to you upon becoming a lead/admin. If you are not a lead/admin please contact one if you believe something is wrong with the server. {% endhint %} ![Main Page after Login](https://2333413738-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LB423_rlWTQK_KuQzK5%2F-LFtoreWZGsq_AjAKExr%2F-LFtpa03fKMMjuZwoffM%2Fazure%20main%20screen.PNG?alt=media\&token=522efa6e-5954-495a-b325-b75249a8768b) Selecting the option in the left white box **pdm2 - Virtual machine** will open the dashboard for our server (exact location may differ, ensure you select the **pdm2 - Virtual machine** option). ![Selection to open main dashboard](https://2333413738-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LB423_rlWTQK_KuQzK5%2F-LFtqPgDWSv40W-slk1M%2F-LFtqXmGZHYLGqJnI59f%2Fazure%20main%20screen%20dashboard%20selection.PNG?alt=media\&token=9b6e0878-d96b-460f-b939-bfbf3a4259b4) ![Main dashboard with resource overview](https://2333413738-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LB423_rlWTQK_KuQzK5%2F-LFtr0WjY6x5CpVjXuvD%2F-LFtr4VC9xBy4DZaALwu%2Fazure%20main%20dashboard.PNG?alt=media\&token=3defeb59-a2e8-4eca-93f1-1c4b146c1837) The dashboard contains most information you will need, including CPU usage, RAM usage, Network usage, Disk usage, Public IP, and links for more actions. ## Advanced maintenance ### Direct Access to Server VM If you need to do more than view resource status, and need to mess with specific features within the server VM, you will need to connect to the server's Virtual Private Network (VPN) and open a Remote Desktop Protocol (RDP) connection to the server. The following steps will cover how to do both. {% hint style="info" %} Previously, the server was accessible through a Remote Desktop Connection to a public IP address and port number. This has been intentionally disabled for increased network security. You must now first connect to the VPN and RDP with \:3389. {% endhint %} ### Connecting to the Network Basically connect to the server's Virtual Private Network (VPN) like you would for the Solidworks Workgroup PDM or other software licensing (Converge CFD). If you have not done so before, or are not sure what that means, [follow this guide.](/public/tutorials/software/deprecated-software/connecting-to-calstars-server.md) ### Remote Desktop Protocol connection [For all systems, download the Remote Desktop Protocol file 'pdm2.rdp' here.](https://drive.google.com/file/d/10KLC-vHKfhdoEB0wp0WwWxkzDUkJIK3P/view?usp=sharing) {% hint style="info" %} The RDP file can only be downloaded when signed into Google Drive with a berkeley.edu account. {% endhint %} #### Windows Simply run the 'pdm2.rdp' file downloaded previously. It should automatically launch Remote Desktop Connection (RDC, a Windows Program that implements RDP) and prompt you for credentials. If Remote Desktop Connection does not launch on its own, open it by searching the Start Menu or by pressing \[⊞ Win + R] and entering ``` mstsc.exe ``` Click **Show Options** and click **Open** in **Connection Settings**. Locate and open the downloaded 'pdm2.rdp' file. You will be prompted to login if done correctly. #### Linux, Mac, and older/nonstandard Windows Computers without RDC (Linux, Mac, unusual Windows installations) will need to find a program that implements RDP. A decent alternative is [FreeRDP](http://www.freerdp.com/), however, some knowledge of the terminal/command prompt is necessary to initiate a connection. [Documentation for FreeRDP can be found here](https://github.com/awakecoding/FreeRDP-Manuals/blob/master/User/FreeRDP-User-Manual.markdown). {% hint style="info" %} While functional, a FreeRDP connection is slower than a standard RDC connection. If at all possible, it is highly recommended to connect to the server from a standard Windows installation. {% endhint %} {% hint style="warning" %} The following information for FreeRDP on Linux and Mac is untested. Please troubleshoot yourselves or contact the current/previous server admin for more information. Please update this wiki if or when you figure out how to properly use FreeRDP. {% endhint %} *For Linux and Mac*, install FreeRDP using your preferred package manager. Use the command below to connect to the server. ``` xfreerdp [path to 'pdm2.rdp'] ``` So as an example: ``` xfreerdp ~/Downloads/pdm2.rdp ``` You will be prompted to login if done correctly. {% hint style="warning" %} The following instructions for Windows may be difficult without basic knowledge of the Command Prompt, specifically how`cd`and `dir`work. More information can be found here \[[wikipedia](https://en.wikipedia.org/wiki/Cd_\(command\)#DOS_and_Windows)]. {% endhint %} *For Windows*, download the program, and unzip the files to a new folder. Copy the downloaded 'pdm2.rdp' file into the new folder. Open the Command Prompt by searching the Start Menu or by pressing \[⊞ Win + R] and entering ``` cmd ``` Using the Command Prompt, navigate to the new folder and run the following command: ``` wfreerdp.exe pdm2.rdp ``` You will be prompted to login if done correctly. ## Troubleshooting ### CredSSP encryption oracle remediation Basically either the computer, the server, or both have outdated security programs. Updating the server and/or your computer will usually fix this issue. If not, follow the steps in **Resolution** [on this website](https://support.microsoft.com/en-us/help/4295591/credssp-encryption-oracle-remediation-error-when-to-rdp-to-azure-vm). {% hint style="danger" %} Avoid using the Workaround in the link above. {% endhint %}