Abhinavxox/AnalySim

Analysim

Analysim is a free online web platform enabling researchers to analyze and share data by providing interactive visualizations, and collaborate with others. The open platform is specialized for working with high-dimensional data sets such as those constructed via computational modeling. Analysim also allows you to run custom analysis on any type of data.

Installation

Clone the Analysim Repository from GitHub so that you have the project locally.

git clone https://github.com/soft-eng-practicum/AnalySim.git

Required software for development

• Visual Studio or ASP.Net 6.0 command-line interface (CLI) (Required)
• Visual Studio Code or other editor
• Postman for testing API calls
• Docker for testing deployment
• Azure Data Studio or use online Azure Portal for browsing Azure Blob Storage

Installing Angular package dependencies

After you have cloned the Analysim repository on your local machine, use the terminal to navigate to the AnalySim\src\Analysim.Web\ClientApp folder and run the following command.

npm install

Running the project

You will need to get the appsettings.json file(s) from the project admins in order to connect to the database. Put these files under the src/Analysim.Web folder.

Step 1:

In Visual Studio Code (or other editor), open up the Analysim project folder. Using a terminal, navigate to src\Analysim.Web\ClientApp and run the following command (also works from Command Line):

ng serve -o

Step 2:

Next, in Visual Studio, open up the AnalySim.sln file. Click on the run to start the project. Once you have completed both steps, your project should be up and running!

Alternatively, without Visual Studio, you use .Net CLI from command line by first navigating into the src\Analysim.Web folder:

dotnet run

Deploying

The overall process of deployment is explained in the tutorial video on deploying ASP.Net on Heroku using Docker.

Prerequisites

1. Download Docker Desktop
2. Download Heroku CLI
3. Enable Docker Support

Publish .Net project and create Docker image

Note: Prepend sudo before each docker and heroku (except dotnet) command on Mac/Linux.

4. Publish Analysim.Web to the local folder (keep default location for folder), which can also be done on the command line:

   dotnet publish --configuration Release

5. Create the Docker image by running the following in the base project folder (e.g. Analysim/) :

   docker build -t analysim-dev -f deploy/Dockerfile .

6. Test image locally, by running it:

   docker run -it -p 127.0.0.1:80:80/tcp analysim-dev

   You can test by opening a browser to http://localhost:80 (not https).

Register and upload Docker image to Heroku

Note: Prepend sudo before each docker and heroku (except dotnet) command on Mac/Linux.

Run the following commands in terminal to update Heroku deployment (more info):

1. Login to Heroku and container service (if using sudo, you may need to copy-paste into browser):

   heroku login
   heroku container:login

2. Tag the image name on Heroku's container registry:

   docker tag analysim-dev registry.heroku.com/analysim-dev
   docker push registry.heroku.com/analysim-dev

3. Change to the deploy/ folder and re-build image using Heroku CLI:

   cd deploy
   heroku container:push web -a analysim-dev --context-path=..
   heroku container:release web -a analysim-dev