{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"never","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"Setting Up Tests","type":"basic","slug":"setting-up-tests","excerpt":"","body":"Test setup in Spatineo Performance is done in two phases: At first, a test assistant dialog guides you through the basic test setup selections. Then you can fine-tune the test parameters and add new meters according to your wishes.\n\n## Test Setup Assistant\n\nThe Test assistant dialog opens up automatically when entering Spatineo Performance. The assistant will guide you through setting up a new test using one of the three pre-defined test profiles (see Table 1). If the service you’re about to test is not yet claimed by your organisation, you are give instructions on how to do that by the assistant. When the assistant is done, you have a complete setup ready for running typical performance test. If you wish you can also change any of the test parameters created for you by the assistant, add or remove meters to be tested, or change the test length and ramp-up time. Any changes you make are saved automatically. If you want to open a previously created test instead, press cancel button and select the test using the “Existing tests..” button.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/L7OPJ29SCq7uvClyFE7w_perf-profiles.png\",\n        \"perf-profiles.png\",\n        \"900\",\n        \"778\",\n        \"#994714\",\n        \"\"\n      ],\n      \"caption\": \"Table 1: Pre-defined test profiles for WMS, WMTS and WFS services\"\n    }\n  ]\n}\n[/block]\n## If the Service Cannot Be Found\n\nIn case you cannot find the service you want to test using the search provided by the Test setup assistant, it’s a good idea to check that the service is registered in our service catalog. It may happen that we do not yet know about a service that is new or not added to well known catalog services and portals.\n\nIt’s simple to check if a service is known to us: just copy-paste the complete URL address of the get capabilities request for the given service to the search field of Spatineo Directory available at http://directory.spatineo.com/ and hit Enter. We’ll start analysing the URL right away and add in to our catalog if we did not know about it before. Note that this simple method only works for services not requiring user authentication. If your service is password protected or requires some other user authentication please contact our support to set the access settings.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/rzwBOpWFQyiHr7o8BvC2_perf-directory.png\",\n        \"perf-directory.png\",\n        \"1040\",\n        \"807\",\n        \"#ec2b08\",\n        \"\"\n      ],\n      \"caption\": \"Use Spatineo Directory to check if a service is known to us, and thus\\nselectable for testing. You can check this for any service publicly available in the Internet\\nby copy-pasting the URL address of the service endpoint in the search box.\"\n    }\n  ]\n}\n[/block]\n## Selecting Meters For the Test\n\nA meter is a specific way of calling a service: It contains the service identification and the operation to execute as well as all the parameters fixed parameters, like the layer or feature type, image size and type and map projection to use. Spatineo Performance automatically varies the bounding box (area) of the request during the tests in order to make the test more realistic.\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"Web Map Service\",\n    \"h-0\": \"Service type\",\n    \"h-1\": \"Types of meter supported\",\n    \"1-0\": \"Web Map Tile Service\",\n    \"2-0\": \"Web Feature Service\",\n    \"3-0\": \"ArcGIS MapServer\",\n    \"3-1\": \"export\\nservice description retrieval\",\n    \"0-1\": \"GetMap\\nGetCapabilities\",\n    \"1-1\": \"GetTile\\nGetCapabilities\",\n    \"2-1\": \"GetFeature\\nDescribeFeatureType\\nGetCapabilities\"\n  },\n  \"cols\": 2,\n  \"rows\": 4\n}\n[/block]\nFor each test you can add as many meters as you like for one or more services that you have claimed ownership for. You can define the maximum request rate separately for each meter. This enables you create complex test scenarios like testing both WMS and WFS interfaces of the same server at the same time or generating predefined loads for services sharing same backend resources or network bandwidth limits. Note however that adding too many meters for the same test can make it more difficult for you to analyse the test results. The total request rate for all the meters in one test is also limited to 1000 requests/s by default. Please contact our support if you want to run tests with higher request rates.\n\nSome layers or features are typically more demanding for a service to produce than others, thus it’s often a good idea to create tests for different types of offered data. Sometimes using certain map projections can also be more demanding to the server products than others because of the necessary on-the-fly re-projection calculations.\n\n## Advanced meters\n\nBy default, meters accessing data on the service (for example GetMap for WMS services) will request data within the bounds declared in the service description. However, sometimes you might require a test where a meter focuses on a smaller area, or an altogether different area. This can be achieved by opening \"Additional options\" in the performance meter and setting a bounding box.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/T0dsOIHXRCSIHiINsjfr_performance-meter-additional-options.png\",\n        \"performance-meter-additional-options.png\",\n        \"890\",\n        \"196\",\n        \"#a55c36\",\n        \"\"\n      ],\n      \"caption\": \"Limiting a performance meter to a particular bounding box\"\n    }\n  ]\n}\n[/block]\nYou can consult the table below to see how the bounding box values are translated into requests for each request type.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Service and request type\",\n    \"h-1\": \"Coordinate order\",\n    \"0-0\": \"**WMS/GetMap**\\n**WFS/GetFeature**\\n**MapServer/export**\",\n    \"1-0\": \"**WMTS/GetTile**\",\n    \"2-0\": \"**MapServer/tile**\",\n    \"0-1\": \"Regardless of projection axis order, BBOX parameter values will use X values as the first coordinate and Y as the second.\",\n    \"1-1\": \"Given X and Y coordinates are used in the projection axis order (X as first coordinate) to calculate tile indices.\\n\\nAxis flip configuration has no bearing on how GetTile requests are generated.\",\n    \"h-2\": \"Other notes\",\n    \"0-2\": \"X and Y are flipped if the selected projection is configured for \\\"flip axis order\\\"\",\n    \"2-2\": \"If given bounds are outside the tiled area, Spatineo Performance may produce illegal tile requests.\",\n    \"1-2\": \"The meter will target only those matrices and tiles which overlap both the given bounding box and the matrix bounds taking into account any TileMatrixLimits configuration.\\n\\nIf the given bounding box is outside the legal bounds of all tile matrices for this projection, the *test will fail* at the prepare stage.\",\n    \"2-1\": \"Given X and Y coordinates are used in the projection axis order (X is first, Y is second) to calculate tile indices.\\n\\nAxis flip configuration has no bearing on how GetTile requests are generated.\"\n  },\n  \"cols\": 3,\n  \"rows\": 3\n}\n[/block]\n## Running the Same or Similar Test Again\n\nIf you want to re-run a previously ran test or use it’s configuration as a basis for your new test you can use the “Re-run test” button at the Setup tab. It creates a new test with the same settings as in currently selected test. You can give the new test a describing name and modify the test parameters as desired. The original test remains archived in Spatineo Performance so you can return to analyse it at any time.\n\n## Running and Reviewing Previously Created Tests\n\nAll test created by your organisation are stored in the test archive regardless of their completion status. You can design a number of tests in advance and just run then one ofter another during a testing session. Another typical use case would be iterative testing, where you want to start with a basic test settings and modify them in the latter tests to try to expose undesired service behaviour or find the service capacity limits.\n\nYou can select any of the previously created tests by clicking the “Existing tests..” button. The opening dialog lets you choose a test and delete tests that you no longer consider worth keeping. You can change the viewed test at any time, even when the test is running. All the changes you made to the test are continuously and automatically stored.","updates":[],"order":15,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5ccaf606c63d3c013b50f6ad","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Spatineo Performance","slug":"spatineo-performance","order":2,"from_sync":false,"reference":false,"_id":"5ccaf606c63d3c013b50f6a8","version":"5ccaf606c63d3c013b50f6bc","project":"544f6e49698ab40800b4f41e","createdAt":"2014-10-28T12:09:46.911Z","__v":0},"project":"544f6e49698ab40800b4f41e","user":"544f6e19cf9f86080080129a","version":{"version":"3.13","version_clean":"3.13.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5ccaf606c63d3c013b50f6a6","5ccaf606c63d3c013b50f6a7","5ccaf606c63d3c013b50f6a8"],"_id":"5ccaf606c63d3c013b50f6bc","project":"544f6e49698ab40800b4f41e","__v":0,"forked_from":"5a5879a7086a05001c4317ac","createdAt":"2018-01-12T09:02:31.335Z","releaseDate":"2018-01-12T09:02:31.335Z"},"createdAt":"2014-10-28T20:17:42.952Z","githubsync":"","__v":0}
Test setup in Spatineo Performance is done in two phases: At first, a test assistant dialog guides you through the basic test setup selections. Then you can fine-tune the test parameters and add new meters according to your wishes. ## Test Setup Assistant The Test assistant dialog opens up automatically when entering Spatineo Performance. The assistant will guide you through setting up a new test using one of the three pre-defined test profiles (see Table 1). If the service you’re about to test is not yet claimed by your organisation, you are give instructions on how to do that by the assistant. When the assistant is done, you have a complete setup ready for running typical performance test. If you wish you can also change any of the test parameters created for you by the assistant, add or remove meters to be tested, or change the test length and ramp-up time. Any changes you make are saved automatically. If you want to open a previously created test instead, press cancel button and select the test using the “Existing tests..” button. [block:image] { "images": [ { "image": [ "https://files.readme.io/L7OPJ29SCq7uvClyFE7w_perf-profiles.png", "perf-profiles.png", "900", "778", "#994714", "" ], "caption": "Table 1: Pre-defined test profiles for WMS, WMTS and WFS services" } ] } [/block] ## If the Service Cannot Be Found In case you cannot find the service you want to test using the search provided by the Test setup assistant, it’s a good idea to check that the service is registered in our service catalog. It may happen that we do not yet know about a service that is new or not added to well known catalog services and portals. It’s simple to check if a service is known to us: just copy-paste the complete URL address of the get capabilities request for the given service to the search field of Spatineo Directory available at http://directory.spatineo.com/ and hit Enter. We’ll start analysing the URL right away and add in to our catalog if we did not know about it before. Note that this simple method only works for services not requiring user authentication. If your service is password protected or requires some other user authentication please contact our support to set the access settings. [block:image] { "images": [ { "image": [ "https://files.readme.io/rzwBOpWFQyiHr7o8BvC2_perf-directory.png", "perf-directory.png", "1040", "807", "#ec2b08", "" ], "caption": "Use Spatineo Directory to check if a service is known to us, and thus\nselectable for testing. You can check this for any service publicly available in the Internet\nby copy-pasting the URL address of the service endpoint in the search box." } ] } [/block] ## Selecting Meters For the Test A meter is a specific way of calling a service: It contains the service identification and the operation to execute as well as all the parameters fixed parameters, like the layer or feature type, image size and type and map projection to use. Spatineo Performance automatically varies the bounding box (area) of the request during the tests in order to make the test more realistic. [block:parameters] { "data": { "0-0": "Web Map Service", "h-0": "Service type", "h-1": "Types of meter supported", "1-0": "Web Map Tile Service", "2-0": "Web Feature Service", "3-0": "ArcGIS MapServer", "3-1": "export\nservice description retrieval", "0-1": "GetMap\nGetCapabilities", "1-1": "GetTile\nGetCapabilities", "2-1": "GetFeature\nDescribeFeatureType\nGetCapabilities" }, "cols": 2, "rows": 4 } [/block] For each test you can add as many meters as you like for one or more services that you have claimed ownership for. You can define the maximum request rate separately for each meter. This enables you create complex test scenarios like testing both WMS and WFS interfaces of the same server at the same time or generating predefined loads for services sharing same backend resources or network bandwidth limits. Note however that adding too many meters for the same test can make it more difficult for you to analyse the test results. The total request rate for all the meters in one test is also limited to 1000 requests/s by default. Please contact our support if you want to run tests with higher request rates. Some layers or features are typically more demanding for a service to produce than others, thus it’s often a good idea to create tests for different types of offered data. Sometimes using certain map projections can also be more demanding to the server products than others because of the necessary on-the-fly re-projection calculations. ## Advanced meters By default, meters accessing data on the service (for example GetMap for WMS services) will request data within the bounds declared in the service description. However, sometimes you might require a test where a meter focuses on a smaller area, or an altogether different area. This can be achieved by opening "Additional options" in the performance meter and setting a bounding box. [block:image] { "images": [ { "image": [ "https://files.readme.io/T0dsOIHXRCSIHiINsjfr_performance-meter-additional-options.png", "performance-meter-additional-options.png", "890", "196", "#a55c36", "" ], "caption": "Limiting a performance meter to a particular bounding box" } ] } [/block] You can consult the table below to see how the bounding box values are translated into requests for each request type. [block:parameters] { "data": { "h-0": "Service and request type", "h-1": "Coordinate order", "0-0": "**WMS/GetMap**\n**WFS/GetFeature**\n**MapServer/export**", "1-0": "**WMTS/GetTile**", "2-0": "**MapServer/tile**", "0-1": "Regardless of projection axis order, BBOX parameter values will use X values as the first coordinate and Y as the second.", "1-1": "Given X and Y coordinates are used in the projection axis order (X as first coordinate) to calculate tile indices.\n\nAxis flip configuration has no bearing on how GetTile requests are generated.", "h-2": "Other notes", "0-2": "X and Y are flipped if the selected projection is configured for \"flip axis order\"", "2-2": "If given bounds are outside the tiled area, Spatineo Performance may produce illegal tile requests.", "1-2": "The meter will target only those matrices and tiles which overlap both the given bounding box and the matrix bounds taking into account any TileMatrixLimits configuration.\n\nIf the given bounding box is outside the legal bounds of all tile matrices for this projection, the *test will fail* at the prepare stage.", "2-1": "Given X and Y coordinates are used in the projection axis order (X is first, Y is second) to calculate tile indices.\n\nAxis flip configuration has no bearing on how GetTile requests are generated." }, "cols": 3, "rows": 3 } [/block] ## Running the Same or Similar Test Again If you want to re-run a previously ran test or use it’s configuration as a basis for your new test you can use the “Re-run test” button at the Setup tab. It creates a new test with the same settings as in currently selected test. You can give the new test a describing name and modify the test parameters as desired. The original test remains archived in Spatineo Performance so you can return to analyse it at any time. ## Running and Reviewing Previously Created Tests All test created by your organisation are stored in the test archive regardless of their completion status. You can design a number of tests in advance and just run then one ofter another during a testing session. Another typical use case would be iterative testing, where you want to start with a basic test settings and modify them in the latter tests to try to expose undesired service behaviour or find the service capacity limits. You can select any of the previously created tests by clicking the “Existing tests..” button. The opening dialog lets you choose a test and delete tests that you no longer consider worth keeping. You can change the viewed test at any time, even when the test is running. All the changes you made to the test are continuously and automatically stored.