{"id":18265142,"url":"https://github.com/nasa-ammos/openmct-mcws","last_synced_at":"2025-12-11T20:04:46.124Z","repository":{"id":94648144,"uuid":"359630278","full_name":"NASA-AMMOS/openmct-mcws","owner":"NASA-AMMOS","description":"Open Mission Control Technologies (Open MCT) for Mission Control Web Services (MCWS)","archived":false,"fork":false,"pushed_at":"2025-03-31T23:42:27.000Z","size":55038,"stargazers_count":9,"open_issues_count":92,"forks_count":7,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-04-01T00:27:52.403Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NASA-AMMOS.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-19T23:56:03.000Z","updated_at":"2025-02-25T23:46:31.000Z","dependencies_parsed_at":"2024-06-12T02:59:53.033Z","dependency_job_id":"817f2a73-225c-42dd-a3fb-3e78e5f96350","html_url":"https://github.com/NASA-AMMOS/openmct-mcws","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NASA-AMMOS%2Fopenmct-mcws","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NASA-AMMOS%2Fopenmct-mcws/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NASA-AMMOS%2Fopenmct-mcws/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NASA-AMMOS%2Fopenmct-mcws/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NASA-AMMOS","download_url":"https://codeload.github.com/NASA-AMMOS/openmct-mcws/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247252195,"owners_count":20908642,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-05T11:17:13.896Z","updated_at":"2025-12-11T20:04:46.084Z","avatar_url":"https://github.com/NASA-AMMOS.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Open MCT for MCWS\nOpen Mission Control Technologies for Mission Control Web Services (Open MCT for MCWS) is a next-generation web-based mission control framework for visualization of data on desktop and mobile devices. Open MCT for MCWS is built on the [Open MCT Framework](https://github.com/nasa/openmct), and includes adapter code for using MCWS as a telemetry and persistence provider. Open MCT is developed at NASA Ames Research Center in Silicon Valley, in collaboration with NASA AMMOS and the Jet Propulsion Laboratory, California Institute of Technology (under its contract with NASA, 80NM0018D0004).\n\n## Configuration\nVarious configurations and customizations are available by editing `config.js`. Descriptions of each configuration reside with the configuration in the file.\n\n### AMMOS configurations\n1. `camUrl`: The url to the CAM server, if CAM is to be used for authentication.\n2. `mcwsUrl`: The url to the MCWS server.\n3. In the `namespaces` configuration, `url`, the path to the MCWS persistence spaces, are required.\n\n## Development\n\n### 1. Install Open MCT for MCWS\nIn a terminal, run this command to install Open MCT for MCWS and its dependencies. This may take a few minutes.\n\n    npm install\n\nIf you've installed Open MCT for MCWS locally before, first run this command.\n\n    npm run clean\n\n### 2. Modify config.js\nUncomment the `proxyUrl` setting in `config.js`. It is located under Developer \nSettings near the end of the file.\n\n### 3. Run Open MCT for MCWS locally\n\n    npm start\n\nWith that running, browse to http://localhost:8080/ to access Open MCT for MCWS.\n\n### 4. Rebuilding SASS stylesheets\n\n    npm run build:prod\n\nWith the stylesheets rebuilt, you can reload your browser (assuming the server is running) to see the rebuilt CSS.\n\n## Development MCWS server\nTo connect Open MCT for MCWS to MCWS, either run a local mock server, run MCWS locally, or connect to a remote instance of MCWS.\n\n## Running a mock MCWS server\nAn example mock mcws server - https://github.com/davetsay/mcws-test-server\n*requires request access\n\n## Running MCWS locally\nRefer to MCWS documentation.\n\n## Running a development server\nRunning a development server requires that you are on the JPL network so that\nyou can access a development MCWS server. You'll need to retrieve an authentication cookie \nand make a small modification to your Open MCT for MCWS configuration; here's how.\n### 1. Get your CAM cookie\nTo get past CAM, you will need to export an environment variable, \n`COOKIE`, that contains your CAM authentication cookie. Instructions for \nretrieving this cookie are at the bottom of the README. If you've copied\nyour CAM cookie into the clipboard, use this command to set the variable:\n\n    export COOKIE=`pbpaste`\n\n## Tests\n\nTests are written for [Jasmine 4.4](https://jasmine.github.io/api/npm/4.4/Jasmine)\nand run by [Karma](http://karma-runner.github.io). \n\nTest files end with `Spec.js`, and will be automatically executed when running the following command:\n\n    npm test\n\nRunning the tests creates a code coverage report in `target/coverage`.\n\n## Building for production\n\n    npm install\n    mvn clean install\n\nThis will create a deployable artifact, `openmct_client.war` in the `target` \ndirectory.\n\n## Notes\n\n### Getting your CAM cookie\n\nGo to the MCWS server location and log in to CAM.  Then retrieve \nthe cookie from your browser.\n\nUnsure how to get cookies from the browser? Here's a shortcut: create a \nbookmarklet with the following code:\n\n    javascript:(function () {prompt('Your cookies for ' + location.host, document.cookie);})();\n\nPressing this bookmarklet will show you your cookies for the current host, \nwhich you can then copy into your clipboard to use to set the cookie environment \nvariable. Note that logging out of CAM or getting a new session will require you\nto get the cookie again.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnasa-ammos%2Fopenmct-mcws","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnasa-ammos%2Fopenmct-mcws","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnasa-ammos%2Fopenmct-mcws/lists"}