Isofax on Linux installation

4. Diva Drivers

http://servicessites.mckesson.com/clinicals/teams/technicalservices/HECTeamPage/Shared%20Documents/Isofax/Diva%20install%20file.zip

Installation is covered in step 9.

5. Run Create_3rd_party script in /u/isofax directory

>./Create_3rd_party

As root

> rm gs

>rm gsLib

rm: remove symbolic link `gsLib'? y

>rm imagemagick

rm: remove symbolic link `imagemagick'? y

cd /u/3rdparty//links

ln -s /usr/local/gs.8.56 gs

ln -s /usr/local/gs.8.56/share/ghostscript/8.56/lib gsLib

ln -s /usr/local/im5.5.4 imagemagick
You will have to do this for all , Live, Train, and Qa.
7. Request an Isofax license

Executing the script above you provide you with the information you need to request a license from Bristol Group. Email pete@isofax.com with the client information and the output from the above. Once you have obtained a license, replace the contents of /u/Isofax/bristol_licenses with the contents of the license received back from Bristol Group.

Run setupHc and add Fax

Distribute fax with hec and the leveler for hclive/hctrain/hcqa

Then do a startsrv -a on the isofaxing brick

/home/oracle:(live1)$ . oraenv

User altered.

SQL> exit

While you are here, make sure you can then login to the database as the inf_aq user:

/home/oracle:(train1)$ sqlplus inf_aq/qmanager

If you get an invalid username/password error, execute the following to reset the password:

/home/oracle:(train1)$ sqlplus "/ as sysdba"
SQL> alter user inf_aq identified by qmanager;

User altered.

**NOTE: If the server was staged as a RHEL 4.x+ server, by default the Create_3^rd_party script above will attempt to build and install these drivers so this step can be skipped. Continue with step 11**.

Once it is up, as root, do a “tail –f /var/log/messages”. Have someone connect the modem(s) one by one watching the log file for the tty name it assigns to the modem. Below is an example of what to expect in the log.

Oct 14 09:26:19 hecform01 kernel: usb 3-2: new full speed USB device using address 4

Oct 14 09:26:20 hecform01 kernel: usb 3-2: configuration #1 chosen from 2 choices

Oct 14 09:26:20 hecform01 kernel: ti_usb_3410_5052 3-2:1.0: TI USB 3410 1 port adapter converter detected

Oct 14 09:26:20 hecform01 kernel: ti_usb_3410_5052: probe of 3-2:1.0 failed with error -5

Oct 14 09:26:20 hecform01 usb.agent[1378]: Keeping default configuration with /sys//devices/pci0000:00/0000:00:1d.1/usb3/3-2

Oct 14 09:26:20 hecform01 kernel: ti_usb_3410_5052 3-2:2.0: TI USB 3410 1 port adapter converter detected

Oct 14 09:26:20 hecform01 kernel: usb 3-2: TI USB 3410 1 port adapter converter now attached to ttyUSB0
11. Configure MODEM.info

Add the device to file /u/isofax/MODEMS.info If you have more then one modem, you will need to add these two lines for each modem and update the ACMD# appropriately. NOTE: If your brick is at Redhat ES Release 3 then the tty id’s might be something like “ttyTIUSB#”.

# MODEMS.info -- modem and serial port declaration/configuration

       speaker_on  = always           # To hear dialtone, etc.

speaker_on = off # To hear dialtone, etc.

# modem_type = dialogic

usage=isofax_o

[/dev/ttyds01] # Device declaration, can be full path

speaker_on = always # To hear dialtone, etc.

#

[/dev/ttyds02] # Device declaration, can be full path

#
12. Replace the isofax file in /etc/init.d

The isofax file in /etc/init.d used to start isofax via “service isofax start” is bad. Replace the one from the gz tar file with this one below. Open the file and copy/paste it into the existing isofax file in that directory, replacing the contents in the file that are there. Make sure it has the correct permissions below.
-rwxr-xr-x 1 root root 7188 Sep 16 13:44 /etc/init.d/isofax

