ShopSite TX 4.3
Installationsanweisungen für den Inhaltserver

In diesen Anleitungen werden die Schritte für die Installation und Konfiguration der ShopSite TX-Software auf einem Inhaltserver beschrieben. Auf diesem Server befinden sich die Shops. Anleitungen für die Installation des ShopSite TX-Screenpack auf einem Transact-System sind in den Installationsanweisungen für ShopSite TX 4.3 Screen Pack enthalten. Nachdem Sie die Software anhand der jeweiligen Anleitungen auf beiden Systemen installiert haben, sind Ihre Server so konfiguriert, dass Sie Händlern das schnelle und leistungsstarke Erstellen von Webshops ermöglichen und dabei branchenführenden Transaktionsverarbeitung und Auftragsverfolgung zur Verfügung stellen.
Inhaltsverzeichnis

I. Vorbereiten der Installation
II. Planen der ShopSite-Verzeichnisse
III. Mall-Initialisierung

A. Bearbeiten der Datei config_mall.aa
B. Ausführen des Skripts start_install_mall_tx
C. Registrieren als Hostadministrator
D. Ausführen des Skripts start_install_mall_tx (zum zweiten Mal)
E. Konfigurieren des Webservers

IV. Aktualisieren
V. Initialisieren des Shops

A. Bearbeiten der Datei config_store.aa
B. Ausführen des Skripts start_install_store_tx
C. Konfigurieren des Webservers
D. Informieren des Händlers, dass der Shop fertig ist

VI. Laufende Aufgaben

A. Erstellen von Schlüsseln
B. Anfordern neuer Shops

VII. Anpassen von ShopSite
Vorbereiten der Installation

Sie müssen den ShopSite Transact-Screenpack installieren, bevor Sie die Inhaltserversoftware installieren oder aktualisieren. Wenn Sie den Screen Pack noch nicht installiert haben, lesen Sie die Installationsanweisungen für ShopSite TX 4.3 Screen Pack.

Damit Sie die ShopSite Software installieren können, muss auf Ihrem Inhaltserver Solaris for Sparc 2.5.1 oder höher oder Linux 2.0.36 oder höher ausgeführt werden, entweder mit Netscape Enterprise Server 3.5.1 oder Apache Web Server Version 1.3.0 oder höher installiert und konfiguriert.
Hinweis: Es können Probleme beim Einrichten von Zahlungsbearbeitern auftreten, wenn Sie Solaris 2.6 ausführen und vesuchen, das Skript tx_assign_store_to_merchant.ksh hinter einer Firewall auszuführen. Dies lässt sich mit Patch 105786-07 für das Solaris-Betriebssystem beheben.

Sie müssen die in der ShopSite Software enthaltenen Skripte für die Erstellung von Shops in der Mall verwenden. Diese Skripte weisen einer bestimmten Transact-Shop-ID eine ShopSite-Shop-ID zu. Diese Abhängigkeit muss erhalten bleiben, damit die Shops korrekt arbeiten. Gehen Sie nicht zum Bildschirm "Transact Keymaster Verwaltungsfunktionen", um Transact-Shop-IDs Händler zuzuweisen, dies wird von den Skripten und der Software übernommen. Befolgen Sie nicht die Anweisungen im Abschnitt "Anweisungen für Händler" im Bildschirm "Keymaster Verwaltungsfunktionen". Diese Funktionen werden ebenfalls von den Skripten und der Software ausgeführt.

Die Anpassung der Transact-Bildschirme auf Shopebene sollte nach dem Ausführen des Skripts start_install_store_tx erfolgen.

Wenn Ihre Site auth-Dateien für jeden Shop generiert, müssen Sie die zur Verfügung gestellten Skripte verwenden, um die Dateien zu generieren. Die store.auth-Dateien haben eine Standardstruktur, zu der die Produkt- und Seitenbegrenzungen eines Shops gehören.

Von Ihrem Account-Manager sollten Sie die Datei csp.id erhalten haben. Diese Datei wird von den Installationsskripten beim Erstellen von Shops benötigt. Wenn Sie diese Datei nicht haben, werden alle Shops als Evaluierungsshops erstellt, und Händler sehen eine entsprechende Meldung am unteren Rand des Hauptbildschirms von ShopSite. Sie können ohne die Datei mit der Installation und dem Testen von Shops fortfahren. Nachdem Sie die Datei csp.id erhalten haben, kopieren Sie sie in das Verzeichnis SHOPSITE_DIRECTORY um den Evaluierungsmodus aufzuheben.

Planen der ShopSite-Verzeichnisse

ShopSite TX legt Dateien in sechs Verzeichnissen ab:

Ausführbare Dateien, die von allen Shops verwendet werden, werden in zwei separaten Verzeichnissen abgelegt, und zwar SHOPSITE_DIRECTORY und SHOPPING_CART_DIRECTORY. Diese Verzeichnisse müssen in Ihrem Server als Alias zugeordnet und über URLs zugänglich sein. Das Verzeichnis SHOPSITE_DIRECTORY darf nur für Händler zugänglich sein. Wenn Sie einen Netscape-Server verwenden, lesen Sie die Informationen in den Anforderungen für die Serverkonfiguration über die Konfiguration von Netscape für die Verwendung von .htacces -Dateien.
® Diese Verzeichnisse sollten sich in oder unter dem cgi-bin-Verzeichnis Ihres Servers befinden. Aus Sicherheitsgründen sollten Sie Ihren Server so konfigurieren, dass er nur CGI-Programme aus den cgi-bin-Verzeichnissen zur Verfügung stellt, keine Textdateien oder HTML-Dateien.

