Lucent Technologies Octel 100 Implementation And Service Manual

							19. Installing and Configuring Visual Mailbox
Implementation and Service ManualInstalling the Voice Fax Server19-19
19.  If you selected Netware in step 17, enter the following information under Nov ell
NetW are Serv er Setup:
· Server Name – Enter the name of the LAN serv er where the \VMBOX
directory is located. The LAN Administrator entered this information in step 1
of the Nov ell NetW are Configuration W orksheet.
· Login Acct Name – Enter VFS_ACCT
, the account name the LAN
Administrator was instructed to assign to the account.
· Login Acct Pass – Enter VMBOX
, the password the LAN Administrator was
instructed to assign to the VFS_ACCT account.
· Mapping – Enter the v olume where Visual Mailbox is installed. The LAN
Administrator entered this information in step 2 of the Nov ell NetW are
Configuration W orksheet.
  If you selected Peer OS/2 in step 17 and the LAN is using NetBIOS/NETBUIE, enter
the following information under W indows NT Serv er Setup:
· Domain Name – Enter the name of the domain to which the Voice Fax
Serv er PC is assigned. The LAN Administrator entered this information in
step 1 of the W indows NT Configuration W orksheet.
· User ID – Enter VFS_ACCT
, the name the LAN Administrator was instructed
to assign to the account.
· Login Pass – Enter VMBOX
, the password the LAN Administrator was
instructed to assign to the VFS_ACCT account.
· NT Network Name – Enter the NT Serv er name and the name of the share
assigned to the \VISMAIL directory (\\\). The
LAN Administrator entered this information in step 2 of the W indows NT
Configuration W orksheet.
  If you selected Peer OS/2 in step 17 and the LAN is using NetBIOS ov er TCP/IP,
enter the following information under W indows NT Serv er Setup:
· Domain Name – Check step 9 of the W indows NT Configuration W orksheet
to determine whether the account for the VFS was created in the domain. If
the account for the VFS was not created in the domain (No was circled in
step 9 of the W indows NT W orksheet), leav e this field blank. If the account
for the VFS was created in the domain (Yes was circled in step 9 of the
W indows NT Configuration W orksheet), enter the name of the domain to
which the Voice Fax Serv er PC is assigned. The LAN Administrator entered
this information in step 1 of the W indows NT Configuration W orksheet.
· User ID – Enter VFS_ACCT
, the name the LAN Administrator was instructed
to assign to the account.
· Login Pass – Enter VMBOX
, the password the LAN Administrator was
instructed to assign to the VFS_ACCT account.
· NT Network Name – Enter the NT Serv er name and the name of the share
assigned to the \VISMAIL directory (\\\). The
LAN Administrator entered this information in step 2 of the W indows NT
Configuration W orksheet.
20.  To sav e the entered information, click Continue. These parameters are also
accessible through the Serv er tab in System Setup. By accessing the parameters in
System Setup, you can change them later without running the Visual Mailbox
installation program again. 
						

							19. Installing and Configuring Visual Mailbox
Implementation and Service ManualInstalling the Voice Fax Server19-20
21.  If you are installing Visual Mailbox in an NT Serv er implementation, skip to step 24.
If you are installing Visual Mailbox in a Nov ell NetW are implementation, when the
necessary files hav e been copied, the Path for NET.CFG dialog box displays. This
dialog box allows you to v erify the NET.CFG file to be updated by the system.
  If the system cannot locate a NET.CFG file, a dialog box displays to notify you that
the system automatically creates a NET.CFG file and places it in the root directory
of the C:\ driv e. Click OK to continue.
22.  If the system locates more than one NET.CFG file, you must specify the file to be
updated by the system. To specify the NET.CFG file, click the arrow button to the
right of the field and then select the correct NET.CFG file from the displayed list.
The field on the right displays the path of the selected NET.CFG file.
23.  Click Continue. A dialog box displays notifying you that the system modified the
NET.CFG file.
24.  Click OK. The Visual Mailbox Serv er Installation Completion dialog box displays.
25.  Click Exit to return to the OS/2 desktop.
26. Type EXIT 
then press  to close the OS/2 window.
27.  Remov e the CD-ROM.
28.  Shut down the PC:
a.  Click the right mouse button on an empty area of the OS/2 desktop and select
Shut down from the menu that displays.
b.  W hen you are prompted whether you want to close all windows and activ e
programs, click OK.
c.  When prompted to shut down or reboot, press  to reboot the
PC.
29.  As the Voice Fax Serv er PC boots, v erify that it is logged into the network and that
the system and the Voice Fax Serv er load.
30.  To v erify that the Voice Fax Serv er software was properly installed:
a.  Once the messaging system software completely loads and the hard driv e stops
showing signs or activ ity, press  to display the W indow List.
b.  Double-click VFSLOG in the list. The VFS Log utility displays.
c. Use the scroll bars to scroll to the end of the file. If the messages “Updating
system directory lists” and “System directory lists complete” display, the Voice
Fax Serv er has been properly installed. If these messages do not appear in the
log file, contact a technical support representativ e.
d.
  W hen you finish v iewing the file, minimize the window. 
						

							19. Installing and Configuring Visual Mailbox