chmod 775 filename


13. Edit /etc/init.d/isofax to include the device names

If your device name is different than the one in bold below, change it to match you device anme. You have to edit the isofax file in /etc/init.d to include them to change permissions on the device files as they are recreated everytime the server is rebooted and the permissions are reset. The isofax script, when isofax is started, changes the permissions to 666 for these device files.

if [ -c /dev/ttyACM01 ]; then

echo "Changing Permissions on modem device files /dev/ttyACM*"

chmod 666 /dev/ttyACM*

fi

At this point you should be able to start isofax and see the modems with the ./view_server_status command.

Starting and stopping the isofax services can be done either logged on as root or isofax.

• 
  service isofax start
  
• 
  service isofax stop
  

As isofax, to start and stop Isofax enter.

• 
  sudo service isofax start
  
• 
  sudo service isofax stop
  

As ISOFAX, edit the file called run_ps_interp in the Isofax home directory. Copy/Paste the below example in blue letters to your site replacing what is in the file.

# This version should be renamed run_ps_interp and stored in $ISOFAXHOME

#echo "$1 is file name, $2, $3 are DPI's"

SCCS_ID="@(#)run_ps_interp.ibm 9.01.2.0.0 07/26/99 14:48:23"

## curr_dir=`/usr/bin/dirname $0`

## cd $curr_dir/ps_interp_alt

###############################################################################

#### Edit the following lines to use ghostscript version 5.10 or higher ######

###############################################################################

cd /u/3rdparty/live/links/gs/bin

GS_LIB=/u/3rdparty/live/links/gs/share/ghostscript/fonts

export GS_LIB

###############################################################################

./gs -q -dNOPAUSE -sDEVICE=pbmraw -r$2x$3 -sOUTPUTFILE=$1.p%03d $1 > /tmp/psi_out.$$ -c quit

ret=$?

if [ "$ret" != "0" ]

exit 1 # this error occurred before gs was run

else

result=`/bin/egrep Error /tmp/psi_out.$$`

then

exit $$ # this error occurred in gs

else

/bin/rm -rf /tmp/psi_out.$$ # won't be needing debugging file

fi

So make sure you have the lines in blue and the permissions match the above example. You can simply copy the above example of the entire run_ps_interp file and paste it into the Isofax home dir. Then change the permissions on this new file chmod 777 run_ps_interp

On the next page there is an example of what needs to be changed.

This is the config file that used at Isofax server startup. It's

referenced as the FAXD_CONF environment variable in the

isofax.init.d startup script.
It has required settings for the McKesson faxing infrastructure.
Other settings are optional and should be configured to suit

customer needs.

'9,' where the comma is a delay value. It's most commonly

used for dialing 9 to get an outside line
dial_one_first: If a 10 digit number is specified it will prepend

a '1' to make it a long distance call. You don't need to put

the '1' in your fax number database. The default is 'YES'.
dial_substitutes: replaces any string with another before dialing

a number. Multiple substitutions may be specified separated by

colons. A substitution rule are 2 strings separated by

whitespace, and a trailing ':'.

There is a special setting to prevent certain area

codes from having the '1' pre-pended. This supports local

areas with different area codes.
Ex: dial_substitutes=651 o651:952 o952:763 o763:612 o612

Numbers with area codes 651, 952, 763, and 612 will not

have the '1' prepended.
Ex: dial_substitutes=415 :

Numbers with the 415 area code are dialed as local numbers

without the area code. Because the substitutions are

performed before the dial_one_first is applied, no 415

area codes would have a '1' prepended.
16. conf.mckesson located in $ISOFAXHOME/mckesson/config

This file needs updating, here’s an example of the variables that need changing in blue.

Any time you make a change to this conf.mckesson file you’ll need to bounce Isofax by using the ./Isofax.init.d stop/start cmnds. NOTE: retries should always be set to zero (see KB 50835).
###########################################################################

### The McKesson faxing infrastructure requires the following settings ####

###########################################################################

retry_interval=5