Sicherheitsbezogene Dateien werden in diesem Verzeichnis gespeichert: MALL_SECURITY_DIRECTORY. Dieses Verzeichnis enthält Kennwörter und muss deshalb vor unberechtigtem Zugriff geschützt werden.
® Dieses Verzeichnis sollte sich in oder unter dem cgi-bin-Verzeichnis Ihres Servers befinden.

Grafiken, die von allen ShopSite-Shops verwendet werden, sind in einem separaten Verzeichnis gespeichert, auf das der Webserver zugreifen kann. Das empfohlene Verzeichnis ist shopsite-images unter dem Dokument-Stammverzeichnis des Websservers.

Jeder Shop benötigt sein eigenes Verzeichnis DATA_DIRECTORY für die Speicherung der Produkt- und Seitendatenbanken.
® Legen Sie jedes Verzeichnis DATA_DIRECTORY im Benutzerbereich ab, den Sie dem Händler zuweise, es darf aber nicht für einen Browser zugänglich sein. Mit anderen Worten, legen Sie nicht das Datenverzeichnis unter dem Dokument-Stammverzeichnis des Websservers ab.

Jeder Shop benötigt außerdem ein Verzeichnis HTML_DIRECTORY für die HTML-Dateien. Dies sind die generierten Seiten für jeden Shop. Dieses Verzeichnis wird manchmal auch das Outputverzeichnis des Shops genannt. Der Shop-URL muss als Alias diesem Verzeichnis zugeordnet sein: HTML_DIRECTORY.
® Legen Sie das Verzeichnis HTML_DIRECTORY für jeden Shop in dem Benutzerbereich ab, den Sie dem Händler zuweisen, oder dort, wo Ihre vorhandene HTML gespeichert wird.
Beachten Sie, dass die Grafiken für jeden Shop im Unterverzeichnis media des HTML_DIRECTORYdes Shops gespeichert sind, deshalb können Sie jedem Händler FTP-Zugriff auf sein eigenes Verzeichnis media gewähren.

In diesen Installationsanweisungen werden diese Verzeichnisse und die dazugehörigen URLs anhand ihrer Funktion, zum Beispiel SHOPSITE_DIRECTORYnicht anhand ihres Namens definiert. Als Person, die das Programm installiert, müssen Sie die tatsächlichen Namen angeben. Überlegen Sie sich, wo Sie die Verzeichnisse erstellen wollen, bevor Sie mit der Installation beginnen. Die Verzeichnisstruktur könnte beispielsweise so aussehen:
 home

  httpd

      cgi-bin

       ss = SHOPSITE_DIRECTORY

               als Alias zugeordnet zum SHOPSITE_URL, wie zum Beispiel

               http://www.xyz.com/cgi-bin/ss

       sc = SHOPPING_CART_DIRECTORY

               als Alias zugeordnet zum SHOPPING_CART_URL, wie zum Beispiel

               http://www.xyz.com/cgi-bin/sc

       ms = MALL_SECURITY_DIRECTORY

                 enthält Kennwörter, muss vor unberechtigtem Zugriff geschützt werden

      html

       shopsite-images

       Store1 = HTML_DIRECTORY als Alias zugeordnet zu Händler 1' STORE_FRONT_URL

        Seiten von Shop 1

        media möglicherweise benötigt Händler 1 FTP-Zugriff

            Bilder von Shop 1

       Store2 = HTML_DIRECTORY als Alias zugeordnet zu Händler 2' STORE_FRONT_URL

           Seiten von Shop 2

           media möglicherweise benötigt Händler 2 FTP-Zugriff

               Bilder von Shop 2

      data

          Store1 = DATA_DIRECTORY

          Store2 = DATA_DIRECTORY
Mall-Initialisierung

Sie müssen eine Konfigurationsdatei bearbeiten und ein Shell-Skript ausführen, um Ihren Inhaltserver auf die Bereitstellung der ShopSite TX-Shops vorzubereiten. Das Skript erstellt Verzeichnisse und installiert Software auf dem Server. Sie müssen einen Webbrowser verwenden, um sich als Hostadministrator beim Transact-System registrieren zu lassen.

Bearbeiten der Datei config_mall.aa

Die Datei config_mall.aa enthält Einstellungen, die von den Installationsskripten für die Konfiguration der Mall und der Shops verwendet werden.

Gehen Sie zum Verzeichnis mit den Installationsdateien.

Öffnen Sie die Datei config_mall.aa mit einem Editor und stellen Sie Werte für die folgenden Variablen ein. Setzen Sie die Werte nicht in Anführungszeichen. Die Datei kann in Abschnitten, die nur für SC gelten, auch andere Variablen enthalten, diese können Sie ignorieren.

