User Manual Recycling Cognos Services

7-Eleven Business Intelligence User Manual - Recycling Cognos Services

Version 1.1

Prepared By Name Role Signature Date

Cognizant Offshore Offshore Team 05-Jan-2012

Reviewed by
Cognizant Onsite Onsite Team

Approved By

Page 1

User Manual Recycling Cognos Services

Table of Contents
1.0Introduction
1.1Purpose of the document 1.2Summary

3
3 3

2.0Production Server Details 3.0Recycling Cognos Services

1.3Stop Cognos Services 1.4Start Cognos Services 1.5Verification

3 5
5 10 12

4.0Known Issues
1.6Planning Services Already in Use or Similar Message 1.7Planning Services Failed to Start

18
18 20

5.0Revision History

21

Page 2

User Manual Recycling Cognos Services

1.0 Introduction
1.1 Purpose of the document
The document provides a step by step guide to Recycle Cognos Services. The intended audience for this document is Cognizant BI Support Team.

1.2

Summary
Recycling (i.e. stopping then starting) the Cognos services will resolve most issues. Order is important; especially when starting the services. The reason is the Content Manager runs on CG4 as primary and CG3 as secondary. Content Manager must be running before any of the other services will function properly. If this process is being performed during normal system availability hours, then Cognizant Team is required to send out user notification. The system is available 24 hours, 7 days a week except for the weekly scheduled maintenance window on from 1:00AM CST to 8:30AM CST Sunday morning. This is a shared window with 1-5AM CST reserved for 7-Eleven Corporate Server Support (CSS). Cognizant will have to work in co-ordination with CSS Team. Recycling of Cognos services is a scheduled weekly event that occurs every Sunday morning between 5:30AM CST-8:30AM CST.

2.0 Production Server Details

Sl.No 1 2 3 4 5 6 7 8 Server Name USTXALACN7 USTXALACG1 USTXALACG2 USTXALACG3 USTXALACG4 USTXALACGW1 USTXALACGW2 USTXALATS4 Sever IP 10.132.11.109 10.132.11.132 10.132.11.154 10.132.11.214 10.132.11.215 10.132.11.98 10.132.11.99 10.132.11.110 Server Description Planning Job Server and Cognos Software Instance Planning Job Server Planning Job Server BI and Secondary Content Manager BI Job Server and Primary Content Manager Web Server Web Server Application Server

Page 3

User Manual Recycling Cognos Services

Page 4

User Manual Recycling Cognos Services

3.0 Recycling Cognos Services

In order to carry out recycling, the below order is very important. The reason is the Content Manager runs on CG4 as primary and CG3 as secondary. Content Manager must be running before any of the other services will function properly. Order while stopping the services USTXALACG1 USTXALACG2 USTXALACN7 USTXALACG3 USTXALACG4 Order while starting the services USTXALACG4 USTXALACG3 USTXALACN7 USTXALACG2 USTXALACG1

1.3

Stop Cognos Services

1. Verify IBM Cognos Services are set to manual status in Window Services 1.1. Open Window Services: Start -> Control Panel -> Administrative Tools -> Services 1.2. Verify the Status Type is Manual: IBM Cognos 8 IBM Cognos 8 Planning 8.4

Page 5

User Manual Recycling Cognos Services 2. If either is set to Automatic, change it to Manual, if not skip the next step.
2.1. Click the service 2.2. Right click and choose properties 2.3. Under General tab 2.4. Change Startup type to Manual 2.5. Click OK

Page 6

User Manual Recycling Cognos Services

3. Stop the Cognos Services 3.1. Open IBM Cognos Configuration 3.2. Start > All Programs > IBM Cognos > IBM Cognos Configuration Run button is disabled and Stop button is enabled stating services are running. Note: Do NOT use the RESTART button

The two services to review are Planning Server and IBM Cognos 8 The status is indicated by the green arrow. If it is enabled, then the services are running.

3.3. Select Environment (under Local Configuration) 3.4. Click on Stop button found on the menu

If you a get a message as below while proceeding with the process click on NO.

Page 7

User Manual Recycling Cognos Services

If an error message is generated while trying to stop the services, which says Unable to start Cognos

Configuration because the configuration data is locked by another instance of Cognos Configuration
then the following needs to be done.

In the particular server where Cognos is running navigate to the file cogstartup.lock You can find this file by searching by the filename in My Computers. Once this file is found, delete the file

Reason When Cognos Configuration is started, a cogstartup.lock file is created. If this file is present, the lock is enabled. Delete this file to release the lock.

Page 8

User Manual Recycling Cognos Services

Itll take couple of minutes to stop the services. Use the <<Details button to view the progress and to check for errors

