Unity IP Fax Service and IOS Configuration

jmujica · ‎07-27-2004

Hi.

I would like to test the IP Fax Service on Unity. Is there a sample configuration or does anyone has a good configuration in order for the router to handle inbound faxes and generate and email with the fax attached to it.

I'll be using a Cisco 2600 Router running 12.3(7) with an FXO port and Unity 4.0(4)

Thanks in advanced,

-Jose

Markus Schneider · ‎07-28-2004

Were you just interested in inbound or both inbound and outbound faxing? For inbound, a single FXO port might not work. Officially, it needs to be an interface that supplies DNIS (dialed number) to be supported. Why? The reason is that when the call comes in, there is a command that is required (mta send with-subject $d$), which will take the DNIS information supplied when the call comes in and then places it in the subject of the mail message that is sent to the fax account. So if there's no DNIS, then there's no subject with the destination fax number in the subject and therefore there's no way for the fax service to deliver the message to the correct fax mailbox. Having said that, it MAY be possible with either an answer-address on the inbound voip dial-peer or translation rules or something to force a called number, but it's currently not supported (for my part, at least, I haven't spent any time on it). Another option would be to try it without any of that and see if the fax service will send it to what you configure the "undeliverable" location (within the fax service documentation. See: http://www.ciscounitytools.com/HelpFiles/IPFax/IPFHelp_ENU.htm).

Those disclaimers above aside, if you still want to try this; for starters, take a look at the general gateway documentation here:

http://www.cisco.com/en/US/partner/products/sw/iosswrel/ps1839/products_feature_guide_chapter09186a00800b5dcf.html

For inbound (from PSTN towards Unity), it's pretty simple. This is known as On-Ramp in the IOS documentation. You'll need to follow the mandatory tasks described above (tasks 1-3). Be sure to take a look at the 'minimum configuration tasks' link for on-ramp.

The only deviation from that is that for Unity, we'll need to have:

mta send with-subject $d$ (or both)

mta send server

on the mmoip dial-peer, use:

session target mailto:faxacct@xyz.com (which will be the fax account).

For the FXO, if it were me, I'd start by configuring a plar to the destination pattern in the mmoip peer. Make sure you have a pots dial-peer that has the (fxo) port configured under it and you may have to play with using/not using direct-inward-dial (i would start with it off).

jmujica · ‎07-28-2004

Thanks for the information.

I have a doubt in the IOS configuration.. In the link you sent me the 2nd task shows an application fax_on_vfc_onramp_app on the dia-peer voice mmoip but that application is not on my 26xx router when I invoke the "show call application voice summary". What application should I placed there?

I have in my router the "app_faxmail_onramp.2.0.1.3.tcl" script in flash and I'm using that one in the pots dial-peer.. Should I use the same script in the mmoip dial-peer??

TIA,

-Jose

Markus Schneider · ‎07-28-2004

Yeah, I'm not real fond of that config piece either. Here's another one that may be a bit more helpful.

http://www.cisco.com/en/US/tech/tk652/tk777/technologies_tech_note09186a00801fe5d9.shtml

You have to have an application defined on both the pots peer and the MMOIP peer. On the mmoip peer it'll be "application fax_on_vfc_onramp_app out-bound" and on the pots peer it'll be whatever you've defined the call application that you've loaded into flash (usually "onramp" or something like that). The fax_on_vfc_onramp_app should already be there (sh call app voice sum).

We're working on a tech tip specific to unity, but, of course, it won't include FXO interfaces.

You can download the TCL files into flash from here:

http://www.cisco.com/cgi-bin/tablebuild.pl/tclware

2.0.1.3 is the latest released one, so I'd go with that.

jmujica · ‎07-30-2004

marschne,

Thanks for all your help. I got the FAX-to-Mail working using an FXO port on a Cisco 2600XM router. Do you know Luis Flores (Guichi) from Cisco in RTP? He was in Puerto Rico and he helped me in getting the fax-to-mail working. We used a voice-translation within the fxo port in order to change de NULL DNIS with a real number in order for the on-ramp application to work as desire. Everything works as expected. Below the partial configuration we used:

!

voice translation-rule 1

rule 1 /^$/ /7777/

!

voice translation-profile DNIS-Replace

translate called 1

!

ip domain name test.com

ip name-server x.x.x.x

!

fax interface-type fax-mail

mta send server x.x.x.x port 25

mta send with-subject both

mta send filename both

mta send postmaster jdoe@test.com

!

call application voice onramp-fax flash://app_faxmail_onramp.2.0.1.3.tcl

!

voice-port 1/0/2

translation-profile incoming DNIS-Replace

supervisory disconnect dualtone mid-call

timeouts interdigit 2

timeouts call-disconnect 2

timeouts wait-release 2

caller-id enable

!

dial-peer voice 26 mmoip

application fax_on_vfc_onramp_app out-bound

destination-pattern 7777

information-type fax

session target mailto:inboundfax@test.com

!

dial-peer voice 25 pots

application onramp-fax

incoming called-number 7777

direct-inward-dial

port 1/0/2

!

Markus Schneider · ‎07-30-2004

Great! I figured it would be possible, this is definitely good to know. Thanks for the posting the results.

PS--yeah, I know Guichi, he's actually in the same team as I am here in RTP.

jmujica · ‎08-02-2004

marschne,

Now that I already have the fax-to-mail working. I configured the Unity IP Fax Service but it is not working as desire.

Below are the logs from the CommServer/log directory related to IPFax Service.

-----

Processing inbox, message count= 1"

"2004-08-02","17:27:29","Message delivered: Fax for test, mailbox ID [ 7777 ] from [ 1111 ] -- Subject= [DNIS=7777][ANI=1111]"

"2004-08-02","17:27:29","Caught COM exception trying to resolve recipient test - Code: 0x800406f7. Method: CIpFaxCdoHelper::ForwardMessage. [IpFaxMessageHelper.cpp::2118]"

"2004-08-02","17:27:29","Caught exception - Code: 0x800445ed. Method: CIpFaxCdoHelper::ForwardMessage. [IpFaxMessageHelper.cpp::2139]"

"2004-08-02","17:27:29","ForwardMessage() failed - Code: 0x800445ed. Method: CIpFaxCdoHelper::ForwardCurrentMessage. [IpFaxMessageHelper.cpp::1940]"

"2004-08-02","17:27:29","ForwardCurrentMessage() failed - Code: 0x800445ed. Method: CIpFaxCdoHelper::ProcessFaxInbox. [IpFaxMessageHelper.cpp::416]"

Hope you can find the problem..

Thanks in advanced,

-Jose

Markus Schneider · ‎08-03-2004

Just to be sure, are you running 2.0.0.17 version of the tool? If not, grab the latest from CiscoUnitytools.com.

jmujica · ‎08-03-2004

That is the one I'm using at the moment.. v2.0.0.17

Please let me know if fou found anything..

TIA,

-Jose

jmujica · ‎08-04-2004

Does anyone have seen the errors already posted here before??

I'm trying to figure out what is causing the problem.

Any help would be welcome.

Later,

-Jose

Markus Schneider · ‎08-05-2004

Sorry, unfortunately the guy who wrote the tool is out until monday. I'll try to see if he has a second to take a look then, if no one replies until then with ideas. Can you just make sure that the subscriber (test) can send/receive voice messages? It looks like the tool is having problems finding him, and the error codes look a lot like MAPI ones, so I'm suspecting something along those lines.

jmujica · ‎08-06-2004

marschne,

The "test" subscriber can send/receive voice messages without problems but the IP FAX Service is unable to send the fax to the right recipient.

If you found something please let me know.

-Jose

Markus Schneider · ‎08-12-2004

Hi Jose,

one more question. We need to find out which version of CDO you're using (it might not be the one that it was supposed to use when the tool was installed). You can download the process explorer from www.sysinternals.com. Then click on Find DLL. Enter CDO.DLL. It should list CsIPfaxSvc.exe. Double-click on that and then on the bottom window, on the right it will show you the version (right-click and properties should show you that it's using the one in the ipfaxconfig folder).