SHOPSITE_DIRECTORY
Absoluter Pfadname des ShopSiote-Verzeichnisses; hier befinden sich alle CGI-Skripte, die für die Erstellung von Shops verwendet werden. Falls das Verzeichnis nicht bereits vorhanden ist, wird es erstellt.

SHOPSITE_URL
Absoluter URL, der auf das SHOPSITE_DIRECTORY verweist. Dieser sollte zu einem cgi-bin-Verzeichnis weisen, zum Beispiel http://host/whatever/cgi-bin/ss.

SHOPPING_CART_DIRECTORY
Absoluter Pfadname des Warenkorbverzeichnisses; hier befinden sich die CGI-Skript zum Erstellen von Bestellungen. Falls das Verzeichnis nicht bereits vorhanden ist, wird es erstellt.

SHOPPING_CART_URL
Absoluter URL, der auf das SHOPPING_CART_DIRECTORY verweist. Dieser sollte zu einem cgi-bin-Verzeichnis weisen, zum Beispiel http://host/whatever/cgi-bin/sc.

SHOPSITE_IMAGE_DIR
Absoluter Pfadname zum Verzeichnis, in dem die Grafiken der ShopSite-Oberfläche für Händler gespeichert werden. Das Verzeichnis wird erstellt, wenn es nicht bereits vorhanden ist.

SHOPSITE_IMAGE_URL
Absoluter URL, der auf das SHOPSITE_IMAGE_DIR verweist. Dieses sollte sich unter dem Dokument-Stammverzeichnis des Websservers befinden. http://host/shopsite/shopsite-images.

MALL_LOCALE
Das Gebiet/die Sprache für die Händler-Oberfläche. Das Gebiet muss in der Datei localeinfo.dat im ShopSite-Verzeichnis definiert sein, zum Beispiel en-US.

UNIX_WEB_USER_ID
Die Webserver-Benutzer-ID.

UNIX_WEB_GROUP_ID
Die Webserver-Gruppen-ID.

PATH_TO_PERL
Absoluter Pfadname zur ausführbaren Perl-Datei, zum Beispiel /usr/bin/perl.

PATH_TO_TAR
Absoluter Pfadname zur ausführbaren tar-Datei, zum Beispiel /bin/tar.

PATH_TO_SENDMAIL
Absoluter Pfadname zur ausführbaren sendmail-Datei, zum Beispiel /usr/bin/sendmail.

LOG_DEBUG
Sezten Sie diese Variable auf JA (nur Großbuchstaben), um die Protokollierung von Debug-Meldungen in einer Protokolldatei zu aktivieren.

DEBUG_LOG_DIRECTORY
Der vollständige Pfadname, ohne den Dateinamen, unter dem die Protokolldatei gespeichert wird.

DEBUG_LOG_FILE
Der Name der Protokolldatei.

BACKUP_ON_UPDATE
Geben Sie NEIN ein, wenn es sich um eine neue Installation handelt. Wenn Sie eine vorhandene Mall aktualisieren, geben Sie JA ein, damit das Updateskript die vorhandenen ShopSite-Verzeichnisse in tar-Dateien sichert. Die tar-Dateien können umfangreich werden, deshalt sollten Sie NEIN eingeben, wenn auf Ihrem System nur wenig Speicherplatz zur Verfügung steht.
Hinweis: Tar auf Solaris hat Probleme mit symbolischen Links, die mehr als 99 Zeichen umfassen, und nimmt diese Links möglicherweise nicht in die tar-Datei auf.

TRANSACT_HOST_NAME
Host- oder Domänenname des Transact-Systems, zum Beispiel paydemo.openmarket.com.

TRANSACT_HTTP_PORT
Die HTTP-Portnummer des Transact-Systems, normalerweise 80.

TRANSACT_SSL_PORT
Die SSL-Portnummer des Transact-Systems, normalerweise 443.

MALL_SECURITY_DIRECTORY
Absoluter Pfadname des Mallsicherheitsverzeichnisses, indem Schlüsseldateien und andere dazugehörige Dateien gespeichert sind. Falls dieses Verzeichnis nicht bereits vorhanden ist, wird es erstellt.

KEY_PASSWORD
Kennwort für die Schlüsseldatenbank. Das Kennwort muss 8 bis 20 Zeichen enthalten, darunter mindestens eine Ziffer oder einen Großbuchstaben. Kennwörter, die nur als Kleinbuchstaben bestehen, sind unzulässig. Dieses Kennwort muss nicht unbedingt identisch sein mit dem Kennwort, das für das Konto des Hostadministrators verwendet wird.

HOST_ADMIN_EMAIL
Die E-Mail-Adresse des Hostadministrators. Achten Sie darauf, die korrekte Adresse anzugeben, da möglicherweise wichtige Nachrichten zur Mall- oder Shoperstellung gesendet werden.

HOST_ADMIN_USER_NAME
Der Benutzername für das Konto des Hostadministrators im Transact-System.

HOST_ADMIN_PASSWORD
Das Kennwort für das Konto des Hostadministrators im Transact-System.

Die folgenden Variablen müssen Sie nur einmal festlegen, Sie können sie aber jederzeit ändern.