3.5. Wait until the Close button is enabled, then click it

3.6. Repeat the above steps on all the servers in the correct order Order while stopping the services USTXALACG1 USTXALACG2 USTXALACN7 USTXALACG3 USTXALACG4

Page 9

User Manual Recycling Cognos Services

1.4

Start Cognos Services

4. Starting the Cognos Services Once all services have been stopped on each server, then the services can be started. Order while starting the services USTXALACG4 USTXALACG3 USTXALACN7 USTXALACG2 USTXALACG1

4.1. Select Environment and then click on Run button.

Page 10

User Manual Recycling Cognos Services

Itll take couple of minutes to start all the services while it cycles through: Note: The next two screenshots are from the Cognos test environment; therefore the options may be different than what you see in production

4.2. Wait until the Close button is enabled, then click it

4.3. Make sure there are no errors either by watching for pop-up notifications and by reviewing the
contents of the Details >> button 4.4. Repeat the above steps on all the servers in the correct order Order while starting the services USTXALACG4 USTXALACG3 USTXALACN7 USTXALACG2 USTXALACG1

Page 11

User Manual Recycling Cognos Services

1.5

Verification

Perform a test after starting the services on the three major Cognos components: Cognos Contributor via Cognos Connection, Planning Contributor Administration Console (CAC) and Planning Analyst. Each of these components can be accessed by logging onto USTXALATS4. 5. Test Cognos Contributor via Cognos Connection 5.1. Open http://7-Cognos

5.2. Click IBM Cognos Content link

Page 12

User Manual Recycling Cognos Services

5.3. Click Planning Folder

5.4. Click Budget Apps

Page 13

User Manual Recycling Cognos Services

5.5. Click IS Budget

5.6. Drill down to Alexander 2836 5.7. Click 2836 CANADA SYSTEMS

Page 14

User Manual Recycling Cognos Services

5.8. Contributor cube should open in a separate window with or without zero data. The window will be
similar as the one above. 5.9. Testing complete 6. Test Planning - Contributor Administration Console (CAC) 6.1. Start > All Programs > IBM Cognos 8 > Planning - Contributor Administration

6.2. Once open, the testing is complete. If the services were not running, then this screen would throw an error

Page 15

User Manual Recycling Cognos Services 7. Test Planning Analyst

7.1. Start > All Programs > IBM Cognos 8 > Planning Analyst 7.2. Scroll down to go_capex_contributor (this is the out of box test library)

7.3. Click OK

Page 16

User Manual Recycling Cognos Services

7.4. Once open, the testing is complete. If the services were not running, then this screen would throw an error Each of these should open error free. If an error is thrown, then wait a few minutes and try opening again. If the error persists, then recycle the Cognos services again. If the error persists, the contact IBM Support: 1-800-4267378 and use 7-Eleven Account number: 7119438.

Page 17

User Manual Recycling Cognos Services

4.0 Known Issues

1.6 Planning Services Already in Use or Similar Message

Stopping the planning services can result is an error stating the planning services are in use after stopping the services per the documented instructions. The issue presents itself as such: In IBM Cognos Configuration the services status presents themselves as stopped (i.e. the green Run button is enabled and the IBM Cognos 8 and Planning Server show squares).

In Windows services one or both IBM Cognos services status show Stopping.

Page 18

User Manual Recycling Cognos Services

The resolution is to manually stop the Cognos services using Task Manager Start > Run > taskmgr Click Processes tab 7.7. Find cogbootstrapservice.exe 7.8. End Process 7.9. Find epPlanningService8.exe 7.10. Click End Process Note: Either of these services could be running or maybe just one of the two. 7.5. 7.6.

If the issue persists after attempting the steps above, then reboot the offending server(s). Before the reboot, email CSS Support at serveroncall@7-11.com AND serverhotpager@7-11.com and let them know you are going to reboot the offending server(s).

Page 19

User Manual Recycling Cognos Services

1.7

Planning Services Failed to Start

Upon starting the IBM Cognos services the following error is thrown:

Reboot the offending server(s). Before the reboot, email CSS Support at serveroncall@7-11.com AND serverhotpager@7-11.com and let them know you are going to reboot the offending server(s). Once rebooted, proceed to the Start Cognos Services section of this document.

Page 20

User Manual Recycling Cognos Services

5.0 Revision History

Change Initiator Change Description Shruti Mehta Creation Shruti Mehta Updated section 2.0 and 3.3 with Benjamins review comments: USTXALATS4 is the application server. Anirban Included error resolution and new screen shot Mukherjee Date of Change 01/05/2012 01/17/2012 01/27/2012

Page 21