Bitnami LAMP for Huawei Enterprise Cloud

Transcription

1 Bitnami LAMP fr Huawei Enterprise Clud Descriptin Bitnami LAMP Stack prvides a cmplete PHP, MySQL and Apache develpment envirnment fr Linux that can be launched in ne click. Hw can I get started with LAMP? Once the deplyment finishes, yu can access the welcme page frm yur brwser: Regardless f hw yu access it, yu shuld see a page similar t the examples belw: T get started with Bitnami AMP stacks, we suggest the fllwing steps: Step 1. Deply yur PHP applicatin.

2 The main directry t deply yur PHP applicatin is /pt/bitnami/apache2/htdcs. Yu can cpy yur PHP applicatin files t that directry and access the applicatin via yur brwser. If yu d nt have a PHP applicatin yet, we suggest deplying the PHP inf example. D yu have issues trying t cnnect t yur server? Check ur FAQ. Step 2. Add a Bitnami applicatin n tp f the AMP stack. Yu can install additinal Bitnami applicatins n tp f an AMP stack using mdule installers. Yu can dwnlad WrdPress, Drupal, Magent, Mdle amng ther applicatins frm the Bitnami website and extend the functinality f yur server. Yu can see mre inf in ur step-by-step guide. Step 3. Access phpmyadmin. phpmyadmin is a PHP-based applicatin intended t handle the administratin f MySQL ver the Web. Find mre infrmatin n hw t access phpmyadmin. Hw t start r stp the services? Each Bitnami stack includes a cntrl script that lets yu easily stp, start and restart services. The script is lcated at /pt/bitnami/ctlscript.sh. Call it withut any service name arguments t start all services: sud /pt/bitnami/ctlscript.sh start Or use it t restart a single service, such as Apache nly, by passing the service name as argument: sud /pt/bitnami/ctlscript.sh restart apache Use this script t stp all services: sud /pt/bitnami/ctlscript.sh stp Restart the services by running the script withut any arguments: sud /pt/bitnami/ctlscript.sh restart Obtain a list f available services and peratins by running the script withut any arguments:

3 sud /pt/bitnami/ctlscript.sh Hw can I run a cmmand in the Bitnami LAMP Stack? Bitnami clud images have been already cnfigured t run any cmmand in the server directly. Yu can run the fllwing nes t check the versins f the cmpnents that are already installed: php --versin PHP (cli) (built: Jun :31:52) Cpyright (c) The PHP Grup Zend Engine v2.5.0, Cpyright (c) Zend Technlgies with Zend OPcache v7.0.4-dev, Cpyright (c) , by Zend Techn lgies mysql --versin /pt/bitnami/mysql/bin/mysql.bin Ver Distrib , fr linux-gl ibc2.5 (x86_64) using EditLine wrapper httpd -v Server versin: Apache/ (Unix) Server built: Jun :43:35 Hw t uplad files t the server with SFTP? NOTE: Bitnami applicatins can be fund in /pt/bitnami/apps. When uplading files via SFTP, yu must have the server's IP address, username and passwrd r, if yu chse t deply the server with an SSH key instead f a passwrd, yu must have the server username and crrespnding SSH private key in.ppk frmat (fr Windws) r in.pem frmat (fr Linux and Mac OS X). T btain the IP address fr yur server, fllw these steps: Lg in t the Huawei Clud Server Cnsle. Navigate t the "Cmputing -> Elastic Clud Server" sectin. Nte the public IP address fr the server yu wish t cnnect t.

4 Once yu have cnfirmed that yu have the IP address and crrect SSH credentials fr yur server, fllw the instructins belw depending n the platfrm yu wish t use. Althugh yu can use any SFTP/SCP client t transfer files t yur server, this guide dcuments FileZilla (Windws, Linux and Mac OS X), WinSCP (Windws) and Cyberduck (Mac OS X). Using an SSH Key Once yu have yur server's SSH key, chse yur preferred applicatin and fllw the steps belw t cnnect t the server using SFTP. FileZilla IMPORTANT: T use FileZilla, yur server private key shuld be in PPK frmat. Fllw these steps: Dwnlad and install FileZilla. Launch FileZilla and use the "Edit -> Settings" cmmand t bring up FileZilla's cnfiguratin settings. Within the "Cnnectin -> SFTP" sectin, use the "Add keyfile" cmmand t select the private key file fr the server. FileZilla will use

