Install ServiceNow Connector on Windows
To install the ServiceNow Connector on Windows, use the following procedure.
To install the ServiceNow Connector
-
Run the ServiceNow Connector installation program.
The installation wizard opens.
-
Read the installation instructions and click Next.
The License Agreement dialog box opens.
-
Read the license agreement. If you agree to its terms, click I accept the agreement and click Next.
The Installation Directory dialog box opens.
-
Choose an installation folder for ServiceNow Connector and click Next.
The Service Name dialog box opens.
-
In the Service name box, type a name to use for the connector’s Windows service and click Next.
The Service Port and ACI Port dialog box opens.
-
Type the following information, and click Next.
Service port The port used by the connector to listen for service actions. ACI port The port used by the connector to listen for actions. The License Server Configuration dialog box opens.
-
Type the following information, and click Next.
License server host The host name or IP address of your License server. License server port The ACI port of your License server. The IDOL database dialog box opens.
-
In the IDOL database box, type the name of the IDOL database to index documents into, and click Next.
The Proxy Server dialog box opens.
-
If you are installing the connector on a machine that is behind a proxy server, specify the details of the proxy server to use to access ServiceNow. Then, click Next.
Proxy host The host name or IP address of the proxy server to use. Proxy port The port of the proxy server to use. Proxy username (Optional) The user name for authenticating with the proxy server. Proxy password (Optional) The password for authenticating with the proxy server. The Instance name dialog box opens.
-
In the Instance name box, type the ServiceNow instance to retrieve information from. The instance name is usually the first part of the URL, for example type
my-instance
formy-instance.servicenow.com
. After typing the instance name, click Next.The ServiceNow Authentication Type dialog box opens.
-
Choose whether to use Basic Authentication or OAuth authentication to retrieve information from ServiceNow.
- To use Basic Authentication, click Basic Authentication and click Next. Then enter the user name and password to use and click Next.
- To use OAuth Authentication, click OAuth Authentication and click Next. Then enter the user name and password that you use to log on to ServiceNow. Use an account that can access all of the data that you want to retrieve (such as an administrator). You must also enter the AppKey and AppSecret that you obtained from ServiceNow when you created an application to represent the connector. For more information about creating the application, see Create a ServiceNow Application. After typing the information, click Next.
The ServiceNow tables dialog box opens.
-
In the ServiceNow tables box, type a comma-separated list of tables to retrieve information from. You can find table names in the administration interface for your ServiceNow instance. Then, click Next.
The CFS dialog box opens.
-
Choose whether to install a new CFS or use an existing CFS.
-
To install a new CFS, select the Install a new CFS check box and click Next.
The Installation directory dialog box opens. Go to the next step.
-
To use an existing CFS, clear the Install a new CFS check box and click Next.
The CFS dialog box opens. Type the host name and port of your existing CFS installation. Click Next and go to Step 18.
-
-
Choose an installation folder for the Connector Framework Server and then click Next.
The Installation name dialog box opens.
-
In the Service name box, type a unique name for the Connector Framework service and click Next. The name must not contain any spaces.
The CFS dialog box opens.
-
Type the following information, and click Next.
Service port The port used by CFS to listen for service actions.
ACI port The port used by CFS to listen for actions. -
Type the following information and click Next.
IDOL Server hostname The host name or IP address of the IDOL server that you want to index documents into. ACI port The ACI port of the IDOL server. The Pre-Installation Summary dialog box opens.
-
Review the installation settings. If necessary, click Back to go back and change any settings. If you are satisfied with the settings, click Next.
The connector is installed.
-
Complete the installation procedure.
- If you chose to use Basic Authentication, click Finish.
-
If you chose to use OAuth authentication, you can run the OAuth tool, which obtains the access tokens necessary to retrieve information from ServiceNow.
-
To run the OAuth tool, select the Run oauth_tool.exe check box, and click Finish.
The OAuth tool obtains the tokens from ServiceNow and creates files named
oauth.cfg
andoauth2_sites.bin
, in the connector's installation folder. These files contain the information required by the connector to retrieve information from ServiceNow. The default configuration automatically uses this information to authenticate with ServiceNow, but for more information about configuring fetch tasks with OAuth authentication, see Retrieve Information from ServiceNow (OAuth Authentication). - To finish installing the connector without running the OAuth tool, clear the Run oauth_tool.exe check box and click Finish. For information about how to run the OAuth tool at a later time, see Configure OAuth Authentication.
-