1.1 Deployment: Local Installation - SAP/application-support-center GitHub Wiki

Overview

You can run ASC locally for development or to test out its functionality. You could also use this setup to run a production instance of ASC. Keep in mind that there is no user or role provisioning, or database backups considered with this deployment method (as Cloud Foundry handles these).

Requirements

The Server/API uses Node.js/Express and uses Postgres for persistence

Step 1: Install prerequisites

Install Node.js and Postgres, create and take note of the Postgres user account.

Step 2: Clone repo

Clone or download this core repo and run npm install in the server folder to download the relevant dependencies.

Step 3: DB Schema Setup

Setup a new schema in your Postgres database called asc, and execute the creation script in resources\asc.sql to create the DB objects, you can do this via the psql command line tools or using a visual tool such as Datagrip.

Step 4: Environment File Setup

Rename the .env_template file to .env in the \server folder. This file needs to have the required environment variables (such as the Postgres hostname, username and password) defined.

Step 5: Run ASC

cd server

npm run dev

The following output should be shown:

App Info

- Environment:             dev
- API Endpoint:            http://localhost:5001/api/v1
- API Documentation:       http://localhost:5001/api/v1/docs # Swagger API Documentation

- Landing UI:              http://localhost:5001/
- Admin UI:                http://localhost:5001/admin
- Portal UI:               http://localhost:5001/portal
- Integration tests:       http://localhost:5001/admin/test/integration/opaTests.qunit.html # Run Frontend Integration Tests

User

As mentioned, with this deployment method the application runs using a single Admin user which can be configured in server/auth.js and be queried using /api/v1/users/me

⚠️ **GitHub.com Fallback** ⚠️