iNomads

Step

Description

1.

Download and install Apache 2.4.x on Server B.

2.

Create a new directory on Server B (e.g. C:\directory). When this setup is complete, it will contain the entire *plus/inomads directory from Server A.

For Window systems, it must be a directory under a root drive. Make this newly created directory on Server B accessible to Server A with full read/write permissions. Generally, this is done with NFS, Samba or some other network file system interface. For Window systems, on Server A create a Map drive to the new C:\directory on Server B.

3.

Configure Apache on Server B as originally configured on Server A. Set the DocumentRoot to the new directory on Server B and include the inomads sub-directory (e.g. C:/directory/inomads).

The sample below contains the required changes to httpd24.conf for Windows and Linux. Remove the comment symbol "#" from the appropriate lines and adjust to the proper path for your system.

Important Note:
For the "ServerName" line below, both the real site domain name and server name should be used.

# Apache 2.4.x
#
# PxPlus iNomads setup
#

LoadModule inomads_module modules/mod_inomads.so

<Location /inomads>
    SetHandler inomads
</Location>

#
# **** IMPORTANT NOTICE: Use forward slashes for all directory names and adjust the pathname as reqd
#

<VirtualHost *:80>
     ServerName inomads.domain.com
     #DocumentRoot "C:/directory/inomads" # Select and adjust accordingly for Windows
     #DocumentRoot #"/var/inomads"        # Select and adjust accordingly for Linux/Unix
     DirectoryIndexinomads
    
     # Default to ISO-8859-1
     AddDefaultCharset ISO-8859-1
    
     # Redirect any attempt to view the .conf files to error 404
     RedirectMatch 404 conf$
</VirtualHost>

#<Directory "C:/directory/inomads">  # Select and adjust accordingly for Windows
#<Directory "/var/inomads">          # Select and adjust accordingly for Linux/Unix
     Options Indexes FollowSymLinks
     AllowOverride None
     Require all granted
</Directory>

4.

Add the following settings to the Processes tab in the inomads.conf file on Server A. They can be manually added by editing *plus/inomads/inomads.conf or by entering RUN "*plus/inomads/admin" at the PxPlus Command prompt:

• Set the system name (Server Name) or IP address (192.168.0.77) for Server A into "Remote process launching IP".
• Set the port (4093) that will be used by *plus/cs/host in "Remote process launch port address". To configure the system to only use a single port (PxPlus 2018 or later), set "Only use the Remote process launch port".
• Set the pathname (x:/inomads) of the mapped drive/share point on the Web Server that contains the inomads directory. To eliminate the need for a mapped drive/share point (PxPlus 2018 or later), place the URL of the Web Server such as http://inomads.myserver.com.

5.

Copy the complete lib/_plus/inomads directory from Server A to x:/inomads on the shared directory on Server B. Once copied, make sure permissions on Server B are still general read/write so that Apache can access them.

6.

Start *plus/cs/host on Server A. Before you do this, see Important Note below.

Important Note:
To avoid any issues that might occur due to any START_UP settings, do not start *plus/cs/host in your application directory. The recommendation is to use C:/PVX Plus Technologies or lib/_plus/inomads directories. You will want to ensure that Simplified Host is setup to start after a system restart.

7.

Start/restart Apache on Server B.

8.

The application should now be accessible on a browser.

• Using a browser, enter http://localhost:80 on the Apache system or http://ServerName:80 on some other system.
• If there is a problem, try to see if the Apache is setup correctly. You can test this by requesting http://localhost:80/sysimage/bug.gif. This should display the tiny red bug on the browser.
• Another problem that can occur is with the firewall between Servers A and B. Server B needs to be able to connect to Server A. Ensure that it is open and not blocked.
• Permissions and the setup of the Map drive are problem areas that should be investigated if issues are encountered.
• Another test would be to confirm that the host connection is working by following these steps: Start the WindX Launcher. Select the PxPlus Simple CS connection type. Enter the server name as defined in Step 4 above. A Simple Client session should launch if properly defined.

9.

Changes to modify the behaviour of iNomads are made to the *plus/inomads/inomads.conf file on Server A. Changes made in the Processes tab (in Step 4 above) in regards to the system name, port and pathname must be made to inomads.conf on both servers.