{"type":"doc","content":[{"type":"paragraph","content":[{"text":"If you need to control access to your simulator or store measurements for metrics during sessions, you must set up a database to house session and user data. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Vortex Studio only supports the MongoDB database. Mongo DB is not part of Vortex Studio. You must install it separately. You can download Mongo DB Community Edition 4.2 from ","type":"text"},{"text":"www.mongodb.org.","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.mongodb.org."}}]},{"text":" Follow the instructions to install the database. Vortex Studio relies on the hostname of and port of the database you configure. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Setting up the database where the simulator will store data involves the following activities:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Selecting a computer to install the database on.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Downloading and installing Mongo DB.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Configuring the connection between the simulator and the database.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Selecting a Computer","type":"text"}]},{"type":"paragraph","content":[{"text":"The computer you select to host the database must be accessible from all other nodes in the simulator.","type":"text"}]},{"type":"paragraph","content":[{"text":"Each node must be able to connect to the host name and port of the database.","type":"text"}]},{"type":"paragraph","content":[{"text":"There must be only one database.","type":"text"}]},{"type":"paragraph","content":[{"text":"Important:","type":"text","marks":[{"type":"strong"}]},{"text":" Do not install the database on the same node as the Engine.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Installing MongoDB","type":"text"}]},{"type":"paragraph","content":[{"text":"MongoDB is not part of Vortex Studio. You must download and install it separately. MongoDB Community Edition is free and can be used with Vortex Studio. MongoDB Community edition 4.2 was validated at CM-Labs for use with Vortex Studio.","type":"text"}]},{"type":"paragraph","content":[{"text":"To download and install the database, go to ","type":"text"},{"text":"www.mongodb.com","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.mongodb.com/"}}]},{"text":" and follow the instructions to install the database. Vortex Studio will need the hostname and the port of the database.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Connecting the Simulator to Database","type":"text"}]},{"type":"paragraph","content":[{"text":"Before the simulator can connect to the database, you must add the MongoDB Module to your setup file and specify the hostname and port:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Editor application, create or open setup file for the Console interface.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"At the root level, add the ","type":"text"},{"text":"Mongo Database","type":"text","marks":[{"type":"strong"}]},{"text":" module. To function properly, the Mongo Database module must be present on all nodes.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Under ","type":"text"},{"text":"Properties","type":"text","marks":[{"type":"strong"}]},{"text":", specify the following parameters:","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"

Parameter	Description
Database Host	Host name or IP address of the computer hosting the database. Each node must read/write in the same database. Only use localhost or 127.0.0.1 if your simulator runs on a single computer.
Database Port	The port of the database at the Database Host. By default, MongoDB runs at port 27017
Database Name	The name of the database

","block-inline":true,"nestedContent":{"type":"doc","content":[{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Database Host","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Host name or IP address of the computer hosting the database. Each node must read/write in the same database. Only use localhost or 127.0.0.1 if your simulator runs on a single computer.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Database Port","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"The port of the database at the Database Host. By default, MongoDB runs at port 27017","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Database Name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"The name of the database","type":"text"}]}]}]}]}],"version":1},"reason":"A table in list item can't be created or edited in the new editor."}}}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1280,"id":"d8630430-2567-476b-ba68-918f371ecc04","collection":"contentId-3985981508","type":"file","height":543}}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Verifying that MongoDB is Running","type":"text"}]},{"type":"paragraph","content":[{"text":"To verify that the database is running during the simulation, do the following:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"During the simulation, in the Editor, under the ","type":"text"},{"text":"Properties","type":"text","marks":[{"type":"strong"}]},{"text":" for the Mongo Database module, verify that the output ","type":"text"},{"text":"Database is running","type":"text","marks":[{"type":"strong"}]},{"text":" is set to true.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(optional) To know the version of the database, check the value for the output ","type":"text"},{"text":"Database version","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Next Steps","type":"text"}]},{"type":"paragraph","content":[{"text":"With the database connected, you can add features and pages for managing users and reporting on metrics the system stores. See ","type":"text"},{"text":"Console Extension, Module, and Page Reference","type":"text","marks":[{"type":"link","attrs":{"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985975458"}}]}]}],"version":1}

Browser not supported