| Date post: | 07-Sep-2014 |
| Category: |
Documents |
| Upload: | anirban-pal |
| View: | 112 times |
| Download: | 1 times |
User Manual – Recycling Cognos Services
7-Eleven
Business Intelligence
User Manual - Recycling Cognos ServicesVersion 1.1
Prepared By Reviewed by Approved ByName Cognizant Offshore Cognizant OnsiteRole Offshore Team Onsite Team
SignatureDate 05-Jan-2012
Page 1
User Manual – Recycling Cognos Services
Table of Contents
1.0 Introduction 3
1.1 Purpose of the document 3
2.0 Production Server Details 3
3.0 Recycling Cognos Services 4
3.1 Stop Cognos Services 4
3.2 Start Cognos Services 8
3.3 Verification 10
4.0 Known Issues 16
4.1 Planning Services Already in Use or Similar Message 16
4.2 Planning Services Failed to Start 18
5.0 Revision History 19
Page 2
User Manual – Recycling Cognos Services
1.0 Introduction
1.1 Purpose of the documentThe 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
Page 3
Sl.No Server Name Sever IP Server Description1 USTXALACN7 10.132.11.109 Planning Job Server and Cognos
Software Instance2 USTXALACG1 10.132.11.132 Planning Job Server3 USTXALACG2 10.132.11.154 Planning Job Server4 USTXALACG3 10.132.11.214 BI and Secondary Content Manager5 USTXALACG4 10.132.11.215 BI Job Server and Primary Content
Manager6 USTXALACGW1 10.132.11.98 Web Server7 USTXALACGW2 10.132.11.99 Web Server8 USTXALATS4 10.132.11.110 Application Server
User Manual – Recycling Cognos Services
3.0 Recycling Cognos ServicesIn 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 Order while starting the servicesUSTXALACG1 USTXALACG4USTXALACG2 USTXALACG3USTXALACN7 USTXALACN7USTXALACG3 USTXALACG2USTXALACG4 USTXALACG1
3.1 Stop Cognos Services1. 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 4
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 5
User Manual – Recycling Cognos Services
3. Stop the Cognos Services3.1. Open IBM Cognos Configuration3.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 6
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 7
User Manual – Recycling Cognos Services
It’ll 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 servicesUSTXALACG1USTXALACG2USTXALACN7USTXALACG3USTXALACG4
Page 8
User Manual – Recycling Cognos Services
3.2 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 servicesUSTXALACG4USTXALACG3USTXALACN7USTXALACG2USTXALACG1
4.1. Select Environment and then click on “Run” button.
Page 9
User Manual – Recycling Cognos Services
It’ll 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 servicesUSTXALACG4USTXALACG3USTXALACN7USTXALACG2USTXALACG1
Page 10
User Manual – Recycling Cognos Services
3.3 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 Connection5.1. Open http://7-Cognos
5.2. Click IBM Cognos Content link
Page 11
User Manual – Recycling Cognos Services
5.3. Click Planning Folder
5.4. Click Budget Apps
Page 12
User Manual – Recycling Cognos Services
5.5. Click IS Budget
5.6. Drill down to “Alexander – 2836”5.7. Click “2836 CANADA SYSTEMS”
Page 13
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 14
User Manual – Recycling Cognos Services
7. Test Planning Analyst 7.1. Start > All Programs > IBM Cognos 8 > Planning Analyst7.2. Scroll down to go_capex_contributor (this is the out of box test library)
7.3. Click OK
Page 15
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-426-7378 and use 7-Eleven Account number: 7119438.
Page 16
User Manual – Recycling Cognos Services
4.0 Known Issues
4.1 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 17
User Manual – Recycling Cognos Services
The resolution is to manually stop the Cognos services using Task Manager
7.5. Start > Run > taskmgr7.6. Click Processes tab7.7. Find cogbootstrapservice.exe7.8. End Process7.9. Find epPlanningService8.exe7.10. Click End ProcessNote: Either of these services could be running or maybe just one of the two.
If the issue persists after attempting the steps above, then reboot the offending server(s). Before the reboot, email CSS Support at [email protected] AND [email protected] and let them know you are going to reboot the offending server(s).
Page 18
User Manual – Recycling Cognos Services
4.2 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 [email protected] AND [email protected] 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 19
User Manual – Recycling Cognos Services
5.0 Revision History
Change Initiator
Change Description Date of Change
Shruti Mehta Creation 01/05/2012Shruti Mehta Updated section 2.0 and 3.3 with Benjamin’s
review comments: USTXALATS4 is the application server.
01/17/2012
Anirban Mukherjee
Included error resolution and new screen shot 01/27/2012
Page 20
