Installing Uwin for use with Procomm Plus as a Rlogin protocol 4

Nice write up Firebird!

Thx Firebird
Win a star...

I am able to load the program and get the login prompt when I connect to 127.0.0.2, but I can't login.
Does my user ID need to be in the Uwin\users folder ??
It isn't.

TIA

Hello cog4030. I've made a few changes to the guide as I had a few errors that were there. Here it is..
If you are still having problems, then please contact me or reply back onto this thread.

How to install Uwin for use with Symantec ProComm Plus as a Rlogin protocol

One of the main problems with using Symantec’s excellent ProComm Plus communications program is not having the “Rlogin” facility. Why this was left out during the programs development was a great shame as the Rlogin protocol is used on Unix software to access various applications. Symantec have missed the opportunity to run it’s ProComm Plus script files on Telephone PBX systems such as the Meridian & Succession family that Nortel produce.
Nortel have their own management tool known as MAT or OTM (Now called TM). The PBX’s are usually accessed via the Ethernet using the Rlogin port 513, although you can also use a serial COM port if your PBX is near to your OTM computer. Unfortunately the Nortel tool has basic functionally in not being able to make mass e.g. ext. changes etc, as it can only do one parameter change at a time.

There is a solution to this by installing a program called “Uwin”. Uwin means “Unix for Windows”. It works by setting up a Telnet loop back link between itself & ProComm. Uwin runs the Telnet server by default and will convert any Unix command that Uwin supports. The program will work for Windows NT, 2000 or on XP. You do need to have on your computer (which most people do!) a login name & password to input when you power-up.

First of all, obtain the software from When you access the site, you will get a page something like…


--------------------------------------------------------------------------------------------------------------------------------------
Software Download Packages
This is the AT&T Software Technology ast software download site from AT&T Research. The AT&T AST Open Source Software Collection provides an overview and Practical Reusable UNIX Software provides a historical perspective. You can join the ast and uwin mail groups, or monitor the mail archives. The man page index contains most of the ast commands; these are available at runtime using the --man or --html option of any ast command.
_______________________________________________________________________

DOWNLOAD FILE ACCESS HAS CHANGED – READ THE NEXT PARAGRAPH FOR DETAILS
_______________________________________________________________________
Most AT&T ast software is licensed by the Common Public License Version 1.0 (CPL-1.0). Before you download any packages you must signify your agreement to the terms of CPL-1.0 by entering a license agreement user name and password. This authorises you to download. If you do not signify agreement then download access is denied. You will be prompted for the license agreement user name and password at download time. Every user will have the same user name and password, listed at the bottom of this copy of the License. Packages covered by licenses other than CPL-1.0 are controlled by a similar license-specific dialogue.

--------------------------------------------------------------------------------------------------------------------------------------
Select “uwin-base”- UWIN base binary self extracting archive, from the package name description list.
The Login Name & password is contained within this section below...
PLEASE READ THE FOREGOING LICENSE AGREEMENT CAREFULLY. By using the following User Name and Password to access software downloads you will indicate your acceptance of the entire agreement and will be bound to use the downloaded software only in accordance with the terms and conditions of the agreement. Once you manifest your acceptance of the license agreement by successfully entering the User Name and Password the software will be available for downloading. Successfully entering the User Name and Password includes, but is not limited to: clicking the "OK" button or typing the ENTER key in the password prompt window, or passing the User Name and Password to a text based browser or other HTTP or FTP interfaces.

When prompted for license agreement authorisation

use this User Name:
I accept and this Password:
.
(Just enter in a dot as the password!)

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

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

Navigate to the files located near to the bottom of the “ page that
Contains the various 9 Uwin application files. i.e.
Uwin - UWIN base source
Uwin-base - UWIN base binary self extracting archive
Uwin-dev - UWIN development binary self extracting archive
Uwin-groff - UWIN groff binary self extracting archive
Uwin-perl-58 – UWIN uwin perl 5.8
Uwin-terminfo – UWIN terminfo binary self extracting archive
Uwin-xbase - UWIN X11 base binary self extracting archive
Uwin-xdev - UWIN X11 development binary self extracting archive
Uwin-xfonts - UWIN X11 fonts binary self extracting archive

Download just the one file into a temporary folder called i.e. “Temp” etc. The UWIN base source file called “uwin-base.2006-02-14.win32.i386.exe” contains the installation files 4.1 & this is the only one required!
Click on the Follow the instructions as given in the guide to load in the software.


