Port and URI settings

You can change certain elements in a URI depending on your environment. An IBM® Cognos® URI contains the following elements:

Additional information about ports is available in the topic Review the default port settings

For a Content Manager URI, Dispatcher URI for external applications, or dispatcher URI
protocol://host_name_or_IP:port/context_root/alias_path
For a Gateway URI or a Web content URI
protocol://host_name_or_IP:port/virtual_directory/gateway_application

or

protocol://host_name_or_IP:port/context_root/alias_path

Important: For HTTPS/SSL configurations, make sure to use fully qualified hostname for URIs.

The elements are described in the following table:

Table 1. IBM Cognos URI elements and descriptions
Element	Description
protocol	Specifies the protocol used to request and transmit information, either Hyper Text Transfer Protocol or Hyper Text Transfer Protocol (Secure). Example: http or https
host name or IP	Specifies the identity of the host on the network. You can use an IP address, a computer name, or a fully qualified domain name. In a distributed installation, you must change the localhost element of a URI. In a mixed environment of UNIX and Microsoft Windows operating system servers, ensure that host names can be resolved to IP addresses by all servers in the environment. Example: localhost or 192.168.0.1 or [2001:0db8:0000:0000:0000:148:57ab]:80
port	Specifies the port on which the host system listens for requests. The default port for the IBM Cognos Analytics services is 9300. The default port for a web server is 80. Example: 9300 or 80
context root	Used by the application server to determine the context of the application so that the request can be routed to the correct Web application for processing. Example: p2pd
alias path	Used by the application server to route a request to the correct component within a Web application. The alias path must not be modified or IBM Cognos components will not function properly. Example: servlet/dispatch
virtual directory	Used by the Web server to map a virtual directory or alias to a physical location. For example, in the default Gateway URI of http://localhost:80/ibmcognos/bi/v1/disp, the virtual directory is ibmcognos/cgi-bin. Example: ibmcognos/
gateway application	Specifies the name of the Cognos gateway application that is used. For example, if you are accessing IBM Cognos components using a Common Gateway Interface (CGI), then the default gateway application would be cognos.cgi. Example: cognos.cgi

If you are using collaboration with IBM Connections, ensure that you include the full domain for all hostname entries in IBM Cognos Configuration. For example, if your computer is named MyComputer and your domain is MyCompanyName.com, then for the host_name_or_IP value, use MyComputer.MyCompanyName.com. The domain must be included in order for IBM Connections to allow access.