jmujica · ‎08-27-2004

I'm still having the same problem. I already installed 2.0.0.17 version of the IP FAX Configuration Wizard. Below is the log file info:

"2004-08-27","16:59:39","CIpFaxInboundRouter::MonThreadProc() start"

"2004-08-27","16:59:40","Logging on to mailbox [LABEXCHANGE-DC\inboundfax]"

"2004-08-27","16:59:40","Processing inbox, message count= 1"

"2004-08-27","16:59:40","Message delivered: Fax for jmujica, mailbox ID [ 7777 ] from [ 7872530394 ] -- Subject= [DNIS=7777][ANI=7872530394]"

"2004-08-27","16:59:40","Caught COM exception trying to resolve recipient jmujica - Code: 0x800406f7. Method: CIpFaxCdoHelper::ForwardMessage. [IpFaxMessageHelper.cpp::2118]"

"2004-08-27","16:59:40","Caught exception - Code: 0x800445ed. Method: CIpFaxCdoHelper::ForwardMessage. [IpFaxMessageHelper.cpp::2139]"

"2004-08-27","16:59:40","ForwardMessage() failed - Code: 0x800445ed. Method: CIpFaxCdoHelper::ForwardCurrentMessage. [IpFaxMessageHelper.cpp::1940]"

"2004-08-27","16:59:40","ForwardCurrentMessage() failed - Code: 0x800445ed. Method: CIpFaxCdoHelper::ProcessFaxInbox. [IpFaxMessageHelper.cpp::416]"

jmujica · ‎08-28-2004

Ok. IT is working now. The problem was on the exchange side. The application is working as expected ..at least the inbound option. Now to test the outbound option..

Is there any whitepaper or sample config for the Outbound FAX Configuration on Unity and also on the Cisco Router?

TIA,

-Jose