Starting Servers
Executing Samples
Stopping Servers

The Samples demonstrate specific features of the Solution Installation and Deployment technology so that a user can learn about specific parts of the technology by observing its behavior, and also visualize how they might apply the features to their own installations.

The Solution installation and deployment samples scenario includes the following samples:
    Java Custom Action Sample – to demonstrate how to define actions during installation.
    Lifecycle Sample (Family) – to show how Solution Installation can be utilized in a typical product cycle.

SISamples can be installed either with prerequisite check or without prerequisite check.
With prerequisites:

This needs the prerequisites to be installed on the machine. After the SISample is successfully installed, you can browse the files and execute the samples from the ISC console. The only prerequisite is ISC (Integrated Solutions Console).

Without prerequisites:

Use this option if you just want to inspect the SISamples files but but do not have prerequisites installed on your machine. This will put the SISamples files on the machine. You will be able to execute the samples from the command line but not from the ISC console.
To get the complete SISamples, you will have to uninstall the existing SISamples and reinstall the SISamples with prerequisite check.

The SISamples can be invoked using a standard web browser. Upon completion of the installation, the scenario is ready to be invoked.

In order for the scenario to function, the following server must be started:

• ISC_Portal

This server is started when Integrated Solutions Console is installed. If the machine is rebooted, the server will be in stop state. The Integrated Solutions Console does not function if ISC_Portal server is not running.

This server can be started using the following shortcuts (only on Windows systems):
On Windows systems:
  Start->Programs->IBM Autonomic Computing Toolkit->Solution Install   Samples->Start ISC Servers

This server can also be started by doing the following:

1. On the system where Integrated Solutions Console is installed, open a command window.

2. Issue the following command to start the server:
For Windows systems:
    your_isc_root\Runtime\AppServer\bin\startServer.bat ISC_Portal
For AIX, Linux, and Solaris systems:
    your_isc_root/Runtime/AppServer/bin/startServer.sh ISC_Portal

where your_isc_root is the root directory for your Integrated Solutions Console Toolkit installation.

To activate the samples, perform the following steps:
Note : Please ensure that no other process is accessing Solution Install repository while SISamples are being executed.

1. Launch the web console using the following shortcuts :

On Windows systems only:
Start->Programs->IBM Autonomic Computing Toolkit->Problem Determination Scenario->Launch Web Console

This brings up the login page of Integrated Solutions Console.
It can also be opened in a Web browser using the following URL:
http://<host_name>:<portalserver.port>/ibm/console/

The PortalServer.Port value can be found in the <isc_install_location>/Runtime/isc.properties file.
The default value is 8421. E.g.: http://localhost:8421/ibm/console

2. Log in using the UserID and password provided during the Integrated Solutions Console installation.

3. Expand Autonomic Computing Scenarios on the console Welcome page under the 'Work Items' tab.

4. Expand Solution Install and Deployment Samples.
 
5. Expand Samples.

6. Expand the sample (java custom action or Family) which you wish to execute.

7. Click Sample Description to learn more about the selected sample.

8. Click Control Panel to display the sample's control page.

9. Click the links in the control panel to invoke commands on the sample.

Please do not manually refresh the browser until the command has completed

If the command fails, exception messages will appear in the status panel.
The status of hyperlinks may still change to reflect falsely that the command has succeeded.
In such case, please uninstall the sample by selecting the uninstall link, and start afresh.

10. The log panel and the IU Db panel will automatically get updated to display the result of command execution.

11. The descriptor files used by the sample can be viewed from the descriptor panel.

The server can be stopped using the following shortcuts:
On Windows systems only:

Start->Programs->IBM Autonomic Computing Toolkit->Solution Install Samples->Stop ISC Servers

This server can also be stopped by doing the following:

1. On the system where Integrated Solutions Console is installed, open a command window.
2. Issue the following command to stop the server:
For Windows systems:
your_isc_root\Runtime\AppServer\bin\stopServer.bat ISC_Portal
For AIX, Linux, and Solaris systems:
your_isc_root/Runtime/AppServer/bin/stopServer.sh ISC_Portal

where your_isc_root is the root directory for your Integrated Solutions Console Toolkit installation.