SCREEN_PACK
Gibt die zu verwendende Screen Pack Version an. Sollte auf ShopSite/v4.2.1 gesetzt werden.

MINIMUM_USERNAME_LENGTH
Die Mindestlänge der Benutzernamen der Händler. Im Allgemeinen sollten Benutzernamen mindestend acht Zeichen enthalten.

MAXIMUM_USERNAME_LENGTH
Die Höchstlänge der Benutzernamen der Händler. 20 ist eine geeignete Höchstzahl.

MINIMUM_PASSWORD_LENGTH
Die Mindestlänge der Kennwörter der Händler. Im Allgemeinen sollten nur Kennwörter mit mindestens acht Zeichen zulässig sein.

MAXIMUM_PASSWORD_LENGTH
Die Höchstlänge der Kennwörter der Händler. 20 ist eine geeignete Höchstzahl.

LOW_WATERMARK
Zahl, die einen Schwellenwert angibt. Wenn im die Zahl der im Transact-System für neue Händler zur Verfügung stehenden Shops untern diesen Schwellenwert fällt, wird der Hostadministrator per E-Mail benachrichtigt, mehr Shops anzufordern. Nährere Informationen zum Anfordern von Shops finden Sie unter Laufende Aufgaben am Ende dieser Anleitungen.

MONTHLY_KEY_ROLL_SCRIPT
Der Dateiname des Schlüsselerstellungsskript, das vom Skript start_install_mall_tx erstellt werden soll. Diese Datei wird im MALL_SECURITY_DIRECTORY gespeichert.

PROXY_SERVER
(Optional) Der Servername Ihres Proxyservers.

PROXY_PORT
(Optional) Die Portnummer des Proxyservers.

Überprüfen Sie die eingestellten Werte sorgfältig und speichern und schließen Sie die Datei.

Erstellen Sie eine Kopie der Datei config_mall.aa, damit sie Ihnen nach einem versehentlichen Überschreiben oder Löschen zur Verfügung steht.

Ausführen des Skripts start_install_mall_tx

Das Skript start_install_mall_tx führt die erste Konfiguration der ShopSite-Software auf dem Inhaltserver durch.

Achten Sie darauf, dass die UNIX_WEB_USER_ID und die UNIX_WEB_GROUP_ID als "Eigentümer" und "Gruppe" der Verzeichnisse SHOPSITE_DIRECTORY und SHOPPING_CART_DIRECTORY festgelegt sind

Melden Sie sich beim Konto UNIX_WEB_USER_ID an, oder melden Sie sich als Superuser (su) an.

Vergewissern Sie sich, dass sich die Datei csp.id im selben Verzeichnis wie das Skript start_install_mall_tx.ksh befindet.

Führen Sie das Skript aus.
% start_install_mall_tx.ksh config_mall.aa 1 ¹

Registrieren als Hostadministrator

Sie müssen sich beim Transact-System als Hostadministrator für Ihre Mall registrieren lassen, sodass Ihnen Shops zugewiesen werden können und Sie bestimmte Funktionen für die Shops ausführen können.

Öffnen Sie einen Webbrowser und gegen Sie zu dem URL, der vom Transact-Administrator angegeben wurde und die folgende Form haben sollte:
http://transact_host_name/tms-ts/keymaster/register.cgi

Geben Sie keinen Benutzernamen und kein Kennwort ein. Klicken Sie auf die Schaltfläche "Abbrechen". Wenn die Seite für Benutzernamen und Kennwort angezeigt wird, wählen Sie die Option, sich registrieren zu lassen.

Geben Sie auf der Seite "Hostadministratorkonto erstellen" alle erforderlichen Informationen ein. Das Transact-System prüft, ob die angegebene E-Mail-Adresse eindeutig ist. Sie können keine E-Mail-Adresse verwenden, die bereits vom System registriert wurde.

Suchen Sie die Datei sok-file.txt im Verzeichnis MALL_SECURITY_DIRECTORY auf dem Inhaltserver. Öffnen Sie die Datei und kopieren Sie den Inhalt der Datei in den Abschnitt "Zertifikat" auf der Seite "Konto erstellen". Kopieren Sie den gesamten Inhalt, von der Zeile
-----BEGIN PRIVACY-ENHANCED MESSAGE-----

bis einschließlich der Zeile
-----END PRIVACY-ENHANCED MESSAGE-----

Senden Sie die Registrierung ab.

Wenn Informationen fehlen oder ungültig sind, werden Sie aufgefordert, dies zu korrigieren. Andernfalls wird Ihr Hostadministratorkonto erstellt, und Sie werden aufgefordert sich anzumelden. Geben Sie Ihren Benutzernamen und Ihr Kennwort ein um fortzufahren.
Hinweis: Sie müssen sich den Hostadministrator-Benutzernamen und das Kennwort merken. Setzen Sie nicht die Sicherheit Ihrer Mall auf's Spiel, indem Sie beides aufschreiben, sodass unberechtigte Personen die Informationen finden könnten.

Forden Sie auf der Seite "Keymaster-Verwaltungsfunktionen" einige Shops an. (Es empfiehlt sich, jeweils die Shops für zwei bis vier Wochen auf einmal anzufordern.) Sie werden per E-Mail benachrichtigt, wenn Ihre Shops bereit sind.