Implementation and Service ManualConfiguring the Messaging System Software19-21
If the Voice Fax Serv er does not load when you restart the PC, use the following
procedure to attempt to manually load the software.
To attempt to manually load the software if the Voice Fax Server does not load:
1.  Open an OS/2 window.
2.  From the \CVR directory prompt, type START VFSLOG 
and press . This
command manually loads the Voice Fax Serv er’s log utility, which monitors Voice
Fax Server activity.
3.  From the \CVR directory prompt, type VFS 
and press .
Configuring the Messaging System Software
To configure Visual Mailbox to function properly on the messaging system:
1.  For each subscriber who will be using the visual interface, modify the Class of
Serv ice to permit Visual Mailbox access. You can edit each of the defined or custom
classes of serv ice to enable this feature for each subscriber. See Chapter 16,
“Managing System Mailboxes,” for information on creating and modifying subscriber
classes of  serv ice.
2.  Verify that the parameter settings on the Serv er tab in System Setup match the
settings you entered during Voice Fax Serv er installation. For information on running
the System Setup utility, see Chapter 13, “Setting Up the System.”
3.  Ensure that at least one port is enabled for Applications on the Port Parameters tab
in System Setup. Otherwise, the Voice Fax Serv er cannot access system ports to
use them with Visual Mailbox. See Chapter 13, “Setting Up the System,” for
information on running the Setup utility.
4.  There are two parameters, accessible on the Switch Settings tab in the Integrator
utility and on the Call Transfer tab in System Setup; these allow subscribers to use
the Dialer and Immediate Call features of Visual Mailbox:
· Third-Party Transfer (Start) Code (called Vis. Mail Conf. Hold in System
Setup) – Enables the Voice Fax Serv er to place the subscriber’s desktop
extension on hold when performing an unsuperv ised transfer using the
Dialer or Immediate Call.
· Third-Party Transfer (End) Code (called Vis. Mail Conf. Cancel in System
Setup) – Releases the Voice Fax Serv er from the conference after the
transfer is initiated.
Most switches use the messaging system default of an ampersand (flash hook) for
these parameters. In this case, the fields are blank. If the customer’s switch is
supported by the Integrator utility and it requires a code other than an ampersand for
these parameters, the required code is automatically specified when you run the
Integrator utility during messaging system installation. See Chapter 7, “Integrating
with the Phone System,” for information on the Integrator utility.
5.  Departmental directories are av ailable to all Visual Mailbox users, based on Div ision
field specifications made on each Mailbox Entry dialog box. A directory is
automatically created for each Div ision that has been defined. See Chapter 16,
“Managing System Mailboxes,” for information on editing a mailbox. 
						

							19. Installing and Configuring Visual Mailbox
Implementation and Service ManualPerf orming Vis ual Mailbox Maintenanc e19-22
Once you are sure that the Voice Fax Serv er is running properly, disable the VFS Debug
Flag option on the Serv er tab in System Setup, which you enabled during Voice Fax
Serv er installation.
Performing Visual Mailbox Maintenance
This topic discusses Visual Mailbox maintenance, including v iewing the activ ity log file,
shutting down the Voice Fax Serv er, generating a listing and descriptions of Visual
Mailbox system files, modifying the VMXGATE.INI file, and troubleshooting networking
problems reported by Visual Mailbox users.
Viewing the Voice Fax Server Log File
W hen the Visual Mailbox Voice Fax Serv er program starts, the VFSLOG.EXE file
automatically launches. This Log utility, which runs in the background, records Voice Fax
Server activity.
To view the VFS log file:
1.  Press  to open the W indow List.
From the menu, select VFSLOG. The VFS Log utility displays. Use the scroll bars to
v iew the entire contents of the file. The maximum size of the VFS log file is 500K by
default; howev er, you can limit the file size.
Do not exit this window unless you want to shut down the VFS Log utility.
2.  W hen you finish v iewing the file, minimize the window.
To specify a maximum VFS log file size:
1.  From the VFS Log Utility window File menu, select Log File Settings. The Log File
Settings dialog box displays.
2.  In the field, enter the maximum size of the file, in kilobytes. The minimum is 500K;
the maximum is 9999K.
3.  Click OK. If the file reaches the maximum size, the system purges the oldest data in
the file.
Do not attempt to use VFS Log Utility menu options other than Log File Settings and
Shutdown VFS without consulting a technical support representativ e. 
						

							19. Installing and Configuring Visual Mailbox
