Repository virtual machine scripts and commands

The repository virtual machine administers itself with minimal user involvement. The repository virtual machine is supplied with scripts and commands that you can use to start, stop, and manage the repository.

All scripts are in the /usr/local/sbin directory of the repository virtual machine.

Change to Repository Server (Informix® database server) Directory (cdids or cdrepo)
The commands . cdids and . cdrepo change the current directory to /opt/IBM/Informix/Optim/repo/server/ids1170. A dot and space must precede the command.
Change to Repository Manager Directory (cdmanager or cdrepomanager)
The commands . cdmanager or . cdrepomanager change the current directory to /opt/IBM/Informix/Optim/repo/manager. A dot and space must precede the command.
Run the Informix DB–Access utility (dbacess)
The command dbaccess starts the Informix DB–Access utility, which you can use to access, modify, and retrieve information from the repository server.
Delete Repository Database locks (deleterepolock ##)
The command deleterepolock lock_id deletes the repository database lock with the specified lock ID See listerepolocks to display a list of repository database locks
Display the repository server environment variables (echoenv)
The command echoenv displays the repository server environment variables.
Display the IP Address (echoip)
The command echoip displays the optimrepository IP address.
Display Network Information (echorules)
The command echorules displays network information for the optimrepository, including the MAC address and number of Ethernet connections. There must be only one Ethernet connection (eth0).
Reset the IP address (hostipaddr_reset)
The command hostipaddr_resets updates the /etc/hosts file with the optimrepository IP address. Useful if the virtual machine is hibernated and when resumed, has a new IP address. This script is automatically called at virtual machine startup.
List Repository Database Locks (listrepolocks)
The command listrepolocks displays the repository database locks. See deleterepolock to delete a specific repository database lock.
List Running Processes (pids)
The command pids displays information about all running processes for the current user.
List Running Processes for Repository Server (pidsids)
The command pidsids displays information about all running repository server processes.
Prepare the Image for Moving (rmrules)
The command rmrules removes the file /etc/udev/rules.d/70-persistent-net.rules If you plan on making a copy of the virtual machine, you must first remove this file by using the rmrules script.
Remove SNAP and TRACE files (rmsnap)
The command rmsnap removes all snap and trace files that are produced when the repository manager stops abnormally.
Start the Repository Manager (repomanager or startrepomanager)
The commands repomanager and startrepomanager call the optimrepomanager.ksh script to start the repository manager. If the repository manager starts successfully, the repository manager automatically starts the repository server. The repomanager and startrepomanager scripts are functionally identical. The output goes to two files:
repomanager.log
Normal output
repomanager.err
Error output
Stop the Repository Manager (stoprepomanager)
The command stoprepomanager calls the stoprepomanager.ksh script to stop the repository manager. You must be the informix user to run this command.
Verify Repository Server Is Running (repostate)
The command repostate displays the repository server state. The repository server is functioning properly if the repository server is listening on port 9088 of the IP address of the virtual machine. If the repository server uses IP address 127.0.0.1, you cannot access the repository from outside the virtual machine. If the repository server uses IP address 127.0.0.1, then open the file /opt/IBM/InfoSphere/Optim/repo/server/ids11750/etc/sqlhosts.optimrepo and ensure that the host name is the virtual machine name optimrepository and not *localhost.
Verify Repository Manager Is Running (repomanagerstate)
The command repomanagerstate shows whether the repository manager is running.
Shut Down or Restart the Virtual Machine (shutdown)
The command shutdown shuts down or restarts the repository virtual machine. You must be the admin user to use the shutdown command.
  • Enter sudo shutdown -h now to shut down the repository virtual machine.
  • Enter sudo shutdown -r now to restart the repository virtual machine.
Start the Repository Server (startrepo)
The command startrepo starts the repository server by calling the startrepo.ksh file that was installed by the repository server installer. You must be the informix user to run this script.
Stop the Repository Server (stoprepo)
The command stoprepo stops the repository server by calling the stoprepo.ksh script that was installed by the repository server installer.