retry_nonfax_calls=NEVER # McKesson software handles the retries

delete_after=1

retries=0

success_fail_script=$ISOFAXHOME/mckesson/bin/isofax_notify

### $ISOFAXHOME, $JRE_HOME and $INFRA_HOME must be setup in the IsoFax

### start-up script $ISOFAXHOME/mckesson/bin/isofax.init.d

###########################################################################
###########################################################################

########## The settings below may be modified to suit your needs ##########

###########################################################################

dial_prefix=9,

##dial_one_first=YES

dial_one=YES

### Don't pre-pend numbers with a '1' if for the local area codes listed below

dial_substitutes=612 o612:952 o952:763 o763:

max_modem_log=1 # No logging of modem usage

max_exception_log=1 # Keep only 1 MB of exceptions (minimum amt)

max_history_log=-1 # No history logging (archive doesn't grow indefinitely)

use_faxinbox=NO

header_string="\d My Hospital Name Fax# 611-954-9601 Page \p of \P"

local_fax_number="611-954-6900"

Rename the file in the home directory of Isofax to eliminate unneeded fax_log warnings.

mv $ISOFAXHOME/parse_log_pl $ISOFAXHOME/parse_log.orig

See kbase article 8679 for more information.

If you try to send a fax and get this popup: An unexpected error occurred while sending fax request; fax not sent! Please contact your site administrator.

2008-07-23 11:43:03,137 ERROR [STDERR] oracle.jms.AQjmsException: JMS-190: Queue queue_user.sendFax not found

Sign on to SQLPLUS as username of queue_user and pswd of qmanager

Then run this SQL statement:
select object_name, object_type from user_objects where object_name like '%ORM%' order by object_name;

Then a good result would be:

Then if you don’t see this result you’ll need to use the rebuild_ag.tar ball to create the proper tables and queues under the Queue_User schema.

You can find it at this link:

http://servicessites.mckesson.com/clinicals/teams/technicalservices/HECTeamPage/Shared%20Documents/Isofax/rebuild_aq.tar

Sign on to SQLPLUS as username of queue_user and pswd of qmanager

Then run this SQL statement:

select name, enqueue_enabled, dequeue_enabled from user_queues order by name;

ACKFAX YES YES

ERROR YES YES

MAKEHTML YES YES

MAKEPDF YES YES

ORM YES YES

RETURNPDF YES YES
If you don’t see YES YES then please do the following as queue_user in both local Live and local Train
hci:ccuser[live]/u/live> sqlplus queue_user/qmanager

SQL> exec dbms_aqadm.start_queue(queue_name => 'SENDFAX');

 PL/SQL procedure successfully completed.

SQL> exec dbms_aqadm.start_queue(queue_name => 'ACKFAX');

 PL/SQL procedure successfully completed.

 SQL> select NAME,ENQUEUE_ENABLED,DEQUEUE_ENABLED from user_queues order by NAME; 

You need to see YES YES for the following table names

------------------------------ ------- -------

ACKFAX YES YES

RETURNPDF YES YES

ORM YES YES

MAKEPDF YES YES

MAKEHTML YES YES

ERROR YES YES

SENDFAX YES YES
sqlplus queue_user/qmanager

select name, enqueue_enabled, dequeue_enabled from user_queues

where name in('SENDFAX', 'ERROR', 'MAKEHTML', 'MAKEPDF', 'ORM',

'RETURNPDF', 'ACKFAX');

exec dbms_aqadm.start_queue(queue_name => 'SENDFAX');

exec dbms_aqadm.start_queue(queue_name => 'ERROR');

exec dbms_aqadm.start_queue(queue_name => 'MAKEHTML');

exec dbms_aqadm.start_queue(queue_name => 'MAKEPDF');

exec dbms_aqadm.start_queue(queue_name => 'ORM');

exec dbms_aqadm.start_queue(queue_name => 'RETURNPDF');

exec dbms_aqadm.start_queue(queue_name => 'ACKFAX');

