makary/my_webapp_ynh
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Update README.md

Browse source
This commit is contained in:
jeromelebleu 2016-05-14 22:50:03 +02:00
parent 9fea67c20c
commit 1245610751
1 changed files with 15 additions and 15 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

30
README.md
View file

@ -6,38 +6,38 @@ Empty application with SFTP access to the Web directory.
## Overview ## Overview
This application allows you to easily install a custom Web application, This application allows you to easily install a custom Web application,
providing files access with SFTP. It can also create a MySQL database providing files access with SFTP. It can also create a MySQL database -
which will be backed up and restored if your application. The connection which will be backed up and restored with your application. The connection
details will be stored in the file `db_accesss.txt` located at the root details will be stored in the file `db_accesss.txt` located in the root
directory. directory.
Once installed, go to the chosen URL to know the user, domain and port Once installed, go to the chosen URL to know the user, domain and port
you will have to use for the SFTP access. Under the Web directory, you you will have to use for the SFTP access - the password is one you give
will have a `www` folder which is the public and served one. You can at the installation. Under the Web directory, you will see a `www` folder
put all the files of your custom Web application inside. which is the public and served one. You can put all the files of your
custom Web application inside.
## Upgrade ## Upgrade
Due to the SFTP access change, the upgrade can not be done from the last Due to the SFTP access change, the upgrade can not be done from the last
`my_webapp` application - provided with YunoHost 2.2. You will have to remove `my_webapp` application - provided with YunoHost 2.2. You will have to remove
it first and install this new one, taking care of migrating your Web it first and install this new one, taking care of migrating your data.
application.
### Save your files and database ### Save your files and the database
You will have to save the content of the `/var/www/my_webapp/files` You will have to save the content of the `/var/www/my_webapp/files`
directory, either from the Web admin interface provided with the old app, directory, either from the Web admin interface provided with the old app or
connecting to your server using SSH or SFTP as `admin`. connecting to your server using SSH - or SFTP as `admin`.
If you've created a MySQL database, you can also migrate it since the new If you've created a MySQL database, you can also migrate it since the new
version allows to manage it for you. To create a dump, you could use version allows to manage it for you. To create a dump, you could either use
*phpMyAdmin* or connect to your server and execute: *phpMyAdmin* or connect to your server and execute:
`mysqldump -u root -p$(cat /etc/yunohost/password --no-create-db "$dbname" > ./dump.sql` `mysqldump -u root -p$(cat /etc/yunohost/password --no-create-db "$dbname" > ./dump.sql`
(do not forget to replace `$dbname` by your database name). (do not forget to replace `$dbname` by your database name).
### Restore your custom Webapp ### Restore your custom Webapp
When you've take care of save your files - and optionally your database, When you've take care of saving your files - and optionally your database,
you can remove the app and install this new one. You can set the same you can remove the app and install this new one. You can set the same
settings as the previous installation. settings as the previous installation.
@ -46,8 +46,8 @@ and put everything into the `www` directory.
If you have chosen to migrate your database too, open the file `db_access.txt` If you have chosen to migrate your database too, open the file `db_access.txt`
to know the new database, user and password you will have to set in your app to know the new database, user and password you will have to set in your app
configuration. You can either restore the dump using *phpMyAdmin* or connect configuration. You can restore the dump you've created earlier either using
to your server and execute: *phpMyAdmin* or connect to your server and execute:
`mysql -u "$dbuser" -p"$dbpass" "$dbname" < ./dump.sql` `mysql -u "$dbuser" -p"$dbpass" "$dbname" < ./dump.sql`
(do not forget to replace `$dbuser`, `$dbpass` and `$dbname` with the values (do not forget to replace `$dbuser`, `$dbpass` and `$dbname` with the values
given in the file). given in the file).