rInstalling Service Virtualization on Linux

Installation on Linux

  1. Install all packages required by Service Virtualization. These packages are located in the deps directory.

    cd deps
    yum install *.rpm
  2. Install the NGINX server directly from NGINX yum repository. You need this to run Service Virtualization Manager.

    For example:

    Oracle Linux 6:

    yum install http://nginx.org/packages/rhel/6/x86_64/RPMS/nginx-1.12.0-1.el6.ngx.x86_64.rpm

    Oracle Linux 7:

    yum install http://nginx.org/packages/rhel/7/x86_64/RPMS/nginx-1.12.0-1.el7.ngx.x86_64.rpm

    For more details, see the nginx pages at http://nginx.org/)

  3. Install Service Virtualization Server. The installation directory is located in deps's parent directory.

    cd ..
    yum install *.rpm
  4. Perform the post-installation steps, as described in Post-installation steps on Linux.

Back to top

Post-installation steps on Linux

  1. Before you can use an Oracle database, you need to install its driver.

    Insert Oracle.ManagedDataAccess.dll in /usr/lib/sv-server/bin.

  2. Install the following SAP libraries in /usr/lib/sv-server/bin:

    libsapjco3.so

    sapjco3.dll

    sapjco3.jar

    sapjco3.pdb

  3. Download and install the MQ client. For details, see Prerequisites.

    Copy amqmdnet.dll from the installation folder to /usr/lib/sv-server/bin.

  4. In /etc/sv-server/app.config/HP.SV.StandaloneServer.exe.database.config, configure the database by running sv-ConfigTool db-setProperties.

    For example:

    db-setProperties server oracle myoracle.mycompany.net/db1 "" "" SqlAuth UserName Password

  5. If needed, change the default certificate generated during installation in /etc/sv-server/certificates.

  6. If needed, update /etc/services to include SAP ports.
  7. If you are using Red Hat-based Linux, you may need to disable SELinux (enabled by default in Enforcing mode) and the firewall, as these features prevent Service Virtualization from starting and working properly. Possible options include:

    To permanently set Permissive mode for SELinux:
    1. In /etc/selinux/config, set SELINUX=permissive.

    2. Save and reboot the machine.

    To temporarily set Permissive mode for SELinux:

    1. Run: setenforce 0

    2. Verify the change by running: getenforce

    Note: To restore Enforcing mode, run setenforce 1 or reboot the machine.

    To temporarily turn off the firewall:

    Run: systemctl stop firewalld

    To disable the firewall:
    (prevents automatic start)

    Run: systemctl disable firewalld

  8. Set up authentication.

    Simple authentication

    Add all users to the /etc/sv-server/users file.

    (Default)

    LDAP authentication

    Configure SV Server and SVM to use LDAP authentication. For details, see Basic or LDAP Authentication.

    It is recommended that you use LDAP.

Back to top

Starting and Stopping Service Virtualization on Linux

Service Virtualization Server service

Note: Integration with Linux is part of the Early Access Features.

To start and stop the Service Virtualization Server service:

Service Virtualization Management service

To start and stop the Service Virtualization Management service:

Back to top

Directories on Linux

During installation, files are installed in the following directories.

Directory Description

/etc/sv-server

Contains app config (the Service Virtualization Server's configuration file), Spring configuration files, and certificates.

Note: If you uninstall Service Virtualization, these files remain on the machine ensuring that your configurations are available when you reinstall.

/usr/lib/sv-server

Contains the principal files, such as bin, extensions, and Service Virtualization Management files.

/usr/share/sv-server

A configuration directory containing symbolic links, or references, to real file or directory locations.

/usr/share/doc/sv-server

Contains documentation.

/var/log/sv-server

Contains Service Virtualization Server logs.

/var/cache/sv-server

Contains cache files, such as logged messages, reports, and generated proxy certificates.

/var/lib/sv-server

Contains various files that remain after the Service Virtualization Server restarts, the agent configuration file, and the scripted rule cache.

/run/sv-server

Contains the PID (Process Identification Number) file.

Back to top

Uninstalling Service Virtualization from Linux

This section described how to uninstall the Service Virtualization server from a Linux machine.

To remove the Service Virtualization server:

  1. Run the rpm command: rpm -e sv-server

  2. Manually remove the following files and directories:

    Directory contents Path
    Various configuration files for the server /etc/sv-server
    A backup of configuration file for SVM /etc/nginx/conf.d/sv-svm.conf.rpmsave
    SVM certificates /etc/nginx/sv-svm
    Files supplied by the user, such as database drivers and protocol extensions /usr/lib/sv-server
    Agent configurations /var/lib/sv-server
    Various caches and logged messages /var/cache/sv-server
    Log files /var/log/sv-server

Back to top

See also: