GINESYS v 11.100.0 Software Installation Guide

SUMMARY

The new GINESYS V 11.100.1 is an installation pack and not just an update. Therefore, we need to understand the various scenarios and the types of installations that may be done with the new pack.

GINESYS v11.100.0 software is pretty easy to install and run if you follow the guide carefully. This page is the header page for an installation of GINESYS version 11.100.0 and contains links to lists of pre-requisites in terms of hardware/OS and software as well as the step by step installation.

Migrating from previous versions creating a new database

You may wish to create a new Oracle 12c database in the interests of enhanced performance. In that case follow the steps given below to uninstall the previous database.

IMPORTANT

Note: When you are migrating from previous versions, you must go through the process of deleting or uninstalling the previous GINESYS Software if you are migrating from a lower version to v11.100.0.

Taking back-up and checking it is mandatory; before uninstallation of software.

You must uninstall the previous GINESYS version from Add/Remove Programmes.
Delete the GINESYS folder structure from the drive where you have installed it.
Delete all GINESYS related schedulers from the command prompt (cmd) with the command <<sc delete <name of scheduler>>>. The list of services run in GINESYS are given below:
1. GINESYS Scheduler Service
2. GINESYS SMS Service
3. GINESYS Email Service
4. GINESYS Licensing Service
5. GINESYS Planning Service
Delete the previous ODAC (Oracle Data Access Components) 11g by executing the following steps:
1. Open Command Prompt; remember to run it as Administrator.
2. Locate the folder where ODAC has been installed (eg: c:\ODAC64).
3. Once the cursor changes, run the command c:\ODAC64 uninstall.bat all odac (Note that “odac” over here is the home name, the same name used while installing ODAC). This uninstalls all the components.
Delete the previous ODAC (Oracle Data Access Components) 10g by executing the following steps:
1. Uninstall all Oracle components using the Oracle Universal Installer (OUI).
2. Run regedit.exe and delete the HKEY_LOCAL_MACHINE/SOFTWARE/Oracle key. This contains registry entries for all Oracle products.
3. If you are running 64-bit Windows, you should also delete the HKEY_LOCAL_MACHINE/SOFTWARE/Wow6432Node/Oracle key if it exists.
4. Delete any references to Oracle services left behind in the following part of the registry (HKEY_LOCAL_MACHINE/SYSTEM/CurrentControlSet/Services/Ora*). It should be pretty obvious which ones relate to Oracle.
5. Reboot your machine.
6. Delete the "C:\Oracle" directory, or whatever directory is your ORACLE_BASE.
7. Delete the "C:\Program Files\Oracle" directory.
8. If you are running 64-bit Windows, you should also delete the "C:\Program Files (x86)\Oracle" directory.
9. Remove any Oracle-related subdirectories from the “C:\ProgramData\Microsoft\Windows\Start Menu\Programs\" directory.
10. Empty the contents of your "C:\temp" directory.

Migrating from previous versions keeping the existing database

Otherwise, if the existing 10g database has to be maintained, the 10g database can exist as it is, provided the OS involved is Windows 7 or Windows Server 2008.

IMPORTANT

Note: that you must have ODAC 12c even if your database 10g

Note: When you are migrating from previous versions, you must go through the process of deleting or uninstalling the previous GINESYS Software if you are migrating from a lower version to V11.100.0.

Taking back-up (especially of environment variables) and checking it is mandatory; before uninstallation of software.
You must uninstall the previous GINESYS version from Add/Remove Programs.
Delete the GINESYS folder structure from the drive where you have installed it.
Delete all GINESYS related schedulers from the command prompt (cmd) with the command <<sc delete <name of scheduler>>>. The list of services run in GINESYS are given below:
1. GINESYS Scheduler Service
2. GINESYS SMS Service
3. GINESYS Email Service
4. GINESYS Licensing Service
5. GINESYS Planning Service
Delete the previous ODAC (Oracle Data Access Components) 10g by executing the following steps:
1. In the command prompt (cmd) type <<cd <drive where ODAC is existing>\ODAC64>>
2. In the current drive i.e. <drive where ODAC is existing>\ODAC64 – type <<uninstall all ODAC>>
3. Similarly change drive for ODAC32, and uninstall it.
Go to Regedit>>software>>wow64>>oracle and delete odp.net file
Restart the System
Run the Server Pack Setup from the CD
Run Getting Started
1. Choose option “I have connected to an existing database”
2. Ensure that your test connection is successful
Generate License request from license manager and mail key to license@gsl.in
Activate license from License Manager
1. Search online for the key and accept and then check POS users
If you get a connection problem to the Primary Database then open the License manager and define the domain in the last tab.
Start the License service and wait for 30 seconds
Run HO AutoUpdate
1. Stop all services from the Services and Processes tab
2. Update till latest
Open software location
1. Locate Webdb updater
2. Run webdb update
Now your software is ready for use.

