PicLan-IP for D3/ProPlus is currently in pre-release. This implementation of the PicLan-IP suite of products is very similar to other PicLan-IP hosted releases. This document describes the pre-requesites of using PicLan-IP on D3/ProPlus, it installation, and operation.
In order to use PicLan-IP, you must install and configure Linux to support TCP/IP network connections. This can include installing ethernet adapters, setting up PPP connections, or whatever. The important thing to understand is that PicLan-IP uses Linux supplied TCP/IP services and you must set these up in Linux before PicLan-IP will run.
PicLan-IP runs on D3/ProPlus phantom processes. For most installations, you will need a total of three phantom processes to run PicLan-IP, so you should install D3/ProPlus with a sufficient number of phantom processes configured for PicLan-IP and other tasks that you will need to run.
In order to use PicLan-IP and Apache at the same time (on the same host system), you must configure the two software packages to use either differnet IP addresses or different TCP port addresses. If you configure Linux for multiple IP addresses, you can then have PicLan-IP's Coyote web server control some of the addresses and have Apache control the others. This configuration allows you to run both Coyote and Apache on the standard HTTP TCP port 80.
If you do not have multiple IP addresses configured, then you must configure Coyote and Apache to use different TCP port numbers. You could setup Coyote to use port 80 (the default for HTTP) and Apache to use port 81.
The other option is for you to not start Apache. Coyote is fully capable of serving all of the HTTP requests of the system and provides the additional benefits of control from within the Pick environment.
At the present time, it does not appear possible to use PicLan-IP mail functions at the same time as sendmail mail functions. Further research for solutions to allow both products to co-exist on a single platform are in works, but sendmail does not appear to be configurable to allow it to run on only a single IP address instead of every IP address on the system. If you are a sendmail expert and know how to do this, please let us know.
Because of the underlying Linux architechure, a maximum of 1024 open connection handles are supported. The underlying OS uses about 5 of these and then PicLan-IP uses a connection handle for RPC synchronization so that limits the number of usable TCP connections to about 1000. In practice, this should not be a serious limitation for most sites.
The design of PicLan-IP on Linux is such that it should work with multiprocessor systems, but this has not been tested.
The PicLan-IP software is supplied as a Linux TAR archive file. These installation steps are designed to be executed by the root user. You should either logon as root or execute the su command before attempting to install PicLan-IP. In order to install the file, you should copy the install file to your Linux system and perform the following steps:This should process should extract several files into the /usr/piclan-ip directory including:mkdir /usr/piclan-ip cp plip-d3lx.tar.gz /usr/piclan-ip cd /usr/piclan-ip tar x -v -z -f plip-18.104.22.168-d3linux.gzipAfter verifying that these files were extracted, you should execute:Makefile plip.tap plip_c.o plip_d px_user.oThis process will relink the D3 monitor so that the PicLan-IP C support routines are included and copy the newly made monitor along with the plip_d daemon executable to the /usr/bin directory.make
After you have rebuilt the D3 monitor, you can continue the PicLan-IP installation process. If D3 is current running, you must shutdown D3 and then restart it. This is necessary so that all processes, including phantom processes, are using the D3 monitor that contains the PicLan-IP support code.
After you have restarted D3, you need to load the PICLAN-IP account from the virtual tape in the /usr/piclan-ip directory. You can load this tape by performing the following operations. You should be logged on to the 'dm' account.This will start the restore process of the PICLAN-IP account.T-SELECT 3 CHG-DEVICE 3 name=/usr/piclan-ip/plip.tap T-ATT T-REW T-LOAD MD (O
After the PICLAN-IP account is installed, you can proceed with standard PicLan-IP configuration by editing the PLIP.CTRL CONFIG item.
is used to control how the PicLan-IP communications daemon is started. This command works by shelling (the Z) a phantom process that then shells the plip_d command. The '&' will cause the shell to run in the background. The reason that this is run on a phantom is so that the daemon will continue to run even if the calling process exits.DAEMON COMMAND=Z !plip_d >> /var/log/plip_d_log &
The ">> /var/log/plip_d_log" part of the command line redirects output from the daemon to the specified log file. Using the double arrow ">>" redirect causes the log file to append and not be erased whenever the daemon is started.
DAEMON COMMAND=Z !plip_d -z >> /var/log/plip_d_log &