Pre-deployment steps

Node JS

1. Izenda Export service needs Node JS runtime environment to execute. Login as root user and run following commands.

   sudo curl -fsSL https://deb.nodesource.com/setup_12.x | sudo -E bash -
   											sudo apt-get install -y nodejs
   											sudo nodejs -v
   										

PM2

1. Izenda Export service leverages PM2 as process manager. Login as root user and run following commands.

   sudo npm install pm2@4.5.0 -g
   											sudo pm2 --version
   										

Deployment steps

1. Login as root user and copy Export Service at desired location. Run following commands.

   tar -xvf <export service archive>
   											cd package
   											sudo pm2 start app.js -- --port 5775
   											sudo pm2 startup systemd
   											sudo pm2 save
   											sudo pm2 list
   										

2. On successful completion of these commands, Export Service will start listening on specified port number.

   

Post-deployment steps

Apache Reverse Proxy

1. Login as root user and run following commands.

   1. Update Ubuntu packages to the latest stable version: sudoapt-getupdate

   2. Install the Apache web server on Ubuntu: sudoapt-getinstallapache2-y

   3. Enable the Apache required modules

      sudo a2enmod rewritesudo a2enmod proxysudo a2enmod proxy_httpsudo a2enmod headerssudo a2enmod ssl –- if you want to configure as SSLsudo service apache2 restart

   4. Verify Apache installation by running localhost.

      

   5. Enter domain name in to apache2.conf file

      sudo nano /etc/apache2/apache2.confServerName localhost

   6. Enter port in to ports.conf file

      Sudo nano /etc/apache2/ports.confListen 9001

   7. Create 9001.conf under /etc/apache2/sites-available: sudonano/etc/apache2/sites-available/9001.conf

      <VirtualHost *:9001>
      											ProxyPreserveHost On
      											ProxyRequests Off
      											ProxyPass / http://localhost:5775/
      											ProxyPassReverse / http://localhost:5775/
      											ServerName localhost
      											ErrorLog /var/log/apache2/9001-api-error.log
      											CustomLog /var/log/apache2/9001-api-access.log common
      											</VirtualHost>
      										

   8. Active the service site.

      sudo a2ensite 9001.conf

2. Verify the configuration: sudoapachectlconfigtest. If the configuration is correct, the result will be SyntaxOk. If not, there is an issue in the configuration.

3. Restart the website: sudoserviceapache2restart

Pre-deployment steps

Node JS

1. Izenda Export service needs Node JS runtime environment to execute. Download and install Node JS from node-v12.21.0-x64.msi by navigating to https://nodejs.org/dist/latest-v12.x/

Deployment steps

1. Copy export service at desired location and unzip Export Service archive. Open command prompt in administrative mode and navigate to extracted location. Run following command.

   cd package
   											node app.js --port 5775
   										

2. On successful completion of these commands, Export Service will start listening on specified port number.

   

Post-deployment steps

IIS Reverse Proxy

1. Install Application Request Routing and URL Rewrite Components

2. Open Microsoft Web Platform Installer’s download page. This can also be opened from IIS Manager Actions panel, “Get New Web Platform Components” link.

3. Download and run the installer.

4. Open Microsoft Web Platform Installer.

5. Search for “Application Request Routing” and click Add.

6. Similarly search for “URL Rewrite 2.0” and click Add.

7. Click Install.

   

8. Setup Reverse Proxy in IIS. Open IIS Manager.

9. Select a server node in the tree view on the left hand side and then click on the “Application Request Routing” feature.

   

10. Check the “Enable Proxy” check box. Leave the default values for all the other settings on this page:

11. Select Apply.

    

12. Right-click on a server node in the tree view and add a new website.

13. Click the ellipsis (…) button to select the location of the extracted Izenda export service containing the app.js file.

    

14. Select your website under sites in left side section. Now select “URL Rewrite” option.

    

15. Now click on “Add Rule(s)…” in actions section on the right side.

16. Now select Reverse Proxy under inbound and outbound section.

    

17. Add the server name or IP address with port under inbound rules input box. This is the URL of the export service running locally on the server.

    

18. At this point, the reverse proxy setup has been done.