Install the Uwin (uwin-base.2006-02-14.win32.i386.exe) base program. You will get a DOS screen appear & then another “welcome” screen to install the UWIN Base Release installation. Press next and accept the terms of the licence. Press next again after checking the program requirements will work with your p.c. You will be asked to select a path to install the software. I.e . . . . “C:\Program Files\UWIN” etc. Press Next. Select the “Home Directory Destination” When asked for the “User” files, I just used the same paths as for the main files with an extra folder called “Users”. I.e. “C:\Program Files\Uwin\Users” (I had to create a new folder called “Users” and then browse to it). The default path suggested is “C:\Users”! Press Finish or Enter to complete the process.
The DOS screen will show you the “ksh.exe” process and you will see various messages such as Stopping Services, Unpacking UWIN 4.1 base files etc. A percentage scale on the left hand side will indicate the installation process. You will see messages, such as assigning functions & making symbolic links etc.
Hit Return / Enter to close the DOS window, once the UWIN 4.1 installation has completed. You should get a message “UWIN installation successful” OK.
It takes a couple of minutes to install. There is no need to reboot your computer. I was using Windows XP Pro.


An icon “ksh” will appear on your desktop.


Note!

I’ve found that there is no need to run the Uwin program. It just needs to be installed on your computer. Actually, once UWIN is installed on your pc, it’s always running. It installs itself as a Windows service, so it can automatically start-up on a windows boot. You can stop the service from the windows services panel. You can also control some of its features from a link in the windows control panel. UWIN is really a small version of UNIX that runs itself inside windows. The Ksh icon that you see on the desktop is an easy access to the Korn Shell for UWIN.

Now open up your ProComm Plus communication program and select your “connection directory”. Create a new Telnet entry. I called mine “Uwin Connection”. Use “127.0.0.1” as the Host/IP Address.
Click on OK to accept the settings. Connect to your connection and you will get a message such as...


UWIN-XP 4.1.0/5.1 (DELLC860) (ttyp0)

login: etc.
Login in using your Windows login and Password (Not the Nortel PBX Name!). You will then get...

Password: etc.
$

Enter in your computers password. If it’s successful, then you will get a “$” appear underneath the password after a few seconds! The "$" is a KORN Shell prompt. It’s kind of like the Windows cmd prompt that look like "C:\".

To access any Nortel PBX, just key in the following example...

rlogin 192.168.1.44 -l CPSID. Press enter twice and the normal Nortel TTY message will appear on the screen. Please note that the “l” is not a “|” or an “I”! (It is the “l”lower case “l” letter!).


You can use your ProComm Plus in the same way as you would if you have accessed it via a serial port for script & listing files etc. You will need to keep the standard ProComm settings such as “VT220” & “Xmodem”. Access to and from Meridian Mail via “AX” are fine. In LD 143, you can do a “XBK” to backup the systems database on the “SSC” models. The transfer rate is very high using this method and it will take only a couple of minutes to receive the data. It does not seem possible to do a “XVR” I did try using the “1K-Xmodem-g” protocol, but I got errors halfway through the “XVR” & therefore I’d expect the same thing to happen if trying to attempt a “XRT” command!.

I have created a small “auto login” script file that I’ve set against the “script” box option in the connection directory. You can use this script file and modify it as listed below.



----------------------------------------------------------------------------------------------------------------------------
; Uwin Default site.was 24th August 2006
; NOTE!
; This program will only work with a WINDOWS version of ProComm Plus.
; The " ; " denotes that the data on the program file line is ignored, when the script is run.
; This autologin script will also set the PABX's time and date to match your computers own settings!.
; If you want to remove the auto time and date change, then put a ";"
; against the first 4 lines below "proc main" and also after the "set txpace 90" line.

proc main
integer iDay, iMonth, iYear, iMin, iHour, iSec
string sSend
ltimeints $LTIME iYear iMonth iDay iHour iMin iSec
strfmt sSend "STAD %02d %02d %d %02d %02d %02d" iDay iMonth iYear iHour iMin iSec

when target 0 "-ksh" call ksh
transmit "^M"
statmsg "Logging into UWIN by using this computers Name and Password"
; waitfor "UWIN"
pause 5
; waitfor "login"
pause 2
transmit "administrator^M" ; Enter in your own computers ID Name
pause 2
; waitfor "Password"
pause 2
transmit "admin^M" ; Enter in your own computers ID Password
pause 2
; waitfor "$"
statmsg "About to transmit the Rlogin string to access the Nortel PBX system"
pause 2
transmit "rlogin 192.168.1.46 -l CPSID^M" ; Enter in the Call Servers E lan IP Address
pause 2
transmit "****^M"
pause 2
statmsg "Access to Nortel TTY in progress"
transmit "^M~~LOGI ~ADMIN2^M" ; Enter in the sites login name
pause 2
; waitfor "PASS?"
transmit "0000^M" ; Enter in the sites login password
pause 2

