1. Prerequisites

a. .NET Hosting Bundle.

Download and install the runtime-aspnetcore-8.0.3-windows-hosting-bundle-installer version from https://dotnet.microsoft.com

b. PostgreSQL (Version 16 is recommended).

Download and install from https://www.enterprisedb.com/downloads/postgres-postgresql-downloads

c. Install AMD Device Management Portal on a fresh Windows machine.

2. Configuration PostgreSQL

a. Add environment variable path for PostgreSQL

i.  Go to Environment Variables.

ii. GO to System Variables, select PostgreSQL PATH and edit the path with "C:\Program Files\PostgreSQL\16\bin" (16 is installed version)

    If the PATH does not exist, click New > Add.

b. Update pg_hba.conf file (path: C:\Program Files\PostgreSQL\16\data\pg_hba.conf).

# IPv4 local connections:

host all all 127.0.0.1/32 scram-sha-256

# IPv6 local connections:

host all all ::1/128 scram-sha-256

In the above lines, change scram-sha-256 to trust and save,run the below command from the command line.

psql -U postgres -c "ALTER USER postgres WITH PASSWORD 'postgrespassword';"

3. Installation

AMD Device Management Portal{version}.exe package contains the following software:

a. NGINX

b. AMA

c. KVM Viewer

To install AMD Device Management Portal, double click the AMD Device Management Portal{version}.exe

Application version: 1.0

4. Configure nginx

a. Edit C:\Program Files\nginx\conf\amd-manageability.conf and update server_name _ to the hostname of the installed machine.

b. Add the following lines in the nginx.conf inside the HTTP tag and ensure that the amd-manageability.conf path is properly mapped.

Command is: include "C:/Program Files/nginx/conf/amd-manageability.conf";

c. Add the maximum file upload size and hide the server version nginx.conf inside the HTTP tag (path:C:/Program Files/nginx/conf/nginx.conf)

client_max_body_size 15028M;

server_tokens off;

proxy_read_timeout 900;

proxy_connect_timeout 900;

proxy_send_timeout 900;

d. To configure HTTPS:

i.   Create a folder named ssl in C:\Program Files\nginx\.

ii.  Copy the certificates (admpcrt.crt,admpkey.key) to C:\Program Files\nginx\ssl\.

iii. Self-signed certificates can be generated using AMD Provisioning Console (APC) 4.0 or later versions.

iv.  Update the following lines inside the server tag in 'amd-manageability.conf'.

ssl_certificate     "C:/Program Files/nginx/ssl/admpcert.crt";

ssl_certificate_key "C:/Program Files/nginx/ssl/admpkey.key";

Note: nginx path may vary based on the installation.

v.   Run nginx.exe in Administrator mode to start the nginx server.(path: C:\Program Files\nginx\).

For more configuration options, refer to nginx's official documentation: https://nginx.org/en/docs/http/configuring_https_servers.html

5. Navigate to https://<hostname> in your browser and complete the database configuration.

6. To use the KVM feature, download the KVM handler from the KVM window in ADMP and install the KVM_Viewer.exe.

a. Create a certs folder in C:\Program Files\AMD\KVM Viewer.

b. Copy KVMSSHKey to the folder: C:\Program Files\AMD\KVM Viewer\certs.

Additional information:

Generating Self-Signed Certificates Using APC 4.0 or later versions

a. Go to Configuration and enter required details.

b. On the Management Console tab, Click 'Generate Certificates'.