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

FAQ ID:    FAQ273
Version:    17.0
Status:    Published
Published date:    07/27/2009
Updated:    05/23/2011


1: To start and stop Reporter:

 Navigate to the /etc/init.d folder and type

  • "./bcreporter start" to start it.
  •  "./bcreporter stop" to stop it.

 2: To start Reporter from within a terminal window, navigate to the /op/bc/reporter directory and type

  • "./bcreporter"

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

  • "nohup bcreporter"

 3: To find out if Reporter is running on the server:

Navigate to the /etc/init.d folder and type

  • "./bcreporter status"

 4: To find out if Reporter is installed on the server.

Navigate to the /opt/bc/reporter folder and look for the binary of reporter.

From any folder type in "RPM -qa | grep reporter"

 5: To display a journal file on the terminal screen.

Navigate to /opt/bc/reporter/journal/ and type.  In some versions, this journal file is found in the installed root folder.

  • "cat jour"  and then the tab key.  This will list out all the journals to the display.

 6: To navigate around the file system:

  • Type "cd" to change directories.
  • Type "pwd" to find out where in the filesytem you are.

For a directory listing type "ls -l "

 7: To find out what version of Linux is running:

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

 8: To find out if Reporter has somehow been running in the background or the foreground:

  • Type "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 will stop as indicated in item #2 above.

 9: To place Reporter in the foreground ( to fix the issue mentioned in item #8)  type.

  • Type "fg 1"

This will immediately start reporter and display the logging to the same screen you are on.

NOTE: You need to use the number of the process that the command "jobs" showed was stopped- see item #8 above.

10: To place reporter in the background (to fix the issue mentioned in item #8) type.

  • Type "bg 1"

This will restart Reporter in 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 stop as per the above.

11: To find out how long this LINUX server has been up:

  • Type "uptime". 

12: To collect the amount of memory available to the system:

  • Type "cat  /proc/meminfo"

13: To find out how much disk space is available to reporter:

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

 14: To find out what binary dependencies there are for a LINUX program you use this command.

  • Navigate to where reporter is installed and type "ldd bcreporter"

 You should see an output such as this:

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)

  14: To find out if any other reporter service is running on your linux server do this.

  •  Type "ps -aux | grep reporter "

 15: If you don't have access to the User interface of the LINUX server, and need to download the latest version of Reporter , you can use the wget command.  Here's a step by step guide on how to do this.

  • Login into your web power account, and navigate to the reporter download links. 

  • Here, you should be given the opportunity to cut and past the link into your browser.

    • SSH to your reporter linux server, and login.

      • type wget <pasting your url here> and press return.

      • The RPM should download, but be saved as a filename that is similar to the end of the URL above- in other words, a number.

      • Using the "mv" command , you can now rename the file to something like "Reporter_9.1.3.2_42002_linux64.rpm"

    • You can now use this RPM file to install Reporter.

  16: To install and/or upgrade Bluecoat reporter type this command from any location.

  • TIP : Ensure you have download the correct Bluecoat RPM to your linux service, prior to executing this step. See the article at the end of this document for more details.
  • rpm -Uhv Reporter_9*.rpm

Note: This will result in it being installed to /opt/bc/reporter.

After the install , you need to run the do-startup.sh script to configure the admin password, license and start reporter. The upgrade will start the process automaticly.

 17: To un-install Reporter type this command from any location.

  • rpm -e bcrep and then press tab to find the right syntax.

    After this, navigate to the /opt/bc/reporter and type

  • do-cleanup.sh

Note: this will remove all the remaining folders left.

 18: to find out more information about a particular library, such as the LDAP library type

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

NOTE: Whenever you run a executable in Linux, you need to prefix it with a './'  This is so it will find the executable in that same folder you are currently in, and run it.


19: To find out the ip address(s) that the LINUX server is configured for type.

  • ifconfig

 20: To find out what TCP/UDP ports are listening on the server type.

  • netstat -a

NOTE: you can pipe this to the 'grep' comand to find reporter.


21: How can I tell if my Red Hat Linux server is 32 bit or 64 bit?

  • Execute the command cat /proc/cpuinfo from a terminal window. At the bottom of the output will be a bunch of flags. If its 64 bit you will see a lm flag.

Here's an example:
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

22: If you need to find out where reporter is installed on LINUX, without using an RPM command, because it was not installed by RPMS, here's a usefull find command.

Nagivate to the root of the filesystem, and execute the below command.

  • [root@vm207 /]# find  -type d -name reporter
  • substuting -name for -iname in the above command makes the find insentive to case
  • to find any file, such as the httpd.conf file, use this command 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 FAQ240

Rate this Page

Please take a moment to complete this form to help us better serve you.

Did this document help answer your question?
If you are finished providing feedback, please click the RATE CONTENT button. Otherwise, please add more detail in the following text box and then click RATE CONTENT.

Your response will be used to improve our document content.

Ask a Question