Quick Start Guide

1. Login

Important

Please read these instructions carefully to create (or use your existing) MUSES account properly.

First, log in to our community forum using this link. This is where you will engage with the MUSES community and seek help when you have questions. The forum login button will take you to a CILogon screen where you can choose which identity provider (IdP) to use for authentication. Once you have chosen your IdP you must always use the same one when logging in to MUSES web services.

If you are already logged in and cannot recall which IdP you originally used, look at your username and email address in your Account preferences; if you log out and back in, you should see the same username and email address.

Once you are logged into the forum and are satisfied with your selected IdP, open the Calculation Engine (CE) in the same web browser. When you click the login button, you should be redirected to the CE home page as an authenticated user. You should see your name in the top-right of the screen, on the navigation bar.

Click here to learn more about MUSES accounts.

2. Request Access

If you see the red “Request Access” button in the navigation bar, it means you do not yet have permission to use the CE. Click it to request access and follow the instructions. When one of our staff approves your request, you will receive a confirmation email. Note that this may take hours or days depending on staff availability. If you are concerned about your request and wish to contact someone, please create a post on our support forum.

3. Fetch an API token

After approval, log out and back in to the CE. You should now see a green “API token” button. Press it to reveal your API access token. You’ll use this token to authenticate your requests when using the CE API.

This token is only for you to use and must be kept secret. To invalidate a token and generate a fresh one, log out and back in.

4. Follow the tutorial

Now you are able to use the Calculation Engine and run workflows. We recommend that you follow the MUSES tutorial to learn the basics of building and launching jobs, uploading files and retrieving data.