In the Property and Domains view, you can see and edit information about your account's properties and its serving domains. You can also see versioning information about the configuration and click a link to see its complete change history.
A property is simply a set of one or more domains, providing a means of grouping your domains together so they can share common configuration settings. An account can have any number of properties.
The Property and Domains screen can be toggled to either of two views:
- the Table view displays all the properties in your account as a table. The columns of the table are Display Name, API (the ID for connecting to the Instart REST APIs), and # of Domains. You can sort the list by each of the
- the Cards view displays your properties as cards, three to a row, each showing a small graph comparing overall traffic over the last 24 hours and the 24 hours prior, an indicator of the traffic trend over those periods, and the number of domains. The cards appear in order left to right and top to bottom in order of the amount of total traffic.
From either view, clicking on a property takes you to the Property Overview screen for the selected property.
The Property Overview screen displays the current property information, including Property name, its API name, whether the property is in the PCI environment or not, and tabs to allow you to work in the regular environment or in the staging environment.
The Property Overview page has two sub-sections for both the production environment or the staging environment:
- Domains lets you add to or modify the DNS addresses that Instart proxies for you.
- Change History shows a list of all changes made to the configuration, with the ability to view a configuration file in detail, compare the current configuration with an earlier version, or roll back to an earlier version.
From the Domains tab, you can view and edit existing domains, add new domains, and view the JSON representation of the property and domains configuration.
The page displays existing domains with four sortable columns: Domain Name, whether or nor the domain has SSL enabled, and the domain's CNAME.
Change History tab
From the Change History tab, you can view a summary list of changes that have been made to the configuration for this property. You can also
- view any configuration by clicking its check box and then clicking View Configuration
- view the difference between any two configurations by selecting two check boxes and then clicking Compare Configurations
- download a copy of the change history by clicking the Export Change History (CSV) button
- roll back to an earlier configuration by selecting the desired version and clicking Roll Back Changes
Here's an example of what you see when you click View Configuration to see the config JSON file's contents:
You can selectively expand and collapse sections of the JSON tree by clicking the appropriate icon in the line number column. You can also click the Collapse All or Expand All button. You can download a copy of the file by clicking the Download JSON button.
Here's what you see when you select any two configurations and click the Compare Configurations button:
Relevant sections of the two configs are displayed side-by-side, the earlier one on the left side and the later on on the right. Additions are highlighted in green, deletions are highlighted in red.
You can click Export Diff to download a .diff file.
Adding a new domain
To create a new domain, click the Add New Domain at the top of the list of domains in the Property Overview screen. This opens a Create New Domain pane:
Enter the Web Site Domain and the Origin Domain (the address of the origin serving the domain) in their respective fields.
If needed, click Edit Advanced Settings and you can change four timeout values (which are normally set to the defaults shown) and specify what HTTP status code the proxy will send in case of a server error:
The four timeout settings you can adjust are:
- Connection timeout – the timeout period within which connection with the origin is expected to be successfully established, in seconds. For HTTPS connections, the SSL handshake time is also included within this timeout period. It can be set to an integer in the range from 1 to 300. The default value is 30.
- First byte response timeout – the timeout period within which the first byte of the response is expected to be received, in seconds. if we do not get the response first byte within this time, we'll mark this connection as bad, close it, and retry. It can be set to an integer in the range from 1 to 9000. The default value is 30.
- Keepalive Timeout – timeout period for persistent connections, in seconds. This can be an integer in the range from 1 to 1500. The default value is 300.
- Inter-response Timeout – timeout period within which the edge proxy is expected to receive the next response chunk from the origin, in seconds. (Note that this occurs for content that has not yet been cached, or has expired, and for dynamic content any anything else that is not cacheable.) This field helps to close requests in case an origin server sends a few response chunks fast and is very slow in sending the next ones. This can be set to an integer in the range from 1 to 600. The default value is 30.
You can also specify a failover origin in case the HTTP response code from the regular origin is a 5xx error. Check the appropriate Request Failover check boxes to specify which response code or codes you want to trigger forwarding the request to a failover host, and a Failover Origin field appears:
Enter the hostname or IP address of the desired failover origin.
When basic and advanced domain settings are set as desired, click Save Changes and a configuration task is created to add the new domain.
Editing or deleting existing domains
To edit an existing domain, click the desired domain in the list on the Property Overview page. The Edit <domain name> Domain screen is displayed:
You can edit the origin of the domain, and you can also edit Advanced Settings by clicking on View Advanced Settings. Advanced settings are described above in the section "Adding a new domain" above.
To delete the domain, click the Delete Domain button.
Adding a new property
To add a new property for your account, click Add a New Property from the My Properties screen to open the Add a New Property screen:
Enter a Property display name, a Property description, and an API name; select Off or On for PCI status; and choose the Team assignment (if you have created any role-based access control teams for your account). Then click Add Property.
Editing a property
To edit an existing property, click the desired property in the list on the My Properties page, then click Edit Property on the Property Overview screen. The Updating <property name> Property screen is displayed:
Make the changes you want to make (note that the API name cannot be changed), then click Update Property.
Note that deleting a property is not supported. You need to contact Instart support if you need a property to be removed.