New Installations and Migrating from previous version with new database

Now we can start installing the software from the CD provided.

Find the Setup.exe on your CD drive.

Now you’ll be taken to the Installation Wizard

System information and mandatory prerequisite information (install/ de-install) will appear.

Please follow the steps given above to enable IIS if you get this alert.

Please enable .NET framework 4.6.2 if you get this alert.

Uninstall old ODAC11 and ODAC12c will automatically be installed by the GINESYS Installer.

If it is a migration scenario, uninstall the old GINESYS version, when you get this message.

If you have already installed and de-installed the prerequisite services and software, then you will find the License Agreement.

Once you accept the licensing terms; the installation process will continue, you need to provide a User Name and a Company Name and choose the “Anyone who uses this machine” option. Then click on Next.

Then choose the features you wish to install by checking the boxes. Click on the Next option.

It displays the Installation Location and the features installed. If you feel all details are correct, click on Next.

Now your GINESYS installation will be validated and configured.

Now the installer will install some of the prerequisite software/utilities

SAP Crystal Reports Runtime 13 version 13.0.8 or above

To install the following Crystal Report and other third party database applications, click the link:

Crystal Reports 13.0.20

SQL Server 2012 Native Client

SQL Server 2012 CLR Types

SQL Server 2012 Shared Management Objects

SQL Server 2012 Command Line Utilities

Then your installation is complete and your software is ready for use.

Make a final check to see that all GINESYS related software and the other installations from the pack are completed properly.

Check the new folder structure.

Check your database installation (whether 10g or 12c).

Getting Started

Right after the physical installation of the software, the GINESYS logo will appear on your screen. Clicking on this logo will take you to the GINESYS Launchpad. The GINESYS Launchpad is a new Dashboard UI for GINESYS v11.100.0. The Getting Started tab is a component of this UI and will be active only once after a new installation to allow users to connect to their database, provide company details and install some of the pre-requisites.

How does getting started work?

Steps	Figure
After completion of running the GINESYS Installation Wizard, the GINESYS Launchpad appears on clicking the GINESYS logo on your screen. It has only one active tab at this stage i.e. the Getting Started.
On clicking Getting Started, you will reach the Welcome screen. Click on the “Next” button.
The next screen is about database connection. Please provide the following: Host: The UI by default shows the Machine (Server) Name. Port: Must be 1521 Service: Must be GINESYS respectively. User (with Data Base Administrator privilege): May be anything (recommended user - SYSTEM) Password: May be anything (recommended password - SYSPWD) This would allow easy management of the database and handling of support issues. Correctly locate Oracle SQLCMD Command Line Utility by browsing; if you have installed your database correctly then it would be in the shown path only. Click on the Next button.
The next screen, provides you the following options: A new installation with a new database Connect to an existing database Restore the old database
After making the above decision and clicking next, if you have chosen a new installation, you will get a new screen. Here you can put in your Company Information. IMPORTANT This is a very important stage of installation, please be careful about the information you put in here, because you will not be able to change the details later. Schema Password - May be anything (recommended password - gmpl) . GINESYS Admin name - May be anything (recommended password - admin) GINESYS Admin password - May be anything (recommended password - admin). Start Date would depend on the financial calendar that your company follows. IMPORTANT Note : Usually the financial year is 1st April current year to 31st March next year. Click on the Next button.
Then the next step of Getting Started shows information about the installations made by it.
Finally, you get the Completion Screen, which prompts you to apply your GINESYS License and open the License Manager. For new installation, click Yes and install the license. Click on the Finish button to complete the process and close the Application. ALERT! Note: Now you can open the software. For first time login you have to use User Name: admin and Password: admin.
After login with User Name: admin and Password: admin, you need to create New User. After creating the new user you need to create User Role, Role Policies etc. For details please check the following link: How To: Manage Security in Ginesys HO Admin

Workstation installation

Since GINESYS runs on Client-Server architecture, it is necessary to carefully install the clients or workstations. Follow steps given below to successfully install them.

Steps	Figure
Map the nodes to the Application Server of the GINESYS software.
In the Application Server, Click on the WKSETUP folder.
In the WKSETUP folder, run the setup.exe as administrator.
This will open the GINESYS Workstation Welcome Screen. Click on Next.
In the next screen, provide the following details and click Next. User name Company Name Select the option of - Anyone who uses the Computer or Only for me (user) (Recommended option - Anyone who uses the Computer).
Next the features to be installed are selected and the Destination folder is provided. Click on Next.
All settings for the installation are displayed on this screen. If any thing needs to be changed - click on Back; if everything is satisfactory - click Next.
The Workstation Configuration happens automatically.
ODAC 64 bit is then installed. Then the installation is complete and ready to be used.