Adding a cache to collect from NetCache appliances

Enable SSL on the NetCache appliance.

To test whether the ContentReporter server can resolve the fully qualified domain name of the NetCache, enter the following at the command line of the ContentReporter server machine:

> nslookup cachename

cachename is the fully qualified domain name of the NetCache.

Result:

Your system displays the results of the nslookup command. If your system found the NetCache, continue with Step 3. If your system did not find the NetCache, ask your IT Administrator to correct this problem, and then continue with Step 3.

Browse to the NetCache using HTTPS.

From the Security Alert window, click View Certificate.

From the Certificate window, click the Details tab, and then click Copy to File.

From the Certificate Manager Export Wizard, click Next.

From the Certificate Export File window, select the Base64 Encoded X.509 (.CER) button, and click Next.

Result:

The Export File Name window appears.

On the ContentReporter server machine, browse to the
..\Network Appliance\ContentReporter\jakarta-tomcat\webapps\ContentReporter\ directory and enter cachename.cer for the file name.

cachename is the name you will enter for the cache in the Name field of the New Cache window if you manually add the cache to a cache group, or the NetCache's fully qualified domain name if you will use Auto Discovery to add the cache to a cache group

.cer is the required file extension

To learn more about the certificate name, see Cache Name for SSL.

Click Next to copy the NetCache's certificate into the directory.

Click Finish to return to the Certificate window.

Click OK to return to the Security window.

Click Yes to confirm that you can open the NetCache Manager using the SSL protocol.

Close the NetCache Manager.

Repeat Steps 1-13 for each NetCache you want to add to a cache group.

Add caches to a cache group

• Using Auto Discovery.
• Manually adding a NetCache appliance.

From a page in ContentReporter, click the Administration tab.

From the Administration page, click the Admin button.

From the Cache Group tab, select a cache group in the left-hand panel, and click New Cache.

In the New Cache window, enter a name for the NetCache, select the Collect from NetCache button, and then click Settings.

Note
If ContentReporter will collect from this NetCache using the SSL protocol, this name must match the SSL certificate file name (without the .cer extension). To learn more about naming the SSL certificate, see Cache Name for SSL.

In the NetCache Settings window, enter the NetCache's IP address or fully qualified domain name.

Note
If ContentReporter will collect from this NetCache using the SSL protocol, this value must match the NetCache's Common Name field value you entered when generating the SSL certificate. To learn more about the NetCache Name or IP Address field value, see NetCache Name or IP Address for SSL.

Enter the NetCache user name and password.

Ensure that the port field displays 3132 if NetCache allows HTTP collection of log files, or select the SSL check box and ensure that the port field displays 443 to allow SSL protocol collection.

To test connectivity between ContentReporter and the NetCache, click Test.

Result:

The Test Cache Connectivity window appears. When ContentReporter completes the test, displays a status of either "available" or "not available."

If...

Then...

The NetCache has an "available" status

Click OK to return to the NetCache Settings window.

The NetCache has a "not available" status

1. Click OK to return to the NetCache Settings window.
2. Verify that you entered the correct IP Address or a fully qualified domain name that can be resolved by the machine on which you installed ContentReporter.
3. Verify that a network connection exists between the NetCache and the ContentReporter server machine.
4. If using SSL, verify that the Cache Name matches the certificate name, that the certificate is in the proper directory, and that the NetCache Name or IP Address matches the NetCache's "Common Name" field value.
5. Repeat Step 8.

If you want, enter the NetCache model, such as C720, and the NetCache OS version, such as 5.1R2D5.

Click OK to return to the New Cache window.

Accept the default location to store this cache's log files, or click Browse, select an appropriate directory, and click OK.

Note
The ContentReporter server copies the log files to this location before processing them. If it fails to process a particular log file, it leaves the log file in this directory.

To delete the log files after processing, select the appropriate check box.

Accept the default number of error lines (200), or enter another number. If you do not want the number of error lines in a log file to stop the ContentReporter server from processing, enter the number 0.

After you enter all the required information, click OK.

Result:

