Omnistar Recruiter Install User Guide (Codelock)

(1)

(2)

Part I HOME

2 Part II Pre-installation

4 Part III Installation

7 Part IV Troubleshooting

10 Part V MySql Troubleshooting

14

(3)

Part

(4)

Omnistar Recruiter Install User Guide (Codelock) 2

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.

(5)

Part

(6)

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 re-name 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.

(7)

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”

(8)

Part

(9)

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

(10)

If you see a login page, then you have successfully installed the program. You can login by using. Login: admin

Password: admin

(11)

Part

(12)

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

(13)

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

(14)

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.

(15)

Part

(16)

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

Omnistar Recruiter Install User Guide (Codelock)

Table of Contents

Part I HOME

2

Part II Pre-installation

4

Part III Installation

7

Part IV Troubleshooting

10

Part V MySql Troubleshooting

14

Part

1

HOME

Part

2

Pre-installation

Part

3

Installation

Part

4

Troubleshooting

Part

5

MySql Troubleshooting