5 this private key t lg in t the server. Use the "File -> Site Manager -> New Site" cmmand t bring up the FileZilla Site Manager, where yu can set up a cnnectin t yur server. Enter yur server hst name and specify bitnami as the user name.

6 Select "SFTP" as the prtcl and "Ask fr passwrd" as the lgn type. Use the "Cnnect" buttn t cnnect t the server and begin an SFTP sessin. Yu might need t accept the server key, by clicking "Yes" r "OK" t prceed. Yu shuld nw be lgged int the /hme/bitnami directry n the server. Yu can nw transfer files by dragging and drpping them frm the lcal server windw t the remte server windw. If yu have prblems accessing yur server, get extra infrmatin by use the "Edit -> Settings -> Debug" menu t activate FileZilla's debug lg.

7 WinSCP IMPORTANT: T use WinSCP, yur server private key shuld be in PPK frmat. Fllw these steps: Dwnlad and install WinSCP. Launch WinSCP and in the "Sessin" panel, select "SFTP" as the file prtcl.

8 Enter yur server hst name and specify bitnami as the user name. Click the "Advanced " buttn and within the "SSH -> Authenticatin -> Authenticatin parameters" sectin, select the private key file fr the

9 server. WinSCP will use this private key t lg in t the server. Frm the "Sessin" panel, use the "Lgin" buttn t cnnect t the server and begin an SCP sessin. Yu shuld nw be lgged int the /hme/bitnami directry n the server. Yu can nw transfer files by dragging and drpping them frm the lcal server windw t the remte server windw. If yu need t uplad files t a lcatin where the bitnami user desn't have write permissins, yu have tw ptins: Once yu have cnfigured WinSCP as described abve, click the "Advanced " buttn and within the "Envirnment -> Shell" panel, select sud su - as yur shell. This will allw yu t uplad files using the

10 administratr accunt. Uplad the files t the /hme/bitnami directry as usual. Then, cnnect via SSH and mve the files t the desired lcatin with the sud cmmand, as shwn belw: sud mv /hme/bitnami/upladed-file /path/t/desired/lcatin/ Cyberduck IMPORTANT: T use Cyberduck, yur server private key shuld be in PEM frmat. Fllw these steps:

11 Select the "Open Cnnectin" cmmand and specify "SFTP" as the cnnectin prtcl. In the cnnectin details panel, under the "Mre Optins" sectin, enable the "Use Public Key Authenticatin" ptin and specify the path

12 t the private key file fr the server. Use the "Cnnect" buttn t cnnect t the server and begin an SFTP sessin. Yu shuld nw be lgged int the /hme/bitnami directry n the server. Yu can nw transfer files by dragging and drpping them frm the lcal server windw t the remte server windw. Using a Passwrd Once yu have yur server's SSH credentials, chse yur preferred applicatin and fllw the steps belw t cnnect t the server using SFTP. FileZilla Fllw these steps: Dwnlad and install FileZilla. Launch FileZilla and use the "File -> Site Manager -> New Site" cmmand t bring up the FileZilla Site Manager, where yu can set up a cnnectin t yur server. Enter yur server hst name. Select "SFTP" as the prtcl and "Ask fr passwrd" as the lgn type. Use bitnami as the server username and the passwrd generated

13 during the server deplyment prcess. Use the "Cnnect" buttn t cnnect t the server and begin an SFTP sessin. Yu might need t accept the server key, by clicking "Yes" r "OK" t prceed. Yu shuld nw be lgged int the /hme/bitnami directry n the server. Yu can nw transfer files by dragging and drpping them frm the lcal server windw t the remte server windw. If yu have prblems accessing yur server, get extra infrmatin by use the "Edit -> Settings -> Debug" menu t activate FileZilla's debug lg.

14 WinSCP Fllw these steps: Dwnlad and install WinSCP. Launch WinSCP and in the "Sessin" panel, select "SFTP" as the file prtcl.

15 Enter yur server hst name and set bitnami as the server username. Frm the "Sessin" panel, use the "Lgin" buttn t cnnect t the server and begin an SCP sessin. Enter the passwrd when prmpted. Yu shuld nw be lgged int the /hme/bitnami directry n the server. Yu can nw transfer files by dragging and drpping them frm the lcal server windw t the remte server windw. Cyberduck Fllw these steps:

16 Select the "Open Cnnectin" cmmand and specify "SFTP" as the cnnectin prtcl.

