The method of installing the Server Studio™ and Sentinel™ depends on the operating system of the host platform
and whether you are installing from a distribution archive or from a CD-ROM. If you have downloaded the software distribution
archive, first you will need to unpack its content into a temporary installation directory — for example, "system_drive:\temp" which
will create the following directory structure: "system_drive:\temp\AGS_Install". From this point forward, these instructions
will uniformly refer to both the CD-ROM and the temporary installation directory as "Setup_Home". Similarly, the home directory
where you chose to install Server Studio™ and Sentinel™ will be uniformly referred to as "AGS_Home".
Note: Server Studio™ and Sentinel™ server can be installed on the same host computer (default installation);
however they do not need to be. In production environments, where Sentinel™ server's operational loads are expected to be significant and its services must be available continuously,
it is recommended to install Sentinel™ server on a different host computer from the one where Server Studio™ is installed.
4.1 Installing Server Studio™ and Sentinel™ on a Windows host platform
- Change to the "Setup_Home\Windows\" directory and verify that the "install.exe" file is present.
- Double-click the "install.exe" file to start installation.
- The installation wizard will launch and guide you through the software installation. You can abort an installation at any step of the process by clicking Cancel.
- Wait for the welcome screen to appear. Click Next to continue.
- Read the software license agreement (SLA), and select an option:
- I accept the terms of the License Agreement - If you accept the agreement, the Setup program continues.
- I do NOT accept the terms of the License Agreement - If you do not accept the agreement, the Setup program ends.
- Click Next.
- Select a location where you want to install the software. You can use the default location ("C:\Program Files\AGS")
or browse to another location of your choice by clicking Change.
- After you make your selection, click Next.
- The Setup program displays a message confirming your selection. Click Install to proceed.
- The summary screen lets you know that the installation was successful, or it displays any errors that may have occurred during the installation.
- Click Done.
4.2 Installing Server Studio™ and Sentinel™ on UNIX-type and MAC OS X host platforms
MAC OS X Installation: Server Studio™ and Sentinel™ server are installed on the MAC OS X host platform via the Terminal command line prompt.
To perform the installation, first start Finder, then under the "Go" menu select "Utilities", then click on the "Terminal" icon. To open new instance of the Terminal, press “Apple+N”.
Once the Terminal instance is open, follow the installation instructions for UNIX-type host platforms provided below.
4.2.1 Interactive Graphical Mode
- From the command line, change to the "Setup_Home\unix" directory and verify that the "install.jar" file is present.
- Run the following command at the command prompt:
java -jar install.jar
- The installation wizard will launch and guide you through the software installation. You can abort an installation at any step of the process by clicking Cancel.
- Wait for the welcome screen to appear. Click Next to continue.
- Read the software license agreement (SLA), and select an option:
- I accept the terms of the License Agreement - If you accept the agreement, the Setup program continues.
- I do NOT accept the terms of the License Agreement - If you do not accept the agreement, the Setup program ends.
- Click Next.
- The Setup program will search your host system for the compatible Java 2 runtime environment and will either:
- display the full path of the Java Virtual Machine (JVM) location; or
- prompt you to manually enter the full path to the location of the "java" executable file.
- Click Next to continue.
- Select a location where you want to install the software. You can use the default location
or browse to another location of your choice by clicking Change.
- After you make your selection, click Next.
- The Setup program displays a message confirming your selection. Click Install to proceed.
- The summary screen lets you know that the installation was successful, or it displays any errors that may have occurred during the installation.
- Click Done.
4.2.2 Interactive Console Mode
The interactive console mode is intended for installation of Server Studio and Sentinel on UNIX-type host platforms where graphical user interface is unavailable.
- From the command line, change to the "Setup_Home\unix" directory and verify that the "install.jar" file is present.
- Run the following shell command at the command prompt:
unset DISPLAY
- Next, run the following command at the command prompt:
java -jar install.jar -i console
- The installer will launch and guide you through the software installation. You can abort an installation at any step of the process by executing "Ctrl-C" or "Ctrl-Break" command.
- Follow the interactive prompts to select or manually enter the full path of the Java Virtual Machine (JVM) location.
- When prompted, select the location where you want to install the software. You can use the default location
("/opt/AGS") or specify an alternate location.
- Read the software license agreement (SLA). Press "ENTER" several times to scroll through the license agreement.
- When the prompt "DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N)" appears, select an option:
- "Y" - If you accept the agreement, the Setup program continues.
- "N" - If you do not accept the agreement, the Setup program ends.
- The installer will proceed with the software installation and on the completion of the process will return control to the command prompt,
or it displays any errors that may have occurred during the installation.
4.2.3 Silent Command-line Mode
The silent command-line mode is intended for installation of Server Studio and Sentinel on UNIX-type host platforms without any user interaction
and is useful in implementing unattended scriptable installations. Server Studio and Sentinel will be installed in the default location ("/opt/AGS").
- From the command line, change to the "Setup_Home\unix" directory and verify that the "install.jar" file is present.
- To initiate silent command-line mode installation, run the following command at the command prompt, or from a script:
java -jar install.jar -i silent -DUSER_INSTALL_DIR=(full path to your installation directory)
- Example:
java -jar install.jar -i silent -DUSER_INSTALL_DIR=/opt/ags
4.2.4 Interactive Console Mode - Sentinel Only
The interactive console mode is intended for installation of Sentinel on UNIX-type host platforms where graphical user interface is unavailable.
- From the command line, change to the "Setup_Home\unix" directory and verify that the "install.jar" file is present.
- Run the following shell command at the command prompt:
unset DISPLAY
- Next, run the following command at the command prompt:
java -jar install.jar -i console -DCHOSEN_INSTALL_FEATURE_LIST=sentinel
- The installer will launch and guide you through the software installation. You can abort an installation at any step of the process by executing "Ctrl-C" or "Ctrl-Break" command.
- Follow the interactive prompts to select or manually enter the full path of the Java Virtual Machine (JVM) location.
- When prompted, select the location where you want to install the software. You can use the default location
("/opt/AGS") or specify an alternate location.
- Read the software license agreement (SLA). Press "ENTER" several times to scroll through the license agreement.
- When the prompt "DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N)" appears, select an option:
- "Y" - If you accept the agreement, the Setup program continues.
- "N" - If you do not accept the agreement, the Setup program ends.
- The installer will proceed with the software installation and on the completion of the process will return control to the command prompt,
or it displays any errors that may have occurred during the installation.
4.2.5 Silent Command-line Mode - Sentinel Only
The silent command-line mode is intended for installation of Sentinel only on UNIX-type host platforms without any user interaction
and is useful in implementing unattended scriptable installations. Sentinel will be installed in the default location ("/opt/AGS").
- From the command line, change to the "Setup_Home\unix" directory and verify that the "install.jar" file is present.
- To initiate silent command-line mode installation, run the following command at the command prompt, or from a script:
java -jar install.jar -i silent -DCHOSEN_INSTALL_FEATURE_LIST=sentinel -DUSER_INSTALL_DIR=(full path to your installation directory)
- Example:
java -jar install.jar -i silent -DCHOSEN_INSTALL_FEATURE_LIST=sentinel -DUSER_INSTALL_DIR=/opt/ags
4.3 Starting Server Studio™
- To start Server Studio™ under Windows operating system, go to Start menu and click Programs > AGS > Server Studio > Server Studio .
- To start Server Studio™ under UNIX-type operating systems, from the command line prompt, change to the "AGS_Home\SeverStudio\" directory and execute:
./ServerStudio
4.4 Starting Server Studio™ using Command-line SQL Runner
You can execute SQL scripts by invoking Server Studio in a command line mode. This feature allows using Server Studio with an external scheduler and in automated application deployment tasks. SQL scripts can include special LOAD and UNLOAD SQL statements to import and export data files as part of script's logic.
Another advantage of Command-line SQL Runner is an ability to execute very large SQL scripts without opening them in graphical SQL editors, which might save significant amount of system memory used by Server Studio application's process.
- To start Server Studio™ under Windows operating system, go to Start menu and run "cmd.exe" to open Windows command console. From the command line prompt, change to the "AGS_Home\SeverStudio\" directory and execute:
serverstudio [command line options - see Command Line Usage below]
- To start Server Studio™ under UNIX-type operating systems, from the command line prompt, change to the "AGS_Home\SeverStudio\" directory and execute:
./ServerStudio [command line options - see Command Line Usage below]
Server Studio command line usage:
-s server name
-h host name[:port] (e.g. production:9088)
-d database (by default sysmaster is used for initial connection)
-u user
-p password
-f SQL script file to execute
-prop connection property file (key=value pairs). Use it to set paremeters like
DBDATE, CLIENT_LOCALE, etc.
-out output directory for SQL statement result sets
-l execution log file
-a append results to existing log file
-err specifies the maximum number of errors after which the tool should quit (by
default all statements will be executed)
-help Server Studio command line usage
Sample of a command-line invocation under Windows OS:
serverstudio -s ol_ids11_qa -h qahostgr2:9088 -d ecomdb -u dev5 -p dv5pswd -f c:\data\sql\myscript.sql -l c:\data\myscript.log -out c:\myscript
IMPORTANT NOTE:
You need to have file write permissions in directories, which you specify in '–out' and '-l' parameters. Otherwise, Server Studio will not be able to save a log file or result set files that might be produced by SQL script’s SELECT statements.
See Tools -> SQL Manager -> Command-line SQL Runner menu in Server Studio for more information on command-line mode and options.
4.5 Starting Sentinel™
- To start Sentinel™ application server, you will need to:
- start Server Studio™ and go to the "Sentinel — Automation" tab, located adjacent to the "Object Browser" and "DB Diff" tabs;
- locate the Sentinel Server node in the object tree (typically it will be named "Sentinel Server [localhost]" in a default installation);
- right-click on the Sentinel Server node and select from the shortcut menu Start Sentinel command.
4.6 Uninstalling Server Studio™ and Sentinel™
To uninstall Server Studio™ and Sentinel™ from the host computer:
- If Sentinel™ is running, you will need to shut down its operations:
- start Server Studio™ (if is is not running already) and go to the "Sentinel — Automation" tab, located adjacent to the "Object Browser" and "DB Diff" tabs
- locate the Sentinel™ node in the object tree (typically it will be named "Sentinel Server [localhost]" in a default installation)
- right-click on the Sentinel node and select from the shortcut menu Stop Sentinel command
- Exit Server Studio™ application.
- Stop Sentinel™ services:
- for Windows — by using Windows Service Manager (look for AGS Sentinel Server service)
- for UNIX-type — by executing the following Shell script:
/opt/AGS/sentinel/sentinel stop
- To permanently remove Server Studio™ and Sentinel™ installation from the host computer:
- for Windows — open the Control Panel, then open the Add/Remove Programs window. Select AGS Server Studio™, then click Change/Remove to uninstall. Select AGS Sentinel™, then click Change/Remove to uninstall.
Follow the instructions in the wizard to uninstall the products.
- for UNIX-type — delete AGS_Home installation directory.
6.0 Technical Support
Refer to the Support section of the Server Studio™ online Help for information about how to contact AGS Technical Support.
To report a problem, you will need to provide AGS Technical Support with the following information:
- The version and build numbers of your AGS product (to find this information, select Help >About from the application menu).
- The version numbers of the the operating system and of the Java 2 Platform runtime environment on the host platform that your AGS product is running on.
- The version number of the IBM Informix® DBMS server you are working with.
- The host platform and the version number of the operating system your IBM Informix® DBMS server is running on.
- Exact content of the error message, if available.
- Sequence of steps required to reproduce the problem.