Implementation and Service ManualPerf orming Vis ual Mailbox Maintenanc e19-23
Shutting Down and Restarting the Voice Fax Server
The Voice Fax Serv er is automatically shut down each time you exit the messaging
system. If you need to shut down the Voice Fax Serv er while the messaging system is
running (to upgrade the system, for example), you can exit it manually from the VFS Log
Utility window.
To shut down the Voice Fax Server manually:
1.  Press  to open the W indow List.
2.  From the menu, select VFSLOG. The VFS Log Utility displays.
3.  From the VFS Log Utility window Send Command menu, select Shutdown VFS. The
Voice Fax Serv er is shut down.
You can restart the Voice Fax Serv er manually, if the messaging system is already
running, by completing steps 1 through 3 in the procedure To attempt to manually load
the software if the Voice Fax Serv er does not load.
Visual Mailbox File System
Sev eral VFS and client software files are accessed and updated as Visual Mailbox runs.
Voice Fax Server Files
W hile the Voice Fax Serv er performs its messaging tasks, it accesses the following files
stored on the system:
· DIRECTRY.EXE – A utility for copying system personal distribution lists for use
in Visual Mailbox.
· OCAPI.DLL – A .DLL file for the system.
· PR2FILE.DLL – A file that receiv es POSTROOM information from the client
software on a LAN using the shared files protocol.
· RUNVFS.CMD – An OS/2 command file that starts the Voice Fax Serv er.
· SETUP.EXE – An executable file that installs the Voice Fax Serv er software.
· SETUP.INS – A script file containing installation instructions used during
installation of the Voice Fax Serv er.
· SLEEP.EXE – A utility that allows delays in OS/2 command scripts.
· VFS.EXE – The Voice Fax Serv er executable file.
· VFSLOG.EXE – A file that inv okes the Voice Fax Serv er graphical user
interface (GUI) and logging tool for troubleshooting.
· WAITVM.EXE – A utility for pausing OS/2 command scripts until the system is
running.
Client PC Files
W hile Visual Mailbox performs its messaging tasks for the user, it accesses the following
files:
· CLIENT.DLL – A file used during the installation procedure.
· CLIENT.INS – An installation file for the client software housed on the network. 
						

							19. Installing and Configuring Visual Mailbox
Implementation and Service ManualPerf orming Vis ual Mailbox Maintenanc e19-24
· IMGVIEW.EXE – An executable file that runs the Visual Fax feature.
· POST2.DLL – A file that directly communicates POSTROOM information from
the client PC to the serv er.
· POSTMAST.EXE – An executable file for POSTROOM error reporting.
· PR2FILE.DLL – A file used to communicate POSTROOM information on a LAN
using the shared files protocol.
· SETUP.EXE – An executable file that installs the Visual Mailbox client software.
· SETUP.INS – A script file containing installation instructions used when
installing client software to the LAN or client PC.
· THREED.VBX – A file containing graphical objects used to create Visual
Mailbox’s graphical application.
· VMXBMP.DLL – A file containing bitmaps for the graphical interface.
· VMXDESK.EXE – An executable file for the client software.
· VMXDESK.HLP – A help file for the client software.
· VMXDESK.INI – A client software setup file resident on the client PC hard driv e.
· VMXGATE.INI – A file allowing communication between the client PC and the
serv er.
· VMXLISTB.DLL – A file containing message list information in the Visual
Mailbox application.
Troubleshooting Visual Mailbox
The following guidelines are prov ided to aid in troubleshooting networking problems
reported by Visual Mailbox users.
Installation Errors
The following error may occur during installation:
All client PCs must be logged off before a reinstallation
W hen this error occurs, make sure all users are logged off Visual Mailbox. If no users
are logged on, check that the installer is logged on with Superv isor or Superv isor
Equiv alent rights. Re-install the software.
Visual Mailbox POSTROOM Errors
POSTROOM is the name for the networking lev el. Error messages referring to
POSTROOM are considered networking problems.
In the ev ent of a POSTROOM error, Visual Mailbox displays an error dialog box. The
dialog box includes an error name. To help solv e errors, ask users receiv ing
POSTROOM errors to write down the error message.
Connectivity Errors
The most common networking problems in a client/serv er application occur when
establishing a network connection between the client PC and serv er. The following error
messages indicate that a connection was not made:
·  “Serv er Could not be found – ” 
						

							19. Installing and Configuring Visual Mailbox
