Installation with SSH

Introduction

This document describes the installation of the PepperShop system via an SSH connection to your your Linux / UNIX web server. The target audience are store operators and system administrators. If you do not have SSH access to your web server, we provide you with the instructions for manual installation without Telnet/SSH:

https://www.peppershop.com/peppershop_files/installation_ohne_telnet_ssh.pdf

Installation procedure

Overview

This guide takes you through the installation process on your web server in four steps

1. information required before installation
2. download your copy of the PepperShop
3. copy to your web server
4. start the installation program and work through it

Information required before installation

System requirements must be met

Please first check whether your current hosting package meets the system requirements of the PepperShop version to be installed. the PepperShop version to be installed. This information is described in a PepperShop FAQ: http://www.peppershop.com/faq.php#3

Required access data

Here is a small checklist of data that you need to have ready before you start the installation start the installation:

• SSH host
• SSH user
• SSH pass
• MySQL host
• MySQL database
• MySQL User
• MySQL Pass
• Shop-Webroot [^1] (See also chapter 2.4: Copying to your web server)
• PepperShop User
• PepperShop Pass

Please also consider the following specification: Shop-Webroot: Target directory on your web server where the shop where the store must be installed so that it can be accessed at the desired address on the web. You also need an active PepperShops license so that you can download and operate the store (PepperShop Pass). (PepperShop account: user name + password).

Download your PepperShop

Log in to the PepperShop sales system and download the latest copy of your PepperShop download. After purchasing the store, you can download all new versions free of charge for one year, including major versions. download, including major versions[^2].

1. Open the PepperShop sales system in the browser: http://www.peppershop.com/shop/
2. Log in with the PepperShop account data (user/password).
3. Under ‘Downloads’ select your PepperShop version ‘Basic / Professional / Connect’ and then select the package for download. then select the package for download. If your downloads are deactivated, you may need to purchase a license extension. This entitles you to download all newly released store versions within one year. within one year. Buy a PepperShop license extension: Basic / Professional or Connect. Please note that license extensions can only be ordered with an account with which a full version was previously purchased. version has been purchased. Also download any modules that you have purchased.

Copy to your web server

Unpacking files

First unpack the downloaded .tar.gz archive or ZIP archive. This can usually be done with the on-board tools of your operating system. For Linux / UNIX, for example, with the following command: tar xfz peppershop_professional_v_x_y_z.tar.gz

Shop-Webroot directory explained

After unpacking the files, we immediately connect to the web server via SSH and change to the correct directory to the correct directory (Shop Webroot). In most cases, the store should be started directly after entering the domain or subdomain name in the browser line or it should be available in a subdirectory. available in a subdirectory. Here are some examples.

In some cases, before the possible directories mentioned here, there is something like /home/user/ or other path parts (for example /home/my-user/public_html).

Copy #### files to the web server

Now copy the unpacked PepperShop directory to your store webroot. Linux / UNIX users do this directly on the console or use an SSH program for Windows to transfer files via transfer files via SCP, e.g. the free WinSCP[^3]. Linux / UNIX / Mac console: scp -rC phpeppershop_src {SSH-User}@{SSH-Host}:{Shop-Webroot}/ An overall example: scp -rC phpeppershop_src meinbenutzer@www.meinedomain.com:/www/

On Windows computers, all you have to do is select all the files in the unpacked directory (phpeppershop_src) and drag them into the directory on the right-hand side of the window (server view).

Start the installation program and work through it

Now establish an SSH connection to your web server. To do this, use your Linux / UNIX con- sole (ssh {SSH-User}@{SSH-Host} , e.g. ssh my-user@www.meinedomain.com) or use an SSH program for Windows such as Putty [^4].

Now change to your store webroot directory. Here you change to the directory you uploaded earlier directory peppershop_src and run the PERL based installation program of the Pepper- store installation program: cd phpeppershop_src perl ./config.pl You will now be guided through a few query pages before you are shown an overview of the specified data. of the specified data is displayed. If you confirm that it is correct, the actual installation will proceed (creating a store directory, copying the store files, filling and transferring tem plate files, importing the preconfigured store database). We will now go through the various screens:

Installation program part 1 of 5: Entering data

