What are some helpful Linux commands to use, monitor, and troubleshoot with, when running Reporter on Linux?

<< Back to Knowledge Search



To Start and Stop Reporter 

  • Navigate to the /etc/init.d folder
    Enter"./bcreporter start" to start it
    Enter "./bcreporter stop" to stop it

To Start Reporter from within a Terminal Window

  • Navigate to the /opt/bc/reporter folder
    Enter "./bcreporter"

NOTE:  If you want reporter to remain running after you terminate your SSH session, insert the nohup command in front like the following example: 

"nohup bcreporter"

To Find out if Reporter is Running on the Server  

  • Navigate to the /etc/init.d folder
    Enter "./bcreporter status"

To Find out if Reporter is Installed on the Server 

  • Navigate to the /opt/bc/reporter folder and look for the binary of reporter as shown in the in following example:
    From any folder enter "RPM -qa | grep reporter"

To Display a Journal File on the Terminal 

  •  Navigate to /opt/bc/reporter/journal/
    Enter "cat jour"  and then press the tab key.  This action lists all the journals to the display.

NOTE: In some versions, this journal file is found in the installed root folder.

To Navigate around the File System

  • Enter "cd" to change directories
  • Enter "pwd" to find out where in the file sytem you are

NOTE: For a directory listing type "ls -l "

To Discover what Version of Linux is running

  • Enter "uname -a" to find the kernel version
  • Enter "cat /etc/redhat-release" to find what version of Red Hat® is being run

To Discover if Reporter has been running either in the background or the foreground 

  • Enter "jobs -l

The result of this command may show bcreporter running in the background but stopped:

 [1] + Stopped (user)      /opt/bc/reporter/bcreporter 

 NOTE: If you start Reporter in a terminal window (you used SSH to connect to the Linux server, and started it that way) and your terminate the connection, Reporter also stops.

To Place Reporter in the foreground

  • Enter "fg 1"
    This action  immediately starts Reporter and displays the login screen (to the same screen you are currently on)

 NOTE: You need to use the number of the process that the command "jobs" showed was stopped

To Place Reporter in the background

  • Enter "bg 1"
    This action restarts Reporter in the background

NOTE: If you start Reporter in a terminal window ( You used SSH to connect to the linux server, and started it that way) and you terminate the connection, Reporter will also stop.

To Discover how long the LINUX server has been up and running

  • Enter "uptime"

To Collect the Amount of Memory Available to the System 

  • Enter "cat  /proc/meminfo"

To Discover how much Disk Space is Available to Reporter 

  • Navigate to the opt/bc/reporter folder
    Enter "df  -h"

To Discover what binary dependencies there are for a LINUX program use the following command 

  • Navigate to where reporter is installed
    Enter "ldd bcreporter"

NOTE: If you start Reporter in a terminal window 

libpthread.so.0 => /lib64/libpthread.so.0 (0x00002ba56fc38000)

libdl.so.2 => /lib64/libdl.so.2 (0x00002ba56fe52000)

libstdc++.so.6 => /usr/lib64/libstdc++.so.6 (0x00002ba570056000)

libm.so.6 => /lib64/libm.so.6 (0x00002ba570357000) 

libgcc_s.so.1 => /lib64/libgcc_s.so.1 (0x00002ba5705da000)

libc.so.6 => /lib64/libc.so.6 (0x00002ba5707e8000) 

/lib64/ld-linux-x86-64.so.2 (0x00002ba56fa1c000)

To Discover if any other Reporter service is Running on your LINUX Server

  • Enter "ps -aux | grep reporter "

To Download the Latest Version of Reporter but don't have Access to the UI of the LINUX Server

Use the following wget command:

  1. Login into your web power account, and navigate to the reporter download links. 
  2. Copy and paste the link into your browser.
  3. SSH to your reporter LINUX server, and login.
  4. Enter "wget" <pasting your url here> and press return.
  5. The RPM downloads, but is saved as a filename that is similar to the end of the URL above (such as a number).
  6. Using the "mv" command , you can now rename the file to distinguish the downloaded file (for example: "Reporter_9.1.3.2_42002_linux64.rpm").
  7. You can now use this RPM file to install Reporter.

To Install and/or Upgrade Bluecoat Reporter

  • From any location enter rpm -Uhv Reporter_9*.rpm
    The action results in it being installed to /opt/bc/reporter

 NOTE: Ensure you have downloaded the correct Bluecoat RPM to your LINUX service prior to executing the step above. See the article at the end of this document for more details.

After installing, run the do-startup.sh script to configure the admin password, license and start Reporter. The upgrade starts the process automaticly.

To Uninstall Bluecoat Reporter

  1. From any location, enter rpm -e bcrep and press the tab button (to find the correct syntax)
  2. Navigate to the /opt/bc/reporter
  3. Enter "do-cleanup.sh"

NOTE: This action removes all the remaining folders.

To Discover more informtion about a particular library (such as the LDAP library)

  • Enter  "rpm -qfi /usr/lib/libldap.so" 

NOTE: Whenever you run a executable in LINUX, you need to prefix it with a './'  This ensures that LINUX finds the executable in the same folder that you are currently in, and run it.

To Discover the IP address(es) that the LINUX Server is Configured

  • Enter "ifconfig"

To Discover what TCP/UDP ports are listening on the Server

  • Enter "netstat -a"

NOTE: You can pipe this to the "grep" command to find Reporter.

How to tell if your Red Hat LINUX Server is 32-bit or 64-bit?

From the Terminal window, execute the following command:

  • Enter "cat /proc/cpuinfo

NOTE: At the bottom of the output you'll see flags. If the server is a 64-bit server, a lm flag is displayed.

cat /proc/cpuinfo
processor : 0
vendor_id : GenuineIntel
cpu family : 15
model : 4
model name : Intel(R) Xeon(TM) CPU 3.00GHz
stepping : 1
cpu MHz : 2793.136
cache size : 1024 KB
fdiv_bug : no
hlt_bug : no
f00f_bug : no
coma_bug : no
fpu : yes
fpu_exception : yes
cpuid level : 5
wp : yes
flags : fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov
pat pse36 clflush dts acpi mmx fxsr sse sse2 ss

Useful Find Command

TIP: If you need to find out where reporter is installed on LINUX, without using an RPM command, because it was not installed by RPMS, the following command is useful.

Navigate to the root of the file system and execute the following commands:

  • Enter [root@vm207 /]# find  -type d -name reporter

NOTE: Substituting -name for -iname in the above command makes the Find Command insentive to case

To find any file (such as the httpd.conf file), use the following command

  • Enter root@vm207 /]# find /  -name httpd.conf

NOTE:  Another artilce that focuses on the downlading of the RPM, and the install and upgrade of Reporter, can be found here 000010823


Additional Information
Bug Number
InQuira Doc IdFAQ273

Article Feedback

Hide Properties
First Published      10/01/2014
Last Modified      10/01/2014
Last Published      10/01/2014
Article Audience
Product      Reporter 8.3, Reporter 9.1
Topic      Configuration / WUI / CLI, Installation / Configuration, Operating System, Reporting
Article Number      000014647
Was this helpful?
Previous MonthNext Month