Scrollen Sie auf der Seite nach unten bis zum Abschnitt "Download Our Certificate". Klicken Sie, um das Transact-Systemzertifikat herunterzuladen. Achten Sie unbedingt darauf, es im Verzeichnis MALL_SECURITY_DIRECTORY unter dem Dateinamen keyscv-cert.txt zu speichern.

Warten Sie, bis Sie eine E-Mail-Nachricht erhalten, dass Ihnen die Shops zugewiesen werden. Fahren Sie erst dann fort, wenn Ihrem Hostadministratorkonto Shops zugewieden wurden.

Ausführen des Skripts start_install_mall_tx (zum zweiten Mal)

Wenn Ihnen neue Shops gewährt werden, müssen Sie das Skript start_install_mall_tx ein zweites Mal ausführen, um die Konfiguration des Inhaltservers für die Verwendung mit dem Transact-System abzuschließen.

Melden Sie sich beim Konto UNIX_WEB_USER_ID an, oder melden Sie sich als Superuser (su) an.

Führen Sie das Skript folgendermaßen aus:
% start_install_mall_tx.ksh config_mall.aa 2 ¹

Dabei gibt 2 an, dass Sie das Skript zum zweiten Mal ausführen.

Konfigurieren des Webservers

Konfigurieren Sie den Webserver so, dass er die neuen Verzeichnisse erkennt:

Ordnen Sie den SHOPSITE_URL als Alias zu, sodass er auf SHOPSITE_DIRECTORY weist.
Ordnen Sie den SHOPPING_CART_URL als Alias zu, sodass er auf SHOPPING_CART_DIRECTORY weist.

Aktualisieren

So aktualisieren Sie Ihre Mall von einer früheren ShopSite TX-Version auf Version 4.3:

Ändern Sie Eigentümer und Berechtigungen (optional). Bei der Installation früherer Versionen von ShopSite TX als Version 4.1 mussten Sie sich als root-Konto anmelden. In Version 4.3 ist dies nicht der Fall. Das Upgrade müssen Sie jedoch als root ausführen, oder Sie müssen die Eigentümer und die Berechtigungen für alle ShopSite-Dateien und -Verzeichnisse zu UNIX_WEB_USER_ID ändern. Es wird empfohlen, das Upgrade vom root-Konto auszuführen, wenn Sie ShopSite ursprünglich von diesem Konto aus installiert haben.

Bearbeiten Sie die Datei config_mall.aa wie in den Anleitungen in Abschnitt III.A beschrieben. Es wird dringend empfohlen, dass Sie BACKUP_ON_UPDATE auf JA setzen, damit das Upgradeskript alle ShopSite-Verzeichnisse in einer tar-Datei packt. Sollten Probleme auftreten, können Sie die Datei entpacken und wieder mit der früheren Version arbeiten. Die Option BACKUP_ON_UPDATE kann unter Umständen viel Speicherplatz benötigen, deshalb sollten Sie vor der Installation prüfen, ob genügend freier Speicher verfügbar ist. Wie viel Speicherplatz benötigt wird, richtet sich nach der Anzahl und Größe der Shops in Ihrer Mall.
Hinweis: Tar auf Solaris hat Probleme mit symbolischen Links, die mehr als 99 Zeichen umfassen, und nimmt diese Links möglicherweise nicht in die tar-Dateien auf.

Aktualisieren Sie Ihre Mall mit dem folgenden Befehl:
% start_update_mall_tx.ksh config_mall.aa

Beachten Sie, dass die Aktualisierung jedes Shops auf der Transact-Seite 20 Sekunden dauert. Das heißt, es können 180 Shops pro Stunde aktualisiert werden. Dazu kommt noch die Zeit, die für die Aktualisierung aller mall-weiten Dateien benötigt wird.

Initialisierung der Shops

Die Datei config_store.aa und das Skript start_install_store_tx.ksh dienen als Beispiel, um das grundlegende Skript install_store_tx.ksh aufzurufen, das Shops erstellt und initialisiert. Diese Skripte akzeptieren Befehlszeilenparameter wie die vom Skript start_install_store_tx.ksh weitergegebenen. Sie können das Beispielskript individuell anpassen oder ein eigenes Skript erstellen. Es ist möglich, den Server so konfigurieren, dass der Shop ohne Eingriff eines Operators erstellt werden kann, wenn ein Händler mit dem Ausfüllen eines Online-Formulars einen Shop anfordert.

Bearbeiten der Datei config_store.aa

Das Skript start_install_store_tx liest die Einstellungen in der Datei config_store.aa und erstellt die Verzeichnisse data und HTML für einen neuen Shop und führt weitere Konfigurationen auf dem Inhaltserver durch. Sie können entweder jedes Mal, wenn Sie einen Shop erstellen, die Konfigurationsdatei bearbeiten, um die Werte für diesen Shop einzustellen, oder das Skript so konfigurieren, dass es Befehlszeilenvariablen aktzeptiert. In dieser Anleitung wird beschrieben, welche Variablen gesetzt werden müssen.

