IBM Business Analytics Diagnostics: Use Case: Diagnosing a Planning Problem with the IBM Cognos Planning Diagnostic Tool

Product(s): IBM Cognos Planning; Area of Interest: Infrastructure

Installing a new version of IBM Cognos Planning, the component Planning Analyst produces an error when launching.

Share:

Business Analytics Proven Practices Team, Business Analytics Proven Practices Team, IBM

Business Analytics Proven Practices Team



28 March 2012

Also available in Russian

Introduction

Purpose

This document is intended to provide a troubleshooting methodology which incorporates publicly available utilities to diagnose and resolve an issue identified within a specific use case. The use case will be presented as a scenario where an IBM Business Analytics Support Analyst is working with a customer to diagnose and solve a particular issue.

The utilities mentioned in this document can be found at http://www.ibm.com/support/docview.wss?uid=swg24020960.

Applicability

Although the troubleshooting approach outlined is not IBM Cognos Planning version specific, some of the diagnostic utilities used are. The version of the utility to be downloaded may be specific to the IBM Cognos Planning version that is experiencing the issue. Please check the compatibility of the version in the Document Information section of the link provided above.


Use Case Description

A customer calls IBM Business Analytics Support and indicates that after an installing a new version of IBM Cognos Planning, the component Planning Analyst produces an error when launching. When logging into Analyst, the customer received an error message stating:

The FileSys.ini is in use by another instance of IBM Cognos Planning – Please select a different FileSys.ini file.


Gathering Information for this Use Case

The Support Analyst asks the customer about the operating system used in the environment and what machine the Analyst client is being run on and if there are any other Analyst users on the system. The customer indicates that the IBM Cognos Planning components are installed on a single server and the server is running a Microsoft Windows Server 2003 SP2 operating system and that no other Analyst users have logged on since the upgrade.

The Support Analyst requests that the customer download and run the IBM Cognos Planning Diagnostic tool. This tool is located at the following URL:
http://www.ibm.com/support/docview.wss?uid=swg24020960.

The diagnostic tool is run on the IBM Cognos Planning server. By default the tool saves diagnostic output to the following path ..\Temp\IBMCognos_Planning. The customer then compresses and sends the resulting files captured by the diagnostic tool to the Support Analyst for review.


Indicating Considerations and Precautions

The Support Analyst reviews the output files from the diagnostic tool and while looking in the IBMCognos_Planning_FilesCopied folder, notices that the FileSys.ini file contains an InstanceLock line (InstanceLock={GUID}).

The Support Analyst informs the customer that there is an InstanceLock in the FileSys.ini that Analyst is referencing and that is preventing Analyst from opening.

The Support Analyst offers a suggestion on how to remedy the situation.

  1. The customer can delete the InstanceLock line in the FileSys.ini and save the file.
  2. Next the customer can try opening Analyst, which will reference the modified FileSys.ini.

Resolving the Issue

After the customer followed the recommended steps provided by the Support Analyst, the customer’s IBM Cognos Planning Analyst client now starts without issue.

Comments

developerWorks: Sign in

Required fields are indicated with an asterisk (*).


Need an IBM ID?
Forgot your IBM ID?


Forgot your password?
Change your password

By clicking Submit, you agree to the developerWorks terms of use.

 


The first time you sign into developerWorks, a profile is created for you. Information in your profile (your name, country/region, and company name) is displayed to the public and will accompany any content you post, unless you opt to hide your company name. You may update your IBM account at any time.

All information submitted is secure.

Choose your display name



The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

Required fields are indicated with an asterisk (*).

(Must be between 3 – 31 characters.)

By clicking Submit, you agree to the developerWorks terms of use.

 


All information submitted is secure.

Dig deeper into Big data and analytics on developerWorks


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=Big data and analytics, Information Management
ArticleID=807192
ArticleTitle=IBM Business Analytics Diagnostics: Use Case: Diagnosing a Planning Problem with the IBM Cognos Planning Diagnostic Tool
publish-date=03282012