< Back
Print

Installation

Installation on Centric PXM™ SaaS Systems

The SAWSConnectors are available for purchase and activation in the Centric PXM™ Marketplace. To find all available SAWSConnectors, simply search for the keyword “saws”. After installation, each connector will receive updates automatically, as detailed in this article.

SAWSConnector Updates on the Centric SaaS

Installation on Centric PXM™ OnPrem Systems via the SAWS Installer

All SAWSConnectors can be easily installed and updated using our installer.

The following video will guide you through the setup, starting from the initial installation up to your first export.

To reinstall or update your SAWSConnector suite, navigate to the installer.
You can find the installer in your options.

If you already have a SAWSConnector installed, you can also access the installer through the SC::Navigator.

 

You need a Redmine account in order to use our installer. If you don’t have an account yet, please contact us via our email sawsconnector@saws.de .

After logging in you will be greeted by an overview of your installed connectors and their versions:

You can determine the version type by checking the color.

To update your SAWSConnector suite choose your main version at the top. All module versions should automatically change to match the desired release.

Check your settings before clicking on “Continue with the installation”.

At the top you should see a summary of your selected versions:

Choose how the installer should react in case of an error.
After accepting our privacy policy you can start the installation.

Once the installation is finished, the installer should display a report on the performed actions.

Installation on Centric PXM™ OnPrem Systems via SVN

To install SAWSConnectors, start by connecting to your server via SSH. Navigate to the “modules” directory within your Centric PXM project folder. The default location is typically:

/var/www/CONTENTSERV/{{Your_Project_Name}}/modules/

Important: Before installing any specific connector, you must install the base connector called sawsconnector. This serves as the shared foundation for all other connectors.

svn checkout https://svn.saws.de/development/tags/sc/1.21/sawsconnector/stable sawsconnector/

Once the base connector is installed, you can proceed with installing your desired connectors. Below are the commands for the most common connectors:

Available Connectors

  • OXID Connector: svn checkout https://svn.saws.de/development/tags/sc/1.21/oxidconnector/stable oxidconnector/
  • GenericJSON Connector: svn checkout https://svn.saws.de/development/tags/sc/1.21/sawsgenericjson/stable sawsgenericjson/
  • GenericXML Connector: svn checkout https://svn.saws.de/development/tags/sc/1.21/sawsgenericxml/stable sawsgenericxml/
  • Intershop Connector: svn checkout https://svn.saws.de/development/tags/sc/1.21/sawsintershop/stable sawsintershop/
  • Magento Connector: svn checkout https://svn.saws.de/development/tags/sc/1.21/sawsmagento/stable sawsmagento/
  • Shopware Connector: svn checkout https://svn.saws.de/development/tags/sc/1.21/sawsshopware/stable sawsshopware/
  • SimpleExcel Connector: svn checkout https://svn.saws.de/development/tags/sc/1.21/sawssimpleexcel/stable sawssimpleexcel/
  • TYPO3 Connector: svn checkout https://svn.saws.de/development/tags/sc/1.21/sawstypo3/stable sawstypo3/

Version Note: The version number 1.21 represents the major/feature version of the installation. For the latest features and improvements, always check the Releases section on the SAWS website and use the newest released version.

Post-Installation Steps

After installing the connectors, ensure proper permissions by running the following command in the modules directory:

chown www-data:www-data ./ -R

This assigns the modules to the Centric group, ensuring smooth operation.

Updating Connectors

To update a connector, navigate to its folder and run:

svn update sawsconnector/

Since the connectors are checked out from the stable branch, running this command will always fetch the latest patch version.

Finalizing the Installation

After installation or updates, perform the following steps in your Centric system:

  1. Run a data model update.
  2. Deactivate and reactivate the plugin cache in the settings.

SAWS Service IP Configuration

Service Endpoints and IP Addresses

To ensure proper connectivity to SAWS services, configure your firewall or network settings to allow traffic to the following three proxy IP addresses. These IPs are used for all SAWS services via DNS load balancing:

Service Hostname IP Addresses (All Required)
Datahub API api.saws.de 46.254.140.136, 46.254.140.137, 46.254.140.138
Owl owl.saws.de 46.254.140.136, 46.254.140.137, 46.254.140.138
Websocket Server blackbird.saws.de 46.254.140.136, 46.254.140.137, 46.254.140.138

Important Notes

  1. All three IPs must be whitelisted in your network/firewall configuration. DNS resolution may direct traffic to any of these IPs based on availability.
  2. The previous IP address for Blackbird (46.254.138.251) is no longer in use and should be removed from any configurations.
  3. If connectivity issues arise, verify that all three IPs are accessible and not blocked by security policies.

Was this article helpful?
How can we improve this article?
Please submit the reason for your vote so that we can improve the article.
Table of Contents