If  Integrated Solutions Console runtime has been installed on an external WebSphere Application Server, the above mentioned commands should be executed from the bin folder of the Application Server.

The documentation for the Solution Installation and Deployment Samples is provided in a stand alone document in the Autonomic Computing Information  bundle called the Solution Installation and Deployment Scenario Guide.

This guide also references the Autonomic Computing Toolkit Developer's Guide that is also present in the Autonomic Computing Information bundle.

In addition, online help is provided using the Eclipse based online help facility in the Integrated Solutions Console.

This scenario requires the following bundles to be installed:
    - Integrated Solutions Console bundle

Known Limitations:

• Deploying SI application on ISC is one of the steps during SI Samples installation. This particular step will fail if the user credentials provided to the installer are wrong (after couple of attempts). But rest of the installation proceeds after throwing a message to the user 'Installer could not deploy the SI Samples component. But the installation is complete. Please refer to the SI Samples Readme for manually deploying SI application on ISC'.
• Undeployment of SI Samples - During uninstallation., if the undeployment of SI Samples application on ISC fails, uninstallation completes with a message to undeploy manually.

SISamples Deployment :
For Windows:

1. Move to <ISCWASHome>/bin folder.Invoke the following command.
   --> startServer.bat ISC_Portal
2. Move to <SISamplesInstallLoc>/bin/ISCComponent folder.Invoke the following command.
   --> deploysicomp.bat <iscadmin> <iscpassword> <iscport>

For Unix:

1. Move to <ISCWASHome>/bin folder.Invoke the following command.
   --> startServer.sh ISC_Portal
2. Move to <SISamplesInstallLoc>/bin/ISCComponent folder.Invoke the following command.
   --> deploysicomp.sh <iscadmin> <iscpassword> <iscport>
   

For OS400:

1. Move to <ISCWASHome>/bin folder.Invoke the following command.
   --> startServer ISC_Portal
2. Move to <SISamplesInstallLoc>/bin/ISCComponent folder.Invoke the following command.
   --> deploysicomp.sh <iscadmin> <iscpassword> <iscport>

SISamples Undeployment :
For Windows:

1. Move to <ISCWASHome>\bin folder.Invoke the following command.
   --> startServer.bat ISC_Portal
2. Move to <SISamplesInstallLoc>\bin\ISCComponent folder.Invoke the following command.
   --> removesicomp.bat <iscadmin> <iscpassword> <iscport>

For Unix:

1. Move to <ISCWASHome>/bin folder.Invoke the following command.
   --> startServer.sh ISC_Portal
2. Move to <SISamplesInstallLoc>/bin/ISCComponent folder.Invoke the following command.
   --> removesicomp.sh <iscadmin> <iscpassword> <iscport>

For OS400:

1. Move to <ISCWASHome>/bin folder.Invoke the following command.
   --> startServer ISC_Portal
2. Move to <SISamplesInstallLoc>/bin/ISCComponent folder.Invoke the following command.
   --> removesicomp.sh <iscadmin> <iscpassword> <iscport>

User Permissions:
The user invoking the installer should have Administrator  (on windows system)/root (on Unix Systems) permissions.

Java
The installer needs SUN/IBM Java 1.4.2 to successfully install the package. The installer has a bundled IBM JRE 1.4.2. If Java 1.4.2 is not present on  the system, the installer will put the bundled java on the machine and this will be used during installation.

IBM JRE 1.4.2 will be installed at the following location :

Windows : C:/Program Files/IBM/Java142/jre
Solaris : /usr/jre142
Linux : /usr/jre142
AIX : /usr/java142
OS/400 : the installer does not contain a bundled java. The machine should have Java 1.4.2 pre- installed. All OS/400 bundles require PTFs  SF99269 and MF34019 to be installed prior to installing any of the Toolkit bundles.

NOTE: The installed bundles use Java 1.4.2. Please do not delete the java after the package is installed.

Integrated Solutions Console bundle - required to monitor and manage the execution of the SI Samples.

If you need help, use the support forum on the developerWorks Web site at:
    www.ibm.com/developerworks/autonomic

This forum is constantly monitored during business hours across two time  zone areas (US-based, and Asia-based); we will make every effort to respond to your comments and questions within one business day promptly.