Öffnen Sie die Datei config_store.aa mit einem Editor und stellen Sie Werte für die folgenden Variablen ein. Setzen Sie die Werte nicht in Anführungszeichen.

SHOPSITE_STORE_ID
Der Benutzername eines Händlers, idealerweise 8 bis 80 Zeichen lang. Mit diesem Benutzernamen ruft der Händler ShopSite auf (der SHOPSITE_URL ist durch ein Kennwort geschützt).

SHOPSITE_SELLER_PASSWORD
Das Kennwort, das der SHOPSITE_STORE_ID zugeordnet ist. Es sollte 8 bis 20 Zeichen enthalten, darunter wenigstens eine Ziffer. Mit diesem Kennwort ruft der Händler ShopSite auf (der SHOPSITE_URL ist durch ein Kennwort geschützt).

STORE_FRONT_URL
Absoluter URL des Shops, den die Kunden des Händlers über das Internet besuchen.

SELLER_EMAIL
Die E-Mail-Adresse des Händlers. Diese muss unbedingt korrekt sein, da der Händler über E-Mail Benachrichtungen für Bestellungen und andere wichtige Informationen erhält.

DATA_DIRECTORY
Absoluter Pfadname zum Datenverzeichnis des Shops des Händlers. In diesem Verzeichnis sind die Produkt- und Seitendatenbanken gespeichert.

HTML_DIRECTORY
Absoluter Pfadname zum HTML-Verzeichnis des Shops des Händlers. In diesem Verzeichnis sind die HTML-Seiten des Shops gespeichert.

SELLER_USER_ID
Die UNIX-Benutzer-ID, dem dem HTML-Verzeichnis des Shops zugeordnet ist. Sie können jedem Händler eine eigene Benutzer-ID zuordnen oder dieselbe ID für alle Händler verwenden.

SELLER_GROUP_ID
Die UNIX-Gruppen-ID, dem dem HTML-Verzeichnis des Shops zugeordnet ist.

PRODUCT_TYPE
Geben Sie die Servicestufe des Shops ein: pro, mgr, lte oder exp.

STORE_LOCALE
Das Gebiet des Shops, wie es vom Transact-System erkannt wird. Geben Sie kein Gebiet an, für das kein Sprachenpaket installiert ist.

STORE_CURRENCY
Die im Shop verwendete Währung. Dabei muss es sich um einen dreibuchstabigen ISO 4217 Währungscode handeln, wie sie in der Datei currency.dat im ShopSite-Verzeichnis definiert werden.

STORE_TYPE
0 = einmal zahlen

PAGE_LIMIT
Die Höchstzahl der Seiten, die ein Händler erstellen kann.

PRODUCT_LIMIT
Die Höchstzahl der Produkte, die ein Händler erstellen kann.

UPDATE_HTPASSWD
Standardmäßig auf YES gesetzt, wodurch das Installationsskript die Datei .htpasswd aktualisiert. Wenn Sie NO einstellen, aktualisiert das Skript die Datei nicht.

TRANSACT_SELLER_ID
Der Benutzername des Händlers im Transact-System. Wenn Sie dieses Feld nicht ausfüllen, wird die SHOPSITE_STORE_ID verwendet und der Händler hat denselben Benutzernamen für ShopSite und das Handeslzentrum. Es wird empfohlen, dass Händler in beiden Systemen denselben Benutzernamen und dasselbe Kennwort haben.

TRANSACT_SELLER_PASSWORD
Das Kennwort des Händlers im Transact-System. Wenn Sie dieses Feld nicht ausfüllen, wird das SHOPSITE_SELLER_PASSWORD verwendet und der Händler hat dasselbe Kennwort für ShopSite und das Handelszentrum. Es wird empfohlen, dass Händler in beiden Systemen denselben Benutzernamen und dasselbe Kennwort haben.

SHOPSITE_STORE_NAME
Der Name des Shops.

SELLER_CHALLENGE
Eine Frage, deren Antwort nur der Händler kennen sollte, zum Beispiel "Welche Sorte Eiskrem essen Sie am liebsten?"

SELLER_CHALLENGE_ANSWER
Die Antwort auf die Frage SELLER_CHALLENGE.

SELLER_PERSONAL_NAME
Der Name des Händlers.

SELLER_TAX_PLAN
Die Steuerart, die der Shop berechnet:

us - innerhalb der USA und Umsatzsteuer wird berechnet
no - innerhalb der USA und Umsatzsteuer wird nicht berechnet
vat - in einem MWSt-Land und Mehrwertsteuer wird berechnet
nov - in einem MWSt-Land und Mehrwertsteuer wird nicht berechnet

SELLER_ADDRESS1
Die erste Zeile der Postadresse des Händlers.

SELLER_ADDRESS2
Die zweite Zeile der Postadresse des Händlers, falls erforderlich.

SELLER_CITY
Die Stadt des Händlers.

SELLER_STATE
Der Bundesstaat des Händlers.

SELLER_POST_CODE
Die Postleitzahl des Händlers.

SELLER_COUNTRY
Das Land des Händlers.

SELLER_PHONE
Die Telefonnummer des Händlers.

STORE_LANGUAGE
Die Standardsprache für den Shop.