Select the language of the administration. You can always add more languages later. Enter the Name of the store database on the first page. The installation tool uses this also uses this as the directory in which the preconfigured store will be copied. In most cases, you have already created and linked this database together with the MySQL user and their password in the Provider Control Panel. If you are MySQL root on this web server, you can choose freely here. When asked for the Database host name, enter the computer on which your MySQL database is running. database is running. With many web hosts, this is the same computer as the web server, in which case you enter lo- calhost, otherwise enter the computer name given to you by your provider. The installation program now searches for a MySQL Monitor program with which the database can be read in later. database can be read in later. If it finds one, it asks whether it should use it. use it. Confirm this with ‘y’. Info: If no MySQL monitor is found, the database must be imported manually. must then be imported manually in any case. Specify whether the installation system should create the MySQL user(s) from scratch or whether they already exist. already exist. In the case of shared hosting, the MySQL user already exists and you can confirm with ‘n’ for “no, do not create”. If you have root rights, you can easily create the users here. here. Now enter the MySQL user and their password. An overview is now displayed. Please check this again for correctness and confirm by clicking on Return. confirm that the installation should be continued by clicking on Return.

*You can cancel at any time with CTRL + C (German keyboard: STRG + C).

Installation program part 2 of 5: Create directories/files

In the second step, the store creates the files and directories of the preconfigured store. If necessary, the Composer packages are also installed in this step. These are normally already contained in the ZIP archive. Click on Return to continue.

Installation program part 3 of 5: Create configuration files

The configuration files and templates have now been created or transferred. Click on the Return button to continue the installation program.

Installation program part 4 of 5: Configuring access rights

The store now configures the access rights for a Linux / UNIX computer where PHP is running as a web server module. If this is not the case for you, this will be explained later.

Installation program part 5 of 5: Insert MySQL database

In the last part you specify whether the store database should be created in the MySQL database management system? should be created? In most cases this is what you want and confirm with ‘y’. You will then be asked for the MySQL user user and his password. The store now inserts all tables into the specified MySQL database and populates it with a demo database. The menu-guided installation is now complete and the pre-configured store is located in the directory, which was previously specified with the database name (at the same directory level as phpeppershop_src). Now you can move up one directory level and rename the newly created directory with the database name: cd .. mv {new_created_directory} {my_desired_shop_directory_name} or copy all files into the current directory if the store is to be displayed directly when you call up the domain / subdomain: mv {new_created_directory}/. ./* Now you have to clean up: We delete the empty installation directory and the peppershop_src directory: **rmdir {new_created_directory} rm -r peppershop_src**

Clean up data using a cron job

A periodically started call should be set up for the PepperShop, which carries out daily tasks (clean-up work, queue forwarding, subscription processing, etc.). Among other things the database is cleaned and cache entries that are no longer required are emptied.

On UNIX/Linux systems, for example, you can use a cron job with the following command: 5 0 * * * cd {shopdirectory}shop/Admin/; php garbage_collection.php commandline

If CRON cannot be used, the following URL can also be opened in the browser: http[s]://{www.ihredomain.tld}/{webshop_directory}/shop/Admin/garbage_collection.php

What next?

First steps

The store is ready, now it’s time to configure it and explain how to handle orders. orders. It is best to read the document ‘First steps’, which answers many questions from new Pepper- Store administrators.

Detailed instructions for the next steps: docs.peppershop.com/latest/en/first-steps/

If you have any questions about the PepperShop, a click on the help archive on the left in the main menu of your PepperShop administration. Further help can be found in the extensive PepperShop forums at https://www.peppershop.com, or individually via the support package.

Further help

Do you need further support? PepperShop provides you with various options.

• A click on the question mark icon in the top right-hand corner of the administration often helps. Here you can get direct help on the topic in question.
• You can find various answers in the FAQ. These can also be accessed in the store administration via Help&News -> Help archive. Or via our homepage https://www.peppershop.com/de/services/support/faq/
• In the PepperShop Academy https://www.peppershop.com/de/services/academy/ you can easily and conveniently find various free video tutorials.
• We are also happy to help you by e-mail or telephone (CHF 185./h) support@glarotech.ch or +41 71 923 08 58