set txpace 90 ; Start of autologin sequence in LD 2
statmsg "Update of systems time and date is being carried out"
transmit "****^M"
waitfor ">"
transmit "LD 2^M"
waitfor "."
transmit "TTAD^M"
waitfor "."
transmit sSend
transmit "^M"
waitfor "."
pause 2
transmit "TTAD^M"
waitfor "."
pause 2
transmit "****^M"

set txpace 120
endproc
proc ksh
usermsg "Rlogin error. Script will exit"
exit
endproc


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




Useful Tips, Question & Answer section

UWIN runs the telnet server daemon by default, so as long as you have a firewall up on your Windows(NT/2000/XP) machine, your telnet port remains closed to your network connection. I did try quite a few other terminal programs such as Putty, Secure CRT etc, but none of them could properly supply the username with rlogin that the PBX was looking for. UWIN works like a charm. You could also put UWIN on a machine inside your network, SSH to it from the outside, and then rlogin from there for a more secure connection to your PBX.

You can run scripts from within ProComm. After you install UWIN, just telnet from ProComm to your 127.0.0.1 loopback. You can then login to your local machine under UWIN(UNIX) shell, and issue the rlogin, SSH, or any supported commands directly from ProComm. Basically you are using UWIN as a tunnel from ProComm.

Question.
I tried to install UWIN on my PC running Win XP. I pick up UWIN-base software from the site.
Installation was successful. I changed the default directory only. In a DOS window I can ping 127.0.0.1. For within ProComm I'm not able to telnet 127.0.0.1. & I get a Telnet Winsock error.
Opening ksh, I can rlogin manually and what did I miss to be able to do it from ProComm?

Answer.
I restart my PC and now I have a login invite within ProComm when telneting to 127.0.0.1.

Question.
Which login and password do I have to enter?. My Windows login doesn't work.

Answer.
I believe that UWIN just recreates all the local accounts on the local computer, it’s installed on. I have both a user account, and an administrator account that I can login in with. If you create any new local accounts, or change any major windows network settings, just reinstall UWIN on top of its current directories, and it should fix any UWIN problems. I'm not an expert it UWIN, but if your more familiar with Cygwin, I'm sure it works with Windows the same way.
Oh, and yes, you can rlogin directly from the ksh. Using ksh without ProComm. I don’t think you can do any scripting.

Question.
What would you recommend to be the best way to exit the Nortel switch & the UWIN program without causing any system lockups?

Answer.
The proper way to exit the PBX and the rlogin sessions are as follows..
a) log off the PBX first, if not the TTY (PTY) session will still remain logged in for up to 1 hour.
b) Key “~.” (Above the hash button & the dot button). That will end the rlogin TTY session on the PBX. . If it’s done right, then you will get back to the Korn shell prompt of "$". Also the ~ key is in different places on keyboards. Mine is above the tab key and I have to use shift because it shares the ` key with it!.
If you just close the program you are using without doing so, you will orphan the ksh and rlogin in the background. Just use the task manager to find the ksh.exe, and the rlogin.exe programs. Right click on each program to end process tree. You can also just reboot the machine. Also make as many PTY’s as you need to have concurrent sessions.

c) You can, at the “$”prompt, key in “exit” to close the rlogin connection. That will end the Telnet session between UWIN and ProComm Plus. Keying “help” will list out the Unix commands

Keying "help" really gives you the Windows help commands inside the UWIN korn shell. UWIN shares command lines with Windows. That means that you can run Windows or Unix commands from it. In order to get help with commands, the procedure is just like Linux or Unix. You can use "man" for manual in front of a Unix command to get an html doc on what it does and what options are available for it. Or you can type the command followed by --h to see the available options. like this:

$ man ls will pull up the manual page for ls
$ ls --h will pull up options for ls

if you want to find most of the commands for UWIN, just look in the directory in Windows
C:\Program Files\UWIN\usr\bin
There is also some good information on the UWIN website, and if installed, in the Windows directory
C:\Program Files\UWIN\usr\doc


Here is a fun tip...Telnet to port 513 on your pbx... its causes the pbx to INI... I found that out the hard way!. (It saves you having to do a “trp” in “pdt”!.




Some information was obtained from the link. It has proved to be of great help in producing this guide.
Another useful link for rlogin documentation, is at

All the best

Firebird Scrambler
Meridian Programmer in the UK

Useful Nortel forum at
If it's working, then leave it alone!.

Win a another star !

Wolfi

Good info... have a star...

I got it to work. I had to create a local account.
My new account now shows up in the uwin\users folder.