17 In the cnnectin details panel, enter the server IP address, bitnami as the username, and the passwrd generated during the deplyment pr Use the "Cnnect" buttn t cnnect t the server and begin an SFTP sessin. Yu shuld nw be lgged int the /hme/bitnami directry n the server. Yu can nw transfer files by dragging and drpping them frm the lcal server windw t the remte server windw. Which cmpnents are included in LAMP? The Bitnami LAMP Stack ships the cmpnents listed belw. If yu want t knw which specific versin f each cmpnent is bundled in the stack yu are dwnlading, check the README.txt file in the dwnlad page r in the /pt/bitnami directry. Yu can als find mre infrmatin abut each cmpnent using the links belw. Main cmpnents:

18 PHP scripting language Apache Web server MySQL/MariaDB database server phpmyadmin web applicatin management tl fr MySQL database Framewrks fr develpment: Zend Framewrk Symfny CdeIgniter CakePHP Smarty Laravel Dependencies and additinal cmpnents: Varnish prxy cache server ImageMagick tl SQLite database MdSecurity mdule XDebug mdule Xcache mdule OAuth mdule Memcache mdule FastCGI mdule APC mdule GD library OpenSSL library CURL library OpenLDAP library PEAR and PECL package manager tls Hw can I deply my PHP applicatin? The main directry t deply yur PHP applicatin is /pt/bitnami/apache2/htdcs. Yu can cpy yur PHP applicatin files t that directry and access the applicatin via yur brwser at Hw can I check the PHP cnfiguratin with phpinf? Sme versins f the Bitnami LAMP Stack include a dcs/ flder in the installatin directry that cntains sme PHP examples. Amng these is a

19 phpinf.php script that shws the current PHP cnfiguratin and is typically used t check that PHP was installed crrectly. In rder t be able t access it, fllw these steps belw: Cpy the phpinf.php script frm the installatin directry t a publicly accessible lcatin under the Web server dcument rt. cp /pt/bitnami/dcs/phpinf.php /pt/bitnami/apache2/htdcs Brwse t Yu shuld see smething like the page belw, which cntains detailed infrmatin n yur PHP deplyment. Hw can I add applicatins n tp f LAMP? Yu can install several applicatin mdules n tp f LAMP. That way, all f the Bitnami-packaged applicatins yu want t run will share a single instance

20 f Apache, MySQL r PstgreSQL (depending n the stack) and PHP, which will save space and imprve perfrmance. Yu can dwnlad and install any PHP-based Bitnami applicatin, including WrdPress, Jmla!, Drupal, SugarCRM and thers, n tp f an existing Bitnami LAMP Stack deplyment. Find a list f all the supprted applicatin mdules. Once yu have dwnladed the applicatin mdule, fllw the steps belw t install it: Change t the directry cntaining the dwnladed mdule and make it executable. Then, execute the installatin script. Fr example, if yu're installing WrdPress, yu wuld use cmmands similar t the fllwing: cd /tmp chmd +x./bitnami-wrdpress-*-mdule-linux-x64-installer.run sud./bitnami-wrdpress-*-mdule-linux-x64-installer.run NOTE: Bitnami ffers bth 32-bit and 64-bit versins f applicatin mdules. Use the versin apprpriate fr yur platfrm. If yu're nt sure whether yu're running a 32-bit r 64-bit perating system, use the uname -a cmmand.

21 During the installatin prcess, yu will need t specify the installatin directry f yur Bitnami LAMP Stack. By default, the installatin directry is /pt/bitnami. During the installatin prcess, yu will als need t specify the current database administratr's passwrd (the passwrd fr user rt fr MySQL databases and user pstgres fr PstgreSQL databases). This passwrd is part f the applicatin credentials. Find ut hw t btain credentials in the FAQ. During the installatin prcess, yu will als be prmpted t create an administratr accunt fr the applicatin, by prviding a user name and/r an address. Sme applicatin mdules may als ask yu t specify a passwrd. NOTE: If nt specifically prmpted fr a passwrd, the default administratr passwrd fr the applicatin is autmatically set t the same value as the database administratr's passwrd prvided in the previus step. This default administratr passwrd can be changed at any time thrugh the applicatin's Web administratin panel r Web dashbard, after the mdule has been successfully installed. After the installatin prcess is cmplete, access the installed applicatin by brwsing t Fr example, if yu have installed WrdPress, yu can access it at T access the applicatin's administratin panel r Web dashbard, use the applicatin administratr accunt credentials set during the mdule installatin prcess. Hw can I run a custm PHP script? Add yur PHP script t the /pt/bitnami/apache2/htdcs/ directry, then brwse t it via the URL where FILENAME is the name f the PHP script. Fr an example, refer t the sectin n using phpinf. NOTE: If yur script file is named index.php, then yu must access it using the URL and nt This is because the Apache server included in the AMP stack is cnfigured t recgnize bth index.html and index.php files by default, but t give the included index.html file pririty. T alter this behaviur, simply mve the /pt/bitnami/apache2/htdcs/index.html file t a different lcatin. What are the "develpment" and "prductin" mdes fr applicatins?