Here are the contents of /u/isofax/.bash_profile.  If the red lines are missing you’ll have to add them. Otherwise you’ll get an error saying ‘invalid fax file’.

# Get the aliases and functions

if [ -f ~/.bashrc ]; then

        . ~/.bashrc

fi

# User specific environment and startup programs

export PATH

unset USERNAME


21. Starting and Stopping Isofax Services

Starting and stopping the isofax services can be done either logged on as root or isofax.

• 
  service isofax start
  
• 
  service isofax stop
  

As isofax, to start and stop Isofax enter.

• 
  sudo service isofax start
  
• 
  sudo service isofax stop
  

Changes you need to make to the web.xml  file as hctrain user.  -AFTER every distribute  (done by the hcdist user)

After making this change you’ll need to bounce fax service as hctrain user stopsrv/startsrv. if faxes remain in a Pending status, it’s a good bet this web.xml isn’t setup right. And you’ll also need to check the permissions on the ACKFAX table as well, if ACKFAX isn’t YES YES the faxes will remain in pending status. REMEMBER: You have to do this for LIVE and QA as well.
hctrain-stlukecm-fax $ ll

/u/hctrain/apps/fax/jboss-deploy/fax.war/WEB-INF

total 10

drwxr-xr-x   2 hctrain    hc            1024 Feb 20 16:44 lib

-rw-r--r--   1 hctrain    hc            3930 Feb 20 16:52 web.xml

hctrain-stlukecm-fax $ vi web.xml

    PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN"

    "http://java.sun.com/j2ee/dtds/web-app_2_2.dtd">

    fax.war

Changes to bootstrap.prop  file as the hctrain user    -AFTER every time a distribute happens (by the hcdist user)   You’ll need to change the makePdf to true.

After making this change you’ll need to bounce fax service as hctrain user stopsrv/startsrv.

REMEMBER: You have to do this for LIVE and QA as well.

/u/hctrain/apps/fax/var/config

total 10

-rw-r--r--   1 hctrain    hc            1209 Feb 20 16:51 bootstrap.prop

-rw-r--r--   1 hctrain    hc            1963 Feb 20 16:42 jboss.conf

-rw-r--r--   1 hctrain    hc             122 Feb 20 16:42 srv.conf

hctrain-stlukecm-fax $ vi bootstrap.prop
# Specify the location of the logging config file resource

com.mckesson.common.logging.config=com.mckesson.common.log.logging.config

com.mckesson.common.jms.service.sendFax.active=true

com.mckesson.common.fax.isofax.path=/u/isofax
com.mckesson.common.sql.ConnectionPool.url=jdbc:oracle:thin:@//pcare1.irmh.org:1521/train.world

com.mckesson.common.sql.ConnectionPoolManager.defaultPool=train

com.mckesson.common.sql.ConnectionPool.aq.user=queue_user

com.mckesson.common.sql.ConnectionPool.aq.password=qmanager
## Required for CLIA or Rx

com.mckesson.common.jms.service.makePdf.active=true

com.mckesson.common.html2pdf.directory.ghostscript=/u/3rdparty/train/links/gs/bin

com.mckesson.common.html2pdf.directory.ghostscript.gs_lib=/u/3rdparty/train/links/gs/share/ghostscript/8.56/lib:/u/3rdparty/train/links/gs/share/ghostscript/8.56/lib

com.mckesson.common.html2pdf.directory.ps2pdf=/u/3rdparty/train/links/gs/bin

com.mckesson.common.html2pdf.directory.pdf2ps=/u/3rdparty/train/links/gs/bin

com.mckesson.common.html2pdf.directory.imagemagick=/u/3rdparty/train/links/imagemagick/bin

log on as isofax

to send fax: ./sendfax FIRST_FAX
To view modem status

log on as isofax

enter: ./view_server_info (this will continually refresh)
Line Model Usage Status

---- ----- ----- ------

/dev/tty0 Multitech SEND/REC MODEM OK: IDLE
To watch log

log on as isofax

cd work

tail -f fax_log