Quick Start
This document will guide you to get started with
OpenCatapult.The easiest way to get started and use
OpenCatapult is by utilizing the released package. At the moment it is only available for Windows x64 platform. We have been planning to release the package for other platforms (Linux or Mac) as well in the future.If you want to try
OpenCatapult in the platforms other than Windows now, you could always build it yourself from the source code which you can get from our GitHub repository. This guide might be useful if you want to do it.Prerequisites
The main
OpenCatapult components require .NET Core 2.2 runtime installed on your machine. However, in this tutorial you will also need .NET Core 2.2 SDK because you will generate an ASP.NET Core MVC application later by using some .NET CLI commands.If you don't have the SDK, please get the installer from the .NET download page. Please note that installing SDK will also include the runtime, so you don't have to install them twice.
After installing .NET Core, please make sure it is correctly installed on your machine by typing this command in a Command Prompt:
1
dotnet --info
Copied!
If you get something like the screenshot below, it means you are good to go.
dotnet info
Get the installer package
Please go to OpenCatapult release website and download the installer package which is available in the
All Components box.
Installer package
Install the package
After downloading the installer package, just double click it and follow the following instructions: 1) If the "Windows Defender Smartscreen" window pops up, just click "More Info" and "Run Anyway" buttons
​
​
2) When the "User Access Control" window pops up, clik "Yes" button
UAC
3) Select where OpenCatapult components should be installed, then click "Next" button
Destination
4) Give the Start Menu folder a name, then click "Next" button
Start Menu
5) Select the "Create a desktop shortcut" checkbox, then click "Next" button
Shortcut
6) Review the installation summary, then click "Install" button
Summary
7) Wait until the installation complete, then click "Finish" button
Finish
Run the components
Please follow these steps to run the
OpenCatapult components:1) If the
OpenCatapult Manager window has been opened, please close it first. Then find the shortcut either in Desktop or Start Menu, right click it, and select "Run as administrator". Click "Yes" on the confirmation.​
​
2) Let's start the API component first by clicking "Start" button in the
OpenCatapult Manager
Start API
Notice that a command prompt is opened. Please wait until the running script is completed. If you see the following status, it means the API has been successfully started on https://localhost:44305​
API is running
3) Let's get back to the
OpenCatapult Manager again. Click on the Web's Start button to start the Web component
Start Web
Notice that another command prompt is opened. Please wait until the running script is completed. If you see the following status, it means the Web component has been successfully started on https://localhost:44300​
Run Web
4) You can now open a browser, and go to
https://localhost:44300 to open the OpenCatapult Web UI
Browse Web
5) In the login page, enter "
[email protected]" as the UserName, and "opencatapult" as the Password. If you are able to login, it means the components have been setup correctly.
Welcome
Next steps
As you have the
OpenCatapult setup on your machine, you can start to explore more about it.Last modified 2yr ago