Implementation and Service ManualPerf orming Vis ual Mailbox Maintenanc e19-25
· “Inv alid Connection Handle Error”
·  “Cannot read file due to factor error – s2w.dat”
To correct these errors, check the following:
·  Ensure the Voice Fax Serv er application is running.
·  Ensure the serv er name in the VMXGATE.INI file matches the VFS serv er name
indicated on the Serv er tab in System Setup.
·  Ensure the user’s network driv e mapping is correct.
·  Ensure the messaging computer has the correct network driv e mapping.
·  Ensure the user’s desktop computer is on the same network as the messaging
system.
·  For systems running under the shared files protocol, ensure the serv er and client
PC hav e read, write, create, modify, and erase rights to the directory where the
S2W .DAT and W 2S.DAT files reside (by default, the \VMBOX\DATA directory).
Also ensure that the client PC and Voice Fax Serv er are connected to the
correct file server.
System Problem Errors
The following errors are due to hardware problems or improper installation. These error
messages are displayed on the last line of the error dialog box next to “Specific Error.”
To correct these errors, check that the appropriate files are present and follow any
suggestions in the description under the error name.
·  “Library File cannot be loaded – Subsystem DLL”
The PR2FILE.DLL, PR2SPX.DLL, or the POST2.DLL files are missing from
the client PC directory.
·  “Library File cannot be loaded – Can’t execute POSTMAST”
The POSTMAST.EXE program is missing from the client PC directory.
·  “Library File cannot be loaded – POSTMAST window disappeared”
A system or memory problem caused the POSTMAST executable program
to terminate. To correct this problem, restart Visual Mailbox.
·  “Insufficient memory to complete request”
The user’s computer desktop has too many windows open for the amount of
memory in the computer.
·  “Connection broken or not made”
A network fault has occurred. To correct this problem, restart Visual Mailbox.
· “Connection aborted”
A network fault has occurred, or the VFS application terminated abnormally.
· “Serv er stopped”
The VFS application has terminated. 
						

							19. Installing and Configuring Visual Mailbox
Implementation and Service ManualPerf orming Vis ual Mailbox Maintenanc e19-26
Network Fault Errors
The following error messages are due to network errors, ov erload, or missing files.
Contact the network administrator for information regarding network status.
· “Cannot read file due to fatal error”
·  “Cannot write file due to fatal error”
·  “Cannot read file due to sharing v iolation”
·  “Cannot write file due to sharing v iolation”
·  “Null connection handle”
These errors indicate a problem with network rights assignments. Request
that the network administrator v erify that the correct network rights hav e
been assigned. Restart the Visual Mailbox software when the network
problem is corrected.
·  “Inv alid connection handle”
This error usually indicates that the wrong name has been specified for the
v oice fax serv er. Verify that the name is correct and restart the Visual
Mailbox software when the network problem is corrected.
·  “Serv er present but not listening”
All connections to the serv er are in use. W ait for an av ailable connection,
then try again.
·  “Settings file cannot be read (access denied)”
·  “Settings file cannot be read (does not exist)”
·  “Settings file missing or incomplete”
These errors indicate the VMXGATE.INI file in the desktop directory is
corrupt or missing. Re-install the file.
Internal Software Errors
The following error messages relate to software errors in Visual Mailbox used to indicate
failures external to the Visual Mailbox software. If these error messages appear, contact
the customer’s IS representativ e to inv estigate network or hardware faults:
·  “Message longer than permitted maximum”
· “Malformed message”
·  “Internal error detected”
·  “Error code not av ailable”
·  “Task switch not possible”
·  “Client operation not av ailable in this library”
·  “Serv er operation not av ailable in this library”
Visual Fax Warning
Ensure that the AUTOEXEC.BAT file contains a \TEMP directory. If you do not hav e this
directory, a warning box may appear and Visual Fax will not run. 
						

							19. Installing and Configuring Visual Mailbox
