How to Change Port of the Web Interface

Management interface

  1. Stop all YSoft SafeQ services.

  2. Go to <SAFEQ_DIR>\Management\tomcat\conf

  3. Open the file server.xml with a text editor (Notepad++ for example).

  4. Find the following xml record:

    <... port="80" ... redirectPort="443".../>
    
  5. Change the port to the number expected for non-encrypted connection.

  6. Change the redirectPort to number expected for encrypted connection.

  7. Start YSoft SafeQ Management Service.

  8. Go to Management interface > System > Configuration > Expert options

  9. Search for two following parameters and change the values of the parameters according to ports set above:

    • webServerPort

    • webServerPortHTTPS

  10. Restart YSoft SafeQ Management Service.

  11. Start all YSoft SafeQ services.

  12. Repeat steps above on all cluster members.

End-user interface

  1. Stop YSoft SafeQ End User Interface service.

  2. Go to <SAFEQ_DIR>\SPOC\EUI\conf

  3. Open the file server.xml with a text editor (Notepad++ for example).

  4. Find the following xml record:

    <... port="9090" ... redirectPort="9443".../>
    
  5. Change the port to the number expected for non-encrypted connection.

  6. Change the redirectPort to number expected for encrypted connection.

  7. Start YSoft SafeQ End User Interface service.

  8. Repeat steps for all servers with end-user interface (it is available on both non-dedicated management servers and site servers).

Make end-user interface accessible on https port (443) instead of the management interface 

This is special nontrivial configuration. By default, end-user interface always expects /end-user/ui in the url after the port number.

  1. Stop services YSoft SafeQ Management Service and YSoft SafeQ End User Interface

  2. Replace the redirectPort in server.xml files of MNGMT and EUI as described above (the 443 and 9443 ports can be swapped)

  3. In <SAFEQ_DIR>\SPOC\EUI\conf\server.xml replace the <Host...>...<Host/> section with these lines:

    <Host appBase="webapps" autoDeploy="true" name="localhost" unpackWARs="true">
    <Valve className="org.apache.catalina.valves.rewrite.RewriteValve" />
    <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs" pattern="%h %l %u %t "%r" %s %b" prefix="localhost_access" suffix=".log"/>
    </Host>
    
  4. Create the ROOT folder (case sensitive) in this path:
    <SAFEQ_DIR>\SPOC\EUI\webapps\ROOT

  5. Create this file:
    <SAFEQ_DIR>\SPOC\EUI\conf\Catalina\localhost\rewrite.config
    With below content (just replace <IP_ADDRESS> with real value):

    RewriteCond %{REQUEST_URI} ^/$
    RewriteCond %{HTTPS} on
    RewriteRule ^.$ https://<IP_ADDRESS>:443/end-user/ui [NC,R,L]
    
  6. Start servcices YSoft SafeQ Management Service and YSoft SafeQ End User Interface.

Payment System

  1. Stop YSoft SafeQ Payment System service.

  2. Go to <SAFEQ_DIR>\YPS\conf

  3. Open the file server.xml with a text editor (Notepad++ for example).

  4. Find the following xml record:        

    <... port="8080" ... redirectPort="8443".../>
    
  5. Change the port to the number expected for non-encrypted connection.

  6. Change the redirectPort to number expected for encrypted connection.

  7. Start YSoft SafeQ Payment System service.