Install Problems:
Permission Problems
After you install the program if you go to your admin login screen in a browser ( i.e. yourdomain.com/mailer/admin/index.php) and you receive an error about file or directory permissions, then you should set the permissions on the file or directory that is indicated in the error message. If you have already set the permissions correctly as indicated in the message and you still get the error then you should do the following:
1. Go to your mailer directory using an FTP program or SSH access.
2. Look for the etools2.php file and rename it to any other file name ( i.e. etools2.php.bak)
3. Look for the etools2_noperm.php file and rename it to etools2.php.
*Once you have completed these three steps above you should no longer receive the permission errors.
Blank Page Seen After Install
Solution 1
If you install the program and you are able to login but when you login and click on one of the sections you see a blank page, then go to:
http://www.yourdomain.com/mailert/start/
(Please note: replace www.yourdomain.com with your actual domain name)
This page will double check to make sure you have decrypted all of the files. There are 2 main files that you must encrypt, and if you go to this page follow all the links until it tell you that you can successfully use the product. If at any page you are asked to enter a decryption code then you should enter the word: omnistar
Solution 2
If you install our program and you go to the admin directory and see a blank page then you should do the following:
chmod 666 lib/etools2.php
Open the etools2.php file you will see a line:
error_reporting(1);
change this to say:
error_reporting(64);
then do a chmod 444 lib/etools.php
And then go to our www.yourdomain.com/mailer/admin/ and see if you see errors. If you cannot figure out from the errors what to do, then you can open a support ticket by going to our Online Support Center.
Uploading Large Files:
If you are looking to upload large files to the mailer to import contacts then you need to do the following:
1. You need to change the setting in PHP called:
upload_max_filesize
and
post_max_size
These values should be set to 16M
You can do this through the php.ini file or you can add this line to your apache under the virtual host and re-start apache:
php_admin_value upload_max_filesize 16M
php_admin_value post_max_size 16M
2. For MySql you have to have the variable:
max_allowed_packet to be equal to 16
This can be accomplished by:
modifying to /etc/my.cnf
and setting the:
set-variable = max_allowed_packet=16M
under: [mysqld]
Also keep in mind that my.cnf can reside in different dirs
depending on the installation. Usually it is /etc/my.cnf,
/var/lib/mysql/my.cnf, /usr/local/var/my.cnf.
Apache Upload Troubleshooting
If you are still having trouble once you set the parmeters above, then you should check the following apache limits
LimitRequestBody
LimitRequestFields
LimitRequestFieldSize
LimitRequestLine
You should check especially the first one in the httpd.conf. It is possible the POST data is larger than the
value in the LimitRequestBody
Foreign Languages
Mysql uses various character sets when storing information in the databases. By default it uses "latin1" charset. This charset is English, american english and other languages that does not have accents, hyphenation and other special symbol modifiers. Therefore, when the email comes to the database with latin1 charset, it looses its accents and other features when saved in the database.To fix this, you must do the following:- find out what character set is native to spanish.
It is probably iso8859-15 or cp1252.-
make sure that mysql on that server supports that charset. If not, it should be re-compiled with the support of that charset, using options
./configure - with-extra-charset=all-
make sure that mysql is started with the support of that charset:
mysql> show variables like '%charset% 'character set: latin1 character sets: (list of many supported charsets)- if necessary, restart mysqld with options --with-charset=your_charset --with-extra-charsets=all-
Now you should backup your database !- you need to convert your database to the spanish charset. You must have access to the physical database files to do that. You cannot do it from mysql console. The command is:
myisamchk -r -q --set-character-set=charset tablename
Do this for all tables in your database. Replace "charset" with the spanish charset name in the command above.
Reset Administrative Password
You will need to follow these instructions if you ever loose your administrative password and you would like to reset the password.
1) Download the reset_password.php file from your mailer directory.
2) Open that file in an editor and enter in your database information between the single quotes.
3) Save the file and upload back into the mailer directory.
4) Once it's been uploaded then go to that page in a web browser, once you visit the page in a web browser it will reset the username and password back to
login: admin
password: admin
Then you should login with admin/admin and change the password.
5) Make sure you remove your database information from the reset_password.php page.
Blue Screen But Cannot Login
1) Download the etools2.php file from your lib directory.
2) Open that file in an editor and enter in your database information between the single quotes.
3) Save the file and upload it back into the lib directory.
Login with admin/admin
If you have any further questions enter a support ticket.