How to Install VisiChat
Posted by VisiChat Hosting, Last modified by VisiChat Hosting on 17 February 2015 11:47 AM
Preparing to Install
You should see the first screen of the installation script. Please carefully read and accept the displayed terms and conditions of the software. After this is done, you can click Start Installation to proceed.
Entering the License Key
The second step of the installation script will prompt you for your Product Key. This is your Visichat license number. You can enter it here or copy and paste it directly from Customers Portal->My Licenses. When the key is in the text field, press Continue.
If you get a failed validation notification, verify the following: 1) Is the '''domain name''' you're trying to install Visichat to registered for the license key? 2) Does the '''application IP''' for the license key match your present Red5 server IP address? To check these details: 1) Go to '''Customers Portal''' at [http://license.visichathosting.com/licenses.php VisiChat Hosting Website]; 2) Login with your email and password (if you don't have a password or lost it, Contact Support to reset it); 3) Go to '''My Licenses'''; 4) Click on the Visichat license key you're trying to use. If details didn't match: 1)Scroll through the form to check the registered '''domain name''' and '''application IP''' fields; 2)Edit one or both fields if needed and save the form (you can do this up to 10 times per license or license renewal); 3)Go back to the Visichat installer's product key screen; 4)Try the key again and it should validate.
Creating config.php and setting required permissions
Keep the browser window with the install script open and using your SSH client navigate to the chat's upload directory via the command line, this is normally something like /install/red5/webapps/videochat/. To confirm that you are in the right place, run the following command at the prompt:
Output should be: admin docs files images index.php install loader.swf scripts swf
If your output is different from the above, you may be in the wrong directory. Navigate back up a few levels and orient yourself using the ls command if necessary to ensure you are creating config.php in the right location.
To create the config.php file, type in the following command:
[$]# touch config.php
No message will be issued when the file is created, so double check that it's definitely present by using ls again:
Output should be: admin docs images install scripts config.php files index.php loader.swf swf
Set read, write and execute permissions for config.php'; most importantly ensure that the file can be written to. To set the necessary permissions, use the following command:
[$]# chmod 777 config.php
Do the same for the files folder and its sub-folders. You can use the following recursive command achieve this:
[$]# chmod 777 files -Rf
Install PHP Components
The following components must be installed next:
If you have done everything correct up to this point, your install script screen should now update itself to look like the screenshot below.
Should you see any items on this screen indicated in red, then please go back to the relevant step and double check your actions follow the instructions precisely.
When all indicators are shown in green, i.e. you have set the permissions and installed all necessary PHP components correctly, press Continue.
MySQL database and Red5 application setup
This step is in four parts:
Configuring Red5 Application
This is the final step in the GChat Visichat installation script for a single chat (installing multiple chats is covered in a separate section, please see below). The screen should display the contents of the config.xml file for you to use.
Copy the displayed text on to the clipboard (CTRL+A, then CTRL+C inside the box, for example). Paste it into the file located at:
You can use a command line text editor such as nano to do this via SSH. Save the changes to the config.xml.
Now you can move the videochat folder from the install directory to the webapps folder of your Red5 server. This can be done using the following command:
[$]# mv /install/red5/webapps/videochat/ /opt/red5/webapps/
Restart your Red5 for the changes to take effect. Follow the Red5 instructions in the troubleshooting section if you are not sure how to do this. After Red5 is restarted, the installation is complete. Click Finish to end the installation script.
You can now navigate to your chat's admin panel and configure it for the first time, the address is normally yourchatname.com/admin/. You should now also remove the install folder, unless you are installing more chats on the same server
How to install multiple chats on the same server
To install multiple chats on the same Red5 server you must use a different name for each chat, have a separate license for each chat and hence have domain details for each chat registered with GChat.
You cannot use one product key for multiple chats.
To rename install/red5/webapps/videochat to install/red5/webapps/videochat-2 via SSH
Use: [$]#mv install/red5/webapps/videochat install/red5/webapps/videochat-2
videochat-2 is an example name we have been using so far, if you are calling your other chat something else, as before, replace videochat-2 with the name you are using.
[$]# mv /install/red5/webapps/videochat-2 /opt/red5/webapps/videochat-2
Repeat the steps for as many chats as needed.