Omnistar Recruiter Install User Guide (Codelock)

Omnistar Recruiter Install User Guide (Codelock)

I Omnistar Recruiter Install User Guide (Codelock) Table of Contents Foreword 0 Part I HOME 2 Part II Pre-installation 4 Part III Installation 7 Part IV Troubleshooting 10 Part V MySql Troubleshooting 14 Index 0

Part I

2 Omnistar Recruiter Install User Guide (Codelock) 1 HOME Welcome to Omnistar Recruiter Install User Guide (Codelock). If you have trouble installing Omnistar Recruiter then we recommend having our developers install it for you. If you would like our developers to install it for you then you can follow the instructions and fill out the forms at our install pages. Also you can fill out a ticket in our Online Customer Care Center with the exact problem. We do not offer phone support for install issues. Important Note: To install this program you will either need to have shell access to your server, or you will need an FTP program that is capable of changing the permissions of files and folders on your server (i.e. executing the chmod command). Examples of FTP programs with these capabilities are WS_FTP or FileZilla (recommended). We also recommend for security reasons you do not unzip or move files up as the root user. You should move files up and unzip them as any other user other then root. You may download a PDF of this User Guide. You will need Adobe Reader to view this userguide in its PDF format. Click on the icon below to download the Adobe Reader for FREE.

Part II

4 Omnistar Recruiter Install User Guide (Codelock) 2 Pre-installation Step 1. Unpack the archive If you are using Unix or Linux ssh (shell access), then you will need to first upload the archive file to your server and put it in the root directory of your web site. Once you have done that, run the following command at the command line (not including the leading ">"): > tar -zxvf recruiter_codelock_32.tgz This will automatically create a directory on your server called "recruiter_32" and unpack all of the archived files into it. OR If you do not have shell access to your server, you will have to use an FTP program with capabilities as noted on the main page. First, unpack the archive using a program such as WinZip. If you use WinZip, before you unzip the file you must go to Options -> Configuration -> Miscellaneous, and undo the option for "Tar file smart CR / LF conversion". This will automatically create a directory on your hard drive called "recruiter_32" and unzip the files into it. Step 2 (VERY IMPORTANT). Rename to recruiter directory. The program unzips to recruiter_32 sub-directory when you unzip it. Your license file is set to use sub-directory recruiter instead of recruiter_32. Therefore, when you unzip the folder you should rename it to recruiter. It you want to install the program in any other directory than recruiter, please submit a support ticket and let us know the name of the sub-directory that you would like to use. Make sure you DO NOT HAVE 2 sub-directories. Therefore instead of having: www.yourdomain.com/hiring/recruiter You should have: www.yourdomain.com/recruiter/ (Note: Replace yourdomain.com with the actual domain name) Step 3. Create an empty database Create an empty database. If you use an existing database, ALL TABLES AND DATA WILL BE DELETED. Write down the database name, database username, database password and database host for future reference. We have a test file that can be used to test the MySql database your created. It is called testmysql. php and it is located in the recruiter directory. You should fill out the top of this page where it is

Pre-installation 5 asking you for the database information and then visit the link: www.yourdomain.com/recruiter/testmysql.php in a web browser. If you see the word: mysql_ok Then this means your database information is correct and you should continue. If you do not see these words then you should contact your hosting company because this means that your database information if not correct. You may send your hosting company this letter and they should be able to help you. You should not continue until you see the word mysql_ok.

Part III

Installation 7 3 Installation When installing Omnistar Recruiter, the first step is to change the permissions to certain files and directories. Step 1. Change permissions of certain files and directories Go into the recruiter directory then run the following commands chmod 777 admin chmod 777 img chmod 666 lib/etools2.php chmod 666 lib/etools2_noperm.php chmod 666 spaw/config/spaw_control.config.php chmod 777 lib/codelock.php chmod 777 admin/codelock.php Step 2. Pull up the install page in your browser From a browser access: http://www.yourdomain.com/recruiter/install.php Follow the instructions on this page and fill out all information and click the Install button. Important Note: ALL Existing Data that you had in the database will be deleted once you install the program. Therefore make sure you use a EMPTY database. Step 3. Secure the directories and files Omnistar Recruiter is now installed and you have to change permissions to certain directories and files to make everything secure. chmod 755 to the recruiter directory chmod 444 lib/etools2.php chmod 444 lib/etools2_noperm.php Step 4. Move license file to lib directory Copy the license.php file to the lib directory. IMPORTANT NOTE: If you use an ftp program to copy the file make sure that you coy the file in binary format. Step 5. Decrypt the software Pull up www.yourdomain.com/recruiter/start/ and when you pull up the page where it ask to enter a decrypt code. You should enter "omnistar" but without the quotes and make sure it is lowercase. Once you enter installed you will be shown text that will take you to another link where you will also enter omnistar. After you finish this step, then program is installed. Step 6. Program Installed Visit http://www.yourdomain.com/recruiter/admin/

8 Omnistar Recruiter Install User Guide (Codelock) If you see a login page, then you have successfully installed the program. You can login by using. Login: admin Password: admin To begin using the software you should click on the first link which is a Getting Started Guide.

Part IV

10 Omnistar Recruiter Install User Guide (Codelock) 4 Troubleshooting Install Problems: Permission Problems After you install the program if you go to your admin login screen in a browser ( i.e. yourdomain.com/ recruiter/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 recruiter 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/recruiter/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/recruiter/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

Troubleshooting 11 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 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.

12 Omnistar Recruiter Install User Guide (Codelock) 1) Download the reset_password.php file from your recruiter 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 your recruiter 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. If you have any further questions enter a support ticket.

Part V

14 Omnistar Recruiter Install User Guide (Codelock) 5 MySql Troubleshooting It is important when you install the software to make sure you are using an EMPTY DATABASE. DO NOT USE A DATABASE WITH EXISTING DATA. If you try to install our software and you get a MySql error, then make sure you follow the following steps before contacting us. Download the testmysql.php file using any ftp program. The testmysql. php file is located in the main directory. Once you download the file open the file using any editor software. You can even use Windows Notepad. Fill in your MySql information at the top of the file with the database name, database username and database password and database host. Once you fill out this information, move the file back to your web server. Once the file is back on your web server go to that file from using any web browser such as Microsoft IE or Netscape. The page should say MySql_OK. If the page does not say MySql_OK then you should contact your hosting company because your MySql information is not correct. This is a problem your hosting company has to fix and we cannot help because it has nothing to do with our software. However, if you would like a letter to forward your hosting company click here. If you visit testmysql.php you see MySQL errors or other Errors then Contact your hosting company If you see MySql_OK then Our technical team can install the product for you. You can fill out the form: http://www.omnistaretools.com/install/ If you see "MySQL_OK" and you also see a Bunch Of Tables listed then Pull up the page etools2.php in the lib directory with any editor and make sure your database information is filled out at the top of the file. When you finish editing the file make sure you move it back to your web server and set the permissions to 444.