22 Applicatins are cnfigured using prductin mde n clud servers by default. These servers already include a lcal FTP server (vsftpd) that it is nly available fr lcal cnnectins (nt remte cnnectins). Sme applicatins like WrdPress, Jmla!, Magent r Drupal are cnfigured t use this server t dwnlad and install plugins, themes r any extensin. Hw t access phpmyadmin? Fr security reasns, phpmyadmin is accessible nly when using as the hstname. T access it frm a remte system, yu must create an SSH tunnel that rutes requests t the Apache Web server frm This implies that yu must be able t cnnect t yur server ver SSH in rder t access these applicatins remtely. IMPORTANT: Befre fllwing the steps belw, ensure that yur Apache and MySQL servers are running. NOTE: The steps belw suggest using prt 8888 fr the SSH tunnel. If this prt is already in use by anther applicatin n yur lcal machine, replace it with any ther prt number greater than 1024 and mdify the steps belw accrdingly. Similarly, if yu have enabled Varnish, yur stack's Apache Web server might be running n prt 81. In this case, mdify the steps belw t use prt 81 instead f prt 80 fr the tunnel endpint. Windws T access the applicatin using yur Web brwser, create an SSH tunnel, as described belw. Dwnlad PuTTY and make sure yu can lg in t the server cnsle with it fllwing the instructins in the FAQ. Once yu have cnfirmed yu are able t lg in successfully, lg back ut. Recnnect t the server using PuTTY, this time adapting the steps t include an additinal SSH tunnel. When cnfiguring the new SSH sessin in PuTTY, additinally navigate t the "Cnnectin -> SSH -> Tunnels" sectin and create a secure tunnel by frwarding prt 80 n the server t prt 8888 n the lcal hst ( r lcalhst). Click the "Add" buttn t add the secure tunnel cnfiguratin t the sessin. Here is an example:

23 G back t the "Sessin" sectin and save yur changes by clicking the "Save" buttn. Click the "Open" buttn t pen an SSH sessin t the server. The SSH sessin will nw include a secure SSH tunnel between the tw specified prts. While the tunnel is active, yu shuld be able t access the phpmyadmin cnsle thrugh the secure SSH tunnel yu created, by brwsing t T lg in, use username rt fr MySQL and the applicatin passwrd frm the detail page fr yur clud server. If yu are unable t access phpmyadmin, verify that the SSH tunnel was created by checking the PuTTY event lg (accessible via the "Event Lg" menu):

24 Linux and Mac OS X T access the applicatin using yur Web brwser, create an SSH tunnel, as described belw. Open a new terminal windw n yur lcal system (fr example, using "Finder -> Applicatins -> Utilities -> Terminal" in Mac OS X r the Dash in Ubuntu). Make sure yu can lg in t the server cnsle fllwing the instructins in the FAQ. Once yu have cnfirmed yu are able t lg in successfully, lg back ut. Run the fllwing cmmand t cnfigure the SSH tunnel. Remember t replace SERVER-IP with the public IP address r hstname f yur server. Enter yur SSH passwrd when prmpted. ssh -N -L 8888: :80 bitnami@server-ip If yu are using a private key t cnnect t the server, use the fllwing cmmand instead, remembering t replace KEYFILE with the path t yur private key and SERVER-IP with the public IP address r hstname f yur server: ssh -N -L 8888: :80 -i KEYFILE bitnami@server-ip NOTE: If successful, the abve cmmands will create an SSH tunnel but will nt display any utput n the server cnsle. While the tunnel is active, yu shuld be able t access the phpmyadmin cnsle thrugh the secure SSH tunnel yu created, by brwsing t T lg in, use username rt fr MySQL and the applicatin passwrd frm the detail page fr yur clud server.