Implementation and Service ManualPerf orming Vis ual Mailbox Maintenanc e19-27
Channel Status Error
If the system Channel Status window displays the status EXTERNAL APPLICATION on
a port for an excessiv e amount of time, and you determine that the call must be dropped
from the port, contact a technical support representativ e.
Inactive Client Polling Problems
The Voice Fax Serv er polls inactiv e client PCs ev ery 30 minutes. W hen polled, the client
PC must respond within 10 minutes, or it is automatically logged out. Polling ensures
that client PCs that are still logged into Visual Mailbox, but no longer running, do not
continue to take up a client license that may be needed by another PC.
Client PCs running DOS applications may be unable to respond to Voice Fax Serv er
polling due to an activ e DOS application. You can prev ent this by lowering the
Foreground Priority of the DOS prompt.
To lower the foreground priority of the DOS prompt on a client PC:
1.  On the client PC, run PIFEDIT.
2. Open DOSPRMPT.PIF.
3.  On the Adv anced Settings window, set Foreground Priority lower than 100%. This
allows other applications to run, but has no noticeable effect on DOS application
performance.
4.  Sav e the settings and exit.
Insufficient Timeouts for Active Login and Message Playback
If Visual Mailbox users are consistently being logged out of activ e logins and message
playback, you can modify the VMXGATE.INI file to increase the timeouts:
·  To specify an activ e login timeout, insert the following line in VMXGATE.INI,
where
 nnn represents the number of seconds:
Idle Offhook TMO=
nnn
·  To specify a message playback timeout, insert the following line in
VMXGATE.INI, where
 nnn represents the number of seconds:
Play Pause TMO=
nnn
The position in which you place these lines in VMXGATE.INI determines the serv ers to
which the specified timeouts apply:
·  To apply the timeouts to all serv ers, insert the lines under [GATEW AY].
·  To apply the timeouts to a specific serv er, insert the lines under [GATEW AY 
x],
where
 x is the number of the gateway. You can use different timeouts for
different serv ers by placing the lines under each gateway for which you want to
ov erride the default.
If you modify VMXGATE.INI, make sure that you back up the file before installing any
updates to Visual Mailbox, as the file is ov erwritten during installation. 
						

							19. Installing and Configuring Visual Mailbox
Implementation and Service ManualInstalling the Client Software on the LAN Server19-28
Installing the Client Software on the LAN Server
Visual Mailbox must access certain files to operate successfully on a client PC desktop.
These files are collectiv ely referred to as 
client software. You can set up Visual Mailbox
to access client software files either of two ways:
·  Install the client software files on the LAN serv er
· Install the client software files on the client PC’s hard driv e
The steps prov ided install the client software files on the LAN serv er, so they can be
accessed by client PCs.
It is strongly recommended that the customer site’s LAN Administrator install the client
software on the LAN serv er.
W hen you install client software on the LAN serv er, files are placed in the
\VMBOX\CLIENT directory, unless you specify otherwise. Also, a VMGATE.INI file is
created in the \VMBOX directory. W hen Visual Mailbox is set up on a client PC, a
VMDESK.INI file is created in the \W INDOW S directory on the client PC’s hard driv e.
To install the client software on the LAN server:
1.  Log into the LAN serv er as a superv isor (with Superv isor Rights if using a Nov ell
network or with Full Control if using a W indows NT network) from a client PC running
under W indows.
2.  If W indows 3.x is installed on the client PC,  from the Program Manager in W indows,
select Run from the File menu. The Run dialog box displays.
  If W indows 95 or W indows NT is installed on the client PC, from the desktop, click
the Start button and select Run from the menu that displays. The Run dialog box
displays.
3.  Click Browse. The Browse dialog box displays.
4.  Insert the messaging system CD-ROM in the CD-ROM driv e.
5.  From the Browse dialog box, select the F: driv e. The contents of the CD-ROM
display.
6.  Double-click the VMBOX folder . The contents of the VMBOX folder display.
7.  Double-click the CLIENT folder. The contents of the CLIENT folder display.
8.  Select the SETUP.EXE file and click Open. The Client Installation introductory
dialog box displays.
9.  Verify that Install Client/Installation software on the LAN Server is selected and click
Continue. The Client Installation dialog box displays.
10.  Verify that the Use Shared Files option is selected.
11.  Enter the LAN serv er data directory where the Visual Mailbox shared files are stored.
By default this is the \VMBOX\DATA directory. (The directory path must match that
entered in the Serv er Path field on the Serv er Parameters dialog box.)