You return to the Cache Group tab and the cache appears under the cache group in the left-hand panel.

Click Apply or OK to save the changes to the ContentReporter server.

Result:

You successfully added the NetCache to a cache group.

Go to Step three: Scheduling log file collection to create a scheduled event to collect and process this cache group's log files.

From a page in ContentReporter, click the Administration tab.

From the Administration page, click the Admin button.

From the Cache Group tab, select a cache group in the left-hand panel, and click Discover.

Result:

The first Auto Discovery window appears.

Ensure that the appropriate cache group appears in the upper-right Cache Groups field, then click Discover New Caches.

Result:

The second Auto Discovery window appears.

Enter the subnet on which the NetCache appliances are located.

In the Range fields, enter the first and last numbers of the range you want to search for NetCache appliances. Any range between the numbers 1 and 254 is acceptable.

Ensure that the correct string appears in the community field to detect the SNMP-enabled NetCaches. The default is "public."

Enter the NetCache user name and password.

Ensure that the port field displays 3132 for caches allowing HTTP collection of log files or, check the SSL box, and ensure that the port field displays 443 for caches allowing SSL protocol collection.

After you enter all required information, click Discover.

Note
Auto Discovery takes approximately one second for each number in a range.

Result:

ContentReporter searches for all SNMP-enabled NetCache appliances in the range of the subnet that are recognized with the selected community string.

If...

Then...

ContentReporter discovers any NetCache appliances in the subnet range, you return to the first Auto Discovery window, and the discovered NetCaches appear in the left-hand Discovered Caches panel.

Proceed to step 11 to select the NetCache appliances for this cache group.

The No Caches Discovered dialog box appears

1. Click OK to return to the first Auto Discovery window.
2. Verify that the NetCaches are SNMP-enabled, and that the community string, User name, Password, and port numbers are correct.
3. Repeat steps 4 through 10.

Select the NetCaches in the left-hand Discovered Caches panel, and click Add.

Result:

The NetCaches appear in the right-hand panel.

To test connectivity between ContentReporter and the selected NetCaches, click Test Connection.

Result:

The Test Cache Connectivity window appears, and, when ContentReporter completes the test, displays a status of either "available" or "not available" for each NetCache.

If...

Then...

All the NetCaches have an "available" status

Click OK to return to the first Auto Discovery window.

Some or all of the NetCaches have a "not available" status

1. Click OK to return to the first Auto Discovery window.
2. Verify that the ContentReporter server can resolve the fully qualified domain name of each NetCache that had a "not available" status.
3. If using SSL, verify each certificate is in the proper directory.
4. In the right-hand panel, select each NetCache that had a "not available" status and click Remove.
5. Repeat Steps 4 through 12.

Click OK.

Result:

You return to the Cache Group tab, and the NetCaches discovered with the Auto Discovery feature appear under the cache group in the left-hand panel.

Click OK to return to the Cache Group tab.

Click Apply or OK to save your changes.

Go to Step three: Scheduling log file collection to create a scheduled event to collect and process this cache group's log files.

Note
The Auto Discovery feature does not give you the ability to specify a folder to store the collected log files. If you accept the Auto Discovery default location, ContentReporter stores collected log files for each cache added with Auto Discovery in the ContentReporter server machine's folder:

..\Network Appliance\ContentReporter\jakarta-tomcat\webapps\ContentReporter\cache group name\cache name\.

To specify a different location to store a particular cache's log files, you must modify the cache's settings.

See step 4 of Modifying a cache's settings.

Note
By default, the Auto Discovery feature uses each NetCache's IP Address for the NetCache Settings window Name or IP Address field value. If ContentReporter will use SSL to collect from a NetCache added with Auto Discovery, the Name or IP Address field value must match the NetCache's Common Name. If the cache's NetCache Management console Common Name field value is not its IP Address, you must modify the NetCache settings in ContentReporter to specify the correct name in the Name or IP Address field of the NetCache Settings window.

See step 6 of Modifying a cache's settings.

To learn about the NetCache Common Name field, see NetCache Name or IP Address for SSL.