25 Hw t create a custm PHP applicatin? Many users run a Bitnami stack as a develpment envirnment fr their wn PHP prjects (as ppsed t running third-party applicatins such as Jmla! r WrdPress). T deply yur PHP applicatin in this envirnment, yu have tw ptins: T make a single PHP applicatin accessible at the rt URL f the Web server (fr example, simply cpy the PHP files int the /pt/bitnami/apache2/htdcs flder. Fr an example, take a lk at the phpinf example. T have several applicatins running, create the same structure used by Bitnami when installing Bitnami PHP applicatins. Recent versins f Bitnami stacks ship a dem applicatin with this structure t help yu get started. T use this, fllw the steps belw: Cpy the /pt/bitnami/dcs/dem flder int the /pt/bitnami/apps directry. sud cp -r /pt/bitnami/dcs/dem /pt/bitnami/apps Add the fllwing line t the end f the /pt/bitnami/apache2/cnf/bitnami/bitnami-apps-prefix.cnf file: Include "/pt/bitnami/apps/dem/cnf/httpd-prefix.cnf" Restart the Apache server using the cmmand-line tl. sud /pt/bitnami/ctlscript.sh restart apache Yu shuld nw be able t access the dem applicatin at Yu shuld see a "Hell wrld" message in yur brwser. If yur stack des nt include a dem applicatin, r if yu prefer t create a custm PHP applicatin frm scratch, fllw the steps belw. These steps assume that yur applicatin will live in the /pt/bitnami/apps/myapp/ directry: Run the fllwing cmmands t create the directries: sud mkdir /pt/bitnami/apps/myapp sud mkdir /pt/bitnami/apps/myapp/htdcs/

26 sud mkdir /pt/bitnami/apps/myapp/cnf Create and edit the /pt/bitnami/apps/myapp/cnf/httpd-prefix.cnf file and add the line belw t it: Alias /myapp/ "/pt/bitnami/apps/myapp/htdcs/" Alias /myapp "/pt/bitnami/apps/myapp/htdcs/" Include "/pt/bitnami/apps/myapp/cnf/httpd-app.cnf" Create and edit the /pt/bitnami/apps/myapp/cnf/httpd-app.cnf file and add the cntent belw t it. This is the main cnfiguratin file fr yur applicatin, s mdify it further depending n yur applicatin's requirements. <Directry /pt/bitnami/apps/myapp/htdcs/> Optins +FllwSymLinks AllwOverride Nne <IfVersin < 2.3 > Order allw,deny Allw frm all </IfVersin> <IfVersin >= 2.3> Require all granted </IfVersin> </Directry> NOTE: If yur applicatin uses.htaccess files, yu shuld change the AllwOverride Nne ptin t AllwOverride All. Find ut hw t mve the.htaccess file cntent t the main server cnfiguratin file. Once yu have created the files and directries abve, add the fllwing line t the end f the main Apache cnfiguratin file at /pt/bitnami/apache2/cnf/bitnami/bitnami-apps-prefix.cnf, as shwn belw:

27 Include "/pt/bitnami/apps/myapp/cnf/httpd-prefix.cnf" Restart the Apache server: sud /pt/bitnami/ctlscript.sh restart apache Yu shuld nw be able t access the applicatin at Hw t disable the cache in the server? If yu are develping n tp f an AMP Stack r custmizing any Bitnami Stack, yur files (like JavaScript files) may be cached by the server and even yu mdify them yur changes will nt appear t be applied. In rder t disable the cache in the server and let the files be served each time, disable PageSpeed fr Apache and OPCache, enabled by default in PHP. T disable PageSpeed, cmment ut the fllwing lines in yur httpd.cnf (/pt/bitnami/apache2/cnf/httpd.cnf) #Include cnf/pagespeed.cnf #Include cnf/pagespeed_libraries.cnf T disable OPCache, change pcache.enable in yur php.ini file and set it t 0 (/pt/bitnami/php/etc/php.ini) Hw t cnnect t the MySQL database? Yu can cnnect t the MySQL database frm the same cmputer where it is installed with the mysql client tl. mysql -u rt -p Yu will be prmpted t enter the rt user passwrd. This is the same as the applicatin passwrd. Find ut hw t btain applicatin credentials.