STORE_CUSTOMER_SERVICE_URL
Die vollständige URL-Adresse zur Kundendienstseite des Shops.

STORE_CUSTOMER_SERVICE_EMAIL
Die E-Mail-Adresse, unter der der Kundendienst des Shops erreichbar ist.

STORE_DECIMAL_SEPARATOR
Das Dezimaltrennzeichen für die Preise; normalerweise ein Punkt oder ein Komma. (Geben Sie das Zeichen ein, nicht den Namen des Zeichens.)

STORE_PAYMENT_BRANDS
Eine Liste der Zahlungsarten, durch Leerzeichen getrennt, zum Beispiel VI MA.
Hinweis: Wenn die "Demo"-Zahlungsart zusammen mit tatsächlichen Zahlungsarten aufführen, kann nur die Demo-Zahlungsart verwendet werden, auch wenn die anderen Arten im Bestellformular genannt werden.

SHIPPING_1_NAME
Der Name der ersten Versandart, die von den Kunden gewählt werden kann. Wenn Sie dieses Feld nicht ausfüllen, wird diese Versandart nicht konfiguriert.

SHIPPING_1_BASEPRICE
Die Basisgebühr für Lieferungen, die mit der ersten Versandart zugestellt werden. Wenn Sie diese Option auf 0 setzen, wird für den Versand mit dieser Methode nur der SHIPPING_1_ADDPRICE berechnet.

SHIPPING_1_ADDPRICE
Der Betrag, der zum SHIPPING_1_BASEPRICE für jede Gewichtseinheit der Bestellung hinzugefügt wird. Die Versandkosten werden nach der folgenden Formel berechnet: shipping_price = baseprice + addprice * (Gewicht - 1). Wenn Sie diese Option auf 0 setzen, wird für den Versand mit dieser Methode nur der SHIPPING_1_BASEPRICE berechnet.

SHIPPING_2_NAME
Der Name der zweiten Versandart, die von den Kunden gewählt werden kann. Wenn Sie dieses Feld nicht ausfüllen, wird diese Versandart nicht konfiguriert.

SHIPPING_2_BASEPRICE
Die Basisgebühr für Lieferungen, die mit der zweiten Versandart zugestellt werden. Wenn Sie diese Option auf 0 setzen, wird für den Versand mit dieser Methode nur der SHIPPING_2_ADDPRICE berechnet.

SHIPPING_2_ADDPRICE
Der Betrag, der zum SHIPPING_2_BASEPRICE für jede Gewichtseinheit der Bestellung hinzugefügt wird. Die Versandkosten werden nach der folgenden Formel berechnet: shipping_price = baseprice + addprice * (Gewicht - 1). Wenn Sie diese Option auf 0 setzen, wird für den Versand mit dieser Methode nur der SHIPPING_2_BASEPRICE berechnet.

SHIPPING_3_NAME
Der Name der dritten Versandart, die von den Kunden gewählt werden kann. Wenn Sie dieses Feld nicht ausfüllen, wird diese Versandart nicht konfiguriert.

SHIPPING_3_BASEPRICE
Die Basisgebühr für Lieferungen, die mit der dritten Versandart zugestellt werden. Wenn Sie diese Option auf 0 setzen, wird für den Versand mit dieser Methode nur der SHIPPING_3_ADDPRICE berechnet.

SHIPPING_3_ADDPRICE
Der Betrag, der zum SHIPPING_3_BASEPRICE für jede Gewichtseinheit der Bestellung hinzugefügt wird. Die Versandkosten werden nach der folgenden Formel berechnet: shipping_price = baseprice + addprice * (Gewicht - 1). Wenn Sie diese Option auf 0 setzen, wird für den Versand mit dieser Methode nur der SHIPPING_3_BASEPRICE berechnet.

VAT_NUMBER
Die Umsatzsteuer-ID des Shops oder eine beliebige Zeichenfolge. Die Zahl oder die Zeichenfolge, die Sie hier eingeben, erscheint auf allen MWSt-Rechnungen und Gutschriften, die Sie an Ihre Kunden ausgeben. Lassen Sie das Feld leer, wenn der Händler keine Umsatzsteuer-ID angeben möchte.

DEFAULT_VAT_COUNTRY
Ein zweistelliger Ländercode, der angibt, in welchem Land der Händler MWSt berechnet.

STORE_SERVICE_LEVEL
Wählen Sie Gold oder Silber, um die Funktionen festzulegen, die dem Händler im Handelszentrum zur Verfügung stehen. Silberne Shops nehmen lediglich Bestellungen auf (keine Verarbeitung von Online-Zahlungen) und ermöglichen es dem Händler nicht, die Konten von Kunden oder Angestellten zu verwalten.

Überprüfen Sie die eingestellten Werte sorgfältig und speichern und schließen Sie die Datei.

Erstellen Sie eine Kopie der Dateiconfig_store.aa damit sie Ihnen nach einem versehentlichen Überschreiben oder Löschen zur Verfügung steht.

Ausführen des Skripts start_install_store_tx

Melden Sie sich beim Konto UNIX_WEB_USER_ID an, oder melden Sie sich als Superuser (su) an.

Führen Sie das Skript aus, geben Sie dabei die beiden Konfigurationsdateien als Parameter ein:
% start_install_store_tx.ksh config_mall.aa config_store.aa ¹
Je nach der Linux-Version und Konfiguration auf Ihrem Server sehen Sie möglicherweise eine Fehlermeldung, die besagt, dass der Befehl chown die Option -h nicht unterstützt. Sie können diese Meldung ignorieren, da dies die Installation und Verwendung von ShopSite nicht betrifft.

Konfigurieren des Webservers

Nehmen Sie die folgenden administrativen Änderungen am Webserver vor:

Ordnen Sie den STORE_FRONT_URL als Alias zum HTML_DIRECTORY für den Shop zu.

Fügen Sie den Benutzernamen SHOPSITE_STORE_ID und das Kennwort SHOPSITE_MERCHANT_PASSWORD der Zugriffsliste für das Verzeichnis SHOPSITE_DIRECTORY hinzu.
Hinweis: ShopSite richtet nur Kennwörter im Apache-Typ ein, dabei werden .htaccess-Dateien verwendet. Wenn Sie mit einem Netscape-Server arbeiten, können Sie ihn für die Verwendung von .htaccess-Dateien konfigurieren, indem Sie die Anweisungen auf der Netscape-Site befolgen.

Informieren des Händlers, dass der Shop fertig ist

Die Initialisierung des neuen Shops ist damit abgeschlossen. Wenden Sie sich jetzt an den Händler und geben Sie ihm:

Den URL, den er für die Verwaltung seines Shops benötigt. Dies ist der SHOPSITE_URL mit /start.cgi angehängt.
Die SHOPSITE_STORE_ID (Benutzername) und das SHOPSITE_SELLER_PASSWORD (Kennwort). Beides wird für die Anmeldung an ShopSite benötigt.

Laufende Aufgaben

Erstellen von Schlüsseln

Als Hostadministrator der Mall sind Sie für die Sicherheit der Mall verantwortlich, indem Sie jeden Monat neue geheime Schlüssel erstellen und vom Inhaltserver auf das Transact-System hochladen. Wenn die Schlüssel nicht wenigstens einmal im Monat aktualisiert werden, akzeptiert das Transact-System keine Bestellungen von den Shops in Ihrer Mall. Das Erstellen von Schlüsseln kann automatisiert werden, indem Sie mit dem Befehl cron ein Skript ausführen, das im Lieferumfang enthalten ist.
Das Skript key_roll.monthly befindet sich im Verzeichnis MALL_SECURITY_DIRECTORY. Bearbeiten Sie die Datei crontab, um dieses Skript jeweils vor dem Monatsende auszuführen. Sorgen Sie dafür, dass dieses Skript nur vom Konto des Hostadministrator gelesen und ausgeführt werden kann.
Wichtig: Sie müssen das Skript key_roll.monthly jedes Mal ausführen, wenn neue Shops angefordert und vom Transact-Administrator gewährt wurden. Wenn zum Beispiel der Hostadministrator 20 neue Shops anfordert und der Transact-Administrator die Shops gewährt, sind die 20 Shops zwar verfügbar, sie haben aber keinen Schlüssel. Ohne Schlüssel können in keinem der neuen Shops Bestellungen aufgegeben werden. Das Skript key_roll.monthly erstellt neue Schlüssel für alle Shops in der Mall und übergibt dem Transact-System Kopien der Schlüssel, damit Bestellungen verarbeitet werden können.
Anfordern neuer Shops

Wenn die Anzahl der noch nicht zugeordneten Shops für neue Händler unter den spezifizierten Schwellenwert fällt, wird der Hostadministrator per E-Mail benachrichtigt. Der Hostadministrator sollte dann über den Bildschirm "Transact Keymaster-Verwaltungsfunktionen" neue Shops anfordern. Den URL für diesen Bildschirm haben Sie vom Transact-Administrator erhalten. Die angeforderten neuen Shops werden nicht unbedingt gewährt. Überprüfen Sie, ob Ihnen die neuen Shops gewährt wurden, gehen Sie nicht davon aus, dass Sie neue Shops haben, nur weil Sie diese angefordert haben. Das Skript start_install_store_tx kann nicht fortfahren, wenn nicht wenigstens ein Shop verfügbar ist.

Anpassen von ShopSite

Sie können Teile der Oberflächen, die Händler und Kunden während der Verwendung von ShopSite sehen, verändern. Weitere Informationen finden Sie auf der Seite ShopSite anpassen.

Fußnoten

¹ Alle Skripte wurden für die Ausführung unter einer Korn-Shell (ksh) geschrieben. Wenn auf Ihrem Server keine Korn-Shell installiert ist, müssen Sie eventuell die Skripte so bearbeiten, dass sie unter einer anderen Shell ausgeführt werden können, Wenn es Probleme bei der Ausführung der Skripte gibt, geben Sie "./" vor dem Skriptnamen ein, zum Beispiel ./start_install_cgi anstelle von start_install_cgi.

ShopSite TX 4.3 Installationsanweisungen für den Inhaltserver

ShopSite TX 4.3
Installationsanweisungen für den Inhaltserver